Saluran

How Capgo memilih saluran (prioritas)

Ketika perangkat meminta Capgo untuk memperbarui, saluran yang akan digunakan ditentukan 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. Tambahan saluran di Cloud (dibuat oleh setChannel() atau aksi Webapp): Menggunakan setChannel (atau mengubah saluran perangkat di dashboard) menulis override persisten di Cloud yang terkait dengan ID perangkat tersebut. Override tersebut dikonsultasikan setelah peta paksa tetapi sebelum default apa pun. Menginstal ulang aplikasi tidak __CAPGO_KEEP_0__ Hapusnya; menghapus entri perangkat melakukan.
3. Capacitor konfigurasi defaultChannel (build uji default): Untuk build internal / beta / uji Anda dapat mengatur defaultChannel (kunci lama channel) di capacitor.config.* sehingga perangkat uji mulai di 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 mendarat di. 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 adalah jalur utama:

• Rollout 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 mempengaruhi baru perangkat normal yang:

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

Jika sebuah build uji terbang bersama defaultChannel: 'beta' dan Anda kemudian mengubah default awan ke production, perangkat yang 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 mereka saat ini kecuali Anda:

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

Jika sebuah saluran dinonaktifkan untuk sebuah platform (lihat toggle iOS / Android / Electron) dan akan lainnya dipilih, 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, penggantian, atau paksa) TIDAK akan berpindah secara otomatis; hanya perangkat baru (atau mereka yang override/paksa Anda hapus) yang menangkapnya.

---

Menangani 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 di gambar) Mengklik tombol tersebut akan membuka modal di mana Anda dapat membuat saluran baru.

Setelah Anda klik pada Add Salah satu saluran baru harus muncul dalam daftar.

Apa itu tidak terkonfigurasi?

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

Bab yang berjudul “Menghapus saluran”

__CAPGO_KEEP_0__ Saluran tab untuk aplikasi Anda dan cari baris saluran. Di kolom Aksi tombol sampah, lalu klik Hapus di dialog konfirmasi.

Jika ikon sampah tidak terlihat, akun Anda tidak memiliki channel.delete izin untuk itu. Tanyakan kepada administrator organisasi atau aplikasi untuk memberikan peran yang dapat menghapus saluran, atau hapus saluran dengan kunci API yang memiliki izin:

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

Mengelola saluran

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

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

---

Pertama adalah Default channel toggle. Ketika diaktifkan, saluran ini menjadi 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), lihatlah Konfigurasi Saluran Default bagian.

---

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

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

Keempat adalah Electron pengaturan. Ini mirip dengan IOS dan AndroidJika ini salah, maka aplikasi Electron tidak akan diizinkan untuk mengunduh pembaruan dari saluran ini.

Kelima adalah Disable auto downgrade under native pengaturan. Jika ini benar, maka tidak akan mungkin untuk menurunkan versi asli. Artinya, jika Anda telah mengunggah versi 1.2.0 ke toko aplikasi atau play store dan mencoba untuk mengatur versi saluran ke 1.1.0 maka pembaruan (penurunan) akan gagal.

Keenam adalah Disable auto updatepengaturan. Pengaturan ini cukup kompleks, dan Anda dapat mempelajari lebih lanjut tentang hal ini di sini

Untuk 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 dipasang ke false akan ditolak. Ini sangat berguna untuk tujuan tes.

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

Sembilan adalah Allow devices to self associate. Jika ini benar maka dapat diakses. Jika ini dipasang ke false dan Anda mencoba untuk memanggil dengan saluran ini maka panggilan akan gagal. Dua belas adalah Jika ini benar maka

Teruskan dari Channel

Jika Anda menggunakan Channel untuk merencanakan routing channel dan rollout yang ditargetkan, hubungkannya dengan Channel untuk detail implementasi di Channel, Channel untuk detail implementasi di Channel, Pengujian Beta Solusi untuk alur kerja produk di Pengujian Beta Solusi, Solusi Target Versi untuk alur produk dalam Solusi Targeting Versi, dan Capgo Praktik Terbaik Lingkungan: Staging dengan Satu ID Aplikasi Mobile untuk konteks praktis dalam Capgo Praktik Terbaik Lingkungan: Staging dengan Satu ID Aplikasi Mobile.