Fehlersuche

Lösungen für häufige Probleme bei der Erstellung von nativen Apps mit Capgo Cloud Build.

Build-Fehler

”Upload failed” or “Connection timeout”

Abschnitt mit dem Titel „ , „ oder „Verbindungstimeout““

• Symptome:
• Das Projekt wird während der Veröffentlichung fehlschlagen

Zeitüberschreitung nach 60 Sekunden

1. Lösungen:

   # Test connection to Capgo
   curl -I https://api.capgo.app

2. Auf die Zwischenablage kopieren

   • Projektgröße reduzieren node_modules/ wird nicht hochgeladen (sollte automatisch ausgeschlossen werden)
   • Überprüfen Sie nach großen Dateien in Ihrem Projekt:

   find . -type f -size +10M

3. Überprüfen Sie die Ablaufzeit der Upload-URL

   • Upload-URLs gelten nur eine Stunde
   • Wenn Sie eine abgelaufene URL-Fehlermeldung erhalten, führen Sie den Build-Befehl erneut aus

Große Projekte (>200MB) können Zeitlimits erreichen. Kontaktieren Sie den Support für Enterprise-Optionen

„Build-Timeout nach 10 Minuten“

Abschnitt mit dem Titel „Build-Timeout nach 10 Minuten“

Symptome:

• Der Build überschreitet die maximale erlaubte Zeit
• Der Status zeigt timeout

Lösungen:

1. Abhängigkeiten optimieren

   • Entsorgen Sie nicht benötigte npm-Pakete
   • Verwenden Sie npm prune --production vor dem Bauen

2. Überprüfen Sie Netzwerkprobleme beim Bauen

   • Einige Abhängigkeiten laden während des Baus große Dateien herunter
   • Betrachten Sie eine Vorab-Caching mit einem Lock-File

3. Überprüfen Sie native Abhängigkeiten

   # iOS - check Podfile for heavy dependencies
   cat ios/App/Podfile
   
   # Android - check build.gradle
   cat android/app/build.gradle

4. Kontakt zur Unterstützung

   • Wenn Ihre App tatsächlich mehr Zeit benötigt
   • Wir können die Grenzen für bestimmte Anwendungsfälle anpassen

Authentifizierungsprobleme

”API key invalid” or “Unauthorized”

Abschnitt mit dem Titel „ , Schlüssel __CAPGO_KEEP_0__ ungültig“ oder „Keine Berechtigung““

• Symptome:
• Die Erstellung scheitert sofort an einer Authentifizierungsfehlermeldung und fällt durch die 401 oder 403 Fehler

Lösungen:

1. Überprüfen Sie, dass die API-Schlüssel korrekt ist

   # Test with a simple command
   npx @capgo/cli@latest app list

2. Überprüfen Sie die Berechtigungen für den API-Schlüssel

   • Der Schlüssel muss write oder all Berechtigungen
   • Überprüfen Sie in der Capgo-Oberfläche unter API Schlüsseln

3. Stellen Sie sicher, dass der API-Schlüssel gelesen wird

   # Check environment variable
   echo $CAPGO_TOKEN
   
   # Or verify local .capgo file
   cat .capgo

4. Wiederholte Anmeldung

   npx @capgo/cli@latest login

”App not found” or “No permission for this app”

Sektion mit dem Titel , Keine Anwendung gefunden

• Symptome:

Authentifizierung funktioniert, aber Anwendungsspezifische Fehler

1. Lösungen:

   npx @capgo/cli@latest app list

2. In die Zwischenablage kopieren

   • Überprüfen capacitor.config.json appId
   • Stellen Sie sicher, dass die Befehlszeile den richtigen App-Id verwendet

3. Überprüfen Sie die Zugriffsberechtigung auf die Organisation

   • Stellen Sie sicher, dass Sie sich in der richtigen Organisation befinden
   • API Schlüssel muss Zugriff auf die Organisation der App haben

iOS-Bau-Probleme

„Code Signieren fehlgeschlagen“

Symptome:

