Einstieg

Mit Capgo Cloud Build loslegen und erstelle deine erste iOS- oder Android-native Build in Minuten.

Was du benötigst

Bevor du beginnst, stelle sicher, dass du folgendes hast:

• A Capacitor-Anwendung, die lokal erfolgreich kompiliert wird
• Node.js 20 oder höher installiert
• Eine Capgo-Konto (ein kostenloses Probeabo reicht aus, um loszulegen)
• Ihr Capgo-Anwendung bereits registriert (führen Sie npx @capgo/cli@latest app add falls nicht
• (Keine Vorbereitung von Signierungszertifikaten erforderlich — wir stellen sie in der nächsten Schritt auf.)

Konfigurieren Sie Ihre Signierungszertifikate

Capgo benötigt Signierungszertifikate, um Ihre Anwendung zu erstellen und zu übermitteln — aber Sie müssen sie nicht manuell verwalten. Beantworten Sie ein paar Fragen und wir zeigen Ihnen den genauen Befehl, den Sie ausführen müssen:

Führen Sie Ihren ersten Build durch

Sie müssen mit Capgo angemeldet sein, 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 initdann sind Sie bereits fertig — die Einrichtung bietet Ihnen an, einen Build für Sie zu starten, wenn Sie am Ende fertig sind, also könnte Ihr erster Build bereits unterwegs sein. 🎉

Ansonsten starten Sie einen Build selbst mit build request — auf --platform setzen Sie

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 Build-Protokolle live in Ihrem Terminal. Capgo Build kann ein signiertes Artefakt zurückgeben oder es bei App Store Connect oder Google Play einreichen, wenn Sie die entsprechende Release-Fluss-Konfiguration einrichten.

Der Build-Prozess verstehen

When 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 Ihrer CI - Der Weblayer 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 Execution - Capgo kompiliert und signiert das native Projekt auf dedizierter Infrastruktur.
4. Log Streaming - Echtzeit-Logs werden in Ihrem Terminal über Server-Sent Events gestreamt.
5. Clean-up - 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.

Verwende Capgo 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 Einrichtung durch, 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 das fertige ios/ oder android/ Projekt, um es zu kompilieren und zu signieren, sodass es Ihre privaten Nexus, CocoaPods SSH oder Web-Build-Zugriff 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-Sync bleiben in Ihrem CI.

Was wird hochgeladen

Inkludiert	Beschreibung
ios/ oder android/	Der Ordner der nativen Plattform, 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

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)	Bereits synchronisiert in das native Verzeichnis via cap sync
.git/	Versionierungsgeschichte
.gradle/, .idea/, .swiftpm/	Build-Caches und IDE-Einstellungen
.env, Geheimnisse	Nie hochgeladen

Hinweis

Deine gebauten Web-Assets (JS, CSS und HTML) werden nur hochgeladen, weil npx cap sync hat sie in das native Projekt kopiert. Die Web-Quellen und die Abhängigkeitsinstallationsschritte bleiben in deinem CI; das vorbereitete native Projekt wird verwendet, um das Binärdatei zu erstellen und dann aufgeräumt.

Deine Verantwortlichkeiten

Bevor du loslegst npx @capgo/cli@latest build request:

1. Vorbereite in deinem CI - Löse private Paketregistrierungen, SSH-basierte CocoaPods, Geräte-SDKs, Erweiterungen und jede benutzerdefinierte native Vorbereitung in Bitrise oder deinem bestehenden CI auf.
2. Baue deine Web-Assets - Ausführe npm run build (oder den Build-Befehl deiner Frameworks).
3. Synchronisiere mit native - Ausführen npx cap sync Um die kompilierten Web-Assets in das vorbereitete native Projekt zu kopieren.
4. Den native Build anfordern - Das vorbereitete ios/ oder android/ Projekt an Capgo Build senden.

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-Operation benötigt keinen Zugriff auf Ihre private Nexus-Registrierung oder SSH-Zugriffskennungen, sobald Ihr CI die native Projekt vorbereitet hat. Siehe Build-Konfiguration zur Unterstützung von Umgebungsvariablen und Speicheroptionen.

Für eine kiosk-freie Version, die über MDM verteilt wird, konfigurieren Sie das Android-Projekt/Build, um ein APK zu produzieren. Wenn Sie die Build-Anfrage 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 verhindert den Upload in die Play Store, selbst wenn die Play-Kennungen gespeichert sind; --output-upload bietet eine zeitbegrenzte Verlinkung auf das signierte Ergebnis. Verteilen Sie das APK über Ihre MDM.

Zukünftige Schritte

Jetzt, da Sie Ihr erstes Build erstellt haben:

• Configure iOS Builds - Zertifikate und Profile einrichten
• Configure Android Builds - Keystores und Play Store einrichten
• Troubleshooting - Häufige Probleme und Lösungen
• CLI Reference - Vollständige Befehlsdokumentation

Benötigen Sie Hilfe?

• Überprüfen Sie das Troubleshooting-Guide
• Beteilige dich an unserer Discord-Gemeinschaft
• E-Mail-Unterstützung bei support@capgo.app