Langsung ke konten

Saluran

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 Perangkat Paksa daftar di pengaturan saluran, maka saluran itu selalu menang.
  2. Cloud override (dibuat oleh setChannel() atau Aksi Webapp): Panggilan setChannel (atau mengubah saluran perangkat di dashboard) menulis override persisten di cloud yang terkait dengan ID perangkat. Override tersebut dikonsultasikan setelah pemetaan paksa tetapi sebelum default apa pun. Menginstal ulang aplikasi tidak menghapusnya; menghapus entri perangkat tidak. __CAPGO_KEEP_0__ konfigurasi
  3. Capacitor config defaultChannel : Untuk build internal / beta / uji Anda dapat mengatur(kunci legacy) defaultChannel (atau mengubah saluran perangkat di dashboard) menulis override persisten di cloud yang terkait dengan ID perangkat. Override tersebut dikonsultasikan setelah pemetaan paksa tetapi sebelum default apa pun. Menginstal ulang aplikasi tidak menghapusnya; menghapus entri perangkat tidak. channeldi dalamnya capacitor.config.* jika tidak ada, perangkat akan melanjutkan ke default cloud. beta, pr-123Default Cloud Channel (strategi utama untuk ~99% pengguna)
  4. : Jalur produksi utama di mana hampir semua pengguna nyata mendarat.Perangkat baru tanpa paksaan, tanpa override, dan tanpa konfigurasi defaultChannel menggunakan ini.

Mengubahnya akan mengeluarkan (atau mengembalikan) untuk semua orang dalam detik—tidak ada binary baru. Mengapa default cloud

  • adalah jalur utama:
  • Rollout instan atau rollback tanpa membangun atau menerbitkan kembali biner native.
  • Satu tempat untuk mengelola perilaku iOS, Android, dan Electron.
  • Perubahan yang dapat diaudit (anggota tim dapat melihat siapa yang mengubah apa di UI / log). Prinsip desain: Layer di atas (paksa / override / konfigurasi) adalah kecuali (debug pengguna tunggal, QA switching, default build test). Pengguna normal mengalir ke default cloud.

Mengubah default cloud saluran mempengaruhi baru perangkat normal yang:

  • Tidak dipaksa
  • Tidak sudah memiliki override cloud
  • Tidak memiliki definisi defaultChannel di tingkat aplikasi

Jika sebuah build uji coba dikirim bersamaan dengan defaultChannel: 'beta' dan Anda kemudian mengubah default cloud menjadi production, perangkat yang telah memulai pada beta melalui konfigurasi akan tetap berada di sana sampai Anda: (a) menggantinya dengan setChannel(), (b) memaksa mereka, atau (c) menghapus entri perangkat.

Perangkat akan tetap berada di saluran mereka saat ini kecuali Anda:

  • Mengubahnya ke saluran lain.
  • Menggunakan setChannel() (membuat/menggantikan override cloud) 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 sebuah platform (lihat toggle iOS / Android / Electron) dan akan lain kali dipilih, pilihan akan melompatinya dan kembali ke aturan berikutnya.

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

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


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

Daftar saluran

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

Saluran baru

Setelah itu Anda mengklik Add Saluran baru harus muncul di daftar.

setelah membuat saluran

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

dalam gambar2 Mengelola Saluran

dalam gambar3 Menghapus Saluran

Pengaturan saluran

Halaman pengaturan saluran berisi semua opsi pengaturan 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), lihat bagian Konfigurasi Saluran Default Kedua adalah


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

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

__CAPGO_KEEP_0__ 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. Ini berarti jika Anda telah mengunggah versi Disable auto downgrade under native ke toko aplikasi atau play store 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 tentang

di sini Disable auto updateUntuk Jika ini benar maka aplikasi pengembangan akan diizinkan untuk mengunduh pembaruan dari saluran ini. Jika tidak maka setiap permintaan pembaruan yang memiliki

akan gagal. Allow development buildJika ini benar maka aplikasi pengembangan akan diizinkan untuk mengunduh pembaruan dari saluran ini. Jika tidak maka setiap permintaan pembaruan yang memiliki prod akan ditolak. Ini lebih berguna untuk tujuan tes.

Ketujuh adalah Allow Emulators. Jika ini salah maka Capgo akan melarang setiap permintaan update yang datang dari emulator. Ini lebih berguna untuk tujuan tes.

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

Jika Anda menggunakan Saluran hubungkannya dengan Saluran detail implementasi di Saluran, Saluran detail implementasi di Saluran, Solusi Uji Beta alur kerja produk di Solusi Uji Beta, Solusi Target Versi alur kerja produk di Solusi Target Versi, dan Capgo Praktik Terbaik Lingkungan: Staging dengan Satu ID Aplikasi Mobile untuk konteks praktis di Capgo Praktik Terbaik Lingkungan: Staging dengan Satu ID Aplikasi Mobile.