Getting Started

Loslegen mit Capgo Cloud Build und erstellen Sie Ihre erste native iOS- oder Android-Anwendung in Minuten.

Wat benötigen Sie?

Before you begin, ensure you have:

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

Konfigurieren Sie Ihre Signaturanmeldeinformationen

Capgo needs signing credentials to build and submit your app — but you don’t have to wrangle them by hand. Answer a couple of questions and we’ll point you to the exact command to run:

Erstellen Sie Ihre erste Build

Sie müssen sich mit Capgo authentifizieren, um zu bauen. Wenn Sie das noch nicht getan haben:

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

Wenn Sie gerade erst build initsind Sie bereits fertig — die Einrichtung bietet Ihnen an, einen Build für Sie zu starten, sodass Ihr erster Build bereits auf dem Weg ist. 🎉

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

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

Verständnis des Build-Prozesses

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 - Die Web-Schicht wird erstellt, private Abhängigkeiten werden gelöst und die fertigen Assets werden in das native Projekt synchronisiert.
2. Hochladen - Das vorbereitete native Projekt wird in die sichere Cloud-Speicherung hochgeladen.
3. Build-Ausführung - Capgo kompiliert und signiert das native Projekt auf dedizierter Infrastruktur.
4. Protokoll-Streaming - Echtzeit-Protokolle werden in Ihrem Terminal über Server-Sent Events gestreamt.
5. Säubern - Die Build-Umgebung und temporäre Projekt-Daten werden nach dem Build bereinigt; die Ausgabehaltung hängt von den ausgewählten Artefakt und Store-Lieferungsoptionen ab.

Verwenden Sie Capgo Build mit Bitrise oder einem anderen CI

Capgo Build ersetzt Ihre bestehende CI nicht. 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 Konfiguration aus, bauen Sie die Web-Schicht und führen Sie npx cap sync.

Dann rufen Sie Capgo Build mit dem vorbereiteten native Projekt auf. Capgo erhält das bereitgestellte ios/ oder android/ Projekt, um es zu kompilieren und zu signieren, sodass es Ihre privaten Nexus, CocoaPods SSH- oder Web-Build-Zugriffscodes nicht benötigt. Die kompilierten Web-Ressourcen befinden sich bereits im vorbereiteten native Projekt; sie werden für den Build verwendet und nicht als Quellrepository aufbewahrt.

Was wird gebaut

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

Was wird hochgeladen

Inkludiert	Beschreibung
ios/ oder android/	Die native Plattformordner, die Sie bauen
package.json, package-lock.json	Abhängigkeitsmanifest
capacitor.config.*	Capacitor-Konfiguration
resources/	App-Ikone, Splash-Screens
Native Plugin code	Nur die ios/ oder android/ Unterverzeichnis jedes Capacitor-Plugins

Was NICHT hochgeladen wird

Ausgeschlossen	Warum
node_modules/ (die meisten davon)	Nur der native Plugin code wird eingeschlossen, nicht die JS-Abhängigkeiten
src/	Ihr Web-Quellcode code bleibt lokal
dist/, www/, build/ (Ebenbene)	Schon synchronisiert in das native Verzeichnis via cap sync
.git/	Versionierungsgeschichte
.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-Quellen 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 beginnen npx @capgo/cli@latest build request:

1. Vorbereiten in Ihrem CI - Löschen Sie private Paketregistrierungen, SSH-basierte CocoaPods, Geräte-SDKs, Erweiterungen und jede benutzerdefinierte native Vorbereitung in Bitrise oder Ihrem bestehenden CI.
2. Bauen Sie Ihre Web-Ressourcen - Führen Sie npm run build (oder den Build-Befehl Ihres Frameworks) aus.
3. Synchronisieren Sie mit native - Ausführen npx cap sync um die kompilierten Web-Ressourcen in das vorbereitete native Projekt zu kopieren.
4. Anfrage für das native Build stellen - Das vorbereitete Projekt senden ios/ oder android/ Projekt an Capgo Build übergeben

Was Capgo Build Handhabt

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

Capgo Die Build-Anforderung benötigt keinen Zugriff auf Ihre private Nexus-Registrierung oder SSH-Zugriffsdaten, sobald Ihr CI die native Projekt vorbereitet hat. Siehe Build-Konfiguration für unterstützte Umgebungsvariablen und Speicheroptionen.

Für eine kiosk-Flavor, die über MDM verteilt wird, konfigurieren Sie das Android-Projekt/Build, um ein APK zu produzieren. Wenn Sie die Build-Anforderung stellen, 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 prevents Play Store upload even if Play credentials are saved; --output-upload verhindert den Upload in die Play Store, selbst wenn die Play-Zugriffsdaten gespeichert sind;

Nächste Schritte

Nun, da Sie Ihre erste Build erstellt haben:

• Konfiguration von iOS-Builds Zertifikate und Profile einrichten
• Konfiguration von Android-Builds Zertifikate und Play Store einrichten
• Fehlersuche Häufige Probleme und Lösungen
• CLI Referenz Komplette Befehlsdokumentation

Hilfe benötigen?

• Überprüfen Sie Fehlersuchehilfe
• Betreibe Discord-Gemeinschaft
• Senden Sie eine E-Mail an support@capgo.app