Einstieg

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

Wat 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
• A Capgo-Konto (ein kostenloses Probeabo reicht aus, um loszulegen)
• Deine App ist bereits in Capgo registriert (führe bunx @capgo/cli@latest app add falls nicht)
• (Keine Vorbereitung von Signaturzertifikaten erforderlich — wir stellen sie im nächsten Schritt ein.)

Konfiguriere deine Signaturzertifikate

Capgo benötigt Signaturzertifikate, um deine App zu erstellen und zu übermitteln — aber du musst sie nicht selbst handhaben. Beantworte ein paar Fragen und wir zeigen dir den genauen Befehl, den du ausführen musst:

Führe deinen ersten Build aus

Du musst mit Capgo angemeldet sein, um zu bauen. Wenn du das noch nicht getan hast:

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

If Sie gerade erstellt haben build init, sind Sie bereits fertig — die Einrichtung bietet Ihnen an, einen Build für Sie zu starten, sodass Ihr erster Build bereits auf dem Weg ist. 🎉

Ansonsten starten Sie einen Build selbst mit build request — setzen Sie --platform auf das, was Sie bauen:

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

Der 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. Vorbereitung auf die Lokalisierung - Ihr Projekt wird komprimiert (ausgenommen node_modules und Versteckdateien)
2. Hochladen - Die Komprimierung wird in einem sicheren Cloudspeicher hochgeladen (Cloudflare R2)
3. Erstellung der Anwendung - Ihre App wird auf dedizierter Infrastruktur erstellt
4. Protokollierung in Echtzeit - Protokolle werden in Echtzeit an Ihr Terminal über Server-Sent Events gesendet
5. Automatische Löschung - Build-Artikel werden gelöscht (Android: sofort, iOS: 24 Stunden)

Was wird erstellt?

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

Inkludiert

oder	Der native Plattformordner, den Sie erstellen
ios/ Abhängigkeitsmanifest android/	__CAPGO_KEEP_0__ Konfiguration
package.json, package-lock.json	Was wird gebaut
capacitor.config.*	Capacitor configuration
resources/	App Icons, Splash Screens
Nativespezifischer Plugin code	Nur der ios/ oder android/ Unterordner jedes Capacitor-Plugins

Was NICHT hochgeladen wird

Ausgeschlossen	Warum
node_modules/ (die meisten davon)	Nur natives Plugin code wird eingeschlossen, nicht JS-Abhängigkeiten
src/	Ihr Web-Quellcode code bleibt lokal
dist/, www/, build/ (root level)	Bereits synchronisiert in das native Verzeichnis über cap sync
.git/	Versionierungsgeschichte
.gradle/, .idea/, .swiftpm/	Build-Caches und IDE-Einstellungen
.env, Geheimnisse	Nie hochgeladen

Hinweis

Ihre gebauten Web-Assets (JS, CSS, HTML) sind hochgeladen - aber als Teil des native Verzeichnisses. Wenn Sie bunx cap synclaufen, wird Ihr Web-Build in das native Verzeichnis kopiert ios/App/App/public/ oder android/app/src/main/assets/public/. Das ist der Grund, warum die Ausführung cap sync vor der Erstellung erforderlich ist.

Deine Verantwortlichkeiten

Bevor du ausführst bunx @capgo/cli@latest build:

1. Baue deine Web-Assets - Ausführe bun run build (oder den Build-Befehl deiner Frameworks)
2. Übertrage in die native - Ausführe bunx cap sync um Web-Assets in das native Projekt zu kopieren
3. Abhängigkeiten festlegen - Stellen Sie sicher, dass alle native Plugins vorhanden sind package.json

Wie Capgo Build-Handling funktioniert

• Native iOS-Kompilierung (Xcode, Fastlane)
• Native Android-Kompilierung (Gradle)
• Code-Signierung mit Ihren Anmeldeinformationen
• App-Store-Bereitstellung (falls konfiguriert)

Zukünftige Schritte

Sie haben nun Ihre erste Build erstellt:

• 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 Befehlsdokumentation

Hilfe benötigen?

• Überprüfen Sie das Fehlersuchehandbuch
• Treten Sie unserem Team bei Discord Community
• E-Mail Support bei support@capgo.app