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. Peta perangkat yang dipaksa: Jika ID perangkat secara eksplisit dipaksa ke saluran (tab Peralatan pada halaman saluran), saluran itu selalu menang. Peta perangkat yang dipaksa adalah console/API override. Capgo menghapusnya 90 hari setelah tulisan override terakhir. Lihat Console dan API override 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. Menginstal ulang aplikasi tidak tidak menghapusnya; menghapus override tersebut.
3. Plugin setChannel() (local): Pada versi plugin saat ini, setChannel() mengingatkan saluran pada perangkat setelah validasi backend. Ini bukanlah override dashboard. Menginstal ulang aplikasi menghapusnya; aplikasi harus memanggil setChannel() lagi jika Anda masih ingin saluran tersebut.
4. Capacitor konfigurasi (bahan uji default) defaultChannel : Untuk build internal / beta / uji Anda dapat mengaturPlugin (local) : Pada versi plugin saat ini, mengingatkan saluran pada perangkat setelah validasi backend. Ini bukanlah override dashboard. Menginstal ulang aplikasi menghapusnya; aplikasi harus memanggil lagi jika Anda masih ingin saluran tersebut. 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. Situs Default Cloud (strategi utama untuk ~99% pengguna): Saluran produksi utama yang hampir semua pengguna nyata mendaratkan. Perangkat baru tanpa paksaan, tanpa override, tanpa lokal setChannel(), dan tanpa konfigurasi defaultChannel menggunakan ini. Mengubahnya mengeluarkan (atau mengembalikan) untuk semua orang dalam detik, tanpa binary baru.

Mengapa situs 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 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 cloud akan mempengaruhi perangkat baru yang: Tidak dipaksa

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

Jika sebuah build uji coba dikirim 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 tersebut tetap ada sampai biner baru dikirim. setChannel() Perangkat tetap pada saluran saat ini kecuali Anda:

Menggantinya 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.
• context setChannel() Penugasan lokal pada versi plugin saat ini.
• Hapus / arsip 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.

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

---

Pengelolaan channel

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

Membuat channel

