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 paksa: Jika ID perangkat secara eksplisit dipaksa ke saluran (lihat di Daftar perangkat paksa saluran pengaturan), saluran itu selalu menang.
2. Cloud override (dibuat oleh setChannel() atau aksi Webapp): Menghubungi setChannel (atau mengubah saluran perangkat di dashboard) menulis override persisten di cloud yang terkait dengan ID perangkat. Override tersebut dipertimbangkan setelah pemetaan paksa tetapi sebelum default apa pun. Menginstal ulang aplikasi tidak akan menghapusnya; menghapus entri perangkat tidak akan menghapusnya. __CAPGO_KEEP_0__ Konfigurasi (versi uji default)
3. Capacitor config defaultChannel (kunci lama) di defaultChannel sehingga perangkat uji akan memulai pada saluran pre-release (misalnya, channel). Jika tidak ada, perangkat akan melanjutkan ke default cloud. Build produksi biasanya tidak mengatur ini. capacitor.config.* Saluran Default Cloud (strategi utama untuk ~99% pengguna) beta, pr-123: Saluran produksi utama di mana pengguna nyata hampir semua berada. Perangkat baru tanpa paksa, tanpa override, dan tanpa konfigurasi akan melanjutkan ke default cloud.
4. Saluran Default Cloud (strategi utama untuk ~99% pengguna): Saluran produksi utama di mana pengguna nyata hampir semua berada. Perangkat baru tanpa paksa, tanpa override, dan tanpa konfigurasi akan melanjutkan ke default cloud. defaultChannel Menggunakan ini. Mengubahnya akan mengaktifkan (atau mengaktifkan kembali) untuk semua orang dalam beberapa detik—tidak ada binary baru.

Mengapa " cloud default " adalah jalur utama:

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

(debug pengguna tunggal, QA switching, test build defaults). Pengguna normal mengalir ke default cloud. Mengubah " pengaruh saluran baru perangkat normal yang:

• Tidak dipaksa
• Tidak sudah memiliki pengaturan awan yang diubah
• Tidak memiliki pengaturan aplikasi yang diubah defaultChannel ditentukan

Jika sebuah build uji dipasok dengan defaultChannel: 'beta' dan Anda kemudian mengubah default awan ke production, perangkat yang sudah mulai pada beta melalui konfigurasi tetap ada sampai Anda: (a) mengubahnya dengan setChannel(), (b) memaksa, atau (c) menghapus entri perangkat.

Perangkat tetap berada di saluran saat ini kecuali Anda:

• Kompak mereka ke saluran lain.
• Panggil setChannel() (membuat/mengganti pengaturan awan) atau ubah secara manual di dashboard.
• Hapus / arsip saluran yang mereka gunakan (kemudian mereka akan kembali melalui urutan keutamaan lagi pada saat cek berikutnya).

Jika suatu saluran dinonaktifkan untuk suatu platform (lihat toggle iOS / Android / Electron) dan akan lainnya dipilih, maka pilihan melewatinya dan kembali ke aturan berikutnya.

Catatan: Mengatur defaultChannel berarti mengubahnya memerlukan binary baru; gunakan secara sengaja untuk pengujian/QA, bukan untuk kontrol produksi umum.

Contoh konfigurasi Capacitor

capacitor.config.ts

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

If Anda kemudian mengubah dashboard default ke production, perangkat yang sudah berada di channel lain (melalui konfigurasi, override, atau force) 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 mengklik aplikasi Anda dan kemudian mengklik tab channel.

Membuat Channel

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

Setelah Anda klik di Add saluran baru harus muncul di daftar.

Apa itu tidak terkonfigurasi?

Sekali-kali konfigurasi saluran tidak valid. Dalam kasus 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

Klik di dalamnya untuk membuka modal di mana Anda dapat membuat saluran baru.

Untuk menghapus sebuah saluran dari aplikasi web, buka tab Saluran untuk aplikasi Anda dan cari baris saluran. Di kolom Aksi klik ikon sampah, lalu klik Hapus di dialog konfirmasi.

