Langsung ke konten

Debugging

GitHub

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.

Penolakan backend terkait billing, throttling, atau status non-error.

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.

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.

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.

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.

Penolakan backend akibat metadata versi native yang tidak valid.

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.

Penolakan backend ketika kebijakan channel memblokir platform, tipe build, atau kelas perangkat.

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.

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.

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.

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.

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.

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.

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.

Penolakan backend ketika aturan semver atau metadata memblokir bundle target.

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.

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.

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.

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.

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.

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.

Penolakan backend akibat konfigurasi channel yang tidak ada atau tidak kompatibel.

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.

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.

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.

Penolakan backend saat Capgo tidak dapat menyajikan atau mendekripsi bundle.

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.

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.

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.

Penolakan backend yang disebabkan oleh konfigurasi aplikasi atau versi updater yang tidak didukung.

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.

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.

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.

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.

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.

Peristiwa sisi perangkat untuk progres download, validasi arsip, dan error install.

Apa artinya

Urutan download dimulai pada progres 0%.

Apa artinya

Bundle baru telah diunduh — progres ditunjukkan pada 10%.

Apa artinya

Bundle baru telah diunduh — progres ditunjukkan pada 20%.

Apa artinya

Bundle baru telah diunduh — progres ditunjukkan pada 30%.

Apa artinya

Bundle baru telah diunduh — progres ditunjukkan pada 40%.

Apa artinya

Bundle baru telah diunduh — progres ditunjukkan pada 50%.

Apa artinya

Bundle baru telah diunduh — progres menunjukkan 60%.

Apa artinya

Bundle baru telah diunduh — progres menunjukkan 70%.

Apa artinya

Bundle baru telah diunduh — progres menunjukkan 80%.

Apa artinya

Bundle baru telah diunduh — progres menunjukkan 90%.

Apa artinya

Download bundle berhasil diselesaikan.

Apa artinya

Perangkat mulai mengunduh manifest update.

Apa artinya

Perangkat selesai mengunduh manifest update.

Apa artinya

Perangkat mulai mengunduh arsip bundle.

Apa artinya

Perangkat selesai mengunduh arsip bundle.

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.

Apa artinya

File manifest gagal validasi checksum.

Cara mengatasi

Upload ulang bundle dengan versi CLI terbaru dan verifikasi checksum manifest.

Apa artinya

File manifest gagal dekompresi Brotli.

Cara mengatasi

Verifikasi pengaturan kompresi dan upload ulang aset yang terdampak.

Apa artinya

Bundle gagal diunduh.

Cara mengatasi

Periksa konektivitas jaringan, masa berlaku signed URL, akses CDN, dan penyimpanan perangkat.

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.

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.

Apa artinya

Bundle yang diunduh gagal di-decrypt.

Cara mengatasi

Verifikasi key enkripsi dan upload ulang bundle dengan pasangan key yang sesuai.

Apa artinya

Zip berisi path bergaya Windows yang tidak valid.

Cara mengatasi

Build ulang bundle dengan path Unix atau bersihkan path arsip sebelum upload.

Apa artinya

Path file di dalam zip tidak bersifat canonical.

Cara mengatasi

Perbaiki pembuatan path archive sebelum upload.

Apa artinya

Zip berisi path direktori yang tidak valid.

Cara mengatasi

Perbaiki struktur archive sebelum upload.

Apa artinya

Perangkat gagal mengekstrak bundle yang diunduh.

Cara mengatasi

Verifikasi integritas arsip dan kompresi yang didukung.

Apa artinya

Download gagal karena memori perangkat habis.

Cara mengatasi

Kurangi ukuran bundle atau coba lagi di perangkat dengan memori bebas lebih banyak.

Diagnostik crash, memori, dan WebView di sisi perangkat. Selalu periksa metadata JSON di dashboard.

Apa artinya

Aplikasi masuk ke background.

Apa artinya

Aplikasi masuk ke foreground.

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.

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.

Apa artinya

OS membunuh aplikasi setelah tekanan memori.

Cara mengatasi

