Channel

Bagaimana Capgo memilih saluran (prioritas)

Ketika perangkat meminta Capgo untuk memperbarui, saluran yang akan digunakan diputuskan dalam urutan berikut (prioritas tertinggi terlebih dahulu):

1. Petaan perangkat yang dipaksaJika ID perangkat secara eksplisit dipaksa ke saluran (tab perangkat pada halaman saluran), saluran itu selalu menang. Petaan paksa adalah console/__CAPGO_KEEP_0__ override. __CAPGO_KEEP_1__ menghapusnya 90 hari setelah tulisan override terakhir. Lihat Konsol dan __CAPGO_KEEP_0__ override yang berakhir tab on the channel page), that channel always wins. Forced mappings are console/API overrides. Capgo removes them 90 days after the last override write. See Console and API overrides expire.
2. Oversai Cloud (Dashboard atau Publik API): Mengubah saluran perangkat di dashboard atau melalui Publik API akan menulis pengaturan yang terkait dengan ID perangkat tersebut. Menginstal ulang aplikasi tidak akan menghapusnya; menghapus pengaturan akan menghapusnya. Retensi 90 hari tetap berlaku. Plugin (local)
3. : Pada versi plugin saat ini, setChannel() mengsimpan saluran di perangkat setelah validasi backend. Ini bukan pengaturan dashboard. Menginstal ulang aplikasi akan menghapusnya; aplikasi harus memanggillagi jika Anda masih ingin saluran tersebut. setChannel() __CAPGO_KEEP_0__ konfigurasi (bahan uji default) setChannel() : Untuk build internal / beta / uji Anda dapat mengatur
4. Capacitor defaultChannel __CAPGO_KEEP_0____CAPGO_KEEP_0__ defaultChannel (kunci legasi) channeldi capacitor.config.* sehingga perangkat uji mulai pada saluran pre-release (misalnya) beta, pr-123. Jika tidak ada, perangkat akan melanjutkan ke default cloud. Pembangunan produksi biasanya meninggalkan ini tidak diatur.
5. SALURAN DEFAULT CLOUD (strategi utama untuk ~99% pengguna): Saluran produksi utama yang hampir semua pengguna nyata mendaratkan. Perangkat baru tanpa paksaan, tanpa pengaturan, tanpa konfigurasi setChannel(), dan tanpa konfigurasi defaultChannel menggunakan ini. Mengubahnya mengeluarkan (atau kembali) untuk semua orang dalam detik, tanpa binary baru.

Mengapa syaluran default adalah jalur utama:

• Rollout instan atau rollback tanpa membangun atau menerbitkan kembali biner native.
• Satu tempat untuk mengelola perilaku iOS, Android, dan Electron.
• Lebih aman: Anda dapat memastikan bahwa bundle ada dan pengaturan sudah benar sebelum mengganti default.
• Perubahan yang dapat diaudit (anggota tim dapat melihat siapa yang mengubah apa di antarmuka / log). Prinsip desain: Layer di atas (paksa / override / konfigurasi) adalah kecuali

(debug pengguna tunggal, QA switching, test build defaults). Aliran pengguna normal menuju default cloud. Mengubah default cloud akan mempengaruhi perangkat baru yang:

• Tidak dipaksa
• Tidak sudah memiliki override cloud
• Jangan memiliki aplikasi tingkat defaultChannel terdefinisi

Jika sebuah build uji coba dikirimkan bersama defaultChannel: 'beta' dan Anda kemudian mengubah default awan ke productionperangkat yang telah dimulai pada beta melalui konfigurasi tetap ada sampai penugasan prioritas lebih tinggi berlaku, atau sampai Anda mengirimkan biner tanpa defaultChannelMenghapus kekuatan, pengaturan awan, atau pengaturan lokal tidak menghapus nilai konfigurasi; fallback itu tetap sampai biner baru. setChannel() Perangkat tetap pada saluran mereka saat ini kecuali Anda:

Menggantinya ke saluran lain (konsol atau Publik __CAPGO_KEEP_0__).

