Saluran

Saluran Update Langsung menunjuk ke bundle build JS tertentu dari aplikasi Anda yang akan dibagikan dengan perangkat apa pun yang telah dikonfigurasi untuk mendengarkan saluran tersebut untuk pembaruan. Ketika Anda install the Capgo Pembaruan Hidup SDK dalam aplikasi Anda, setiap biner native yang dikonfigurasi ke saluran tersebut akan memeriksa pembaruan yang tersedia setiap kali aplikasi dijalankan. Anda dapat mengubah saluran yang dituju pada saat apapun dan juga dapat kembali ke versi sebelumnya jika perlu.

Sifat Rahasia Tidak Diberikan Oleh Saluran

Saluran mengontrol kelayakan pembaruan, bukan rahasia paket. Bahkan jika saluran privat atau pengasosiasi sendiri dinonaktifkan, paket tidak terenkripsi yang diunggah ke Capgo masih harus dianggap sebagai aset publik yang disampaikan kepada klien. Pengenkripsian melindungi jalur pengiriman dan autentikasi pembaruan, tetapi paket yang dikirim masih dapat direkayasa balik dari aplikasi yang didistribusikan dengan usaha yang cukup karena kunci publik merupakan bagian dari klien. Lihat Pengenkripsian Pembaruan Hidup untuk informasi lebih lanjut.

Bagaimana perangkat memilih saluran (prioritas)

Saat perangkat memeriksa pembaruan, Capgo memutuskan saluran yang digunakan dalam urutan ini yang ketat (prioritas tertinggi terlebih dahulu):

1. Pengaturan perangkat paksa (Dashboard) – Pasang perangkat ID tertentu secara manual ke saluran. Gunakan untuk debugging darurat atau pengujian terkendali dengan pengguna nyata tunggal. Ini selalu menang.
2. Oversai Cloud (per-perangkat) melalui Dashboard atau API – Dibuat ketika Anda mengubah saluran perangkat di dashboard atau melalui API. Gunakan untuk pengguna QA yang beralih antara saluran fitur / PR atau untuk mereproduksi masalah pengguna. Menginstal ulang biner tidak menghapusnya; menghapus entri perangkat.
3. Plugin setChannel() saluran lokal – Dibuat ketika aplikasi memanggil setChannel() dan backend memvalidasi bahwa saluran target memungkinkan penugasan sendiri. Saluran yang dipilih disimpan secara lokal pada perangkat tersebut, berlaku segera, dan tidak ditampilkan di UI Oversai Perangkat.

Pengaturan Saluran Instan dengan setChannel()

Mulai dari versi plugin 5.34.0, 6.34.0, 7.34.0, atau 8.0.0 (tergantung pada versi utama Anda), setChannel() berfungsi berbeda: menghubungi backend untuk memvalidasi itu channel diizinkan (mengatur apakah pengaturan sendiri diaktifkan untuk channel tersebut), kemudian menyimpan channel secara lokal di perangkat sebagai defaultChannel. Hal ini berarti channel baru berlaku langsung untuk periksa update berikutnya—tidak perlu menunggu replikasi.

Sebelumnya, setChannel() menghemat pengaturan channel override ke database backend (seperti Dashboard atau API perubahan), dan perangkat harus menunggu replikasi data (hingga 2 menit) sebelum channel baru diakui. perilaku baru hanya membaca dari backend (untuk validasi) dan menyimpan secara lokal, membuat switch channel instan.

Karena setChannel() hanya lokal, maka tidak membuat entri Pengaturan Perangkat di __CAPGO_KEEP_0__ dashboard. Tampilan Pengaturan Perangkat hanya menampilkan pengaturan yang dibuat dari dashboard atau Public __CAPGO_KEEP_1__. create a Device Override entry in the Capgo dashboard. The Device Override UI only shows overrides created from the dashboard or the Public API.

Catatan: Meskipun sebuah saluran menjadi tidak diizinkan setelah diatur secara lokal, backend masih akan memvalidasi saluran selama periksa update, sehingga keamanan tetap terjaga.