Seperti yang Anda lihat, ada tombol plus di sudut kanan bawah. (1 Klik pada gambar tersebut untuk membuka modal di mana Anda dapat membuat saluran baru.

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

Apa itu tidak terkonfigurasi?

Kadang-kadang 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

__CAPGO_KEEP_0__

Menghapus saluran dari aplikasi web, buka tab Saluran context untuk aplikasi Anda dan cari baris saluran. Di kolom Aksi Aksi Klik ikon sampah, lalu klik

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 channel yang terkait dengan organisasi dan aplikasi Penglihatan Aplikasi Kunci organisasi dan aplikasi dapat menghapus channel dan paket non publik secara atomik yang dibuat bersamaan dengan kunci tersebut. Namun, kunci tersebut tidak dapat mengubah atau menghapus channel utama/default atau channel milik kunci lainnya. Lihat channel delete <preview-channel> <app-id> --delete-bundle__CAPGO_KEEP_0__ Kunci API Keys Pengelolaan Channel

Judul bagian “Pengelolaan Channel”

Pengaturan Channel

Pengaturan Channel

• DashboardStatistik Penggunaan Saat Ini dan Instalasi untuk Channel Ini
• Informasi: Channel settings listed below, plus progressive rollout and Test Update API.
• Pengaturan Channel di bawah ini, plus Rilis Perlahan dan Uji Coba __CAPGO_KEEP_0__: 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()Perangkat yang Dibuat dari Console atau Public __CAPGO_KEEP_0__ Hanya. Ini tidak menampilkan setiap perangkat yang saat ini ada di Channel, dan tidak menampilkan perangkat yang pernah menggunakan Console and API overrides expire.
• Konfigurasi Console dan __CAPGO_KEEP_0__ akan BerakhirRiwayat
• Perubahan Pengaturan dan Paket untuk Channel Ini: Tampilan pratinjau di dalam browser dan native untuk bundle yang terkait. Aktifkan pratinjau bundle di Info Aplikasi terlebih dahulu.

Pengaturan Informasi

tetap di Tab Informasi 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 Pengaturan di 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

Kelima adalah pengaturan Electron Kelima adalah pengaturan

Kelima adalah pengaturan Disable auto downgrade under native Konfigurasi. 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 channel ke maka update (menurunkan) akan gagal. 1.2.0 Versi ke toko aplikasi atau play store dan mencoba mengatur versi channel ke 1.1.0 Keenam adalah

Konfigurasi ini cukup kompleks, dan Anda dapat mempelajari lebih lanjut tentangnya Disable auto updatedi sini Ketujuh adalah

Konfigurasi ini memilih apakah perangkat mengunduh zip penuh, delta file yang berubah, atau kedua-duanya. Lihat Update package Paket update Kedelapan adalah .

Konfigurasi ini. Jika ini benar maka build pengembangan akan diizinkan untuk mengunduh update dari channel ini. Jika tidak maka setiap permintaan update yang telah Allow development buildditetapkan ke false akan ditolak. Ini lebih berguna untuk tujuan pengujian. prod ditetapkan ke false akan ditolak.

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

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

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

Kelima belas adalah Allow devices to self dissociate/associate. Jika ini benar maka metode setChannel akan tersedia. Jika ini ditetapkan ke palsu dan Anda mencoba untuk 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 menugaskan diri sendiri.

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 kunci push Android dan iOS di tab Notifikasi aplikasi terlebih dahulu.

Console dan API pengaturan override kedaluwarsa

Pengaturan paksa dan Dashboard/Public API saluran override dihapus 90 hari setelah tulisan override terakhir. Pemeriksaan perangkat terakhir tidak mengatur ulang jam itu. Untuk pengaturan yang bertahan selama pembersihan itu, atur defaultChannel dalam konfigurasi Capacitor Anda (bertahan setelah 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. Notifikasi yang sama muncul ketika Anda memaksa ID perangkat ke saluran.

Hal ini terpisah dari penyimpanan inventori perangkatInventori menghapus perangkat yang tidak terhubung ke Capgo selama 90 hari. Penghapusan pengaturan menghapus mapean bahkan jika perangkat masih aktif. Detail lengkap: Console dan API pengaturan override akan berakhir setelah 90 hari.

Paket Perbarui

Buka saluran dan tetap di tab Informasi Paket Perbarui terdapat di daftar pengaturan, di bawah Nonaktifkan auto update. Pilihan Paket Perbarui di saluran __CAPGO_KEEP_0__ menampilkan Zip dan delta, Zip hanya, Delta hanya, Zip hanya dari bawaan, dan Delta hanya dari bawaan

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	Arsip zip lengkap dan delta ketika kedua ada. Ini adalah default.
Hanya Zip	zip	Hanya arsip zip.
Hanya delta	delta	Hanya file yang berubah.
Zip hanya dari bawaan.	zip_from_builtin	Zip hanya saat perangkat masih aktif di binary toko. Setelah live update pertama, Capgo menyajikan zip dan delta kembali.
Delta hanya dari bawaan.	delta_from_builtin	Delta hanya saat perangkat masih aktif di binary toko. Setelah live update pertama, Capgo menyajikan zip dan delta kembali.

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 selanjutnya dapat menggunakan kedua-duanya. from builtin mode ini tidak akan mempairkan 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 Informasi tab termasuk Rollout progresif bagian dengan Sasaran rollout dan __CAPGO_KEEP_0__ Kontrol Rilis Progresif di Saluran __CAPGO_KEEP_0__, Target Rilis yang Dapat Dibedakan, Aplikasikan Persentase, dan Aksi Rilis yang Selesai, Rilis yang Dibatalkan, Aktifkan Rilis, Matikan Rilis, Jeda Rilis, dan Mulai Rilis.

Kontrol pergeseran progresif muncul di bagian informasi saluran di atas.

Baca Pergeseran progresif Sebelum mengaktifkan salah satu. Panduan tersebut membahas routing unggah (Otomatis (direkomendasikan) / Target pergeseran / Ganti stabil; CLI --stable / API target: "stable" untuk menggantikan), Saluran ini menggunakan pergeseran progresif dialog tautan bundle, dan alur kerja aman dengan Amati dan Insight Log.

Teruskan dari Saluran

Jika Anda menggunakan Saluran untuk merencanakan routing saluran dan peluncuran tahap demi tahap, hubungkannya dengan Saluran untuk detail implementasi di Saluran, Saluran 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.