Mengatasi Masalah

Solusi masalah umum ketika membuat aplikasi native dengan Capgo Cloud Build.

Kegagalan Bangun

”Upload failed” or “Connection timeout”

Gejala:

• Proyek gagal saat mengunggah
• Kesalahan waktu out setelah 60 detik

Solusi:

1. Periksa koneksi internet Anda

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

2. Kurangi ukuran proyek

   • Pastikan node_modules/ tidak sedang diunggah (seharusnya dikecualikan secara otomatis)
   • Periksa file besar di proyek Anda:

   find . -type f -size +10M

3. Periksa kadaluarsa URL unggah

   • URL unggah kadaluarsa setelah 1 jam
   • Jika Anda mendapatkan kesalahan URL yang telah kadaluarsa, jalankan kembali perintah pembangunan

Tips

Proyek besar (>200MB) mungkin mengalami batasan waktu. Hubungi dukungan untuk opsi perusahaan.

”Build timeout after 10 minutes”

Symptoms:

• Gejala:
• Pembangunan melebihi waktu maksimum yang diizinkan timeout

Status menampilkan

1. Solusi:

   • Remove unused npm packages
   • Gunakan npm prune --production __CAPGO_KEEP_0__ sebelum membangun

2. Periksa masalah jaringan selama pembangunan

   • Beberapa dependensi mungkin mengunduh file besar selama pembangunan
   • Pertimbangkan untuk mempercepat dengan menggunakan file lock

3. Ulas dependensi native

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

4. Hubungi dukungan

   • Jika aplikasi Anda memang memerlukan waktu lebih lama
   • Kami dapat menyesuaikan batasan untuk kasus penggunaan tertentu

Masalah Autentikasi

API key tidak valid

Gejala:

• Pembangunan gagal segera dengan kesalahan autentikasi
• Kode 401 atau 403

Solusi:

1. Pastikan API key benar

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

2. Periksa izin API key

   • Kunci harus memiliki write atau all izin
   • Periksa di Capgo dashboard di bawah API Kunci

3. Pastikan kunci API sedang dibaca

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

4. Re-autentikasi

   npx @capgo/cli@latest login

Aplikasi tidak ditemukan

Gejala:

• Autentikasi berfungsi tetapi kesalahan aplikasi spesifik

Solusi:

1. Pastikan aplikasi terdaftar

   npx @capgo/cli@latest app list

2. Periksa ID aplikasi sesuai

   • Pastikan capacitor.config.json appId
   • Pastikan perintah menggunakan ID aplikasi yang benar

3. Pastikan akses organisasi

   • Periksa apakah Anda berada di organisasi yang benar
   • API harus memiliki akses ke organisasi aplikasi

Masalah Pembangunan iOS

”Code signing gagal”

Gejala:

• Pembangunan gagal selama fase code signing
• Xcode mengeluarkan kesalahan tentang sertifikat atau profil

Solusi:

1. Periksa jenis sertifikat sesuai dengan jenis pembangunan

   • Pembangunan pengembangan memerlukan sertifikat pengembangan
   • Pembangunan App Store memerlukan sertifikat distribusi

2. Periksa sertifikat dan profil sesuai

   # 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. Pastikan profil penyediaan valid

   • Periksa tanggal kadaluarsa
   • Pastikan termasuk ID Aplikasi Anda
   • Konfirmasikan termasuk sertifikat

4. Regenerasi kunci akses

   • Hapus sertifikat/ profil lama
   • Buat yang baru di portal Pengembang Apple
   • Re-encode dan update variabel lingkungan

”Profil penyediaan tidak termasuk sertifikat tanda tangan”

Gejala:

• Xcode tidak dapat menemukan sertifikat di profil

Solusi:

1. Unduh profil terbaru dari Apple

   • Pergi ke Portal Pengembang Apple → Sertifikat, ID, dan Profil
   • Unduh profil pengembangan
   • Pastikan termasuk sertifikat Anda

2. Verifikasi sertifikat ada di profil

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

3. Buat profil ulang dengan sertifikat yang benar

   • Di portal pengembang Apple, edit profil
   • Pastikan sertifikat distribusi Anda telah dipilih
   • Unduh dan re-encode

”Gagal autentikasi App Store Connect”

Gejala:

• Upload ke TestFlight gagal
• Error API key

Pengaturan:

1. Verifikasi kunci API

   • Periksa APPLE_KEY_ID (harus 10 karakter)
   • Periksa APPLE_ISSUER_ID (dalam format UUID)
   • Verifikasi bahwa APPLE_KEY_CONTENT telah dikodekan base64 dengan benar

2. Test API key secara lokal

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

3. Periksa hak akses API key

   • Kunci memerlukan peran “Developer” atau lebih tinggi
   • Verifikasi di App Store Connect → Pengguna dan Akses → Kunci

4. Pastikan kunci tidak dicabut

   • Periksa di App Store Connect
   • Buat kunci baru jika diperlukan

”Gagal melakukan pod install”

Gejala:

• Pemasangan CocoaPods gagal saat build
• Error Podfile

Solusi:

1. Pastikan Podfile.lock telah dikomit

   git status ios/App/Podfile.lock

2. Tes pemasangan pod secara lokal

   cd ios/App
   pod install

3. Periksa pod yang tidak kompatibel

   • Ulangi Podfile untuk konflik versi
   • Pastikan semua pod mendukung target pengembangan iOS Anda

4. Hapus cache pod

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

Masalah Pembangunan Android

”Keystore password incorrect”

Judul Bagian “Salah Kata Sandi Keystore”

• Gejala:
• Pembangunan gagal selama proses penandatanganan

Kesalahan Gradle tentang keystore