Penting: Ketika perubahan saluran dilakukan melalui Dashboard atau API, masih ada keterlambatan replikasi hingga 2 menit sebelum semua server edge menampilkan perubahan. Untuk mengaktifkan saluran secara instan, gunakan setChannel() dari aplikasi code—ini memvalidasi dengan backend, kemudian mengatur saluran secara lokal untuk efek langsung.

4. Konfigurasi Capacitor defaultChannel (versi uji default) – Jika ada di capacitor.config.* dan tidak ada saluran paksa/override/local, aplikasi dimulai pada saluran ini (misalnya, ). Intended untuk versi uji / build internal sehingga tester langsung mendarat pada saluran pre-release secara otomatis. Build produksi biasanya meninggalkan ini tidak diatur. beta, qa, pr-123Saluran Default Cloud (jalur utama ~99% pengguna)
5. – Jika Anda menandai sebuah saluran default di dashboard, semua pengguna normal (tidak paksa, tidak Dashboard/__CAPGO_KEEP_0__ override, tidak plugin local channel, tidak konfigurasi defaultChannel) akan terhubung ke sini. Perubahan ini untuk mengeluarkan atau mengembalikan secara instan—tidak ada binary baru. Jika Anda memiliki default platform khusus (misalnya, satu iOS-only, satu Android-only, satu Electron-only), setiap perangkat akan mendarat pada default yang sesuai dengan platformnya. Meninggalkan saluran default cloud tidak diatur diperbolehkan; dalam hal ini perangkat harus menyesuaikan langkah 1–4 untuk menerima update. API

Praktik terbaik:

• Tangani 1–4 sebagai kecuali / lapisan pengujian; ketika Anda menetapkan default cloud, pengguna nyata harus mengalir ke dalamnya. Jika Anda memilih tidak menetapkan satu, jadilah sadar tentang bagaimana pengguna menghubungkan (biasanya melalui defaultChannel dalam konfigurasi atau pengaturan per-device).
• Hanya konfigurasi defaultChannel dalam biner yang Anda kirim secara eksplisit kepada tester. Menyimpannya tidak terdefinisi menjaga logika produksi sentral di dashboard.
• Pakai setChannel() sangat jarang dalam produksi—utamanya untuk QA atau diagnostik sasaran.

Jika sebuah saluran dinonaktifkan untuk platform (iOS/Android/Electron toggle) ketika akan dipilih, proses seleksi melompatinya dan melanjutkan ke bawah daftar.

Ringkasan: Paksa > Dashboard/API Override > Plugin setChannel() saluran lokal > Konfigurasi defaultChannel > Default Cloud.

Pengaturan Saluran Bawaan

Pengaturan awan default tidak wajib, tetapi biasanya berfungsi sebagai jalur default untuk perangkat baru. Tanpa satu, hanya perangkat yang sesuai dengan peta paksa, penggantian, atau defaultChannel di konfigurasi Capacitor yang akan menerima pembaruan. Ketika Anda memilih untuk menandai default, ingatlah pola-pola berikut:

• Pengaturan default tunggal (yang paling umum) – Jika sebuah channel memiliki iOS, Android, dan Electron diaktifkan, maka menjadi default tunggal; perangkat tanpa penggantian akan menempel di sini.
• Pengaturan default khusus platform – Jika Anda memisahkan channel berdasarkan platform (misalnya ios-production dengan hanya iOS diaktifkan, android-production dengan hanya Android diaktifkan, dan electron-production dengan hanya Electron diaktifkan), tandai setiap satu sebagai default untuk platformnya. Perangkat iOS pergi ke default iOS, perangkat Android pergi ke default Android, dan aplikasi Electron pergi ke default Electron.

Ingatlah bahwa default awan dan defaultChannel di capacitor.config.* keduanya mengisi lapisan keputusan yang sama. Jika Anda menetapkan nilai awal cloud, Anda tidak perlu mengulang nilai tersebut di konfigurasi Capacitor Anda—biarkan defaultChannel kosong untuk pembangunan produksi. Simpan defaultChannel untuk file biner yang Anda sengaja kirimkan kepada tester atau QA ketika Anda ingin mereka memulai di saluran non-produksi meskipun nilai awal cloud berbeda

