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 ‘Saluran’ pada halaman saluran), saluran itu selalu menang. Petaan paksa adalah pengaturan console/__CAPGO_KEEP_0__. Perangkat 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 dan pengaturan API yang telah berlalu.
2. Oversai Cloud (Dashboard atau Publik API): Mengubah saluran perangkat di dashboard atau melalui Publik API menuliskan override yang terkait dengan ID perangkat tersebut. Menginstal ulang aplikasi tidak tidak menghapusnya; menghapus override tersebut. Retensi 90 hari yang sama berlaku.
3. Plugin setChannel() (local): Pada versi plugin saat ini, setChannel() menyimpan saluran pada perangkat setelah validasi backend. Ini bukan override dashboard. Menginstal ulang aplikasi menghapusnya; aplikasi harus memanggil setChannel() lagi jika Anda masih ingin saluran tersebut.
4. Capacitor konfigurasi (bentuk uji default) defaultChannel : Untuk build internal / beta / uji Anda dapatmengatur defaultChannel (kunci lama) channeldi capacitor.config.* sehingga perangkat uji mulai pada saluran pre-release (misalnya. beta, pr-123Jika tidak ada, perangkat akan melanjutkan ke default cloud. Pembangunan produksi biasanya meninggalkan ini tidak terdefinisi.
5. SALURAN DEFAULT CLOUD (strategi utama untuk ~99% pengguna): Saluran produksi utama yang hampir semua pengguna nyata mendarat. Perangkat baru tanpa paksaan, tanpa pengaturan, tanpa konfigurasi, dan tanpa pengaturan lokal menggunakan ini. Mengubahnya akan mengeluarkan (atau mengembalikan) untuk semua orang dalam detik, tanpa binary baru. setChannel()Mengapa saluran default cloud adalah jalur utama: defaultChannel Rollout instan atau rollback tanpa membangun atau menerbitkan kembali biner native.

__CAPGO_KEEP_0__ __CAPGO_KEEP_0__ __CAPGO_KEEP_0__

• __CAPGO_KEEP_0__
• 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). Pengguna normal mengalir ke default cloud. Mengubah default channel cloud mempengaruhi perangkat baru yang:

• Tidak dipaksa
• Tidak sudah memiliki override cloud
• Jangan memiliki aplikasi yang ditentukan defaultChannel terdefinisi

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

Menggunakan kekuatan lain ke saluran lain (console atau Publik __CAPGO_KEEP_0__).