• Der Aufbau scheitert während der code-Signierungsphase
• Xcode-Fehler über Zertifikate oder Profile

Lösungen:

1. Überprüfen Sie, ob der Zertifikatstyp der Build-Typ entspricht

   • Entwicklungsbuilds benötigen Entwicklungszertifikate
   • App Store Builds benötigen Verteilungszertifikate

2. Überprüfen Sie, ob Zertifikat und Profil übereinstimmen

   # Decode and inspect your certificate
   echo $BUILD_CERTIFICATE_BASE64 | base64 -d > cert.p12
   openssl pkcs12 -in cert.p12 -nokeys -passin pass:$P12_PASSWORD | openssl x509 -noout -subject

3. Stellen Sie sicher, dass das Provisioning-Profile gültig ist

   • Überprüfen Sie die Ablaufzeit
   • Überprüfen Sie, ob es Ihr App-ID enthält
   • Bestätigen Sie, dass es das Zertifikat enthält

4. Regenerieren Sie die Anmeldeinformationen

   • Löschen Sie das alte Zertifikat/Profil
   • Erstellen Sie neue im Apple Developer Portal
   • Re-encode und aktualisieren Sie die Umgebungsvariablen

„Das Provisioning-Profil enthält kein Signierungszertifikat“

Symptome:

• Xcode kann das Zertifikat im Profil nicht finden

Lösungen:

1. Herunterladen des neuesten Profils von Apple

   • Gehe zu Apple Developer → Zertifikate, IDs und Profile
   • Herunterladen des Provisioning-Profils
   • Stellen Sie sicher, dass es Ihren Zertifikat enthält

2. Überprüfen Sie, ob das Zertifikat im Profil enthalten ist

   # Extract profile
   echo $BUILD_PROVISION_PROFILE_BASE64 | base64 -d > profile.mobileprovision
   
   # View profile contents
   security cms -D -i profile.mobileprovision

3. Rekreation des Profils mit dem richtigen Zertifikat

   • In der Apple-Entwickler-Portal bearbeiten Sie das Profil
   • Stellen Sie sicher, dass Ihr Verteilungs-Zertifikat ausgewählt ist
   • Herunterladen und erneut kodieren

„App Store Connect-Authentifizierung fehlgeschlagen“

Symptome:

• Hochladen auf TestFlight fehlschlägt
• API-Schlüssel-Fehler

Lösungen:

1. Überprüfen Sie die API-Schlüssel-Zertifikate

   • Überprüfen Sie APPLE_KEY_ID (soll 10 Zeichen lang sein)
   • Überprüfen Sie APPLE_ISSUER_ID (soll UUID-Format haben)
   • Überprüfen Sie, ob APPLE_KEY_CONTENT korrekt base64-codiert ist

2. Testen Sie den API-Schlüssel lokal

   # Decode key
   echo $APPLE_KEY_CONTENT | base64 -d > AuthKey.p8
   
   # Test with fastlane (if installed)
   fastlane pilot list

3. Überprüfen Sie die API-Schlüssel-Rechte

   • Der Schlüssel benötigt das 'Entwickler'-Rollen oder höher
   • Überprüfen Sie in App Store Connect → Benutzer und Zugriff → Schlüssel

4. Stelle sicher, dass die Schlüssel nicht zurückgezogen wurden

   • Überprüfe in App Store Connect
   • Erstelle einen neuen Schlüssel, wenn erforderlich

”Pod install failed”

Symptome:

• Die Verarbeitung scheitert während der CocoaPods-Installation
• Podfile-Fehler

Lösungen:

1. Überprüfe, ob Podfile.lock im Repository committet wurde

   git status ios/App/Podfile.lock

2. Test lokale pod installieren

   cd ios/App
   pod install

3. Nach inkompatiblen Pods suchen

   • Überprüfe Podfile auf Versionskonflikte
   • Stelle sicher, dass alle Pods Ihr iOS-Zielsystem unterstützen

4. Pod-Cache löschen

   cd ios/App
   rm -rf Pods
   rm Podfile.lock
   pod install
   # Then commit new Podfile.lock