Anda dapat mengubah nilai default kapan saja di dashboard. Ketika Anda mengganti nilai default, perangkat baru mengikuti aturan routing baru segera dan perangkat yang sudah ada mengikuti aturan keutamaan normal saat mereka memeriksa kembali

Pengaturan Saluran

Pada saat onboard, Anda membuat saluran pertama (banyak tim menamainya “Produksi”), tetapi tidak ada yang terkunci—Anda dapat menamai atau menghapus saluran apa pun kapan saja. Untuk menambahkan saluran tambahan kemudian:

1. Kunjungi bagian “Saluran” di dashboard Capgo
2. Klik tombol “Saluran Baru”
3. Masukkan nama saluran dan klik “Buat”

Nama saluran dapat apa saja yang Anda inginkan. Strategi umum adalah untuk menyesuaikan nama saluran dengan tahapan pengembangan, seperti:

• Development - untuk menguji pembaruan hidup di perangkat lokal atau emulator
• QA - untuk tim QA Anda untuk memverifikasi pembaruan sebelum rilis yang lebih luas
• Staging - untuk tes akhir di lingkungan yang mirip produksi
• Production - untuk versi aplikasi yang diterima pengguna akhir dari toko aplikasi

Konfigurasi Saluran di Aplikasi Anda

Dengan saluran Anda yang dibuat, Anda perlu mengonfigurasi aplikasi Anda untuk mendengar saluran yang tepat. Dalam contoh ini, kita akan menggunakan saluran. Development saluran.

Buka file Anda capacitor.config.ts (atau capacitor.config.json) di editor Anda. Di bawah bagian plugins opsionalnya atur defaultChannel __CAPGO_KEEP_0__ tes build (internal / QA). Untuk build produksi, prefer menghilangkannya agar perangkat menggunakan Default Cloud kecuali secara eksplisit diatur.

import { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      // For a QA/TestFlight build – testers start on the Development channel automatically.
      defaultChannel: 'Development',
      // Production builds usually omit this so users attach to the Cloud Default channel.
    },
  },
};

Selanjutnya, bangun aplikasi web Anda dan jalankan npx cap sync untuk menyalin file konfigurasi yang diperbarui ke proyek iOS, Android, dan Electron Anda. Jika Anda melewatkan langkah sinkronisasi ini, proyek native Anda akan terus menggunakan saluran yang sebelumnya dikonfigurasi.

Peringatan

Urutan pilihan saluran: Force > Dashboard/API pengaturan perangkat > Plugin setChannel() saluran lokal > Konfigurasi defaultChannel > Saluran Default Cloud.

Gunakan defaultChannel hanya dalam build internal/test; tinggalkan saja untuk produksi agar pengguna mengikuti Saluran Default Cloud (jika diatur) daripada mengulangi routing di konfigurasi native.

You masih bisa memaksa (pin) perangkat atau menerapkan override lebih lanjut—hal-hal tersebut langsung menggantikan nilai konfigurasi.

Nama saluran sangat sensitif terhadap huruf besar dan kecil.

Opsi dan Strategi Saluran

Saluran memiliki beberapa opsi yang mengontrol siapa yang dapat menerima update dan bagaimana update disampaikan. Opsi-opsi yang paling penting adalah di bawah. Anda dapat mengonfigurasi hal-hal ini dari aplikasi web, CLI, atau Public API.