1. Solusi: 1. Periksa kata sandi keystore

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

2. Periksa variabel lingkungan

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

3. Verifikasi pengkodean base64

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

”Key alias not found”

Gejala:

• Tanda tangan gagal dengan kesalahan alias

Solusi:

1. Daftar alias keystore

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

2. Pastikan alias sesuai dengan yang diharapkan

   • Alias sangat sensitif terhadap huruf besar dan kecil
   • Periksa kesalahan ketik pada KEYSTORE_KEY_ALIAS

3. Gunakan alias yang benar dari keystore

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

”Gagal membangun Gradle”

Gejala:

• Error Gradle umum
• Masalah kompilasi atau dependensi

Solusi:

1. Tes bangun secara lokal terlebih dahulu

   cd android
   ./gradlew clean
   ./gradlew assembleRelease

2. Periksa dependensi yang hilang

   • Ulangi file build.gradle
   • Pastikan semua plugin terdaftar di dependensi

3. Verifikasi kompatibilitas versi Gradle

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

4. Hapus cache Gradle

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

”Play Store upload failed”

Gejala:

• Pembangunan berhasil tetapi upload gagal
• Masalah akun layanan

Solusi:

1. Periksa JSON akun layanan

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

2. Periksa izin akun layanan

   • Pergi ke Console Play → Setup → API Akses
   • Pastikan akun layanan memiliki akses ke aplikasi Anda
   • Berikan izin “Rilis ke jalur uji coba”

3. Verifikasi aplikasi telah terkonfigurasi di Console Play

   • Aplikasi harus dibuat terlebih dahulu di Console Play
   • Setidaknya satu APK harus diunggah secara manual awalnya

4. Periksa API telah diaktifkan

   • Google Play Developer API harus diaktifkan
   • Periksa di Console Cloud Google

Masalah Umum

Tidak Ditemukan Pekerjaan

Gejala:

• Tidak Mungkin Memeriksa Status Bangun
• Masalah ID Pekerjaan

Solusi:

1. Tunggu sebentar dan coba lagi

   • Pekerjaan bangun mungkin membutuhkan beberapa detik untuk diinisialisasi

2. Periksa apakah ID pekerjaan sudah benar

   • Periksa ID pekerjaan dari respons awal bangun

3. Periksa apakah bangun sudah kadaluarsa

   • Data pembangunan tersedia selama 24 jam

”Project sync failed”

Gejala:

• Pembangunan gagal sebelum proses kompilasi dimulai
• Masalah file yang hilang

Solusi:

1. Jalankan Capacitor sinkronisasi secara lokal

   npx cap sync

2. Pastikan semua file native telah di-commits

   git status ios/ android/

3. Periksa file native yang diignore oleh Git

   • Tinjau .gitignore
   • Pastikan file konfigurasi penting tidak diignore

”Build succeeded but I don’t see output”

Gejala:

• Pembangunan menunjukkan kesuksesan tapi tidak ada tautan download

Solusi:

1. Periksa konfigurasi pembangunan

   • Penyimpanan artefak mungkin tidak dikonfigurasi
   • Hubungi dukungan jika akses artefak tidak tersedia untuk pembangunan Anda

2. Untuk Pengiriman Uji Coba iOS

   • Periksa App Store Connect
   • Proses dapat memakan waktu 5-30 menit setelah unggah

3. Untuk Toko Aplikasi Android

   • Periksa Play Console → Testing → Pengujian Internal
   • Proses dapat memakan waktu beberapa menit

Isu-isu Khusus CI/CD

GitHub Aksi: “Komando tidak ditemukan”

Gejala:

• npx @capgo/cli gagal di CI

Solutions:

1. Pastikan Node.js telah terinstal

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

2. Pasang CLI secara eksplisit

   - run: npm install -g @capgo/cli

GitHub Aksi: “Rahasia tidak ditemukan”

Gejala:

• Variabel lingkungan kosong dalam pembangunan

Solutions:

1. Verifikasi rahasia telah diset

   • Lihat pengaturan repo → Rahasia dan variabel → Aksi
   • Tambahkan semua rahasia yang diperlukan

2. Gunakan sintaks yang benar

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

3. Periksa nama rahasia sesuai

   • Nama sangat sensitif terhadap huruf besar/kapital
   • Tidak ada kesalahan ketik dalam referensi rahasia

Mendapatkan Bantuan Lebih Lanjut

Aktifkan Pemantauan Verbalis

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

Mengumpulkan Informasi Pembangunan

Ketika menghubungi dukungan, termasuk:

1. Perintah pembangunan yang digunakan

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

2. Pesan kesalahan (seluruh output)

3. ID Tugas (dari output pembangunan)

4. Log pembangunan (salin seluruh output terminal)

5. Informasi Lingkungan

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

Hubungi Dukungan

• Discord: Bergabunglah dengan Komunitas
• Email: support@capgo.app
• Dokumentasi: Capgo Dokumen

Keterbatasan yang Dikenal

Keterbatasan saat ini:

• Waktu pembangunan maksimum: 10 menit
• Ukuran unggahan maksimum: ~500MB
• Pembangunan iOS memerlukan sewa Mac selama 24 jam, pembangunan pada Mac akan diantrekan untuk memastikan penggunaan optimal
• Ketersediaan download artefak pembangunan bergantung pada tujuan pembangunan dan konfigurasi penyimpanan artefak

Keterbatasan-keterbatasan ini mungkin disesuaikan berdasarkan umpan balik

Sumber Daya Tambahan

• Mulai - Panduan pengaturan awal
• Pembangunan iOS - Pengaturan spesifik iOS
• Membangun Android - Pengaturan spesifik Android
• CLI Referensi - Dokumentasi perintah lengkap