Debugging
Salin prompt setup yang berisi langkah install dan panduan markdown lengkap untuk plugin ini.
Memahami cloud logs
Bagian berjudul âMemahami log cloudâJika Anda menerima penolakan cloud code dan membutuhkan panduan perbaikan yang lebih mendalam, lihat Masalah Update Umum.
Log Capgo dapat mencakup metadata untuk peristiwa tersebut. Di dashboard, filter berdasarkan aksi snake_case code, lalu klik sel metadata untuk menyalin payload JSON lengkap. Metadata sangat berguna untuk peristiwa crash dan WebView karena dapat berisi pesan error, URL sumber, baris dan kolom, status proses, tekanan memori, atau alasan spesifik platform. Log lama masih dapat menampilkan alias camelCase lama yang tercantum dalam tanda kurung.
Setiap judul bagian sesuai dengan aksi code yang ditampilkan di tabel log konsol, sehingga Anda dapat langsung menautkan ke bagian tersebut.
Limit paket dan respons normal
Bagian berjudul âBatas paket dan respons normalâPenolakan backend terkait billing, throttling, atau status non-error.
InvalidIp
Bagian berjudul âInvalidIpâApa artinya
Capgo mendeteksi lalu lintas yang tampak berasal dari Google atau infrastruktur cloud. Update yang usianya kurang dari empat jam diabaikan agar lalu lintas bot tidak dihitung sebagai perangkat yang dapat ditagih.
Cara mengatasi
Abaikan ini untuk pengguna asli. Coba lagi dari jaringan normal dan perangkat asli, atau tunggu dan periksa lagi nanti.
provider_infrastructure_request_blocked
Bagian berjudul âprovider_infrastructure_request_blockedâApa artinya
Aplikasi Anda dikonfigurasi untuk memblokir permintaan dari rentang IP datacenter Google dan Apple yang dikenal. Proteksi ini berlaku untuk pemeriksaan update, statistik, dan permintaan channel-self, sehingga probe yang di-hosting di cloud dan runner provider dapat menerima respons ini meskipun konfigurasi aplikasi lainnya valid.
Cara mengatasi
Coba lagi dari perangkat fisik di jaringan pengguna normal. Jika lalu lintas yang berasal dari provider bersifat disengaja, nonaktifkan sementara Blokir permintaan infrastruktur provider di dalam aplikasi Informasi tab, lalu aktifkan kembali setelah pengujian. Aplikasi baru mengaktifkan pengaturan ini secara default; aplikasi yang sudah ada mempertahankan pengaturan nonaktif sebelumnya hingga diubah.
needPlanUpgrade
Bagian berjudul âneedPlanUpgradeâApa artinya
Organisasi Anda telah mencapai batas paket atau perangkat. Perangkat tidak akan menerima update sampai Anda upgrade atau siklus penagihan berikutnya mereset penggunaan.
Cara mengatasi
Upgrade paket Anda di dashboard atau tunggu siklus penagihan berikutnya.
Apa artinya
Perangkat sudah memiliki bundle terbaru untuk channel-nya. Ini adalah kondisi normal, bukan error.
rateLimited
Bagian berjudul ârateLimitedâApa artinya
Perangkat mengirim terlalu banyak request update atau channel dalam waktu singkat.
Cara mengatasi
Jangan memanggil update API di dalam render loop. Panggil setChannel / getChannel hanya dari user action, dan set defaultChannel di capacitor.config.
Format versi
Bagian berjudul âFormat versiâPenolakan backend akibat metadata versi native yang tidak valid.
semver_error
Bagian berjudul âsemver_errorâApa artinya
Versi aplikasi native di config tidak ada atau bukan semver yang valid (x.y.z).
Cara mengatasi
Atur plugins.CapacitorUpdater.version agar semver valid, verifikasi di Penguji SemVer, lalu rebuild dan reinstall aplikasi native.
Target platform dan build
Bagian berjudul âPlatform and build targetingâPenolakan backend ketika kebijakan channel memblokir platform, tipe build, atau kelas perangkat.
disablePlatformIos
Bagian berjudul âdisablePlatformIosâApa artinya
Perangkat ini menjalankan iOS, tetapi pembaruan iOS dinonaktifkan untuk channel ini.
Cara mengatasi
Aktifkan iOS di channel ini jika tidak disengaja, atau arahkan build iOS ke channel khusus jika pemblokiran memang disengaja.
disablePlatformAndroid
Bagian berjudul âdisablePlatformAndroidâApa artinya
Perangkat ini menjalankan Android, tetapi pembaruan Android dinonaktifkan untuk channel ini.
Cara mengatasi
Aktifkan Android di channel ini jika tidak disengaja, atau arahkan build Android ke channel khusus jika pemblokiran memang disengaja.
disablePlatformElectron
Bagian berjudul âdisablePlatformElectronâApa artinya
Perangkat menjalankan Electron, tetapi pembaruan Electron dinonaktifkan untuk channel ini.
Cara mengatasi
Aktifkan Electron di channel ini jika tidak disengaja, atau arahkan build Electron ke channel khusus jika pemblokiran memang disengaja.
disableDevBuild
Bagian berjudul âdisableDevBuildâApa artinya
Perangkat ini adalah build pengembangan, tetapi build dev diblokir untuk channel ini.
Cara mengatasi
Izinkan build dev di channel pengujian, atau pertahankan channel ini hanya untuk rilis dan pindahkan perangkat dev ke tempat lain.
disableProdBuild
Bagian berjudul âdisableProdBuildâApa artinya
Build produksi yang disebut /updates, tetapi production update diblokir untuk channel ini.
Cara mengatasi
Izinkan production update di channel ini jika ini tidak disengaja, atau arahkan production build ke channel yang benar.
disableDevice
Bagian berjudul âdisableDeviceâApa artinya
Ponsel atau tablet asli diblokir karena channel ini memblokir perangkat asli.
Cara mengatasi
Aktifkan update untuk perangkat asli jika ini tidak disengaja, atau pertahankan pembatasan dan arahkan perangkat asli ke channel lain.
disableEmulator
Bagian berjudul âdisableEmulatorâApa artinya
Perangkat adalah emulator, tetapi update emulator dinonaktifkan untuk channel ini.
Cara mengatasi
Aktifkan update emulator di channel pengujian, atau pertahankan channel ini terblokir untuk emulator dan gunakan channel lain untuk validasi emulator.
Aturan kompatibilitas auto-update
Bagian berjudul âAturan kompatibilitas auto-updateâPenolakan backend ketika aturan semver atau metadata memblokir bundle target.
disableAutoUpdate
Bagian berjudul âdisableAutoUpdateâApa artinya
Auto-update dinonaktifkan oleh kebijakan kompatibilitas channel. Metadata mencakup auto_update dengan aturan yang cocok seperti major, minor, patch, metadata, atau none.
Cara mengatasi
Ubah kebijakan auto-update channel untuk memungkinkan rollout yang Anda inginkan.
disableAutoUpdateUnderNative
Bagian berjudul âdisableAutoUpdateUnderNativeâApa artinya
Channel memiliki bundle yang lebih lama daripada baseline perangkat dan memblokir pengiriman update di bawah versi native.
Cara mengatasi
Publikasikan bundle pada atau di atas baseline native, atau nonaktifkan proteksi under-native di channel.
disableAutoUpdateMetadata
Bagian berjudul âdisableAutoUpdateMetadataâApa artinya
Channel membutuhkan min_update_version, tetapi versi native perangkat berada di bawah ambang batas tersebut.
Cara mengatasi
Atur min_update_version pada bundle target atau release dari versi native yang lebih baru.
disableAutoUpdateToMajor
Bagian berjudul âdisableAutoUpdateToMajorâApa artinya
Channel memblokir lompatan versi mayor, misalnya 1.x.x ke 2.x.x.
Cara mengatasi
Sesuaikan strategi channel dengan rencana rilis mayor Anda, atau izinkan lompatan mayor untuk track ini. Lihat Masalah Update Umum.
disableAutoUpdateToMinor
Bagian berjudul âdisableAutoUpdateToMinorâApa artinya
Channel memblokir lompatan versi minor relatif terhadap baseline native perangkat (version_build), misalnya 1.2.3 ke 1.3.0.
Cara mengatasi
Selaraskan strategi channel dengan rencana rollout minor Anda, atau izinkan lompatan minor untuk track ini.
disableAutoUpdateToPatch
Bagian berjudul âdisableAutoUpdateToPatchâApa artinya
Channel memblokir perubahan tingkat patch sambil mempertahankan MAJOR.MINOR.PATCH prefix yang sama; hanya perubahan suffix yang diizinkan.
Cara mengatasi
Selaraskan cadence rilis dengan kebijakan channel, atau izinkan lompatan patch untuk track ini.
Konfigurasi channel
Bagian berjudul âSetup channelâPenolakan backend akibat konfigurasi channel yang tidak ada atau tidak kompatibel.
cannotUpdateViaPrivateChannel
Bagian berjudul âcannotUpdateViaPrivateChannelâApa artinya
Perangkat mencoba mengasosiasikan dirinya dengan channel privat yang tidak mengizinkan self-assignment perangkat (allow_device_self_set bernilai false) dan channel tersebut bukan publik.
Cara mengatasi
Aktifkan allow_device_self_set di channel tersebut atau alihkan perangkat ke channel publik atau yang diizinkan.
channelMisconfigured
Bagian berjudul âchannelMisconfiguredâApa artinya
Channel menggunakan disable_auto_update: "version_number" tetapi bundle min_update_version bernilai null, sehingga Capgo tidak dapat menentukan perangkat mana yang harus di-update.
Cara mengatasi
Lengkapi config yang hilang untuk aturan tersebut atau beralih ke mode auto-update yang lebih sederhana.
NoChannelOrOverride
Bagian berjudul âNoChannelOrOverrideâApa artinya
Tidak ada channel default yang dikonfigurasi dan perangkat tidak memiliki override channel.
Cara mengatasi
Atur channel default di dashboard atau konfigurasikan defaultChannel di dalam build.
Pengiriman dan enkripsi bundle
Bagian berjudul âPengiriman dan enkripsi bundleâPenolakan backend saat Capgo tidak dapat menyajikan atau mendekripsi bundle.
cannotGetBundle
Bagian berjudul âcannotGetBundleâApa artinya
Capgo gagal membuat URL download bertanda tangan yang valid dan tidak ada fallback manifest yang tersedia.
Cara mengatasi
Upload ulang bundle, buat ulang manifest, dan periksa pengaturan R2 atau bundle publik.
missingBundle
Bagian berjudul âmissingBundleâApa artinya
Bundle yang ditetapkan ke channel tidak memiliki konten yang dapat diunduh: tidak ada external_url, tidak ada r2_path, bukan versi bawaan, dan tidak ada entri manifest.
Cara mengatasi
Build ulang dan upload ulang versinya, lalu pastikan bundle benar-benar berisi konten file.
keyMismatch
Bagian berjudul âkeyMismatchâApa artinya
Public key enkripsi perangkat tidak cocok dengan kunci yang digunakan untuk mengenkripsi bundle. Metadata dapat berisi device_key_id, bundle_key_id, dan version.
Cara mengatasi
Bandingkan ID kunci perangkat dan bundle di konsol. Publish dengan kunci yang sama dan versi CLI/plugin yang cocok.
Konfigurasi aplikasi dan klien lama
Bagian berjudul âKonfigurasi aplikasi dan klien lamaâPenolakan backend yang disebabkan oleh konfigurasi aplikasi atau versi updater yang tidak didukung.
customIdBlocked
Bagian berjudul âcustomIdBlockedâApa artinya
Aplikasi mengirimkan custom device ID, tetapi aplikasi ini tidak menerima custom ID, sehingga ID tersebut diabaikan.
Cara mengatasi
Hentikan pengiriman ID kustom, atau aktifkan ID kustom hanya jika alur kerja Anda membutuhkannya.
blocked_by_server_url
Bagian berjudul âblocked_by_server_urlâApa artinya
server.url disetel di konfigurasi Capacitor, sehingga WebView memuat URL jarak jauh alih-alih file bundle lokal. Capgo live updates memerlukan file lokal dan server.url tidak disarankan di produksi.
Cara mengatasi
Hapus atau kosongkan server.url untuk build produksi dan simpan payload update secara lokal. code ini bisa muncul sebagai penolakan backend atau sebagai statistik sisi perangkat.
backend_refusal
Bagian berjudul âbackend_refusalâApa artinya
Plugin updater adalah v4, yang tidak lagi diterima oleh backend.
Cara mengatasi
Upgrade plugin dan CLI ke v5+ (disarankan v8) dengan Capacitor v5+, rebuild, dan terbitkan ulang metadata bundle.
Lifecycle update
Bagian berjudul âUpdate lifecycleâPeristiwa sisi perangkat untuk alur update normal, aktivasi, dan rollback.
Apa artinya
Aksi pengujian internal yang digunakan untuk memverifikasi pipeline statistik.
Apa artinya
Capgo mengirim informasi download untuk versi baru ke perangkat.
Apa artinya
Bundle diaktifkan di perangkat.
set_fail
Bagian berjudul âset_failâApa artinya
Bundle gagal diaktifkan di perangkat.
Cara mengatasi
Cek native logs dengan npx @capgo/cli@latest app debug dan verifikasi integritas bundle, path, serta notifyAppReady flow.
Apa artinya
Perangkat di-reset ke bundle bawaan.
Apa artinya
Satu bundle dihapus dari perangkat.
Kegagalan download dan install
Bagian berjudul âGagal download dan installâPeristiwa sisi perangkat untuk progres download, validasi arsip, dan error install.
download_0
Bagian berjudul âdownload_0âApa artinya
Urutan download dimulai pada progres 0%.
download_10
Bagian berjudul âdownload_10âApa artinya
Bundle baru telah diunduh â progres ditunjukkan pada 10%.
download_20
Bagian berjudul âdownload_20âApa artinya
Bundle baru telah diunduh â progres ditunjukkan pada 20%.
download_30
Bagian berjudul âdownload_30âApa artinya
Bundle baru telah diunduh â progres ditunjukkan pada 30%.
download_40
Bagian berjudul âdownload_40âApa artinya
Bundle baru telah diunduh â progres ditunjukkan pada 40%.
download_50
Bagian berjudul âdownload_50âApa artinya
Bundle baru telah diunduh â progres ditunjukkan pada 50%.
download_60
Bagian berjudul âdownload_60âApa artinya
Bundle baru telah diunduh â progres menunjukkan 60%.
download_70
Bagian berjudul âdownload_70âApa artinya
Bundle baru telah diunduh â progres menunjukkan 70%.
download_80
Bagian berjudul âdownload_80âApa artinya
Bundle baru telah diunduh â progres menunjukkan 80%.
download_90
Bagian berjudul âdownload_90âApa artinya
Bundle baru telah diunduh â progres menunjukkan 90%.
download_complete
Bagian berjudul âdownload_completeâApa artinya
Download bundle berhasil diselesaikan.
download_manifest_start
Bagian berjudul âdownload_manifest_startâApa artinya
Perangkat mulai mengunduh manifest update.
download_manifest_complete
Bagian berjudul âdownload_manifest_completeâApa artinya
Perangkat selesai mengunduh manifest update.
download_zip_start
Bagian berjudul âdownload_zip_startâApa artinya
Perangkat mulai mengunduh arsip bundle.
download_zip_complete
Bagian berjudul âdownload_zip_completeâApa artinya
Perangkat selesai mengunduh arsip bundle.
download_manifest_file_fail
Bagian berjudul âdownload_manifest_file_failâApa artinya
Satu entri manifest gagal diunduh. version_name menggunakan version:fileName untuk mengidentifikasi aset.
Cara mengatasi
Perbaiki aset yang hilang atau terblokir, buat ulang manifest, dan upload ulang bundle.
download_manifest_checksum_fail
Bagian berjudul âdownload_manifest_checksum_failâApa artinya
File manifest gagal validasi checksum.
Cara mengatasi
Upload ulang bundle dengan versi CLI terbaru dan verifikasi checksum manifest.
download_manifest_brotli_fail
Bagian berjudul âdownload_manifest_brotli_failâApa artinya
File manifest gagal dekompresi Brotli.
Cara mengatasi
Verifikasi pengaturan kompresi dan upload ulang aset yang terdampak.
download_fail
Bagian berjudul âdownload_failâApa artinya
Bundle gagal diunduh.
Cara mengatasi
Periksa konektivitas jaringan, masa berlaku signed URL, akses CDN, dan penyimpanan perangkat.
update_fail
Bagian berjudul âupdate_failâApa artinya
Bundle terinstal tapi app tidak pernah memanggil notifyAppReady, jadi Capgo melakukan rollback.
Cara mengatasi
Panggil notifyAppReady() setelah app selesai bootstrapping. Teks log native notifyAppReady was not called, roll back current bundle merujuk ke code ini.
checksum_fail
Bagian berjudul âchecksum_failâApa artinya
Bundle yang diunduh gagal validasi checksum. Penyebab umum: mismatch CRC32 vs SHA256 dari upload CLI lama, atau mismatch encryption key pada plugin lama yang memunculkan kegagalan dekripsi sebagai kegagalan checksum.
Cara mengatasi
Ulangi upload dengan CLI/plugin terbaru (SHA256). Jika menggunakan enkripsi, pastikan public key aplikasi cocok dengan key upload, atau upgrade ke plugin 8.3.0+ untuk eksplisit keyMismatch errors.
decrypt_fail
Bagian berjudul âdecrypt_failâApa artinya
Bundle yang diunduh gagal di-decrypt.
Cara mengatasi
Verifikasi key enkripsi dan upload ulang bundle dengan pasangan key yang sesuai.
windows_path_fail
Bagian berjudul âwindows_path_failâApa artinya
Zip berisi path bergaya Windows yang tidak valid.
Cara mengatasi
Build ulang bundle dengan path Unix atau bersihkan path arsip sebelum upload.
canonical_path_fail
Bagian berjudul âcanonical_path_failâApa artinya
Path file di dalam zip tidak bersifat canonical.
Cara mengatasi
Perbaiki pembuatan path archive sebelum upload.
directory_path_fail
Bagian berjudul âdirectory_path_failâApa artinya
Zip berisi path direktori yang tidak valid.
Cara mengatasi
Perbaiki struktur archive sebelum upload.
unzip_fail
Bagian berjudul âunzip_failâApa artinya
Perangkat gagal mengekstrak bundle yang diunduh.
Cara mengatasi
Verifikasi integritas arsip dan kompresi yang didukung.
low_mem_fail
Bagian berjudul âlow_mem_failâApa artinya
Download gagal karena memori perangkat habis.
Cara mengatasi
Kurangi ukuran bundle atau coba lagi di perangkat dengan memori bebas lebih banyak.
Kesehatan aplikasi dan event WebView
Bagian berjudul âKesehatan aplikasi dan event WebViewâDiagnostik crash, memori, dan WebView di sisi perangkat. Selalu periksa metadata JSON di dashboard.
app_moved_to_background
Bagian berjudul âapp_moved_to_backgroundâApa artinya
Aplikasi masuk ke background.
app_moved_to_foreground
Bagian berjudul âapp_moved_to_foregroundâApa artinya
Aplikasi masuk ke foreground.
app_crash
Bagian berjudul âapp_crashâApa artinya
Crash di layer JavaScript atau Capacitor. Metadata dapat mencakup message, stack, source, dan konteks bundle aktif.
Cara mengatasi
Periksa metadata dan logs native. Gabungkan pelaporan error JS dan native (misalnya Sentry) untuk melacak jalur code yang gagal.
app_crash_native
Bagian berjudul âapp_crash_nativeâApa artinya
Crash di platform native. Metadata dapat mencakup platform, reason, stack, dan detail proses.
Cara mengatasi
Gunakan crash logs dari Xcode atau Logcat dan korelasikan dengan bundle aktif dari metadata.
Apa artinya
Peristiwa Android Application Not Responding.
Cara mengatasi
Periksa trace ANR di Logcat dan kurangi pekerjaan yang memblokir main-thread setelah update.
app_killed_low_memory
Bagian berjudul âapp_killed_low_memoryâApa artinya
OS membunuh aplikasi setelah tekanan memori.
Cara mengatasi
Kurangi penggunaan memori setelah aktivasi update dan periksa metadata untuk sinyal memori yang tersedia.
app_killed_excessive_resource_usage
Bagian berjudul âapp_killed_excessive_resource_usageâApa artinya
OS membunuh aplikasi karena penggunaan sumber daya yang berlebihan.
Cara mengatasi
Periksa metadata untuk jenis sumber daya atau alasan platform.
app_initialization_failure
Bagian berjudul âapp_initialization_failureâApa artinya
Updater atau startup gagal sebelum runtime normal siap.
Cara mengatasi
Periksa metadata untuk langkah yang gagal dan pesan error.
app_memory_warning
Bagian berjudul âapp_memory_warningâApa artinya
Peringatan memori iOS.
Cara mengatasi
Periksa konteks memori di metadata dan kurangi penggunaan puncak setelah update.
webview_javascript_error
Bagian berjudul âwebview_javascript_errorâApa artinya
Error JavaScript yang tidak tertangkap di WebView. Metadata dapat mencakup pesan, URL sumber, baris, kolom, dan stack.
Cara mengatasi
Pasang error reporting di lapisan JS dan native untuk menangkap baris yang gagal secara persis di produksi.
webview_unhandled_rejection
Bagian berjudul âwebview_unhandled_rejectionâApa artinya
Penolakan promise yang tidak ditangani di WebView.
Cara mengatasi
Tangkap kegagalan async dengan error reporting JS dan native.
webview_resource_error
Bagian berjudul âwebview_resource_errorâApa artinya
Sumber daya WebView gagal dimuat.
Cara mengatasi
Gunakan metadata URL dan detail status untuk memperbaiki aset rusak atau aturan jaringan.
webview_security_policy_violation
Bagian berjudul âwebview_security_policy_violationâApa artinya
Content security policy memblokir sebuah resource.
Cara mengatasi
Sesuaikan CSP menggunakan direktif metadata dan detail URI yang diblokir.
webview_unclean_restart
Bagian berjudul âwebview_unclean_restartâApa artinya
Sesi WebView sebelumnya tidak tertutup dengan bersih, yang bisa mengindikasikan adanya crash loop setelah update.
Cara mengatasi
Korelasikan dengan event crash dan error WebView sebelum dan sesudah restart.
webview_render_process_gone
Bagian berjudul âwebview_render_process_goneâApa artinya
Proses renderer WebView Android berhenti.
Cara mengatasi
Periksa sinyal crash renderer di metadata dan native logs.
webview_content_process_terminated
Bagian berjudul âwebview_content_process_terminatedâApa artinya
Proses konten WebView iOS dihentikan.
Cara mengatasi
Periksa bundle aktif dan URL halaman dari metadata.
Telemetri peluncuran dan navigasi
Bagian berjudul âLaunch and navigation telemetryâEvent timing ini menggambarkan siklus hidup aplikasi. Mereka tidak membuktikan bahwa setiap fitur berfungsi.
app_launch_start
Bagian berjudul âapp_launch_startâApa artinya
Aplikasi memulai pengukuran peluncuran. Ini peristiwa siklus hidup yang normal.
app_launch_ready
Bagian berjudul âapp_launch_readyâApa artinya
Aplikasi melaporkan sudah siap. Metadata timing dapat membantu membandingkan startup antar versi. Ini peristiwa siklus hidup yang normal.
app_launch_timeout
Bagian berjudul âapp_launch_timeoutâApa artinya
Aplikasi tidak melaporkan siap dalam jendela pengukuran peluncurannya.
Cara mengatasi
Periksa error startup dan timeline perangkat. Pastikan startup mencapai panggilan readiness, dan panggil notifyAppReady() setelah bootstrapping berhasil. Bandingkan timing dan kegagalan dengan bundle sebelumnya sebelum mengubah pengaturan timeout.
webview_dom_content_loaded
Bagian berjudul âwebview_dom_content_loadedâApa artinya
WebView melaporkan bahwa konten DOM telah dimuat. Ini adalah event timing normal, bukan bukti bahwa semua resource atau fitur aplikasi sudah siap.
webview_page_loaded
Bagian berjudul âwebview_page_loadedâApa artinya
WebView melaporkan bahwa halaman telah dimuat. Ini adalah event timing normal. Bandingkan metadata durasi antar versi saat menyelidiki proses load yang lambat.
Apa artinya
Aplikasi melaporkan event navigasi. Ini adalah telemetri normal. Metadata route dan durasi memungkinkan perbandingan per layar jika aplikasi menyediakannya.
Hasil updater tambahan
Bagian berjudul âHasil updater tambahanâset_next
Bagian berjudul âset_nextâApa artinya
Bundle dijadwalkan untuk diaktifkan pada peluncuran aplikasi berikutnya. Penjadwalan ini normal dan tidak berarti bundle sudah diaktifkan.
channelPaused
Bagian berjudul âchannelPausedâApa artinya
Channel yang dipilih sedang dijeda. Server tidak mengirim update dan perangkat tetap menggunakan bundle saat ini. Ini bisa menjadi kebijakan rilis yang disengaja.
Cara mengatasi
Periksa alasan channel dijeda dan apakah aman untuk dilanjutkan. Jangan lanjutkan rollout secara otomatis hanya untuk menghilangkan event ini.
finish_download_fail
Bagian berjudul âfinish_download_failâApa artinya
Perangkat tidak dapat menyelesaikan bundle yang telah diunduh.
Cara mengatasi
Periksa metadata dan log native untuk error filesystem atau validasi yang mendasarinya. Verifikasi penyimpanan yang tersedia dan arsip yang di-upload sebelum mencoba lagi.
manifest_path_fail
Bagian berjudul âmanifest_path_failâApa artinya
Path file manifest gagal validasi atau tidak dapat digunakan selama update.
Cara mengatasi
Periksa path yang gagal di log native, perbaiki tata letak file bundle, dan upload ulang. Jangan lewati validasi path.
checksum_required
Bagian berjudul âchecksum_requiredâApa artinya
Updater memerlukan metadata checksum yang hilang untuk download ini.
Cara mengatasi
Upload bundle lagi dengan CLI saat ini dan pastikan metadata checksum ada. Jangan nonaktifkan pemeriksaan integritas untuk mengakali error ini.
insufficient_disk_space
Bagian berjudul âinsufficient_disk_spaceâApa artinya
Perangkat tidak memiliki penyimpanan yang cukup untuk pembaruan.
Cara mengatasi
Lepaskan penyimpanan perangkat, kurangi ukuran bundle seperlunya, dan coba lagi di perangkat uji yang terdampak. Ini tidak terselesaikan dengan mengubah kebijakan versi channel.
update_check_error
Bagian berjudul âupdate_check_errorâApa artinya
Pemeriksaan update gagal. Peristiwa ini saja tidak dapat mengidentifikasi apakah penyebabnya adalah konektivitas, ketersediaan server, atau penolakan respons tertentu.
Cara mengatasi
Periksa metadata respons dan log native di sekitarnya. Cek konektivitas dan URL update yang dikonfigurasi, lalu cari error backend tertentu di Common Update Problems sebelum mengubah pengaturan.
Konteks environment dan channel
Bagian berjudul âEnvironment and channel contextâPeristiwa konteks sisi perangkat yang membantu mengorelasikan perilaku update dengan OS, versi native, atau perubahan channel.
os_version_changed
Bagian berjudul âos_version_changedâApa artinya
Versi OS perangkat berubah di antara pemeriksaan.
native_app_version_changed
Bagian berjudul ânative_app_version_changedâApa artinya
Versi native app store berubah, membantu memisahkan perubahan native vs web bundle.
getChannel
Bagian berjudul âgetChannelâApa artinya
Perangkat melakukan query channel saat ini.
setChannel
Bagian berjudul âsetChannelâApa artinya
Channel berhasil diatur untuk perangkat.
uninstall
Bagian berjudul âuninstallâApa artinya
Aplikasi di-uninstall atau data Capgo dihapus.
Status bundle
Bagian berjudul âBundle statusâSUCCESS: install bundle selesaiERROR: install atau download gagalPENDING: Download selesai, menunggu rilisDELETED: Bundle dihapus, tetap ditampilkan untuk statistikDOWNLOADING: Sedang mendownload bundle
Memahami device logs
Bagian berjudul âMemahami log perangkatâPerintah debug
Bagian berjudul âPerintah debugâTersedia perintah debug untuk pengguna cloud Capgo.
npx @capgo/cli@latest app debugIni memungkinkan Anda mengecek semua event yang terjadi di app dan mencari solusi jika update tidak berjalan.
log native iOS
Bagian berjudul âiOS native logsâuntuk menemukan log Anda di Xcode
Log native Android
Bagian berjudul âAndroid native logsâuntuk menemukan log Anda di Android Studio
Pemetaan frasa log native
Bagian berjudul âPemetaan frasa log nativeâFailed to download fromdipetakan kedownload_failnotifyAppReady was not called, roll back current bundledipetakan keupdate_fail
Menemukan bundle yang diunduh di perangkat
Bagian berjudul âMencari bundle yang diunduh di perangkatâUntuk debug di iOS, Anda perlu dump aplikasi ke komputer. Caranya:
Xcode memiliki fitur bawaan untuk memeriksa file system aplikasi yang diinstal pengembang di perangkat iOS.