Jika ikon sampah tidak terlihat, akun Anda tidak memiliki izin untuk itu. Tanyakan kepada administrator organisasi atau aplikasi untuk memberikan peran yang dapat menghapus saluran, atau hapus saluran dengan kunci __CAPGO_KEEP_0__ yang memiliki izin: 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>

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

Pengelolaan Saluran

Mengklik nama saluran akan membuka modal di mana Anda dapat mengelola pengaturan saluran. (3 dalam gambar)

Halaman pengaturan saluran berisi semua pilihan pengaturan untuk saluran Anda.

---

Mari kita lalui setiap pengaturan. Default channel Pertama, pengaturan ini. Ketika diaktifkan, saluran ini menjadi saluran default untuk perangkat baru. Untuk penjelasan komprehensif tentang bagaimana saluran default bekerja, termasuk cara mengatur default platform khusus (satu untuk iOS, satu untuk Android, dan satu untuk Electron), lihat bagian Konfigurasi Saluran Default.

---

Kedua, pengaturan ini. IOS Pengaturan ini relatif sederhana. Jika ini salah, maka perangkat iOS tidak akan diizinkan untuk mengunduh pembaruan dari saluran ini.

Ketiga adalah pengaturan ini. Android Pengaturan ini mirip dengan IOSJika ini salah, maka perangkat Android tidak akan diizinkan untuk mengunduh pembaruan dari saluran ini.

Keempat adalah pengaturan ini. Electron Pengaturan ini mirip dengan IOS dan Android. Jika ini salah maka aplikasi Electron tidak akan diizinkan untuk mengunduh pembaruan dari saluran ini.

Kelima adalah pengaturan. Jika ini benar maka tidak akan mungkin untuk menurunkan versi asli. Artinya jika Anda telah mengunggah versi tertentu ke toko aplikasi atau toko aplikasi Play dan mencoba untuk mengatur versi saluran ke maka pembaruan (penurunan) akan gagal. Disable auto downgrade under native Keenam adalah pengaturan. Pengaturan ini cukup kompleks, dan Anda dapat mempelajari lebih lanjut tentang itu 1.2.0 di sini 1.1.0 Mengenai

. Jika ini benar maka aplikasi pengembangan akan diizinkan untuk mengunduh pembaruan dari saluran ini. Jika tidak maka setiap permintaan pembaruan yang memiliki nilai Disable auto updateditetapkan ke salah akan ditolak. Ini sangat berguna untuk tujuan pengujian. __CAPGO_KEEP_0__

__CAPGO_KEEP_0__ Allow development build__CAPGO_KEEP_0__ prod __CAPGO_KEEP_0__

Kedelapan adalah Allow Emulators. Jika ini salah, maka Capgo akan melarang permintaan update dari mana pun.

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

Rollout Langsung

Saluran Informasi tab termasuk sebuah Peluncuran progresif bagian. Tentukan sebuah bundle target, pilih persentase dan durasi cache keputusan, kemudian aktifkan peluncuran. Dari bagian yang sama Anda dapat menghentikan atau melanjutkan ekposur, promosikan target ke stabil, gulung kembali, atau atur penghentian otomatis, gulung kembali, atau pemberitahuan ketika signal kegagalan melewati ambang batas.

Peluncuran progresif mengontrol muncul di bagian atas tab Informasi saluran.

Baca Peluncuran progresif sebelum mengaktifkannya. Ini menjelaskan kelompok-kelompok yang menempel, perubahan persentase yang aman, dan perilaku penghentian otomatis.

Lanjutkan 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 Uji Coba Beta untuk alur kerja produk di Solusi Uji Coba Beta, Solusi Target Versi untuk alur kerja produk di Solusi Target Versi, dan Capgo Praktik Terbaik Lingkungan: Staging dengan Satu ID Aplikasi Mobile untuk konteks praktek di Capgo Praktik Terbaik Lingkungan: Staging dengan Satu ID Aplikasi Mobile.