Getting Started

Mit Capgo Cloud Build beginnen und in Minuten Ihre erste native iOS- oder Android-Anwendung erstellen.

Was Sie benötigen

Before you begin, ensure you have:

• Eine Capacitor-Anwendung, die lokal erfolgreich kompiliert wird
• Node.js 20 oder höher installiert ist
• Eine Capgo-Konto (ein kostenloses Probeabo reicht aus, um loszulegen)
• Deine App ist bereits in Capgo registriert (führe npx @capgo/cli@latest app add Wenn nicht)
• Keine Vorbereitung von Signierungsanmeldeinformationen erforderlich – wir stellen sie in der nächsten Schritt ein.

Konfiguriere deine Signaturzertifikate

Capgo benötigt Signaturzertifikate, um deine App zu erstellen und zu übermitteln — aber du musst sie nicht selbst handhaben. Beantworte ein paar Fragen und wir zeigen dir den genauen Befehl, den du ausführen musst:

Erstelle deine erste Build

Du musst mit Capgo angemeldet sein, um zu bauen. Wenn du das noch nicht getan hast:

npx @capgo/cli@latest login
# or, in CI, set the token directly:
export CAPGO_TOKEN=your_api_key

Wenn du gerade erst build init, Sie sind bereits fertig – die Einrichtung bietet Ihnen an, einen Build für Sie zu starten, sodass Ihr erster Build bereits auf dem Weg sein könnte. 🎉

Ansonsten starten Sie einen Build selbst mit build request — setzen Sie --platform auf das, was Sie bauen:

npx @capgo/cli@latest build request com.example.app --platform <android|ios> --build-mode debug

Das CLI lädt die vorbereitete native Projektdatei hoch und streamt die Build-Protokolle live in Ihrem Terminal. Capgo Der Build kann eine signierte Artefakt zurückgeben oder es bei App Store Connect oder Google Play einreichen, wenn Sie die entsprechende Freigabefluss konfigurieren.

Der Build-Prozess verstehen

Wenn Sie den Build-Befehl ausführen, passiert Folgendes:

flowchart LR
    A[Your CI] -->|1. Prepare Native Project| B[Prepared iOS / Android Project]
    B -->|2. Upload| C[Capgo Build]
    C -->|3. Compile and Sign| D[Dedicated Build Infrastructure]
    D -->|4. Stream Logs| E[Your Terminal]
    D -->|Return Signed Artifact or Store Delivery| F[Output]
    D -->|5. Clean Temporary Project Data| G[Cleanup]

1. Vorbereitung in Ihrem CI - Erstellen Sie die Web-Schicht, lösen Sie private Abhängigkeiten und synchronisieren Sie die fertigen Assets in das native Projekt.
2. Hochladen Die vorbereitete native Projekt wird in eine sichere Cloud-Speicherung hochgeladen, um das Build zu erstellen.
3. Build-Execution - Capgo kompiliert und signiert das native Projekt auf dedizierter Infrastruktur.
4. Protokoll-Streaming - Echtzeit-Protokolle fließen in Ihr Terminal über Server-Sent Events.
5. Säubern - Die Build-Umgebung und die temporären Projekt-Daten werden nach dem Build bereinigt; die Ausgabewahrung hängt von den ausgewählten Artefakt und Speicherdienstoptionen ab.

Verwende Capgo Build mit Bitrise oder einem anderen CI

Capgo Build ersetzt nicht Ihre bestehende CI. Halten Sie die Schritte, die Ihre private Zugriff benötigen, in Bitrise oder einem anderen CI-System: Installieren Sie aus privaten Registern, lösen Sie private CocoaPods über SSH, führen Sie eine benutzerdefinierte native Einstellung aus, bauen Sie die Web-Schicht und führen Sie npx cap sync.

Rufen Sie dann Capgo Build mit dem vorbereiteten native Projekt auf. Capgo erhält die bereitgestellte ios/ oder android/ Das Projekt wird so vorbereitet, dass es nicht Ihre privaten Nexus-, CocoaPods-SSH- oder Web-Build-Zugangsdaten benötigt. Die kompilierten Web-Ressourcen befinden sich bereits im vorbereiteten nativen Projekt; sie werden für den Build verwendet und nicht als Quellrepository beibehalten.

Was wird gebaut

