Masalah Pembaruan Umum

Ketika cek update gagal, Capgo biasanya mengembalikan sebuah Capgo dan sebuah error code dan sebuah message di dalam /updates respons. Halaman ini menjelaskan gagalannya yang paling umum dan perbaikan yang paling cepat.

Baca ini terlebih dahulu

• no_new_version_available adalah keadaan normal, bukan gagal.
• Banyak laporan “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 Gagal umum

Judul bagian “Gagal umum”

provider_infrastructure_request_blocked

Penyebab

Aplikasi Anda telah Mengaktifkan infrastruktur permintaan penyedia dan permintaan asal dari rentang alamat IP pusat data Google atau Apple yang dikenal. __CAPGO_KEEP_0__ menghalangi permintaan-permintaan ini di enabled and the request originated from a known Google or Apple datacenter IP range. Capgo blocks these requests on /updates, /statsuntuk mencegah lalu lintas yang berasal dari penyedia dari dianggap sebagai lalu lintas perangkat. /channel_self Pembetulan

Reproduksi update dari perangkat fisik di jaringan pengguna normal.

• Tidak menggunakan probe yang di-host di cloud atau penyedia pusat data untuk memeriksa pembaruan, statistik, atau cek kanal-self sementara proteksi ini diaktifkan.
• Jika lalu lintas tersebut sengaja, buka tab
• Pengaturan dan matikan Informasi Block penyedia infrastruktur permintaan. Aktifkan kembali ketika tes selesai.

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

Detail respons

• /updates mengembalikan kontrak respons pembaruan dan mengembalikan HTTP 200. Tubuhnya termasuk 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

Salah satu penyebabnya adalah saluran Anda menghalangi pembaruan besar-besaran (disable_auto_update = major) dan versi besar target bundle melebihi versi dasar perangkat.

Gejala Umum

version: 1.0.8 artinya perangkat melaporkan dasar old: 0.0.0 , sehingga pembaruan besar-besaran ditolak. 0.0.0Bagaimana Membaca Ini

Di belakang, backend membandingkan versi besar menggunakan dasar perangkat dan target

dan old Jika target adalah version.

• maka versi besar dasar harus 1.0.1__CAPGO_KEEP_0__ 1 Contoh (misalnya) 1.0.0).
• Jika target adalah 10.0.1, harusnya baseline major adalah 10 Contoh (misalnya) 10.0.0).

Opsi A (direkomendasikan): sesuaikan baseline major perangkat

Setel plugins.CapacitorUpdater.version di capacitor.config.* sehingga MAJOR menyamai MAJOR yang Anda inginkan untuk mengirimkan (misalnya) 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 reinstall aplikasi native.

Pilihan B: Longgarkan 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 menghalangi ketika bundle target memiliki versi mayor atau minor yang berbeda dengan baseline 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 sama, 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_numberdan garis dasar perangkat di bawah yang diperlukan (“) min_update_version.

Pembetulan

• Sinkronkan garis dasar perangkat (“)CapacitorUpdater.versiondengan versi aplikasi asli yang terpasang, atau
• atur (“) min_update_version strategi saluran.

Referensi terkait:

• Saluran: Nonaktifkan Strategi Perbarui Otomatis

disable_auto_update_under_native

Pemicu

Saluran mencegah penurunan di bawah garis dasar asli.

Pemecahan Masalah

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

Referensi Dokumen terkait:

• Target Versi: Pencegahan Penurunan Otomatis

cannot_update_via_private_channel

Pemicu

Saluran yang dipilih/default tidak memungkinkan perubahan pengasosiasi perangkat.

Pemecahan Masalah

• Gunakan saluran yang berbeda dengan pengaturan self-assignment diaktifkan, atau
• buat saluran menjadi publik / diaktifkan self-assignment.

Referensi dokumen 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 versi semver yang valid seperti 1.2.3.
• Sync dan membangun aplikasi native.

Referensi dokumen terkait:

• Saluran: Pengaturan Versi 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 instal ulang aplikasi native.

disabled_platform_ios / disabled_platform_android

Penyebab

Saluran memiliki pembaruan diaktifkan untuk platform tersebut.

Solusi

• Nonaktifkan 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 opsi saluran sesuai dengan target uji Anda.allow_prod, allow_dev, allow_device, allow_emulatorTetapkan saluran untuk memenuhi target uji Anda.

key_id_mismatch

Pemicu

Kunci enkripsi paket dan kunci perangkat berbeda.

Pemecahan Masalah

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

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 bangun uji, atau
• atur saluran override untuk perangkat.

Rujukan dokumen terkait:

• Saluran

on_premise_app

Saluran Capgo fitur nama. Halaman/area: Halaman pemasaran solusi Capgo. Peran: Label UI singkat atau item navigasi. Dilihat di: halaman solusi/white-label.astro. Kunci pesan `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. — pesan yang — 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 apa yang ditampilkan di dashboard Capgo (sensitif kasus).
• Jika aplikasi belum terdaftar, jalankan npx @capgo/cli@latest app add.
• Jika aplikasi sengaja di-host sendiri, atur plugins.CapacitorUpdater.updateUrl ke endpoint update self-hosted Anda sendiri bukan URL cloud Capgo.
• Jika rencana organisasi telah kedaluwarsa, ulangi atau tingkatkan rencana.

Daftar pemeriksaan cepat

1. Pastikan ID aplikasi dan saluran sudah benar untuk 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
• Bagaimana Mendapatkan Bantuan

Teruskan dari Masalah Pembaruan Umum

Jika Anda Menggunakan Masalah Pembaruan Umum Menggunakan @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-updater Menggunakan @capgo/capacitor-updater untuk kemampuan native di Menggunakan @capgo/capacitor-updater, for the native capability in Using @capgo/capacitor-updater, Menggunakan @Capgo/__CAPGO_KEEP_1__-updater untuk alur kerja produk di Capgo Direktori Plugin, for the product workflow in Capgo Plugin Directory, Capacitor Aplikasi oleh Capgo untuk detail implementasi di Capacitor Aplikasi oleh Capgo Menambahkan atau Mengupdate Aplikasi untuk detail implementasi di Menambahkan atau Mengupdate Aplikasi, dan Alternatif Aplikasi Enterprise Ionic untuk alur kerja produk di Alternatif Aplikasi Enterprise Ionic.