Masalah Pembaruan Umum

Ketika cek update gagal, Capgo biasanya mengembalikan sebuah Capgo dan sebuah error code dan sebuah message dalam hal ini /updates dalam respons. Halaman ini menjelaskan gagal umum dan perbaikan tercepat.

Baca ini terlebih dahulu

• no_new_version_available adalah keadaan normal, bukan gagal.
• Banyak laporan “update ditemukan tetapi tidak diterapkan” adalah penolakan kebijakan/konfigurasi daripada keterlambatan cache, terutama ketika respons mencakup __CAPGO_KEEP_0__ yang eksplisit. error code.
• sambil mereproduksi masalah untuk melihat detail permintaan/respons. npx @capgo/cli@latest app debug Kode gagal umum

Judul bagian “Kode gagal umum”

provider_infrastructure_request_blocked

Pemicu

Aplikasi memiliki Menghalangi permintaan infrastruktur penyedia enabled and the request originated from a known Google or Apple datacenter IP range. Capgo blocks these requests on /updates, /stats__CAPGO_KEEP_0__ menghalangi permintaan-permintaan ini di /channel_self , dan

untuk mencegah lalu lintas yang berasal dari penyedia dari dianggap sebagai lalu lintas perangkat.

• Pemecahan Masalah
• Reproduksi update dari perangkat fisik di jaringan pengguna normal.
• Tidak menggunakan probe yang di-host di cloud atau penyedia pusat data untuk cek updater, statistik, atau cek channel-self sementara proteksi ini aktif. Jika lalu lintas tersebut sengaja, buka tab Pengaturan Informasi Block penyedia infrastruktur permintaan. Aktifkan kembali saat tes selesai.

New aplikasi memiliki perlindungan ini diaktifkan secara default. Aplikasi yang dibuat sebelum pengaturan diperkenalkan tetap dinonaktifkan sampai Anda mengaktifkannya.

Detail respons

• /updates mengawetkan kontrak respons pembaruan dan mengembalikan HTTP 200. Tubuhnya mencakup error, message, kind: "blocked", dan provider ("google" , atau "apple").
• /stats atau /channel_self dan 429 with the same error code. Treat this as an intentional policy block, not a transient retry condition.

disable_auto_update_to_major

Masalah Umum

Penyebabdisable_auto_update = majorSalah satu saluran Anda menghalangi pembaruan besar-besaran (

) dan versi target bundle besar-besaran lebih tinggi dari versi dasar perangkat.

version: 1.0.8 Gejala Umum old: 0.0.0 artinya perangkat melaporkan versi dasar 0.0.0sehingga pembaruan besar-besaran ditolak.

Bagaimana Membaca Ini

Backend membandingkan versi besar menggunakan versi dasar perangkat old dan target version.

• Jika target adalah 1.0.1versi dasar besar harusnya adalah 1 (contoh, contohnya) 1.0.0).
• Jika target adalah 10.0.1, harusnya baseline major adalah 10 (contoh, contohnya) 10.0.0).

Opsi perbaikan A (direkomendasikan): sesuaikan baseline major perangkat

Tetapkan plugins.CapacitorUpdater.version dalam capacitor.config.* sehingga MAJOR mengacu pada MAJOR yang ingin Anda kirimkan (contoh, contohnya) 1.0.0 untuk 1.0.1, 10.0.0 untuk 10.0.1).

Lalu aplikasikan konfigurasi ini ke aplikasi yang terpasang sekali:

1. Jalankan npx cap sync.
2. Rebuild dan pasang kembali aplikasi native.

Pilihan B: lembagai kebijakan saluran

Izinkan pembaruan otomatis lintas-maor di pengaturan saluran (hanya jika strategi perluasan itu sengaja).

Dokumen terkait:

• Target Versi: Nonaktifkan Pembaruan Otomatis di Antara Versi Utama
• Saluran: Nonaktifkan Strategi Pembaruan Otomatis

disable_auto_update_to_minor / disable_auto_update_to_patch

Penyebab:

Kebijakan saluran lebih ketat (minor atau patchlebih besar daripada update yang ditawarkan.

• minor mengalami masalah ketika target bundle memiliki versi mayor atau minor yang berbeda dengan versi native perangkat (version_buildContoh: 1.2.3 -> 1.3.0 diblokir.
• patch menghalangi perubahan nomor mayor, minor, atau patch apa pun dari version_buildHanya perubahan sufiks yang diizinkan sementara MAJOR.MINOR.PATCH tetap identik, seperti 1.0.0-beta.1 -> 1.0.0-beta.2 atau 1.0.0+build.1 -> 1.0.0+build.2.

pertanyaan alternatif.

• Perbaiki
• change channel policy in dashboard/CLI.

Ganti kebijakan channel di dashboard/__CAPGO_KEEP_0__.

• Saluran: Nonaktifkan Strategi Perbarui Otomatis

disable_auto_update_to_metadata

Penyebab

Saluran menggunakan target berdasarkan metadata (version_number) dan garis dasar perangkat di bawah yang diperlukan min_update_version.

Pemecahan Masalah

• Sinkronkan garis dasar perangkat (CapacitorUpdater.version) dengan versi aplikasi native yang terpasang, atau
• atur min_update_version Strategi saluran.

Referensi Dokumen terkait:

• Saluran: Nonaktifkan Strategi Perbarui Otomatis

disable_auto_update_under_native

Pemicu

Saluran mencegah penurunan di bawah garis dasar asli.

Pemecahan Masalah

• Unggah versi bundle yang sama atau lebih tinggi dari garis dasar asli, atau
• nonaktifkan perlindungan penurunan di bawah asli untuk saluran tersebut.

Referensi Dokumen terkait:

• Pengaturan Versi: Pencegahan Penurunan Otomatis

cannot_update_via_private_channel

Pemicu

Saluran yang dipilih/default tidak memungkinkan pengasasan perangkat sendiri.

Pemecahan Masalah

• Gunakan saluran yang berbeda dengan pengaturan penugasan sendiri diaktifkan, atau
• buat saluran publik / diaktifkan pengaturan penugasan sendiri.

Referensi terkait:

• Saluran: Menggunakan setChannel() dari Aplikasi Anda

unknown_version_build / semver_error

Penyebab

Versi dasar perangkat hilang (“unknown) atau tidak Solusi.

Set

• ke plugins.CapacitorUpdater.version versi dasar perangkat yang tepat. versi semver yang valid seperti 1.2.3.
• Sync dan membangun aplikasi native.

Referensi dokumen terkait:

• Saluran: Versi Paket dan Saluran
• Pengaturan Masalah: Pembaruan tidak berlaku

unsupported_plugin_version

Penyebab

Versi plugin Updater terlalu tua untuk persyaratan backend saat ini.

Pengaturan

• Perbarui @capgo/capacitor-updater.
• Jalankan npx cap sync.
• Rebuild dan reinstall aplikasi native.

disabled_platform_ios / disabled_platform_android

Penyebab

Saluran memiliki pembaruan diaktifkan untuk platform tersebut.

Solusi

• Aktifkan toggle platform pada saluran.

disable_prod_build / disable_dev_build / disable_device / disable_emulator

Penyebab

Saluran melarang jenis build atau target runtime saat ini.

Solusi

• Pastikan pengaturan saluran sesuai dengan target uji Anda.allow_prod, allow_dev, allow_device, allow_emulatorJudul bagian “disabled_platform_ios / disabled_platform_android”

key_id_mismatch

Pemicu

Kunci enkripsi bundle dan kunci perangkat berbeda.

Pemecahan Masalah

• Gunakan kunci enkripsi yang sama/kunci publik di seluruh konfigurasi aplikasi dan alur kerja enkripsi bundle.

no_channel / null_channel_data

Pemicu

Tidak ada saluran yang valid ditentukan untuk perangkat.

Pemecahan Masalah

• Setel saluran default di awan, atau
• setel defaultChannel di build uji, atau
• atur saluran override untuk perangkat.

Rujukan dokumen terkait:

• Saluran

on_premise_app

Capgo fitur saluran rilis nama. Halaman/area: Halaman pemasaran solusi Capgo. Peran: Label UI singkat atau item navigasi. Dilihat di: halaman solusi/white-label.astro. Pesan kunci `solutions_white_label_visual_cell2_value` (Solutions White Label Visual Cell2 Value).

Bagian berjudul “on_premise_app” on_premise_appPemicu

1. App ID does not exist in Capgo . Hal ini terjadi dalam tiga situasi: app_id ID Aplikasi tidak ada di __CAPGO_KEEP_0__
2. — saluran __CAPGO_KEEP_0__ yang dikirimkan oleh perangkat tidak terdaftar, sehingga backend tidak memiliki catatan tentangnya. — the app exists but is configured for self-hosted updates, so the Capgo cloud endpoint refuses to serve it.
3. Rencana organisasi dibatalkan — organisasi aplikasi tidak lagi memiliki langganan aktif.

Kesalahan umum

Kesalahan ketik di plugins.CapacitorUpdater.appId (di capacitor.config.ts) atau tidak sesuai dengan ID aplikasi yang terdaftar di dashboard Capgo. Backend tidak dapat membedakan “aplikasi tidak dikenal” dari “aplikasi on-premise”, sehingga mengembalikan kesalahan yang sama code.

Pemecahan masalah

• Periksa apakah app_id cocok dengan yang ditampilkan di dashboard Capgo (sensitif kasus).
• Jika aplikasi belum terdaftar, jalankan npx @capgo/cli@latest app add.
• Jika aplikasi sengaja on-premise, atur plugins.CapacitorUpdater.updateUrl ke endpoint update self-hosted Anda sendiri daripada URL cloud Capgo.
• Jika rencana organisasi telah berakhir, perbarui atau tingkatkan rencana.

Daftar checklist diagnostik cepat

1. Pastikan ID aplikasi dan saluran sudah benar untuk versi build.
2. Konfirmasi CapacitorUpdater.version cocok dengan versi aplikasi native yang terpasang.
3. Konfirmasi kebijakan saluran (“disable_auto_update) sesuai dengan rencana peluncuran yang diinginkan.
4. Konfirmasi pengaturan platform/target build memungkinkan perangkat ini.
5. Jalankan npx @capgo/cli@latest app debug dan baca kesalahan backend code.

Membutuhkan bantuan lebih lanjut?

• Pengaturan Masalah
• context

Panduan Mendapatkan Bantuan

Bagian berjudul “Teruskan dari Masalah Pembaruan Umum” Jika Anda menggunakan Masalah Pembaruan Umum Using @capgo/capacitor-updater Menggunakan @capgo/capacitor-updater untuk kemampuan native di Menggunakan @Capgo/__CAPGO_KEEP_1__-updater, Capgo Direktori Plugin Capacitor Plugin oleh Capgo untuk detail implementasi di Capacitor Plugin oleh Capgo Menambahkan atau Mengupdate Plugin untuk detail implementasi di Menambahkan atau Mengupdate Plugin, dan Alternatif Plugin Enterprise Ionic untuk alur kerja produk di Alternatif Plugin Enterprise Ionic.