Kurangi penggunaan memori setelah aktivasi update dan periksa metadata untuk sinyal memori yang tersedia.

Apa artinya

OS membunuh aplikasi karena penggunaan sumber daya yang berlebihan.

Cara mengatasi

Periksa metadata untuk jenis sumber daya atau alasan platform.

Apa artinya

Updater atau startup gagal sebelum runtime normal siap.

Cara mengatasi

Periksa metadata untuk langkah yang gagal dan pesan error.

Apa artinya

Peringatan memori iOS.

Cara mengatasi

Periksa konteks memori di metadata dan kurangi penggunaan puncak setelah update.

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.

Apa artinya

Penolakan promise yang tidak ditangani di WebView.

Cara mengatasi

Tangkap kegagalan async dengan error reporting JS dan native.

Apa artinya

Sumber daya WebView gagal dimuat.

Cara mengatasi

Gunakan metadata URL dan detail status untuk memperbaiki aset rusak atau aturan jaringan.

Apa artinya

Content security policy memblokir sebuah resource.

Cara mengatasi

Sesuaikan CSP menggunakan direktif metadata dan detail URI yang diblokir.

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.

Apa artinya

Proses renderer WebView Android berhenti.

Cara mengatasi

Periksa sinyal crash renderer di metadata dan native logs.

Apa artinya

Proses konten WebView iOS dihentikan.

Cara mengatasi

Periksa bundle aktif dan URL halaman dari metadata.

Event timing ini menggambarkan siklus hidup aplikasi. Mereka tidak membuktikan bahwa setiap fitur berfungsi.

Apa artinya

Aplikasi memulai pengukuran peluncuran. Ini peristiwa siklus hidup yang normal.

Apa artinya

Aplikasi melaporkan sudah siap. Metadata timing dapat membantu membandingkan startup antar versi. Ini peristiwa siklus hidup yang normal.

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.

Apa artinya

WebView melaporkan bahwa konten DOM telah dimuat. Ini adalah event timing normal, bukan bukti bahwa semua resource atau fitur aplikasi sudah siap.

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.

Apa artinya

Bundle dijadwalkan untuk diaktifkan pada peluncuran aplikasi berikutnya. Penjadwalan ini normal dan tidak berarti bundle sudah diaktifkan.

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.

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.

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.

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.

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.

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.

Peristiwa konteks sisi perangkat yang membantu mengorelasikan perilaku update dengan OS, versi native, atau perubahan channel.

Apa artinya

Versi OS perangkat berubah di antara pemeriksaan.

Apa artinya

Versi native app store berubah, membantu memisahkan perubahan native vs web bundle.

Apa artinya

Perangkat melakukan query channel saat ini.

Apa artinya

Channel berhasil diatur untuk perangkat.

Apa artinya

Aplikasi di-uninstall atau data Capgo dihapus.

  • SUCCESS: install bundle selesai
  • ERROR: install atau download gagal
  • PENDING: Download selesai, menunggu rilis
  • DELETED: Bundle dihapus, tetap ditampilkan untuk statistik
  • DOWNLOADING: Sedang mendownload bundle

Tersedia perintah debug untuk pengguna cloud Capgo.

Jendela terminal
npx @capgo/cli@latest app debug

Ini memungkinkan Anda mengecek semua event yang terjadi di app dan mencari solusi jika update tidak berjalan.

untuk menemukan log Anda di Xcode

untuk menemukan log Anda di Android Studio

  • Failed to download from dipetakan ke download_fail
  • notifyAppReady was not called, roll back current bundle dipetakan ke update_fail

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. Menu Window di Xcode yang menampilkan opsi Devices and Simulators

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.

Panel Xcode Devices yang menampilkan opsi download app container

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

File xcappdata yang diunduh dengan menu konteks Show Package Contents

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.

Struktur folder container aplikasi iOS yang menampilkan folder Documents dan Library

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.

Device File Explorer di Android Studio yang menampilkan direktori data aplikasi

Then Find the versions folder untuk melihat semua versi

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.