• Mengubah pengaturan awan di dashboard atau Publik API.
• Change the cloud override in the dashboard or Public API.
• Pindahkan ke saluran lain (konsol atau Publik __CAPGO_KEEP_0__). setChannel() Penugasan lokal pada versi plugin saat ini.
• Hapus/arsipkan saluran yang mereka gunakan (kemudian mereka akan kembali melalui urutan keutamaan lagi pada saat cek berikutnya).
• Tunggu sampai override konsol/API berakhir setelah 90 hari.
• Reinstall aplikasi, yang menghapus penugasan lokal tapi tidak override konsol/__CAPGO_KEEP_0__. setChannel() assignment but not a console/API override.

Perlu diingat: Mengatur

berarti mengubahnya memerlukan binary baru; gunakan secara sengaja untuk tes/QA, bukan untuk kontrol produksi umum. defaultChannel Contoh konfigurasi __CAPGO_KEEP_0__

Judul bagian “Contoh konfigurasi Capacitor”

capacitor.config.ts

// Example: a TestFlight or internal QA build defaults to the beta channel.
const config = {
  plugins: {
    CapacitorUpdater: {
      defaultChannel: 'beta', // Test build default. Omit in production so users attach to cloud default.
      // legacy key: channel
    },
  },
};
export default config;

Jika Anda kemudian mengubah dashboard default ke productionManajemen saluran

---

Judul bagian “Manajemen saluran”

klik aplikasi Anda dan kemudian klik tab saluran Daftar saluran.

Judul bagian “Membuat saluran”

Daftar saluran1 Dengan mengekliknya, Anda akan membuka modal di mana Anda dapat membuat saluran baru.

Kemudian setelah Anda mengeklik pada Add Saluran baru harus muncul di daftar.

Apa itu tidak terkonfigurasi?

Sekaligus, konfigurasi saluran tidak valid. Dalam hal itu, Anda akan mendapatkan peringatan besar dan kolom akan mengatakan Misconfigured untuk satu atau lebih dari saluran. Anda dapat mengetahui lebih lanjut tentang hal ini Yes di sini Menghapus saluran

Menghapus saluran