• Saluran default: Opsional untuk menandai saluran atau saluran spesifik platform yang perangkat baru terhubung ke. Lihat “Pengaturan Saluran Default” untuk skenario routing.
• Pengatur filter platform: Aktifkan atau nonaktifkan pengiriman ke iOS, Android, atau Electron perangkat per saluran.
• Nonaktifkan auto downgrade di native: Menghalangi pengiriman update ketika versi aplikasi native perangkat lebih baru daripada bundle saluran (misalnya, perangkat pada 1.2.3 sementara saluran memiliki 1.2.2).
• Permitir build pengembangan: Izinkan update ke build pengembangan (bermanfaat untuk testing).
• Permitir perangkat emulator: Izinkan update ke perangkat emulator/simulator (bermanfaat untuk testing).
• Biarkan perangkat melakukan penugasan sendiri: Biarkan aplikasi beralih ke saluran ini pada waktu eksekusi menggunakan setChannelJika dinonaktifkan, setChannel akan gagal untuk saluran ini.

Nonaktifkan Strategi Perbarui Otomatis

Gunakan ini untuk membatasi jenis-jenis perbarui yang akan disampaikan secara otomatis. Pilihan:

• utama: Menghalangi paket sasaran yang versi mayor lebih tinggi dari dasar native perangkat (version_build). Contoh: 1.2.3 -> 2.0.0 ditolak; 1.2.3 -> 1.9.0 diperbolehkan.
• minor: Menghalangi paket sasaran yang versi mayor atau minor berbeda dari version_build. Contoh: 1.2.3 -> 1.3.0 terblokir; 1.2.3 -> 1.2.4 diperbolehkan.
• patch: Mode paling ketat. Menghalangi perubahan apa pun pada nomor mayor, minor, atau patch. Perubahan sufiks saja yang diizinkan sementara MAJOR.MINOR.PATCH tetap identik. Contoh: 1.0.0-beta.1 -> 1.0.0-beta.2 diperbolehkan, 1.0.0+build.1 -> 1.0.0+build.2 diperbolehkan, 1.0.0 -> 1.0.1 terblokir.
• metadata: Tuntut versi update minimum metadata pada setiap bundle. Konfigurasi melalui CLI menggunakan --min-update-version atau --auto-min-update-version. Jika tidak ada, saluran tersebut akan ditandai tidak terkonfigurasi dan update akan ditolak sampai diatur.
• tidak ada: Izinkan semua update sesuai dengan kompatibilitas semver.

Strategi ini membandingkan bundle target saluran dengan baseline asli yang dikirim sebagai version_builddan bukan bundle yang diunduh saat ini yang dikirim sebagai version_name.

Pelajari lebih lanjut dan contoh di strategi Non-aktifkan update di /docs/cli/perintah/#non-aktifkan-update-strategi.

Contoh (CLI):

# Block major updates on the Production channel
npx @capgo/cli@latest channel set production com.example.app \
  --disable-auto-update major

# Allow devices to self-assign to the Beta channel
npx @capgo/cli@latest channel set beta com.example.app --self-assign

Menggunakan setChannel() dari Aplikasi Anda

Saluran setChannel() Metode ini memungkinkan aplikasi Anda untuk berganti saluran secara programatis pada waktu runtime. Hal ini sangat berguna untuk:

• Menu QA/debug di mana tester dapat berganti antara saluran
• Alur pilihan beta untuk mengaktifkan saluran
• Implementasi flag fitur
• Skenario uji A/B

import { CapacitorUpdater } from '@capgo/capacitor-updater';

// Switch to the beta channel
await CapacitorUpdater.setChannel({ channel: 'beta' });

// Optionally trigger an immediate update check after switching
await CapacitorUpdater.setChannel({
  channel: 'beta',
  triggerAutoUpdate: true
});

Bagaimana Cara setChannel() Berfungsi (v5.34.0+ / v6.34.0+ / v7.34.0+ / v8.0.0+)

Kapan setChannel() dipanggil:

1. Validasi backend (hanya baca): Permintaan dikirim ke backend Capgo untuk memvalidasi apakah channel diizinkan (mengatur izin pengasasan sendiri)
2. Perbarui penyimpanan lokal: Jika validasi berhasil, channel disimpan ke penyimpanan lokal perangkat sebagai defaultChannel
3. Efek instan: Periksa update selanjutnya menggunakan saluran baru langsung (tidak menunggu replikasi)

