Checklist setup satu kali

You finished onboarding. Sekarang konfigurasi Capgo sekali. Setelah itu, alur kerja harian hanya upload → test → deploy.

Rilis build store baru terlebih dahulu

Menginstal plugin Capgo di proyek Anda saja tidak cukup. Update OTA hanya berfungsi pada perangkat yang menjalankan native app yang sudah menyertakan plugin tersebut.

Setelah Anda menambahkan Capgo dan memanggil CapacitorUpdater.notifyAppReady():

1. Jalankan npx cap sync
2. Build binary iOS / Android baru
3. Submit ke App Store, Play Store, TestFlight, atau distribusi internal Anda

Pengguna pada build store versi lama tanpa plugin tidak akan pernah menerima live updates. Upload bundle ke Capgo hanya berdampak pada perangkat dengan binary Capgo-enabled.

Lihat juga troubleshooting.

Aturan: channel adalah jalur rilis (development, production), bukan tiket, fitur, atau nama developer.

---

Checklist setup satu kali

1. Buat channel: pilih set terkecil yang sesuai (lihat di bawah).

2. Atur channel upload default di pengaturan aplikasi:

   • Aplikasi solo → production
   • Team → development

3. Channel produksi: public on, device self-set off, block updates under native on, auto-update guard on major.

4. Uji channel (development / staging): public off, device self-set on untuk QA.

5. Upload dari CI dengan --delta (checksum dan native dependencies otomatis):

   npx @capgo/cli@latest bundle upload \
     --channel development \
     --bundle "1.8.0-${BUILD_NUMBER}" \
     --comment "commit ${GIT_SHA:0:7} run ${CI_RUN_ID}" \
     --delta

   Panduan --bundle nilai harus harus valid semantic versioning. Validasi di dalam Tester SemVer sebelum Anda upload.

6. Deploy ke production hanya setelah testing, dari dashboard atau CLI.

7. Tim & keamanan: undang sekali, izin minimal, 2FA untuk org, satu kunci API di CI.

Biarkan enkripsi, min_update_version, metadata, dan preview nonaktif kecuali ada alasan jelas.

---

Pilih ukuran Anda

Simpel: 1 app, 1 channel: production

Tim: development + production. Upload ke dev, deploy ke prod.

Versi Native: tambah channel hanya saat butuh, misal production-9.0 + test-9.0. Jaga user store di channel produksi utama.

Banyak app: model simpel yang sama per app (biasanya satu production tiap app). Jangan buat channel ekstra hanya karena org besar.

Jadwal rilis (opsional): staging → rc → production. Gunakan template yang sama untuk setiap aplikasi.

Peringatan

Jangan gunakan nama channel berdasarkan tiket, orang, atau variabel CI seperti ${inputs_capgo_channel}.

---

Nama bundle vs komentar

Nama bundle adalah wajib mengikuti semantic versioning. Capgo menggunakan semver untuk pengecekan kompatibilitas, aturan auto-update channel, dan rollback. Validasi setiap nama di Tester SemVer sebelum upload.

• Nama = semver dari CI, misal 1.8.0, 1.8.0-beta.1, atau 1.8.0-20260629.42
• Komentar = teks bebas untuk manusia → commit abc1234 run 28059070270

Gunakan semver pre-release label (bagian setelah -) saat Anda merilis banyak build dengan MAJOR.MINOR.PATCH. Contohnya, tetap gunakan 1.8.0 dan tambahkan tanggal atau build counter pada pre-release: 1.8.0-20260629.1, 1.8.0-beta.2. Jangan buat format kustom seperti fix-login-bug atau 2.5.2026062306. Format tersebut tidak valid secara semver dan upload akan gagal atau tidak terprediksi.

Masukkan release notes di --comment, bukan di nama bundle.

Lihat juga penargetan versi dan versioning bundle.

---

Upload Delta

--delta upload file delta sehingga perangkat hanya download file yang berubah, bukan seluruh bundle setiap saat. Checksum selalu dihitung otomatis. Anda tidak perlu menyertakan flag checksum.

Default: --delta (file delta + backup zip)

npx @capgo/cli@latest bundle upload \
  --channel development \
  --bundle "1.8.0-${BUILD_NUMBER}" \
  --delta

Ini adalah default yang direkomendasikan untuk sebagian besar aplikasi. Capgo menyimpan file delta dan dan menyimpan zip lengkap sebagai backup. Perangkat dengan versi plugin lama tanpa dukungan Delta akan menggunakan zip. Cocok jika biaya storage bukan prioritas utama.

Hemat storage: --delta-only

npx @capgo/cli@latest bundle upload \
  --channel development \
  --bundle "1.8.0-${BUILD_NUMBER}" \
  --comment "commit ${GIT_SHA:0:7} run ${CI_RUN_ID}" \
  --delta-only

Gunakan --delta-only saat Anda ingin mengurangi penyimpanan Capgo. Hanya file delta yang disimpan, bukan file zip lengkap. Pilih opsi ini untuk aplikasi besar atau volume upload tinggi agar penyimpanan tidak membengkak.

Konsekuensi: tanpa backup zip di server, Anda sepenuhnya bergantung pada file delta, dan perangkat dengan versi plugin lama tanpa dukungan Delta tidak bisa update. Lewati --delta-only kecuali jika Anda memang butuh penghematan penyimpanan.

Tidak perlu konfigurasi plugin tambahan di perangkat. Updater akan membaca daftar file delta dan hanya mengambil file yang berubah saja.

Tips

Lihat Update Delta untuk troubleshooting dan directUpdate perilaku.

---

Workflow harian

Upload to development (--delta)
  → test
  → deploy to production
  → don't touch channel settings again

---

Kesalahan umum

Kesalahan	Solusi
Mengharapkan OTA sebelum rilis store baru	Rebuild dan rilis native app setelah tambah plugin
Upload bundle tapi tidak deploy ke channel	Assign bundle ke sebuah channel (misal. production)
Channel per fitur, tiket, atau developer	Gunakan permanent release lanes saja
Nama channel CI yang dinamis	Nama tetap: development, production
Terlalu banyak channel untuk app sederhana	Mulai dengan 1-2 channel
Device self-set di production	Off untuk production, on untuk channel test
Skip --delta	Tambah --delta untuk upload; gunakan --delta-only hanya saat ingin menghemat storage
Nama bundle non-semver	Ikuti semantic versioning dan validasi di Penguji SemVer
Mengubah skema versioning seiring waktu	Tetap gunakan semver; pakai label pre-release untuk build tambahan (1.8.0-20260629.1)
Metadata / preview aktif tanpa alasan	Matikan secara default

---

Learn more

Channel Default, presedensi, dan routing.

Update Delta Mengapa dan cara menggunakan --delta.

CI/CD Otomatisasi upload dan deploy.

Bundle Checksum, dependensi, dan metadata.