Untuk menghapus saluran dari aplikasi web, buka tab Saluran konteks Capgo fitur nama saluran. 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` (Nilai Sel Visual Putih Label Solusi). untuk aplikasi Anda dan cari baris saluran. Di kolom Aksi tindakan

Hapus channel.delete permission for that app. Ask an organization or app admin to grant a role that can delete channels, or delete the channel with an API key that has permission:

npx @capgo/cli@latest channel delete <channel-name> <app-id>

Salah satu organisasi dan aplikasi yang terikat Penglihatan Aplikasi Kunci organisasi dan aplikasi dapat menghapus secara atomik hanya saluran non publik penglihatan dan mengemasnya yang dibuat bersamaan dengan channel delete <preview-channel> <app-id> --delete-bundle. Kunci ini tidak dapat mengubah atau menghapus saluran default/main yang ada, saluran kunci lain penglihatan, atau bundel kunci lain. Lihat API Kunci untuk pengaturan dengan hak istimewa yang paling sedikit.

Pengelolaan saluran

Klik nama saluran untuk membuka halaman saluran. Halaman ini adalah halaman penuh dengan tab, bukan modal.

Tab saluran

• DashboardStatistik Pengadopsian dan Instalasi Paket Saat Ini untuk Channel Ini
• InformasiChannel Pengaturan yang Terdaftar di Bawah Ini, Plus Pengaturan Perubahan dan Uji Coba API
• PerangkatPerangkat yang Dibuat dari Console atau Publik API Hanya. Ini Tidak Menampilkan Setiap Perangkat yang Saat Ini Berada di Channel Ini, dan Ini Tidak Menampilkan Perangkat yang Pernah Menggunakan setChannel()Console dan __CAPGO_KEEP_0__ Override Berakhir Console and API overrides expire.
• Perubahan Pengaturan dan Paket untuk Channel IniPengaturan Uji Coba
• Pengaturan Uji Coba: Tampilan awan dan native preview dari bundle yang terkait. Aktifkan preview bundle di Informasi Aplikasi terlebih dahulu.

Pengaturan Informasi

Tetap di Informasi tab. Pengaturan muncul dalam urutan ini:

Pertama, Saluran Download Default adalah label status, bukan toggle. aktif berarti saluran ini adalah default cloud untuk perangkat baru. Klik Pengaturan Aplikasi untuk mengubah default pada Informasi Aplikasi. Untuk default spesifik platform (satu untuk iOS, satu untuk Android, dan satu untuk Electron), lihat bagian yang sama.

Kedua adalah pengaturan. Jika ini salah maka perangkat iOS tidak akan diizinkan untuk mengunduh pembaruan dari saluran ini. IOS Ketiga adalah pengaturan. Jika ini salah maka perangkat Android tidak akan diizinkan untuk mengunduh pembaruan dari saluran ini.

Keempat adalah pengaturan. Jika ini salah maka aplikasi Electron tidak akan diizinkan untuk mengunduh pembaruan dari saluran ini. Android Kelima adalah pengaturan

Pengaturan Aplikasi Electron untuk mengubah default pada

Informasi Aplikasi Disable auto downgrade under native pengaturan. Jika ini benar maka tidak akan mungkin untuk menurunkan versi dari versi native. Ini berarti jika Anda telah mengunggah versi ke toko aplikasi atau play store dan mencoba mengatur versi saluran ke maka pembaruan (penurunan) akan gagal. 1.2.0 versi ke toko aplikasi atau play store dan mencoba mengatur versi saluran ke 1.1.0 maka pembaruan (penurunan) akan gagal.

Keenam adalah Disable auto updatepengaturan ini cukup kompleks, dan Anda dapat mempelajari lebih lanjut tentangnya di sini

Ketujuh adalah Update package pengaturan. Ini memilih apakah perangkat mengunduh zip penuh, delta file yang berubah, atau kedua-duanya. Lihat Paket pembaruan.

Kedelapan adalah Allow development buildpengaturan. Jika ini benar maka build pengembangan akan diizinkan untuk mengunduh pembaruan dari saluran ini. Jika tidak maka setiap permintaan pembaruan yang telah prod diatur ke false akan ditolak. Ini sangat berguna untuk tujuan pengujian.

Kedua belas adalah Allow production build. Jika ini salah maka bangun produksi (toko) tidak akan menerima pembaruan dari saluran ini. Biarkan ini aktif untuk saluran yang melayani pengguna nyata.

Ketiga belas adalah Allow Emulators. If this is false then Capgo will disallow any update request that comes from an emulator. This is mostly useful for testing purposes.

Keempat belas adalah Allow physical devices. If this is false then Capgo will reject update requests from real phones and tablets. Leave this on for production channels.

Kelima belas adalah Allow devices to self dissociate/associate. Jika ini benar maka metode setChannel akan tersedia. Jika ini diatur ke salah dan Anda mencoba memanggil setChannel dengan saluran ini maka panggilan akan gagal.

Uji Coba Perbarui API

Pada bagian bawah dari Informasi tab, ekspansi Uji Coba Perbarui API. Capgo menampilkan perintah curl terhadap /updates untuk perangkat contoh pada saluran ini.

Pengaturan dapat membutuhkan waktu hingga 60 detik untuk ditampilkan di API karena caching. Jika saluran tidak dapat diuji, konsol memberi peringatan: saluran membutuhkan setidaknya satu platform (iOS atau Android), produksi, perangkat fisik, dan entah menjadi saluran download default atau memungkinkan perangkat untuk menetapkan diri sendiri.

Kirim notifikasi perbarui

Setelah Anda mengubah bundle yang terkait, konsol dapat meminta Kirim notifikasi pembaruan. Itu mengantrekan push diam sehingga perangkat di saluran memeriksa bundle baru sekarang. Konfigurasi kunci push Android dan iOS di tab Notifikasi aplikasi terlebih dahulu.

Console dan API override kadaluarsa

Petaan paksa dan Dashboard/Public API saluran override dihapus 90 hari setelah tulisan override terakhir. Pemeriksaan perangkat terakhir tidak mengatur jam itu. Untuk pengaturan yang bertahan selama pembersihan itu, atur defaultChannel dalam konfigurasi Capacitor (bertahan selama reinstall, perlu binary baru untuk mengubahnya) atau panggil setChannel() dari aplikasi (menghindari pembersihan 90 hari, tetapi reinstall menghapusnya sehingga aplikasi harus panggil setChannel() lagi).

Retensi override di tab Devices saluran. Peringatan yang sama muncul ketika Anda paksa ID perangkat ke saluran.

ini berbeda dari penyimpanan inventori perangkat. Inventory menghapus perangkat yang belum terhubung ke Capgo selama 90 hari. Penghapusan yang diubah menghapus mappin bahkan jika perangkat masih aktif. Detail lengkap: Console dan API penghapusan diubah akan berakhir setelah 90 hari.

Paket Perbarui

Buka saluran dan tetap di Informasi tab. Paket Perbarui terdapat di daftar pengaturan, di bawah Nonaktifkan auto perbarui.

Perbarui paket di tab Informasi saluran. Saluran baru secara default menggunakan Zip dan delta.

Pengaturan ini memilih apa yang Capgo kirimkan ketika perangkat di saluran ini memeriksa pembaruan. Tinggalkan Zip dan delta kecuali Anda perlu memaksa salah satu jenis.

Label di konsol	CLI / API nilai	Apa yang perangkat download
Zip dan delta	all	Zip penuh dan delta ketika kedua ada. Ini adalah default.
Hanya Zip	zip	Hanya zip penuh.
Hanya delta	delta	Hanya file yang berubah. Plugin yang tidak dapat menerapkan delta masih menerima zip.
Hanya zip dari bawaan	zip_from_builtin	Hanya zip saat perangkat masih aktif di binary toko. Setelah live update pertama, Capgo menyajikan zip dan delta lagi.
Hanya delta dari bawaan	delta_from_builtin	Hanya delta saat perangkat masih aktif di binary toko. Setelah live update pertama, Capgo menyajikan zip dan delta lagi.

Bawaan adalah aset web yang dikirimkan di dalam binary App Store atau Play Store sebelum ada Capgo update. Gunakan mode ini ketika update pertama dari build toko harus zip-only atau delta-only, dan update lainnya dapat menggunakan kedua-duanya. from builtin mode ini akan tidak memasangkan channel zip-only dengan bundle delta-only, atau sebaliknya. Console, __CAPGO_KEEP_1__, dan

Capgo will not pair a zip-only channel with a delta-only bundle, or the reverse. The console, CLI, and Channels API Anda dapat mengatur nilai yang sama dari __CAPGO_KEEP_0__. Channel harus sudah ada:

CLI

npx @capgo/cli@latest channel set production com.example.app --update-package zip

Nilai-nilai yang valid: all, zip, delta, zip_from_builtin, delta_from_builtin.

Rollout progresif

Saluran ini Informasi Tab informasi ini termasuk Rollout Progresif Bagian. Tetapkan bundle target, pilih persentase dan durasi cache keputusan, kemudian aktifkan rollout. Dari bagian yang sama Anda dapat menghentikan atau melanjutkan pengecapan, mempromosikan target ke stabil, mengembalikannya, atau mengkonfigurasi penghentian otomatis, pengembalian, atau pemberitahuan ketika signal kegagalan melewati ambang batas.

Kontrol rollout progresif muncul di atas tab informasi saluran.

Read Beralih ke rollouts progresif Sebelum mengaktifkan satu. Ini menjelaskan kelompok yang menempel, perubahan persentase yang aman, dan perilaku pause otomatis.

Teruskan dari Channel

Jika Anda menggunakan Saluran context Untuk merencanakan routing saluran dan peluncuran yang dipersiapkan, hubungkannya dengan Saluran context Untuk detail implementasi di Saluran, Solusi Pengujian Beta untuk alur kerja produk di Solusi Pengujian Beta, Solusi Target Versi untuk alur kerja produk di Solusi Target Versi, dan Capgo Praktik Terbaik Lingkungan: Pengujian Staging dengan Satu ID Aplikasi Mobile untuk konteks praktis di Capgo Praktik Terbaik Lingkungan: Pengujian Staging dengan Satu ID Aplikasi Mobile.