Android-Bau-Probleme

”Keystore password incorrect”

Symptome:

• Das Build-Prozess scheitert während des Signierens
• Gradle-Fehler über das Keystore

Lösungen:

1. Überprüfen Sie das Keystore-Passwort

   # Test keystore locally
   keytool -list -keystore my-release-key.keystore
   # Enter password when prompted

2. Überprüfen Sie die Umgebungsvariablen

   # Ensure no extra spaces or special characters
   echo "$KEYSTORE_STORE_PASSWORD" | cat -A
   echo "$KEYSTORE_KEY_PASSWORD" | cat -A

3. Überprüfen Sie die Base64-Codierung

   # Decode and test
   echo $ANDROID_KEYSTORE_FILE | base64 -d > test.keystore
   keytool -list -keystore test.keystore

”Key alias not found”

Abschnitt mit dem Titel „Keyschlüsselalias nicht gefunden“

• Symptome:

Signieren fehlschlägt mit Aliasfehler

1. Lösungen:

   keytool -list -keystore my-release-key.keystore

2. Auf die Zwischenablage kopieren

   • Überprüfe, ob der Alias genau übereinstimmt. Alias ist case-sensitive
   • Überprüfen Sie die Tippfehler in KEYSTORE_KEY_ALIAS

3. Verwenden Sie den richtigen Alias aus dem Keystore

   # Update environment variable to match
   export KEYSTORE_KEY_ALIAS="the-exact-alias-name"

”Gradle build failed”

Symptome:

• Allgemeine Gradle-Fehler
• Kompilations- oder Abhängigkeitsprobleme

Lösungen:

1. Testen Sie den Build lokal zuerst

   cd android
   ./gradlew clean
   ./gradlew assembleRelease

2. Überprüfen Sie auf fehlende Abhängigkeiten

   • Bauen Sie build.gradle-Dateien überprüfen
   • Stellen Sie sicher, dass alle Plugins in den Abhängigkeiten aufgeführt sind

3. Überprüfen Sie die Kompatibilität der Gradle-Version

   # Check gradle version
   cat android/gradle/wrapper/gradle-wrapper.properties

4. Gradle-Cache löschen

   cd android
   ./gradlew clean
   rm -rf .gradle build

Fehler beim Hochladen in die Play Store

Symptome:

• Der Build gelingt, aber die Upload-Fehlern treten auf
• Fehler bei Dienstkonten

Lösungen:

1. Überprüfen Sie die JSON-Datei der Dienstkonten

   # Decode and check format
   echo $PLAY_CONFIG_JSON | base64 -d | jq .

2. Überprüfen Sie die Berechtigungen der Dienstkonten

   • Zum Play Console → Setup → API Zugriff gehen
   • Stellen Sie sicher, dass die Dienstkonten Zugriff auf Ihre App haben
   • Die Berechtigung „Release to testing tracks“ erteilen

3. Überprüfen Sie, ob die App im Play Console eingerichtet ist

   • Zuerst muss die App im Google Play Console erstellt werden
   • Zumindest ein APK muss manuell zuerst hochgeladen werden

4. Überprüfen Sie, ob API aktiviert ist

   • Google Play Developer API muss aktiviert sein
   • Überprüfen Sie im Google Cloud Console

Allgemeine Probleme

”Job not found” or “Build status unavailable”

Stand der Aufbau nicht verfügbar

• Symptome:
• Der Aufbau kann nicht überprüft werden

Lösungen:

1. Warten Sie einen Moment und versuchen Sie es erneut

   • Die Ausführung von Build-Jobs kann einige Sekunden dauern

2. Überprüfen Sie, ob die Job-ID korrekt ist

   • Überprüfen Sie die Job-ID aus der Antwort der ersten Build-Ausführung

3. Überprüfen Sie, ob die Build-Ausführung abgelaufen ist

   • Die Build-Daten sind 24 Stunden verfügbar

”Project sync failed”

Symptome:

