Anfangen

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

Was Sie benötigen

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

• Eine Capacitor-Anwendung, die lokal erfolgreich kompiliert wird
• 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 "if not" aus, wenn nicht) bunx @capgo/cli@latest app add Keine Vorbereitung von Signierungszertifikaten erforderlich – wir stellen sie in der nächsten Schritt ein.
• Get started with __CAPGO_KEEP_0__ Cloud Build and create your first iOS or Android native build in minutes.

Ihre Signierkennungen konfigurieren

Capgo benötigt Signierkennungen, um Ihre App 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:

Erstellen Sie Ihre erste Build

Sie müssen bei Capgo angemeldet sein, um zu bauen. Wenn Sie das noch nicht getan haben:

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

Wenn Sie gerade build inithaben, sind Sie bereits fertig — die Einrichtung bietet Ihnen an, einen Build zu starten, wenn Sie fertig sind, also kann Ihre erste Build bereits auf dem Weg sein. 🎉

Ansonsten starten Sie einen Build selbst mit build request — set --platform wofür Sie auch bauen:

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

Die CLI lädt Ihr Projekt hoch, streamt die Build-Protokolle live in Ihrem Terminal und — sobald Ihre Anmeldeinformationen konfiguriert sind — sendet das Ergebnis automatisch an den Store.

Der Build-Prozess verstehen

Wenn Sie den Build-Befehl ausführen, passiert Folgendes:

flowchart LR
    A[Your Machine] -->|1. Zip Project| B[Local Temp]
    B -->|2. Upload| C[Capgo Cloud]
    C -->|3. Build| D[Mac Mini Silicon M4 Build Server]
    D -->|4. Logs Stream| A
    D -->|5. Cleanup| E[Auto Delete]

1. Lokale Vorbereitung - Ihr Projekt wird komprimiert (außer node_modules und .dotfiles)
2. Hochladen - Der Zip-Datei wird in einem sicheren Cloud-Storage hochgeladen (Cloudflare R2)
3. Build-Ausführung - Ihre App wird auf dedizierter Infrastruktur gebaut
4. Protokollierung - Echtzeit-Protokolle werden über Server-Sent Events in Ihrem Terminal gestreamt
5. Automatische Löschung - Build-Artikel werden gelöscht (Android: sofort, iOS: 24 Stunden)

Was wird gebaut

Capgo Nur die erforderlichen Dateien werden hochgeladen, um Ihre native App zu kompilieren. Ihre vollständige Quellcode __CAPGO_KEEP_0__ bleibt auf Ihrem Rechner. to compile your native app. Your full source code never leaves your machine.

Was wird hochgeladen

Eingeschlossen	Beschreibung
ios/ oder android/	Der native Plattformordner, den Sie bauen
package.json, package-lock.json	Abhängigkeitsmanifest
capacitor.config.*	Capacitor Konfiguration
resources/	App-Ikone, Splash-Screens
Natives Plugin code	Nur das ios/ oder android/ Untergeordneter Ordner jeder Capacitor-Erweiterung

Was NICHT hochgeladen wird

Ausgeschlossen	Weshalb
node_modules/ (die meisten davon)	Erstes native Plugin code wird eingeschlossen, nicht JS-Abhängigkeiten
src/	Ihr Web-Quellcode code bleibt lokal
dist/, www/, build/ (Ebenbene)	Bereits synchronisiert in den nativen Ordner via cap sync
.git/	Versionierungsgeschichte
.gradle/, .idea/, .swiftpm/	Build-Caches und IDE-Einstellungen
.envGeheimnisse	Nie hochgeladen

Hinweis

Ihre gebauten Web-Assets (JS, CSS, HTML) sind gehoben - aber als Teil des nativen Ordners. Wenn Sie bunx cap synclaufen ios/App/App/public/ , wird Ihr Web-Build in android/app/src/main/assets/public/oder cap sync kopiert. Deshalb ist es erforderlich,

vor der Verarbeitung zu laufen.

Bevor Sie starten bunx @capgo/cli@latest build:

1. Bauen Sie Ihre Web-Assets - Ausführen bun run build (oder den Build-Befehl Ihres Frameworks)
2. Synchronisieren Sie mit nativem - Ausführen bunx cap sync um Web-Assets in das native Projekt zu kopieren
3. Commit von Abhängigkeiten - Stellen Sie sicher, dass alle native Plugins in package.json

Was Capgo Build Handhabt

• Native iOS-Kompilierung (Xcode, Fastlane)
• Native Android-Kompilierung (Gradle)
• Code mit Ihren Zugangsdaten signieren
• App-Store-Submission (falls konfiguriert)

Weitere Schritte

Jetzt, dass Sie Ihre erste Build erstellt haben:

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

Brauchen Sie Hilfe?

• Überprüfen Sie die Troubleshooting-Guide
• Beitreten Sie unserer Discord-Gemeinschaft
• E-Mail-Unterstützung bei support@capgo.app