Anfangen

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

Was Sie benötigen

Bevor Sie beginnen, stellen Sie sicher, dass Sie Folgendes haben:

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

Konfigurieren Sie Ihre Signaturzertifikate

Capgo benötigt Signaturzertifikate, um Ihre Anwendung zu bauen und zu übermitteln – aber Sie müssen sie nicht selbst handhaben. Beantworten Sie ein paar Fragen und wir zeigen Ihnen den genauen Befehl, den Sie ausführen müssen:

Führen Sie Ihre erste Build durch

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, bist du bereits fertig — die Einrichtung bietet dir an, einen Build für dich zu starten, sodass dein erster Build bereits auf dem Weg ist. 🎉

Ansonsten starte einen Build selbst mit build request — setze --platform auf das, was du bauen möchtest:

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 deinem Terminal. Capgo Build kann eine signierte Artefakt zurückgeben oder es bei App Store Connect oder Google Play einreichen, wenn du die entsprechende Freigabe-Konfiguration konfiguriert hast.

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 - Der 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. Reinigung - Nach dem Build werden die Build-Umgebung und die temporäre Projekt-Daten gelöscht; die Ausgabehaltung hängt von den ausgewählten Artefakten und -Liefersystemen ab.

Verwende 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 fertige ios/ oder android/ Kontext: HTML-Textfragment aus einer längeren Capgo-UI-Zeichenfolge (Elternschlüssel `alternatives_cta_questions`). Seite/Bereich: Vergleichsseite für lebendaktualisierte Capacitor-Alternativen. Rolle: Langen Marketing- oder Rechtsparagraphen. Gesehen in: Seite alternatives.astro. Produkt- und Markenbegriffe von Capgo sowie Entwicklertitel werden genau beibehalten. Nachrichtenschlüssel `alternatives_cta_questions` (Alternativen-CTA-Fragen). | HTML-Textfragment aus einer längeren Capgo-UI-Zeichenfolge (Elternschlüssel `appflow_cta_questions`). Seite/Bereich: Appflow-Vergleichs- und Migration-Marketingtext. Rolle: Langen Marketing- oder Rechtsparagraphen. Gesehen in: Seite ionic-appflow.astro. Produkt- und Markenbegriffe von Capgo sowie Entwicklertitel werden genau beibehalten. Nachrichtenschlüssel `appflow_cta_questions` (Appflow-CTA-Fragen). | HTML-Textfragment aus einer längeren Capgo-UI-Zeichenfolge (Elternschlüssel `capwesome_cta_questions`). Seite/Bereich: Capawesome-Vergleichsseite. Rolle: Langen Marketing- oder Rechtsparagraphen. Gesehen in: Seite capwesome.astro. Produkt- und Markenbegriffe von Capgo sowie Entwicklertitel werden genau beibehalten. Nachrichtenschlüssel `capwesome_cta_questions` (Capwesome-CTA-Fragen). | Seite/Bereich: Beratungsdienste-Seite. Rolle: Untertitel oder Slogan. Gesehen in: Seite consulting.astro. Produkt- und Markenbegriffe von Capgo sowie Entwicklertitel werden genau beibehalten. Nachrichtenschlüssel `consulting_faq_subtitle` (Beratungsdienste-Faq-Untertitel). | Seite/Bereich: Appflow-Vergleichs- und Migration-Marketingtext. Rolle: Kurzer UI-Label oder Navigationselement. Gesehen in: Seite ionic-appflow.astro, Seite ionic-enterprise-plugins.astro, Seite solutions/ionic-enterprise-plugins.astro. Nachrichtenschlüssel `appflow_plugins_or` (Appflow-Plugins-oder)

Projekt, um 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 beibehalten.

Capgo Build receives the prepared native project required to compile your app. Your web source code, private dependency installation, and Capacitor sync remain in your CI.

__CAPGO_KEEP_0__ Build erhält das erforderliche native Projekt, um Ihr App zu kompilieren. Ihre Web-Quelle __CAPGO_KEEP_1__, private Abhängigkeitsinstallation und __CAPGO_KEEP_2__-Synchronisation bleiben in Ihrer CI.

Eingeschlossen	Beschreibung
ios/ oder android/	Die native Plattformordner, die Sie erstellen
package.json, package-lock.json	Abhängigkeitsmanifest
capacitor.config.*	Capacitor-Konfiguration
resources/	App-Ikonen, Splash-Screens
Natives Plugin code	Nur die ios/ oder android/ Unterordner jeder Capacitor-Erweiterung

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 hat sie in das native Projekt kopiert. Die Web-Quelle und die Abhängigkeitsinstallationsschritte bleiben in Ihrer 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 Ihrer CI - Lösen Sie private Paketregistrierungen, SSH-basierte CocoaPods, Geräte-SDKs, Erweiterungen und jede benutzerdefinierte native Vorbereitung in Bitrise oder Ihrer bestehenden CI.
2. Bauen Sie Ihre Web-Ressourcen - Ausführen npm run build (oder Ihre Frameworks Build-Befehl).
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 zur nativen Build - Senden Sie das vorbereitete ios/ oder android/ Projekt zu Capgo Build.

Was Capgo Build Handhabt

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

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

Für eine kiosk-freie Version, die über MDM verteilt wird, konfigurieren Sie das Android-Projekt/Bau, um ein APK zu produzieren. Wenn Sie die Build-Anforderung stellen, verwenden Sie beide Flags, um die Google Play-Upload zu umgehen und die signierte Ausgabe abzurufen:

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 die Play-Anmeldeinformationen gespeichert sind; --output-upload bietet eine zeitbegrenzte Verlinkung zur signierten Ausgabe. Verteilen Sie das APK über Ihr MDM.

Nächste Schritte

Nun hast du deine erste Build erstellt:

• iOS-Builds konfigurieren - Zertifikate und Profile einrichten
• Android-Builds konfigurieren - Keystores und Play Store einrichten
• Problembehandlung Kontext: Unterstützung / Premium-Unterstützung oder Fußzeile-Unterstützungsabschnitt. Rolle: Abschnitt oder Seiteüberschrift. Gesehen in: Seite support-policy.astro. Nachrichtenschlüssel `support_policy_troubleshooting_title` (Support Policy Troubleshooting Title).
• CLI Reference __CAPGO_KEEP_0__ Referenz

- Vollständige Befehlsdokumentation

• Überprüfen Sie die Troubleshooting-Anleitung
• Betreten Sie unsere Discord-Gemeinschaft
• Wenden Sie sich an unseren support@capgo.app