• Der Build scheitert, bevor die Kompilierung beginnt
• Fehlende Dateien-Fehler

Lösungen:

1. Führe Capacitor lokal synchron aus

   npx cap sync

2. Stelle sicher, dass alle native Dateien committet sind

   git status ios/ android/

3. Überprüfe ignorierte native Dateien

   • Überprüfe .gitignore
   • Stelle sicher, dass wichtige Konfigurationsdateien nicht ignoriert werden

„Der Build war erfolgreich, aber ich sehe keine Ausgabe“

Symptome:

• Das Build zeigt Erfolg, aber kein Downloadlink

Lösungen:

1. Überprüfe die Build-Konfiguration

   • Die Artefakt-Speicherung mag nicht konfiguriert sein
   • Kontaktiere den Support, wenn der Zugriff auf Artefakte für dein Build nicht verfügbar ist

2. Für die iOS-Testflug-Submission

   • Überprüfe App Store Connect
   • Die Verarbeitung kann nach dem Hochladen 5-30 Minuten dauern

3. Für die Android-Play-Store-Submission

   • Überprüfe Play Console → Testing → Internal testing
   • Die Verarbeitung kann einige Minuten dauern

CI/CD-Spezifische Probleme

GitHub Aktionen: „Befehl nicht gefunden“

Symptome:

• npx @capgo/cli fehlschlägt in CI

Lösungen:

1. Stellen Sie sicher, dass Node.js installiert ist

   - uses: actions/setup-node@v6
     with:
       node-version: '24'

2. Installieren Sie CLI explizit

   - run: npm install -g @capgo/cli

GitHub Aktionen: „Geheime Daten nicht gefunden“

Symptome:

• Umgebungsvariablen sind in der Build leer

Lösungen:

1. Überprüfen Sie, ob die Geheimnisse gesetzt sind

   • Gehe zu Repo-Einstellungen → Geheime Daten und Variablen → Aktionen
   • Fügen Sie alle erforderlichen Geheimnisse hinzu

2. Verwenden Sie die richtige Syntax

   env:
     CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}

3. Überprüfen Sie, ob die Geheimnisnamen übereinstimmen

   • Die Namen sind case-sensitive
   • Keine Tippfehler in den Geheimnisbezügen

Mehr Unterstützung erhalten

Ausführliche Protokollierung aktivieren

# Add debug flag (when available)
npx @capgo/cli@latest build com.example.app --verbose

Baumusterinformationen sammeln

Bei der Kontaktaufnahme mit dem Support sollten Sie Folgendes mitteilen:

1. Verwendeter Build-Befehl

   npx @capgo/cli@latest build com.example.app --platform ios

2. Fehlermeldung (voller Ausgabe)

3. Auftrags-ID (aus Ausgabemeldung)

4. Baumeldungen (Kopieren Sie die vollständige Terminalausgabe)

5. Umgebungsinformationen

   node --version
   npm --version
   npx @capgo/cli --version

Kontakt zu Support

• Discord: Beteiligen Sie sich an unserer Community
• E-Mail: support@capgo.app
• Dokumentation: Capgo Dokumentationen

Bekannte Einschränkungen

Aktuelle Einschränkungen:

• Maximale Aufbauzeit: 10 Minuten
• Maximale Uploadgröße: ~500 MB
• iOS-Builds erfordern 24-Stunden-Mac-Mietverträge, führen Sie den Aufbau auf einem Mac durch, um sicherzustellen, dass die Nutzung optimal ist
• Die Verfügbarkeit von Build-Artefakten zum Herunterladen hängt von der Zielkonfiguration des Aufbaus und der Konfiguration der Artefakt-Speicherung ab

Diese Einschränkungen können auf der Grundlage von Feedback angepasst werden.

Zusätzliche Ressourcen

• Einstieg - Anleitung für die Initialisierung
• iOS-Builds - iOS-spezifische Konfiguration
• Android-Builds - Android-spezifische Konfiguration
• CLI Referenz - Vollständige Dokumentation der Befehle