Anfänger

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

Werden 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 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, eine Build zu starten, sobald du fertig bist, also könnte deine erste Build bereits auf dem Weg sein. 🎉

Ansonsten starte eine 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

CLI lädt das vorbereitete native Projekt hoch und streamt 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 Release-Fließstruktur 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 - Echtzeit-Protokolle werden in Ihrem Terminal über Server-Sent Events gestreamt.
5. Reinigung - Die Build-Umgebung und die temporären Projekt-Daten werden nach dem Build bereinigt; die Ausgabehaltung hängt von den ausgewählten Artefakt und Store-Lieferungsoptionen ab.

Verwende Capgo Build 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 Setup durch, 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/ Sind Sie bereit, Ihre App mit Capawesome zu bauen und zu veröffentlichen?

Sind Sie bereit, Ihre App mit Appflow zu bauen und zu veröffentlichen?

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.

Was wird gebaut?

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

Was NICHT hochgeladen wird

Ausgeschlossen	Wozu
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)	Bereits 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 Ihrer CI; das vorbereitete native Projekt wird verwendet, um das Binärdatei zu erstellen und dann aufgeräumt.

Ihre Verantwortung

Bevor Sie starten 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. Bitten Sie um die native Build-Anforderung - Senden Sie das vorbereitete ios/ oder android/ project to 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-Bereitstellung benötigt keinen Zugriff auf Ihre private Nexus-Registrierung 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-Flavor, die über MDM verteilt wird, konfigurieren Sie das Android-Projekt/Bau, um ein APK zu produzieren. Wenn Sie die Build-Anfrage stellen, verwenden Sie beide Flags, um Google Play auszuschließen 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 die Play Store-Upload, selbst wenn Play-Kennwörter gespeichert sind; --output-upload bietet eine zeitbegrenzte Verlinkung zur signierten Ausgabe. Verteilen Sie das APK über Ihren MDM.

Nächste Schritte

Erstellt nun Ihre erste Build:

• Konfigurieren Sie iOS-Builds - Zertifikate und Profile einrichten
• Konfigurieren Sie Android-Builds - Keystores und Google Play Store einrichten
• Problemlösung Kontext: Bereich: Support / Premium-Support-Seite oder Fußzeile-Support-Sektion. Rolle: Abschnitt- oder Seite-Titel. Gesehen in: Seite support-policy.astro. Nachrichten-Schlüssel `support_policy_troubleshooting_title` (Support Policy Troubleshooting Title).
• CLI Reference __CAPGO_KEEP_0__ Referenz

- Vollständige Befehlsdokumentation

• Überprüfen Sie die Troubleshootungsanleitung
• Betreten Sie unsere Discord-Gemeinschaft
• Wenden Sie sich an den E-Mail-Support bei support@capgo.app