Einstieg

Mit Capgo Cloud Build loslegen 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:

• Ein Capacitor-App, das lokal erfolgreich kompiliert wird
• Node.js 20 oder höher installiert
• Ein Capgo-Konto mit einer aktiven Abonnement
• Ihre App bereits in Capgo registriert (führen Sie "if not" aus) bunx @capgo/cli@latest app add Build-Zertifikate konfiguriert
• Zertifikate, Keystores - siehe unten Bevor Sie das erste Mal bauen

Abschnitt mit dem Titel „Bevor Sie das erste Mal bauen“

⚠️ Setup Credentials First

Erforderlich vor der Erstellung: Sie müssen Ihre Build-Credentials (Zertifikate für iOS, Keystore für Android) konfigurieren.

Setup Credentials →

Schnellstart

1. Setup Build Credentials

   Bevor Sie bauen können, müssen Sie Ihre Credentials lokal speichern:

   Für iOS:

   bunx @capgo/cli@latest build credentials save \
     --platform ios \
     --certificate ./cert.p12 \
     --p12-password "password" \
     --provisioning-profile ./profile.mobileprovision \
     --apple-key ./AuthKey.p8 \
     --apple-key-id "KEY123" \
     --apple-issuer-id "issuer-uuid" \
     --apple-team-id "team-id"

   Für Android:

   bunx @capgo/cli@latest build credentials save \
     --platform android \
     --keystore ./release.keystore \
     --keystore-alias "my-key" \
     --keystore-key-password "key-pass" \
     --keystore-store-password "store-pass"

   Siehe den vollen Anweisungen zum Anmelden für Details.

2. Verifizieren Sie die lokale Anwendung

   Zuerst stellen Sie sicher, dass Ihre App lokal ohne Fehler erstellt wird:

   # Build your web assets
   bun run build
   
   # Sync with Capacitor
   bunx cap sync
   
   # Test local build (optional but recommended)
   bunx cap open ios    # For iOS
   bunx cap open android # For Android

3. Mit Capgo anmelden

   Stellen Sie Ihren Capgo API-Schlüssel (wenn nicht bereits konfiguriert):

   bunx @capgo/cli@latest login

   Oder setzen Sie die Umgebungsvariable:

   export CAPGO_TOKEN=your_api_key_here

4. Mit Ihrem ersten Build beginnen

   Mit einem Android-Debug-Build (schnell zum Testen) beginnen:

   bunx @capgo/cli@latest build com.example.app \
     --platform android \
     --build-mode debug

   Sie sehen die Echtzeit-Protokolle, während Ihr Build fortschreitet:

   ✔ Creating build job...
   ✔ Uploading project (15.2 MB)...
   ✔ Build started
   
   📝 Build logs:
   → Installing dependencies...
   → Running Gradle build...
   → Signing APK...
   ✔ Build succeeded in 3m 42s

5. Bau-Status überprüfen

   Der CLI wird den Bau-Status automatisch abrufen und anzeigen. Sobald der Bau abgeschlossen ist, sehen Sie:

   • Bauzeit
   • Erfolg/Feuerstatus
   • App wurde an App Store/Play Store (wenn Zugangsdaten konfiguriert) eingereicht

Verständnis des Build-Prozesses

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 Komprimierung wird an sicheren Cloud-Speicher (__CAPGO_KEEP_0__ R2) hochgeladen - The zip is uploaded to secure cloud storage (Cloudflare R2)
3. Build Ausführung - Ihre App baut auf dedizierter Infrastruktur
4. Log Streaming - Echtzeit-Logs 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)

Build-Infrastruktur

Die Build-Ausführung läuft auf dedizierten Mac Mini Silicon M4-Maschinen:

• 10-kerniger M4-Prozessor (4 Leistungskerne, 6 Effizienzkernen)
• 10-kerniger GPU
• 16-kerniger Neural Engine
• 16 GB RAM
• macOS Tahoe 26.2

Das Build-Image unterstützt Xcode 26.2, Android Studio 2025 und .NET 9/.NET 10 SDK-Workloads für native Buildpipelines.

Ihr erster Produktionsbuild

Erstelle nachdem du den Prozess überprüft hast, einen Produktionsbuild:

Android

bunx @capgo/cli@latest build com.example.app \
  --platform android \
  --build-mode release

Zu Beginn musst du die Signierungskontakte konfigurieren. Siehe Android Build-Konfiguration.

iOS

bunx @capgo/cli@latest build com.example.app \
  --platform ios \
  --build-mode release

iOS-Builds erfordern Signaturzertifikate und Bereitstellungsprofile. Siehe iOS-Build-Konfiguration.

Was wird gebaut?

Capgo Nur die erforderlichen Dateien werden hochgeladen, um Ihre native App zu kompilieren. Ihr vollständiger Quellcode Capgo bleibt auf Ihrem Rechner. Was wird hochgeladen? code

__CAPGO_KEEP_0__

Eingeschlossen	Beschreibung
ios/ oder android/	Der Ordner der nativen Plattform, den Sie bauen
package.json, package-lock.json	Abhängigkeitsmanifest
capacitor.config.*	Capacitor-Konfiguration
resources/	App-Ikonen, Splash-Screens
Natives Plugin code	Nur der ios/ oder android/ Unterordner jedes Capacitor-Plugins

Was NICHT hochgeladen wird

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/ (Ebenbene)	Bereits synchronisiert in den native Ordner via cap sync
.git/	Versionskontrollhistorie
.gradle/, .idea/, .swiftpm/	Build-Caches und IDE-Einstellungen
.envGeheimnisse	Nie hochgeladen

Hinweis

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

Ihre Verantwortung

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

1. Erstellen Sie Ihre Web-Assets - Ausführen bun run build (oder den Build-Befehl Ihres Frameworks)
2. Synchronisieren Sie mit der nativen Plattform - 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

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

Aufbauzeit & Kosten

Die Aufbauzeit wird vom Start bis zur Vollendung gemessen:

• Android: Typischerweise 3-5 Minuten
• iOS: Typischerweise 5-10 Minuten
• Infrastruktur: Mac Mini Silicon M4-Maschinen mit macOS Tahoe 26.2 laufen

Sie zahlen nur für die tatsächliche Ausführungszeit. Keine versteckten Gebühren.

Gemeinsame Verwendungsfälle

CI/CD-Integration

Auslösen Capgo Build automatisch aus Ihrem GitHub Actions-Workflow — bei Push, bei Tag oder mit einem manuellen Schaltknopf. Siehe die dedizierte GitHub Actions-Anleitung für vollständige Workflowbeispiele, die manuelle Auslöser, tagbasierte Releases und kontinuierliche Debug-Builds abdecken.

Lokale Entwicklung

Testen Sie Builds lokal, bevor Sie sich verpflichten:

# Quick debug build for testing
bun run build && bunx cap sync
bunx @capgo/cli@latest build com.example.app \
  --platform android \
  --build-mode debug

Multiplattform-Builds

Für beide Plattformen bauen Sie, indem Sie zwei Befehle ausführen:

# iOS build
bunx @capgo/cli@latest build com.example.app \
  --platform ios \
  --build-mode release

# Android build
bunx @capgo/cli@latest build com.example.app \
  --platform android \
  --build-mode release

In CI/CD können Sie diese in parallelen Aufgaben für schnellere Builds ausführen.

Weitere Schritte

Nachdem Sie Ihr erstes Build erstellt haben:

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

Hilfe benötigt?

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