Capgo Das Build-Prozess erhält das erforderliche vorbereitete native Projekt, um Ihre App zu kompilieren. Ihre Web-Quelle code, Ihre private Abhängigkeitsinstallation und Capacitor bleiben in Ihrem CI.

Was wird hochgeladen

Enthalten	Beschreibung
ios/ oder android/	Der native Plattformordner, den Sie bauen
package.json, package-lock.json	Abhängigkeitsmanifest
capacitor.config.*	Capacitor Konfiguration
resources/	App-Ikonen, Splash-Screens
Natives Plugin code	Nur der ios/ oder android/ Unterordner jedes Capacitor-Plugins

Unterstützter Plugin-Unterverzeichnis

Ungeschlossene	Warum
node_modules/ (die meisten davon)	Nur natives Plugin code wird eingeschlossen, nicht JS-Abhängigkeiten
src/	Ihr Web-Quelle code bleibt lokal
dist/, www/, build/ (Ebeneniveau)	Wurde bereits in das native Verzeichnis via cap sync
.git/	Versionkontrollhistorie
.gradle/, .idea/, .swiftpm/	Build-Caches und IDE-Einstellungen
.env, Geheimnisse	Nie hochgeladen

Hinweis

Ihre gebauten Web-Ressourcen (JS, CSS und HTML) werden nur hochgeladen, weil npx cap sync sie sie in das native Projekt kopiert haben. Die Web-Quelle und die Abhängigkeitsinstallationsschritte bleiben in Ihrem CI; das vorbereitete native Projekt wird zum Bauen des Binärs verwendet und dann gelöscht.

Ihre Verantwortung

Bevor Sie starten npx @capgo/cli@latest build request:

1. Vorbereiten in Ihrer CI - Beheben Sie private Paketregistrierungen, SSH-basierte CocoaPods, GerätesDKs, Erweiterungen und jede benutzerdefinierte native Vorbereitung in Bitrise oder Ihrer bestehenden CI.
2. Bauen Sie Ihre Web-Ressourcen - Ausführen npm run build (oder die Build-Befehls Ihres Frameworks).
3. Synchronisieren Sie mit der nativen - Ausführen npx cap sync um die kompilierten Web-Ressourcen in das vorbereitete native Projekt zu kopieren.
4. Anfrage für die nativen Build - Senden Sie die vorbereitete ios/ oder android/ Projekt zu Capgo erstellen.

Wie Capgo erstellt

• Native iOS-Kompilierung (Xcode, Fastlane)
• Native Android-Kompilierung (Gradle)
• Code-Signierung mit Ihren Anmeldeinformationen
• Optionale Einreichung bei App Store Connect oder Google Play
• Unterstützte native Build-Konfiguration und -Anmeldeinformationen als Umgebungsvariablen übergeben

Capgo Build benötigt keinen Zugriff auf Ihr privates Nexus-Repository oder SSH-Anmeldeinformationen, sobald Ihr CI die native Projekt vorbereitet hat. Siehe Build-Konfiguration zur Liste der unterstützten Umgebungsvariablen und Speicheroptionen.

Für eine Kiosk-Variante, die über MDM verteilt wird, konfigurieren Sie das Android-Projekt/Build, um eine APK zu produzieren. Wenn Sie das Build anfordern, verwenden Sie beide Flags, um Google Play auszuschließen und das signierte Ergebnis abzurufen:

npx @capgo/cli@latest build request YOUR_APP_ID --platform android --no-playstore-upload --output-upload

--no-playstore-upload verhindert den Upload in die Play Store, selbst wenn Play-Kennwörter gespeichert sind; --output-upload bietet eine zeitbegrenzte Verlinkung zum signierten Ergebnis. Verteilen Sie diese APK über Ihr MDM.

Nächste Schritte

Abschnitt mit dem Titel „Zukünftige Schritte“

• Konfigurieren von iOS-Builds Konfigurieren Sie iOS-Builds
• - Zertifikate und Profile einrichten Konfigurieren Sie Android-Builds
• Fehlersuche - Häufige Probleme und Lösungen
• CLI Referenz - Vollständige Befehlsdokumentation

Hilfe benötigt?

• Überprüfen Sie Fehlersucheführer
• Join our Discord-Gemeinschaft
• E-Mail-Support bei support@capgo.app