• Mengubah pengaturan awan di dashboard atau Publik API.
• Change the cloud override in the dashboard or Public API.
• Langkah 2 Migrasi Aplikasi setChannel() Penugasan lokal pada versi plugin saat ini.
• Hapus / arsip saluran yang mereka gunakan (kemudian mereka akan kembali melalui urutan keutamaan lagi pada 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.

Catatan: Mengatur

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

Judul bagian ‘Capacitor config example’

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 production, perangkat yang sudah ada di channel lain (melalui konfigurasi, override, atau paksa) TIDAK akan berpindah secara otomatis; hanya perangkat baru (atau mereka yang override/force Anda hapus) yang akan mengambilnya.

---

Menangani channel

Pertama-tama, mari kita lihat halaman channel. Anda dapat mengaksesnya dengan mengklik aplikasi Anda dan kemudian mengklik tab channel.

Membuat channel

Seperti yang Anda lihat, ada tombol plus di sudut kanan bawah. (1 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

Menghapus saluran dari aplikasi web, buka tab Saluran konteks: Fitur nama saluran Capgo. 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). tab untuk aplikasi Anda dan cari baris saluran. Di kolom Aksi tindakan kolom, klik ikon sampah, lalu klik

di dialog konfirmasi. 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 terkait Pratinjau Aplikasi Kunci organisasi dan aplikasi dapat menghapus secara atomik hanya saluran non publik pratinjau dan mengemasnya bersama dengan channel delete <preview-channel> <app-id> --delete-bundle. Kunci ini tidak dapat mengubah atau menghapus saluran default/main yang sudah ada, saluran pratinjau kunci lain, 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 Penggunaan
• Informasi: Channel settings listed below, plus progressive rollout and Test Update API.
• Perangkat: Forced mappings created from the console or Public API only. It does not list every device currently on the channel, and it does not list devices that used setChannel()Lihat Console and API overrides expire.
• RiwayatPengaturan Pratinjau
• Pengaturan Pratinjau: Tampilan awan dan native dari bundle yang terkait. Aktifkan tampilan awan bundle di Info Aplikasi terlebih dahulu.

Pengaturan Informasi

tetap di Info tab. Pengaturan muncul dalam urutan ini:

Pertama, Saluran Download Default adalah label status, bukan tombol. Aktif berarti saluran ini adalah default cloud untuk perangkat baru. Klik Manajemen di Pengaturan Aplikasi untuk mengubah default pada Pengaturan 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

Keenam adalah pengaturan Electron Ketujuh adalah pengaturan

Kedelapan adalah pengaturan Disable auto downgrade under native Pengaturan. Jika ini benar maka tidak akan mungkin untuk menurunkan versi asli dari versi native. Ini berarti jika Anda telah mengunggah versi ke toko aplikasi atau play store dan mencoba mengatur versi saluran ke maka update (penurunan) akan gagal. 1.2.0 Pengaturan ke enam adalah 1.1.0 Pengaturan ini cukup kompleks, dan Anda dapat mempelajari lebih lanjut tentangnya di

Pengaturan ketujuh adalah Disable auto updatePengaturan ini memilih apakah perangkat mengunduh zip penuh, delta file yang berubah, atau kedua-duanya. Lihat Paket Update

Pengaturan kedelapan adalah Update package Pengaturan ini jika benar maka akan memungkinkan build pengembangan untuk mengunduh update dari saluran ini. Jika tidak maka setiap permintaan update yang telah ditetapkan ke false akan ditolak. Ini lebih berguna untuk tujuan pengujian..

__CAPGO_KEEP_0__ Allow development build__CAPGO_KEEP_0__ prod __CAPGO_KEEP_0__

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

Ketiga belas adalah Allow Emulators. Jika ini salah, maka Capgo akan melarang setiap permintaan pembaruan yang datang dari emulator. Ini sangat berguna untuk tujuan tes.

Keempat belas adalah Allow physical devices. Jika ini salah, maka Capgo akan menolak permintaan pembaruan dari ponsel dan tablet nyata. Biarkan ini tetap aktif untuk saluran produksi.

Kelima belas adalah Allow devices to self dissociate/associate. Jika ini benar, maka metode setChannel akan tersedia. Jika ini disetel 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 memerlukan setidaknya satu platform (iOS atau Android), pembangunan produksi, perangkat fisik, dan entah menjadi saluran download default atau memungkinkan penggunaan perangkat untuk menetapkan saluran.

Kirim notifikasi perbarui

Setelah Anda mengubah bundle yang terkait, konsol dapat meminta untuk Kirim notifikasi pembaruan. Itu mengantrekan push diam sehingga perangkat di saluran memeriksa bundle baru sekarang. Konfigurasi kredit 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 dalam pemulihan itu, atur defaultChannel dalam konfigurasi Capacitor (bertahan setelah reinstall, perlu binary baru untuk mengubahnya) atau panggil setChannel() dari aplikasi (menghindari pemulihan 90 hari, tetapi reinstall menghapusnya sehingga aplikasi harus panggil setChannel() lagi).

Retensi override di tab Devices saluran. Peringatan yang sama muncul ketika Anda memaksa 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 pembaruan

Buka saluran dan tetap di tab Info tab. Paket pembaruan terdapat di daftar pengaturan, di bawah Nonaktifkan pembaruan otomatis.

Paket update 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 update. Tinggalkan Zip dan delta kecuali Anda perlu memaksa salah satu jenis.

Label di konsol	Nilai CLI / API	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 pembaruan hidup pertama, Capgo menyediakan zip dan delta lagi.
Hanya delta dari bawaan	delta_from_builtin	Hanya delta saat perangkat masih aktif di binary toko. Setelah pembaruan hidup pertama, Capgo menyediakan zip dan delta lagi.

Bawaan adalah aset web yang dikirimkan di dalam binary App Store atau Play Store, sebelum pembaruan Capgo apa pun. Gunakan mode ketika pembaruan pertama dari build toko harus zip-only atau delta-only, dan pembaruan lainnya dapat menggunakan kedua-duanya. from builtin __CAPGO_KEEP_0__ tidak akan memasangkan saluran 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__. Saluran 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 penampakan, promosikan target ke stabil, kembali ke versi sebelumnya, atau atur pause otomatis, kembali ke versi sebelumnya, atau notifikasi ketika signal kegagalan melebihi ambang batas.

Kontrol rollout progresif muncul di atas tab informasi saluran.

Baca Rollout Progressif sebelum mengaktifkan satu. Ini menjelaskan kelompok yang menempel, perubahan persentase yang aman, dan perilaku pause otomatis.

Lanjutkan dari Channel

Jika Anda menggunakan Saluran context":"Capgo fitur nama saluran rilis. 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 merencanakan routing saluran dan rollout yang dipersiapkan, hubungkannya dengan Saluran context":"Capgo fitur nama saluran rilis. 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 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.