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 Signierungszertifikaten erforderlich – wir stellen sie in der nächsten Schritt ein.

Konfigurieren Sie Ihre Signierungszertifikate

Capgo benötigt Signierungszertifikate, 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 initbist, bist du bereits fertig — die Einrichtung bietet dir an, einen Build für dich zu starten, wenn du fertig bist, also könnte dein erster Build bereits auf dem Weg sein. 🎉

Ansonsten starte einen Build selbst mit build request – set --platform zu dem, was du bauen möchtest:

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

CLI lädt das vorbereitete native Projekt hoch und streamt die Build-Protokolle live in deinem Terminal. Capgo Build kann ein signiertes 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 - 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. Protokollierung in Echtzeit - Echtzeit-Protokolle werden in Ihrem Terminal über Server-Sent Events gestreamt.
5. Reinigung - Die Buildumgebung und die temporären Projektdateien werden nach dem Build bereinigt; die Ausgabehaltung hängt von den ausgewählten Artefakt und -Liefersystemoptionen 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 Einstellung durch, bauen Sie die Weblayer 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 einem längeren Capgo-UI-String (Elternschlüssel `alternatives_cta_questions`). Seite/Bereich: Capacitor-Lebendaktualisierungs-Vergleichsseite. Rolle: Langwierige Marketing- oder Rechtsparagraphen. Gesehen in: Seite alternatives.astro. Produkt/Marken- und Entwicklertrems erhalten genau. Nachrichtenschlüssel `alternatives_cta_questions` (Alternativen-CTA-Fragen). | HTML-Textfragment aus einem längeren Capgo-UI-String (Elternschlüssel `appflow_cta_questions`). Seite/Bereich: Appflow-Vergleichs-/Migration-Marketingtext. Rolle: Langwierige Marketing- oder Rechtsparagraphen. Gesehen in: Seite ionic-appflow.astro. Produkt/Marken- und Entwicklertrems erhalten genau. Nachrichtenschlüssel `appflow_cta_questions` (Appflow-CTA-Fragen). | HTML-Textfragment aus einem längeren Capgo-UI-String (Elternschlüssel `capwesome_cta_questions`). Seite/Bereich: Capawesome-Vergleichsseite. Rolle: Langwierige Marketing- oder Rechtsparagraphen. Gesehen in: Seite capwesome.astro. Produkt/Marken- und Entwicklertrems erhalten genau. Nachrichtenschlüssel `capwesome_cta_questions` (Capwesome-CTA-Fragen). | Seite/Bereich: Consulting-Dienstleistungsseite. Rolle: Untertitel oder Slogan. Gesehen in: Seite consulting.astro. Produkt/Marken- und Entwicklertrems erhalten genau. Nachrichtenschlüssel `consulting_faq_subtitle` (Consulting-Faq-Untertitel). | Seite/Bereich: Appflow-Vergleichs-/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 Webassets befinden sich bereits in dem vorbereiteten native Projekt; sie werden für den Build verwendet und nicht als Quellrepository aufbewahrt.

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 Ihre App zu kompilieren. Ihr Web-Quellcode __CAPGO_KEEP_1__, Ihre private Abhängigkeitsinstallation und __CAPGO_KEEP_2__ bleiben in Ihrem CI erhalten.

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

Was wird NICHT hochgeladen

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/ (auf Ebene der Wurzel)	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ängigkeitsinstallation bleiben in Ihrem CI; das vorbereitete native Projekt wird verwendet, um das Binärdatei zu erstellen und dann aufgeräumt.

Ihre Verantwortlichkeiten

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

1. Vorbereiten in Ihrem CI - Lösen Sie private Paket-Registrierungen, SSH-basierte CocoaPods, Geräte-SDKs, Erweiterungen und jede benutzerdefinierte native Vorbereitung in Bitrise oder Ihrem 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. Bitten Sie um die native Build-Anfrage - Senden Sie das vorbereitete ios/ oder android/ Projekt zum Capgo Build.

Was Capgo Build Handhabt

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

Capgo Die Build-Anforderung benötigt keinen Zugriff auf Ihre private Nexus-Registrierung oder SSH-Anmeldeinformationen, 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/Bau, um ein APK zu produzieren. Wenn Sie die Build-Anforderung stellen, verwenden Sie beide Flags, um die Google Play-Einreichung 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 auf dem Play Store, selbst wenn die Play-Anmeldeinformationen gespeichert sind; --output-upload bietet eine zeitbegrenzte Verlinkung zum signierten Ergebnis. Verteilen Sie das APK über Ihr MDM.

Nächste Schritte

Erstellt nun Ihre erste Build:

• iOS-Builds konfigurieren - Zertifikate und Profile einrichten
• Android-Builds konfigurieren - Keystores und Google Play Store einrichten
• Fehlersuche context: Seite/ Bereich: Support / Premium-Support-Seite oder Fußzeile-Support-Sektion. 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 Fehlersuche
• Beitreten Sie unserer Discord-Gemeinschaft
• Kontaktieren Sie das support@capgo.app