Masalah Pembaruan Umum

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

Baca ini terlebih dahulu

• no_new_version_available adalah keadaan normal, bukan gagalan.
• 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

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 ini pada /channel_self , dan

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

• Pembetulan
• Reproduksi update dari perangkat fisik di jaringan pengguna normal.
• Tidak gunakan probe yang dihosting di cloud atau penyedia pusat data untuk cek pembaruan, statistik, atau cek kanal-self sementara proteksi ini diaktifkan. Jika lalu lintas itu sengaja, buka tab 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 memelihara 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 utama (disable_auto_update = major) dan versi utama bundle target lebih tinggi dari versi dasar perangkat.

Gejala Umum

version: 1.0.8 artinya perangkat melaporkan dasar old: 0.0.0 sehingga pembaruan utama ditolak. 0.0.0Bagaimana Membaca Ini

Backend membandingkan versi utama menggunakan dasar perangkat

dan target old Jika target adalah version.

• dasar utama harus versi utama 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).

Fix opsi A (direkomendasikan): sesuaikan baseline major perangkat

Tetapkan plugins.CapacitorUpdater.version dalam capacitor.config.* sehingga MAJOR MAJOR sesuai dengan bundle MAJOR yang ingin Anda kirim (contoh, misalnya) 1.0.0 untuk 1.0.1, 10.0.0 untuk 10.0.1).

Kemudian aplikasikan konfigurasi ini ke aplikasi yang telah diinstal sekali:

1. Jalankan npx cap sync.
2. Rebuild dan reinstall aplikasi native.

Opsi perbaikan B: lembagikan kebijakan saluran

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

Referensi dokumen terkait:

• Pengaturan 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 baseline perangkat asli (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.

context: Fragment teks HTML dari string UI Capgo yang lebih panjang (kunci induk `alternatives_cta_questions`). Halaman/area: Halaman perbandingan update hidup Capacitor. Peran: Paragraf pemasaran atau hukum yang panjang. Dilihat di: halaman alternatives.astro. Simpanlah istilah produk/brand dan istilah pengembang Capgo secara tepat. Kunci pesan `alternatives_cta_questions` (Pertanyaan Tindakan Alternatif). | Fragment teks HTML dari string UI Capgo yang lebih panjang (kunci induk `appflow_cta_questions`). Halaman/area: Halaman perbandingan/migrasi pemasaran Appflow. Peran: Paragraf pemasaran atau hukum yang panjang. Dilihat di: halaman ionic-appflow.astro. Simpanlah istilah produk/brand dan istilah pengembang Capgo secara tepat. Kunci pesan `appflow_cta_questions` (Pertanyaan Tindakan Appflow). | Fragment teks HTML dari string UI Capgo yang lebih panjang (kunci induk `capwesome_cta_questions`). Halaman/area: Halaman perbandingan Capawesome. Peran: Paragraf pemasaran atau hukum yang panjang. Dilihat di: halaman capwesome.astro. Simpanlah istilah produk/brand dan istilah pengembang Capgo secara tepat. Kunci pesan `capwesome_cta_questions` (Pertanyaan Tindakan Capwesome). | Fragment teks HTML dari string UI Capgo yang lebih panjang (kunci induk `consulting_faq_subtitle`). Halaman/area: Halaman layanan konsultasi. Peran: Judul atau tagline bagian. Dilihat di: halaman consulting.astro. Simpanlah istilah produk/brand dan istilah pengembang Capgo secara tepat. Kunci pesan `consulting_faq_subtitle` (Judul FAQ Konsultasi). | Halaman/area: Halaman perbandingan/migrasi pemasaran Appflow. Peran: Label UI singkat atau item navigasi. Dilihat di: halaman ionic-appflow.astro, halaman ionic-enterprise-plugins.astro, halaman solusi/ionic-enterprise-plugins.astro. Kunci pesan `appflow_plugins_or` (Appflow Plugins Atau).

• Pemecahan masalah
• change channel policy in dashboard/CLI.

Ganti kebijakan channel di dashboard/__CAPGO_KEEP_0__.

• Saluran: Nonaktifkan Strategi Perbarui Otomatis

disable_auto_update_to_metadata

Pemicu

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

Pemecahan Masalah

• Sinkronkan garis dasar perangkat (“)CapacitorUpdater.versiondengan versi aplikasi asli 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.

Solusi

• Unggah versi bundle yang sama atau lebih besar 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 pengasosiasi perangkat sendiri.

Solusi

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

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 yang tepat. versi semver yang valid seperti 1.2.3.
• Sync dan bangun aplikasi native kembali.

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 reinstall aplikasi native.

disabled_platform_ios / disabled_platform_android

Penyebab

Saluran memiliki pembaruan di nonaktifkan untuk platform tersebut.

Solusi

• Nonaktifkan toggle platform pada saluran.

disable_prod_build / disable_dev_build / disable_device / disable_emulator

Penyebab

Saluran melarang jenis build saat ini atau target waktu eksekusi.

Solusi

• Jalankan opsi saluran (allow_prod, allow_dev, allow_device, allow_emulator) sesuai dengan target uji Anda.

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 diresolusi 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

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. 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 secara persis 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, silakan memperbarui atau meningkatkan rencana.

Daftar checklist diagnostik cepat

1. Pastikan ID aplikasi dan saluran sudah benar untuk versi build ini.
2. Konfirmasi CapacitorUpdater.version sesuai dengan versi aplikasi native yang terpasang.
3. Konfirmasi kebijakan saluran (“disable_auto_update) sesuai dengan rencana peluncuran yang diinginkan.
4. Pastikan toggle target platform/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

Lanjutkan dari Masalah Pembaruan Umum

Jika Anda menggunakan Masalah Pembaruan Umum Untuk merencanakan pekerjaan plugin asli, hubungkannya dengan Menggunakan @capgo/capacitor-updater untuk kemampuan asli dalam Menggunakan @capgo/capacitor-updater, Capgo Direktori Plugin untuk alur kerja produk dalam 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.