Einstieg

Mit Capgo Cloud Build beginnen und Ihre erste native iOS- oder Android-Anwendung in Minuten 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
• Eine Capgo-Konto (ein kostenloses Probeabo reicht aus, um loszulegen)
• Ihre App ist bereits in Capgo registriert (führen Sie bunx @capgo/cli@latest app add wenn nicht)
• (Keine Vorbereitung von Signaturzertifikaten erforderlich — wir stellen sie im nächsten Schritt ein.)

Konfigurieren Sie Ihre Signaturzertifikate

Capgo benötigt Signaturzertifikate, um Ihre App zu erstellen 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 Ihren ersten Build aus

Sie müssen mit Capgo authentifiziert 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 erst geführt haben build initSie sind bereits eingerichtet — die Einrichtung bietet Ihnen an, einen Build für Sie zu starten, sodass Ihr erster Build bereits auf dem Weg sein könnte. 🎉

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

Das 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 Hochladen
2. - Die Zip-Datei wird in sicheren Cloud-Speicher hochgeladen (__CAPGO_KEEP_0__ R2) - The zip is uploaded to secure cloud storage (Cloudflare R2)
3. - Ihr App baut auf dedizierter Infrastruktur Protokollierung in Echtzeit
4. - Echtzeit-Protokolle streamen in Ihr Terminal via Server-Sent Events Automatische Löschung
5. - Build-Artikel werden gelöscht (Android: sofort, iOS: 24 Stunden) Was wird gebaut

Section titled “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.

Abschnitt: Was wird hochgeladen

Beschreibung	oder
ios/ Der native Plattformordner, den Sie erstellen android/	Abhängigkeitsmanifest
package.json, package-lock.json	__CAPGO_KEEP_0__ Konfiguration
capacitor.config.*	Capacitor configuration
resources/	Build only uploads the minimum files needed to compile your native app. Your full source __CAPGO_KEEP_0__ never leaves your machine. What Gets Uploaded Section titled “What Gets Uploaded” Included Description or The native platform folder you’re building Dependency manifest __CAPGO_KEEP_0__ configuration App icons, splash screens
Nativescript-Plugin code	Nur der ios/ oder android/ Unterverzeichnis jedes Nativescript-Plugin Capacitor

Was NICHT hochgeladen wird

Ausgeschlossen	Warum
node_modules/ (meistens)	Nur natives Nativescript-Plugin code wird eingeschlossen, nicht JS-Abhängigkeiten
src/	Ihr Web-Quellcode code bleibt lokal
dist/, www/, build/ (Ebenbenebene)	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-Assets (JS, CSS, HTML) sind hochgeladen - aber als Teil des native Verzeichnisses. Wenn Sie bunx cap synclaufen ios/App/App/public/ wird, wird Ihr Web-Build in android/app/src/main/assets/public/. Das ist der Grund, warum eine Ausführung cap sync vor dem Bauen erforderlich ist.

Ihre Verantwortlichkeiten

Bevor Sie ausführen 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-Abhängigkeiten - Stellen Sie sicher, dass alle native Plugins vorhanden sind package.json

Was Capgo Build Handhabt

• Natives iOS-Kompilieren (Xcode, Fastlane)
• Natives Android-Kompilieren (Gradle)
• Code Signieren mit Ihren Zugangsdaten
• App-Store-Submission (wenn konfiguriert)

Nächste Schritte

Jetzt, dass Sie Ihren ersten Build erstellt haben:

• iOS-Builds konfigurieren - Zertifikate und Profile einrichten
• Android-Builds einrichten - Zertifikate und Google Play Store einrichten
• Fehlerbehebung - Häufige Probleme und Lösungen
• CLI Referenz - Vollständige Befehlsdokumentation

Hilfe benötigt?

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