Mengapa ini penting: Pada versi lama, setChannel() menghemat pengaturan saluran ke database backend (sama seperti Dashboard atau API perubahan). Perangkat harus menunggu replikasi backend (hingga 2 menit) sebelum perubahan saluran berlaku. Sekarang, setChannel() hanya membaca dari backend (untuk validasi) dan menyimpan secara lokal, membuat perubahan saluran instan.

Keterlihatan Dashboard: Pengaturan saluran yang ditetapkan dengan plugin tidak membuat perangkat muncul sebagai Pengaturan Perangkat di Capgo UI. Hanya pengaturan saluran yang dibuat dari dashboard atau Public API yang terdaftar di sana. Gunakan dashboard atau API ketika Anda membutuhkan pengaturan override yang dapat dilihat oleh administrator.

Pesan keamanan: Meskipun hak akses saluran berubah setelah ditetapkan secara lokal (misalnya, pengaturan self-assignment dihapus), backend akan masih melakukan validasi saluran selama periksa update, memastikan keamanan tetap terjaga.

Penggabungan metode perubahan saluran:

Metode	Waktu Efek	Di Simpan Dimana	Ditampilkan di Pengaturan Perangkat	Penggunaan
setChannel() dari plugin	Instan	Hanya Perangkat (local)	Tidak	Penggantian saluran pengguna di dalam aplikasi
Pengaturan Perangkat di Dashboard	Hingga 2 menit	Database Server	Iya	Perubahan yang diinisiasi oleh administrator untuk perangkat tertentu
API pengaturan saluran	Maksimal 2 menit	Database backend	Ya	Integrasi backend otomatis

Untuk pengalaman pengguna yang terbaik ketika membangun antarmuka penggantian saluran, selalu gunakan metode plugin. setChannel() Versi minimum untuk penggantian saluran hanya lokal:

, atau 5.34.0, 6.34.0, 7.34.0(tergantung pada versi mayor Anda). Setiap nomor versi minor yang sesuai dengan set fitur yang sama di semua versi mayor (misalnya, X.34.0 termasuk fitur yang sama apapun X adalah 5, 6, 7, atau 8). Lihat 8.0.0 instalasi plugin Penggunaan plugin ini memastikan pengalaman pengguna yang lebih baik ketika membangun antarmuka penggantian saluran. untuk tag versi.

Mengasosiasi Paket ke Saluran

Untuk mengaktifkan pembaruan live, Anda perlu mengunggah bundle JS baru dan mengasosiasikannya ke saluran. Anda bisa melakukannya dalam satu langkah dengan Capgo CLI:

npx @capgo/cli@latest bundle upload --channel=Development

Ini akan mengunggah aset web yang dibangun dan mengatur bundle baru sebagai build aktif untuk saluran. Aplikasi-aplikasi yang dikonfigurasi untuk mendengarkan saluran tersebut akan menerima pembaruan pada saat mereka memeriksa pembaruan berikutnya. Development Anda juga bisa mengasosiasikan build ke saluran dari bagian “Paket” di __CAPGO_KEEP_0__ dashboard. Klik ikon menu di samping build dan pilih “Asosiasi ke Saluran” untuk memilih saluran untuk build tersebut.

You can also assign builds to channels from the “Bundles” section of the Capgo dashboard. Click the menu icon next to a build and select “Assign to Channel” to choose the channel for that build.

Judul Bagian “Versi Paket dan Saluran”

It’s important to note that bundles in Capgo are global to your app, not specific to individual channels. The same bundle can be assigned to multiple channels.

When versi bundel Anda, kami merekomendasikan menggunakan versi semantik dengan __CAPGO_KEEP_0__’s Semver Tester dan identifikasi pra-rilis untuk bangunan khusus saluran. Misalnya, rilis beta mungkin versi sebagai semantic versioning with Capgo’s Semver Tester Memudahkan komunikasi hubungan antara bangunan. 1.2.3-beta.1.

Jelas bahwa adalah pra-rilis dari

