Pengaturan Masalah

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

Kegagalan Bangun

”Gagal mengunggah” atau “Koneksi waktu out”

Gejala:

• Proyek gagal saat mengunggah
• Masalah waktu tunggu setelah 60 detik

Solutions:

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 (harus dikecualikan secara otomatis)
   • Periksa file besar di proyek Anda:

   find . -type f -size +10M

3. Periksa kadaluarsa URL unggah

   • URLs untuk upload akan kedaluwarsa setelah 1 jam
   • Jika Anda mendapatkan kesalahan URL yang kedaluwarsa, jalankan perintah build lagi

Tip

Proyek yang sangat besar mungkin akan mencapai batas waktu pembangunan (lihat Keterbatasan yang Dikenal) Hubungi dukungan untuk opsi perusahaan.

”Waktu pembangunan melebihi 10 menit”

Gejala:

• Waktu pembangunan melebihi waktu maksimum yang diizinkan
• Status menampilkan timeout

Solutions:

1. Optimalkan dependensi

   • Hapus paket npm yang tidak digunakan
   • Pilih npm prune --production sebelum membangun

2. Cek masalah jaringan selama pembangunan

   • Beberapa dependensi mungkin mengunduh file besar selama pembangunan
   • Perhatikan ketergantungan native

3. Jendela terminal

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

4. Solutions:

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

Masalah Autentikasi

”API kunci tidak valid” atau “Tidak Berwenang”

Gejala:

• Pembangunan gagal secara langsung dengan kesalahan autentikasi
• Kode 401 atau 403

Solusi:

1. Pastikan kunci API sudah benar

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

2. Periksa izin API

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

3. Pastikan kunci API sedang dibaca

   # Check environment variable
   echo $CAPGO_TOKEN
   
   # Or check your saved credentials file
   cat ~/.capgo-credentials/credentials.json   # global
   cat .capgo-credentials.json                 # local (--local)

4. Re-autentikasi

   bunx @capgo/cli@latest login

Tidak ditemukan aplikasi

Gejala:

• Autentikasi berhasil tetapi ada kesalahan aplikasi spesifik

Pengaturan:

1. Pastikan aplikasi terdaftar

   bunx @capgo/cli@latest app list

2. Periksa apakah ID aplikasi sesuai

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

3. Verifikasi akses organisasi

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

Issue Pembangunan iOS

“Code gagal menandatangani”

Gejala:

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

Pembahasan:

1. Verifikasi jenis sertifikat sesuai dengan jenis pembangunan

   • Builds pengembangan memerlukan sertifikat pengembangan
   • Builds App Store memerlukan sertifikat distribusi

2. Periksa sertifikat dan profil match

   # 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 provisioningnya valid

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

4. Regenerasi kredential

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

”Profil pengaturan tidak termasuk sertifikat tanda tangan”

Gejala:

• Xcode tidak dapat menemukan sertifikat di profil

Pembahasan:

1. Unduh profil terbaru dari Apple

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

2. Periksa apakah 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. Rekreasikan profil dengan sertifikat yang benar

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

”Gagal autentikasi App Store Connect”

Gejala:

• Upload ke TestFlight gagal
• Error API key

Solutions:

1. Verifikasi kreditensi API key

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

2. Test API kunci secara lokal

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

3. Periksa kunci API

   • 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 instal pod”

Gejala:

• Pembangunan gagal selama instalasi CocoaPods
• Error Podfile

Solusi:

1. Pastikan Podfile.lock telah dikomit

   git status ios/App/Podfile.lock

2. Tes instalasi 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. Bersihkan cache pod

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

Issue Pembangunan Android

”Kata sandi keystore salah”

Gejala:

• Pembangunan gagal selama proses signing
• Masalah Gradle tentang keystore

Solutions:

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. Periksa pengkodean base64

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

”Alias kunci tidak ditemukan”

Gejala:

• Tanda tangan gagal dengan kesalahan alias

Pemecahan masalah:

1. Daftar alias keystore

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

2. Periksa apakah alias cocok secara tepat

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

3. Pakai alias yang benar dari keystore

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

”Gagal membangun Gradle”

Gejala:

• Masalah kesalahan Gradle umum
• Masalah kompilasi atau dependensi

Solusi:

1. Test bangun secara lokal terlebih dahulu

   cd android
   ./gradlew clean
   ./gradlew assembleRelease

2. Periksa dependensi yang hilang

   • Ulangi pengujian build.gradle files
   • Pastikan semua plugin terdaftar di dependencies

3. Verifikasi kompatibilitas versi Gradle

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

4. Membersihkan cache Gradle

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

Gagal mengunggah ke Play Store

Gejala:

• Bangunan berhasil tetapi unggahan gagal
• Error akun layanan

Solutions: Solusi:

1. Verify service account JSON Verifikasi akun layanan JSON

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

2. Check service account permissions Periksa izin akun layanan

   • Go to Play Console → Setup → API Access Pergi ke Play Console → Pengaturan → API Akses
   • Ensure service account has access to your app Pastikan akun layanan memiliki akses ke aplikasi Anda
   • Grant “Release to testing tracks” permission Berikan izin “Rilis ke jalur uji coba”

3. Verify app is set up in Play Console Periksa apakah aplikasi telah terinstal di Play Console

   • App must be created in Play Console first Aplikasi harus dibuat terlebih dahulu di Play Console
   • At least one APK must be uploaded manually initially Setidaknya satu APK harus diunggah secara manual secara awal

4. Check API is enabled Periksa apakah API telah diaktifkan

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

Issu-Issu Umum

”Tidak Ditemukan” atau “Status Pembangunan Tidak Tersedia”

Gejala:

• Tidak dapat memeriksa status pembangunan
• Error ID pekerjaan

Pengaturan:

1. Tunggu sebentar dan coba lagi

   • Pekerjaan pembangunan mungkin membutuhkan beberapa detik untuk diinisialisasi

2. Periksa ID pekerjaan benar

   • Verifikasi ID pekerjaan dari respons pembangunan awal

3. Periksa apakah pembangunan belum kedaluwarsa

   • Data pembangunan tersedia selama 24 jam

”Gagal sinkronisasi proyek”

Gejala:

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

Pembahasan:

1. Jalankan Capacitor sinkronisasi secara lokal

   bunx cap sync

2. Pastikan semua file native telah dikomit

   git status ios/ android/

3. Periksa file native yang diignore oleh Git

   • Tinjau .gitignore
   • Pastikan file konfigurasi penting tidak diignore

”Sukses dibangun tapi saya tidak melihat hasil”

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 TestFlight iOS

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

3. Untuk Play Store Android

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

Isu Spesifik CI/CD

GitHub Aksi: “Komando tidak ditemukan”

Gejala:

• bunx @capgo/cli@latest … Gagal di CI dengan “perintah tidak ditemukan”

Solusi:

1. Atur Bun terlebih dahulu jadi bunx tersedia:

   - uses: oven-sh/setup-bun@v2

2. Lalu jalankan CLI — bunx mengambilnya secara on demand, tidak perlu instalasi global:

   - run: bunx @capgo/cli@latest build request com.example.app --platform android

GitHub Aksi: “Rahasia tidak ditemukan”

Gejala:

• Variabel lingkungan kosong dalam pembangunan

Solusi:

1. Verifikasi rahasia telah disetel

   • Pergi ke Repositori Pengaturan → 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 tipe dalam referensi rahasia

Mendapatkan Bantuan Lebih Lanjut

Memungkinkan Log Verbal yang Lebih Detil

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

Mengumpulkan Informasi Pembangunan

Ketika menghubungi dukungan, termasuk:

1. Perintah pembangunan yang digunakan

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

2. Pesan kesalahan (output penuh)

3. ID pekerjaan (dari output pembangunan)

4. Log pembangunan (salin output terminal penuh)

5. Info lingkungan

   node --version
   npm --version
   bunx @capgo/cli@latest --version

Hubungi Dukungan

• Discord: Join our komunitas
• Email: support@capgo.app
• Dokumentasi: Capgo Dokumen

Keterbatasan yang Dikenal

Keterbatasan saat ini:

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

Keterbatasan ini mungkin disesuaikan berdasarkan umpan balik.

Sumber Daya Tambahan

• Mulai - Panduan pengaturan awal
• Buat iOS - Konfigurasi spesifik iOS
• Buat Android - Konfigurasi spesifik Android
• CLI Referensi - Dokumentasi perintah lengkap