Channel

How Capgo chooses a channel (precedence)

Saat perangkat meminta pembaruan dari Capgo, saluran yang akan digunakan ditentukan dalam urutan berikut (prioritas tertinggi terlebih dahulu):

1. Pengaturan perangkat paksa: Jika ID perangkat secara eksplisit dipaksa ke saluran (lihat pengaturan saluran untuk daftar perangkat paksa), saluran tersebut selalu menang. Tambahan saluran di Cloud (dibuat oleh atau aksi Webapp)
2. : Menggunakan setChannel() (atau mengubah saluran perangkat di dashboard) menulis override persisten di cloud yang terkait dengan ID perangkat tersebut. Override tersebut dipertimbangkan setelah pengaturan paksa tetapi sebelum default apa pun. Menginstal ulang aplikasi tidakmenghapusnya; menghapus entri perangkat tidak. setChannel Forced devices list inside the channel settings Cloud override (created by
3. Capacitor konfigurasi defaultChannel (test build default): Untuk build internal / beta / test, Anda dapat menetapkan defaultChannel (kunci lama channel) di capacitor.config.* sehingga perangkat uji mulai pada saluran pre-release (misalnya, beta, pr-123). Jika tidak ada, perangkat akan melanjutkan ke default cloud. Build produksi biasanya meninggalkan ini tidak diatur.
4. Saluran Default Cloud (strategi utama untuk ~99% pengguna): Saluran produksi utama yang hampir semua pengguna nyata mendaratkan. Apapun perangkat baru tanpa paksa, tanpa override, dan tanpa konfigurasi defaultChannel menggunakan ini. Mengubahnya mengeluarkan (atau mengembalikan) untuk semua dalam detik—tidak ada binary baru.

Mengapa default cloud is the main path:

• Pengalihan Instan atau rollback tanpa harus 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). Pengguna normal mengalir ke default cloud.

Mengubah default cloud saluran akan mempengaruhi perangkat baru normal yang:

• Tidak dipaksa
• Tidak sudah memiliki pengaturan awan override
• Tidak memiliki pengaturan aplikasi defaultChannel ditentukan

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

Perangkat tetap pada saluran saat ini kecuali Anda:

• Memaksa mereka ke saluran lain.
• Menghubungi setChannel() (mengatur/mengganti pengaturan cloud) atau ubah secara manual di dashboard.
• Hapus/arsipkan saluran yang mereka gunakan (kemudian mereka akan kembali melalui urutan prioritas lagi pada saat cek berikutnya).

Jika sebuah saluran dinonaktifkan untuk sebuah platform (lihat toggle iOS / Android / Electron) dan akan dipilih lain kali, maka pilihan melompatinya 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;

Jika Anda kemudian mengubah default dashboard ke production, perangkat yang sudah menggunakan saluran lain (melalui konfigurasi, override, atau paksa) TIDAK akan berpindah secara otomatis; hanya perangkat baru (atau mereka yang override/force Anda hapus) yang mengambilnya.

---

Mengelola saluran

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

Membuat saluran

Seperti yang Anda lihat, ada tombol plus di sudut kanan bawah. (1 dalam gambar) Mengklik tombol tersebut akan membuka modal di mana Anda dapat membuat saluran baru.

Setelah itu, Anda mengklik Add Sebuah saluran baru harus muncul dalam daftar.

Apa itu tidak terkonfigurasi?

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

Menghapus saluran

Menghapus saluran sangatlah sederhana. Cukup klik pada ikon sampah dan konfirmasi penghapusan. (2 dalam gambar)

Menangani sebuah saluran

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

Halaman pengaturan saluran berisi semua opsi pengaturan untuk saluran Anda. Mari kita bahas setiap pengaturan.

---

Pertama kali Default channel toggle. 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 Pengaturan Saluran Default Kedua pengaturan

---

ini. Ini cukup sederhana. Jika ini salah, maka perangkat iOS tidak akan diizinkan untuk mengunduh pembaruan dari saluran ini. IOS __CAPGO_KEEP_0__

Ketiga adalah pengaturan. Ini mirip dengan Android . Jika ini salah maka perangkat Android tidak akan diizinkan untuk mengunduh pembaruan dari saluran ini. IOSKeempat adalah pengaturan. Ini mirip dengan

dan Electron . Jika ini salah maka aplikasi Electron tidak akan diizinkan untuk mengunduh pembaruan dari saluran ini. IOS Kelima adalah pengaturan. Jika ini benar maka tidak akan mungkin untuk menurunkan versi asli. Ini berarti jika Anda telah mengunggah versi Androidke toko aplikasi atau toko play dan mencoba untuk mengatur versi saluran ke

maka pembaruan (penurunan) akan gagal. Disable auto downgrade under native Keenam adalah pengaturan. 1.2.0 __CAPGO_KEEP_0__ 1.1.0 __CAPGO_KEEP_1__

__CAPGO_KEEP_2__ Disable auto update. Pengaturan ini cukup kompleks, dan Anda dapat mempelajari lebih lanjut tentangnya di sini

Untuk itu Allow development build. Jika ini benar maka pembangunan akan memungkinkan untuk mengunduh pembaruan dari saluran ini. Jika tidak maka setiap permintaan pembaruan yang memiliki prod dihentikan akan ditolak. Ini lebih berguna untuk tujuan pengujian.

Kedelapan adalah Allow Emulators. Jika ini salah maka Capgo akan melarang setiap permintaan pembaruan yang berasal dari emulator. Ini lebih berguna untuk tujuan pengujian.

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

Lanjutkan dari Saluran

Jika Anda menggunakan Saluran untuk merencanakan routing saluran dan peluncuran rolut, 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 dengan Satu ID Aplikasi Mobile untuk konteks praktis di Capgo Praktik Terbaik Lingkungan: Pengujian dengan Satu ID Aplikasi Mobile.