Untuk melakukannya:
- Hubungkan perangkat Anda ke Mac, lalu pilih Window > Devices di menubar Xcode.
- Pilih perangkat Anda di panel kiri di bawah bagian Devices.
- Ini akan menampilkan daftar aplikasi yang diinstal oleh developer untuk perangkat tersebut.
- Pilih aplikasi yang ingin Anda periksa, lalu klik ikon 3 titik di dekat bagian bawah layar.
- Di sini Anda dapat melihat file system saat ini dengan memilih download a snapshot of it.

Memilih Download Container⌠akan mengunduh dan mengekspor snapshot file system sebagai file .xcappdata yang dapat Anda jelajahi.

Klik kanan pada file ini dan pilih Show Package Contents untuk membuka folder.
Buka folder App Data, dan Anda seharusnya melihat beberapa folder seperti Documents, Library, tmp, dll.

Lalu Anda akan menemukan versi di 2 folder:
library/NoCloud/ionic_built_snapshots diperlukan setelah app di-restart
dan documents/versions untuk hot reload
Untuk debug di Android, Anda perlu mengakses perangkat dari Android Studio:
- Klik View > Tool Windows > Device File Explorer atau klik tombol Device File Explorer di bilah tool window untuk membuka Device File Explorer.
- Pilih perangkat dari daftar dropdown.
- Open the path data/data/APP_NAME/ di mana APP_NAME adalah ID app Anda.

Then Find the versions folder untuk melihat semua versi
Memahami crash log produksi iOS
Bagian berjudul âMemahami log crash produksi iOSâLanjutkan dari Debugging
Bagian berjudul âLanjut dari DebuggingâJika Anda menggunakan Debugging untuk merencanakan pekerjaan plugin native, hubungkan dengan Menggunakan @capgo/capacitor-updater untuk fitur native di bagian Menggunakan @capgo/capacitor-updater, Direktori Plugin Capgo untuk alur kerja produk di Direktori Plugin Capgo, Plugin Capacitor oleh Capgo untuk detail implementasi pada Capacitor Plugins oleh Capgo Menambahkan atau Memperbarui Plugin untuk detail implementasi di Menambahkan atau Memperbarui Plugin, dan Alternatif Plugin Ionic Enterprise untuk alur kerja produk dalam Alternatif Plugin Ionic Enterprise.