Saluran

Bagaimana Capgo memilih saluran (prioritas)

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

1. Petaan Perangkat Paksa: Jika ID perangkat dipaksakan secara eksplisit ke saluran (lihat daftar di pengaturan saluran), saluran tersebut selalu menang. Perangkat Paksa Daftar di pengaturan saluran
2. Override Cloud (dibuat oleh setChannel() atau Aksi Webapp): Menghubungi setChannel (atau mengubah saluran perangkat di dashboard) menulis override persisten di cloud yang terkait dengan ID perangkat tersebut. Override tersebut dikonsultasikan setelah petaan paksa tetapi sebelum default apa pun. Menginstal ulang aplikasi tidak menghapusnya; menghapus entri perangkat tidak. __CAPGO_KEEP_0__ Konfigurasi
3. Capacitor config defaultChannel Petaan Perangkat Paksa: Untuk build internal / beta / test Anda dapat mengatur defaultChannel (kunci legasi 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 kembali) untuk semua orang dalam detik-detik—tidak ada binary baru.

Mengapa default cloud adalah jalur utama:

• Rollout instan atau rollback tanpa 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 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 perangkat baru yang: Tidak dipaksa

• Tidak sudah memiliki override cloud
• Tidak sudah memiliki override cloud
• Jangan memiliki aplikasi defaultChannel __CAPGO_KEEP_0__

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

Perangkat tetap pada saluran mereka saat ini kecuali Anda:

• Mengubah mereka ke saluran lain.
• Menghubungi setChannel() (membuat/menggantikan override awan) atau mengubahnya secara manual di dashboard.
• Menghapus / mengarsipkan saluran yang mereka gunakan (kemudian mereka akan kembali melalui urutan keutamaan lagi pada saat cek berikutnya).

Jika sebuah saluran dinonaktifkan untuk platform (lihat toggle iOS / Android / Electron) dan akan dipilih jika tidak ada, maka pilihan melompatinya dan jatuh ke aturan berikutnya.

Catatan: Pengaturan defaultChannel mengubahnya memerlukan biner 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 ada di saluran lain (melalui konfigurasi, override, atau paksa) TIDAK akan berpindah secara otomatis; hanya perangkat baru (atau mereka yang Anda hapus override / paksa) yang mengambilnya.

---

Mengelola saluran

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

Membuat saluran

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

Kemudian setelah Anda mengklik pada Add saluran baru harus muncul di daftar.

Apa itu tidak terkonfigurasi?

Kadang-kadang konfigurasi saluran tidak valid. Dalam kasus itu, Anda akan mendapatkan peringatan besar dan Misconfigured kolom akan mengatakan Yes Untuk satu atau lebih dari saluran tersebut.\ Anda dapat mengetahui lebih lanjut tentang hal ini di sini

Menghapus saluran

Menghapus sebuah saluran cukup mudah. Cukup klik ikon sampah dan konfirmasi penghapusan.2 dalam gambar)

Mengelola saluran

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

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

---

Pertama kali 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), lihat Konfigurasi Saluran Bawaan Bagian.

---

Kedua IOS Pengaturan. Ini relatif 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 pengaturan. Ini mirip dengan Electron dan IOS Jika ini salah, maka aplikasi Electron tidak akan diizinkan untuk mengunduh pembaruan dari saluran ini. AndroidKelima adalah pengaturan.

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

Pengaturan ini cukup kompleks, dan Anda dapat mempelajari lebih lanjut tentangnya Disable auto updatedi sini Jika ini salah, maka perangkat Android tidak akan diizinkan untuk mengunduh pembaruan dari saluran ini.

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 ditetapkan ke false akan ditolak. Ini sangat berguna untuk tujuan pengujian.

Kedelapan adalah Allow Emulators. If this is false then Capgo will disallow any update request that comes from an emulator. This is mostly useful for testing purposes.

akan melarang setiap permintaan pembaruan yang berasal dari emulator. Ini sangat berguna untuk tujuan pengujian. Allow devices to self associateSembilan adalah . Jika ini benar maka metode akan tersedia. Jika ini ditetapkan ke false dan Anda mencoba untuk memanggil metode dengan saluran ini maka panggilan akan gagal.