• Mengizinkan penggunaan nomor versi kembali di saluran, mengurangi kebingungan. 1.2.3-beta.1 Mengaktifkan jalur rollback yang jelas. Jika Anda perlu kembali dari 1.2.3.
• Anda tahu
• adalah rilis stabil sebelumnya. 1.2.3Berikut adalah contoh cara Anda mungkin menyesuaikan versi bundel dengan pengaturan saluran yang umum: 1.2.2 saluran:

saluran:

• Development saluran: 1.2.3-dev.1, 1.2.3-dev.2Menggunakan
• QA salah satu channel: 1.2.3-qa.1, 1.2.3-qa.2dan lain-lain.
• Staging salah satu channel: 1.2.3-rc.1, 1.2.3-rc.2dan lain-lain.
• Production salah satu channel: 1.2.3, 1.2.4dan lain-lain.

Menggunakan semver dengan identifikasi pra-rilis adalah pendekatan yang disarankan, tetapi tidak sepenuhnya diperlukan. Kunci adalah menemukan skema versi yang dengan jelas menyampaikan hubungan antara build Anda dan sejalan dengan proses pengembangan tim Anda. Mengembalikan Perbaruan Hidup

Judul bagian “Mengembalikan Perbaruan Hidup”

Jika Anda mengaktifkan pembaruan hidup yang memperkenalkan bug atau perlu diubah kembali, Anda dapat dengan mudah kembali ke versi sebelumnya. Dari bagian “Saluran” di dashboard:

1. Klik nama saluran yang ingin Anda kembali
2. Cari versi yang ingin Anda kembalikan dan klik ikon mahkota
3. Konfirmasi aksi

Versi yang dipilih akan langsung menjadi versi aktif untuk saluran tersebut lagi. Aplikasi akan menerima versi yang dikembalikan pada saat mereka memeriksa pembaruan berikutnya.

Mengautomasi Pembaruan

Untuk alur kerja yang lebih maju, Anda dapat mengautomasi pembaruan hidup Anda sebagai bagian dari pipeline CI/CD Anda. Dengan mengintegrasikan Capgo ke dalam proses pembangunan Anda, Anda dapat mengunggah bundle baru secara otomatis dan menugaskan mereka ke saluran pada saat Anda push ke cabang tertentu atau membuat rilis baru.

Cek tautan Integrasi CI/CD dokumen untuk mengetahui lebih lanjut tentang mengautomasi pembaruan hidup Capgo.

Mengirimkan ke Perangkat

Sekarang Anda sudah memahami saluran, Anda siap untuk memulai mengirimkan pembaruan hidup ke perangkat nyata. Proses dasar adalah:

1. Instal Capgo SDK di aplikasi Anda
2. Konfigurasi aplikasi untuk mendengarkan saluran yang diinginkan Anda
3. Unggah bangun dan alokasikan ke saluran tersebut
4. Luncurkan aplikasi dan tunggu pembaruan!

Untuk walkthrough yang lebih rinci, lihat Pembaruan Hidup panduan. Selamat mengupdate!

Penggunaan Saluran Lanjutan: Segmentasi Pengguna

Saluran dapat digunakan untuk lebih dari hanya tahap pengembangan. Mereka adalah alat yang kuat untuk segmentasi pengguna, memungkinkan fitur seperti:

• Flag fitur untuk tingkat pengguna yang berbeda
• Pengujian A/B
• Rollout fitur secara bertahap
• Program uji coba beta

Belajar cara menerapkan kasus penggunaan maju ini dalam panduan kami: Bagaimana Membagi Pengguna Berdasarkan Paket dan Saluran untuk Flag Fitur dan Pengujian A/B.

Teruskan dari Saluran

Saluran untuk merencanakan routing saluran dan rollout yang berstadium, hubungkannya dengan Jika Anda menggunakan Saluran untuk merencanakan routing saluran dan rollout yang berstadium, hubungkannya dengan Saluran untuk detail implementasi di Saluran, Saluran untuk detail implementasi di Saluran, Solusi Uji Beta untuk alur produk di Solusi Uji Beta, Solusi Target Versi untuk alur 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.