Erste Schritte

Starte mit Capgo Cloud Build und erstelle in wenigen Minuten deinen ersten nativen Build für iOS oder Android.

Was du benötigst

Before you begin, ensure you have:

• Eine Capacitor-App, die lokal erfolgreich gebaut wird
• Node.js 20 oder höher installiert
• Ein Capgo Account (ein kostenloser Testzugang reicht für den Start)
• Deine App ist bereits in Capgo registriert (sonst führe npx @capgo/cli@latest app add aus)
• (Du musst keine Signing-Credentials vorab vorbereiten – wir richten sie im nächsten Schritt ein.)

Signing-Credentials konfigurieren

Capgo braucht Signing-Credentials, um deine App zu bauen und einzureichen – aber du musst dich nicht selbst darum kümmern. Beantworte ein paar Fragen und wir zeigen dir den exakten Befehl:

Deinen ersten Build ausführen

Du musst bei Capgo authentifiziert sein, um zu bauen. Falls noch nicht geschehen:

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

Falls du gerade build init, bist du bereit – das Onboarding bietet am Ende an, einen Build für dich zu starten, sodass dein erster Build möglicherweise bereits unterwegs ist. 🎉

Starte andernfalls selbst einen Build mit build request – setze --platform auf das, was du baust:

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

Das CLI lädt das vorbereitete Native-Projekt hoch und streamt die Build-Logs live in deinem Terminal. Capgo Build kann ein signiertes Artefakt zurückgeben oder es an App Store Connect oder Google Play übermitteln, wenn du den entsprechenden Release-Flow konfigurierst.

Der Build-Prozess im Überblick

Wenn du den Build-Befehl ausführst, 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 deiner CI - Baue die Web-Schicht, löse private Abhängigkeiten auf und synchronisiere die fertigen Assets in das Native-Projekt.
2. Upload - Das vorbereitete native Projekt wird für den Build in einen sicheren Cloud-Speicher hochgeladen.
3. Build-Ausführung - Capgo kompiliert und signiert das native Projekt auf dedizierter Infrastruktur.
4. Log-Streaming - Logs werden in Echtzeit via Server-Sent Events an dein Terminal gestreamt.
5. Aufräumen - Die Build-Umgebung und temporäre Projektdaten werden nach dem Build bereinigt; die Aufbewahrung der Ergebnisse hängt vom gewählten Artefakt und den Store-Delivery-Optionen ab.

Nutze Capgo Build mit Bitrise oder einer anderen CI

Capgo Build ersetzt nicht deine bestehende CI. Behalte die Schritte, die privaten Zugriff erfordern, in Bitrise oder einem anderen CI-System: Installation aus privaten Registries, Auflösen privater CocoaPods über SSH, eigenes natives Setup, Web-Layer-Build und Ausführung. npx cap sync.

Rufe dann Capgo Build mit dem vorbereiteten nativen Projekt auf. Capgo erhält das fertige ios/ oder android/ Projekt zum Kompilieren und Signieren, sodass keine privaten Nexus-, CocoaPods-SSH- oder Web-Build-Zugangsdaten benötigt werden. Die kompilierten Web-Assets befinden sich bereits in diesem vorbereiteten nativen Projekt; sie werden für den Build verwendet, statt als Quellcode-Repository aufbewahrt zu werden.

Was gebaut wird

Capgo Build erhält das vorbereitete native Projekt, das zum Kompilieren Ihrer App erforderlich ist. Ihre Web-Quelldateien code, die Installation privater Abhängigkeiten und die Capacitor-Synchronisation bleiben in Ihrer CI.

Was hochgeladen wird

Inklusive	Beschreibung
ios/ oder android/	Der native Plattformordner, den Sie bauen
package.json, package-lock.json	Abhängigkeits-Manifest
capacitor.config.*	Capacitor-Konfiguration
resources/	App-Icons, Splashscreens
Native-Plugin code	Nur der ios/ oder android/ Unterordner jedes Capacitor-Plugins

Was NICHT hochgeladen wird

Ausgeschlossen	Warum
node_modules/ (der größte Teil)	Nur das native Plugin code wird einbezogen, keine JS-Abhängigkeiten
src/	Deine Web-Quelle code bleibt lokal
dist/, www/, build/ (Root-Level)	Bereits in den nativen Ordner synchronisiert über cap sync
.git/	Version control history
.gradle/, .idea/, .swiftpm/	Build-Caches und IDE-Einstellungen
.env, Secrets	Wird nie hochgeladen

Hinweis

Deine gebauten Web-Assets (JS, CSS und HTML) werden nur hochgeladen, weil npx cap sync sie in das native Projekt kopiert hat. Die Web-Quelle und die Abhängigkeitsinstallation bleiben in deiner CI; das vorbereitete native Projekt wird zum Build der Binärdatei verwendet und anschließend bereinigt.

Ihre Verantwortlichkeiten

Vor dem Start npx @capgo/cli@latest build request:

1. In Ihrer CI vorbereiten - Private Package-Registries, SSH-basierte CocoaPods, Device-SDKs, Erweiterungen und jede benutzerdefinierte native Vorbereitung in Bitrise oder Ihrer bestehenden CI auflösen.
2. Web-Assets bauen - Ausführen npm run build (oder der Build-Befehl Ihres Frameworks).
3. Mit nativ synchronisieren - Ausführen npx cap sync um die kompilierten Web-Assets in das vorbereitete native Projekt zu kopieren.
4. Native Build anfordern - Das vorbereitete senden ios/ oder android/ Projekt zu Capgo Build.

Was Capgo Build übernimmt

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

Capgo Build benötigt keinen Zugriff auf Ihr privates Nexus-Registry oder SSH-Zugangsdaten, sobald Ihre CI das native Projekt vorbereitet hat. Siehe Build-Konfiguration für unterstützte Umgebungsvariablen und Store-Optionen.

Für eine Kiosk-Variante, die per MDM verteilt wird, konfiguriere das Android-Projekt/Build so, dass ein APK erzeugt wird. Nutze beim Anfordern des Builds beide Flags, um Google Play zu überspringen und das signierte Artefakt zu erhalten:

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

--no-playstore-upload verhindert den Play-Store-Upload, selbst wenn Play-Credentials gespeichert sind; --output-upload liefert einen zeitlich begrenzten Link zum signierten Artefakt. Verteile dieses APK über dein MDM.

Nächste Schritte

Nachdem du deinen ersten Build erstellt hast:

• iOS-Builds konfigurieren - Zertifikate und Profile einrichten
• Android-Builds konfigurieren - Keystores und Play Store einrichten
• Fehlerbehebung - Häufige Probleme und Lösungen
• CLI Referenz - Vollständige Befehlsdokumentation

Brauchst du Hilfe?

• Schau in die Troubleshooting-Guide
• Tritt unserem Discord-Community
• E-Mail-Support unter support@capgo.app