Daftar checklist pengaturan satu kali

Anda telah menyelesaikan onboarding. Sekarang konfigurasi Capgo satu kali. Setelah itu, pekerjaan sehari-hari hanya unggah → tes → terbitkan.

Kirimkan bangunan toko baru pertama kali

Menginstal plugin Capgo di proyek Anda tidak cukup. Update OTA hanya berfungsi pada perangkat yang menjalankan aplikasi asli yang sudah termasuk plugin.

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

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

Pengguna pada versi toko lama Tidak the plugin will never receive live updates. Uploading bundles to Capgo only affects devices on a Capgo-enabled binary.

plugin akan tidak pernah menerima update live. Mengunggah bundle ke __CAPGO_KEEP_0__ hanya mempengaruhi perangkat pada binary __CAPGO_KEEP_1__-dijalankan. Lihat juga.

Pengaturan Masalah saluran adalah jalur rilis (development, production), bukan tiket, fitur, atau nama pengembang.

---

Daftar Pemeriksaan Satu Kali

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

2. Atur saluran unggah default di pengaturan aplikasi:

   • Aplikasi Solo → production
   • Tim → development

3. Saluran produksi: aktifkan publik, matikan sendiri perangkat, blokir pembaruan di bawah native aktifkan, pengaman pembaruan otomatis aktifkan major.

4. Saluran Uji (development / staging): matikan publik, aktifkan sendiri perangkat untuk QA.

5. Upload dari CI dengan --delta (checksum dan dependensi native 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

   The --bundle nilai harus sah Pengaturan Versi SemantikValidasi di . Pengujian SemVer sebelum mengunggah.

6. Tunggu sampai produksi setelah pengujian, dari atau __CAPGO_KEEP_0__. or CLI.

7. undang sekali, hak akses minimal, 2FA untuk organisasi, satu __CAPGO_KEEP_0__ kunci di CI. for the org, one API key in CI.

Kriptografi pengiriman, min_update_version, metadata, dan pratinjau mati kecuali Anda memiliki alasan yang jelas.

---

Pilih ukuran Anda

Sederhana: 1 aplikasi, 1 saluran: production

Tim: development + productioncontext: Halaman/area: Situs web pemasaran Capgo. Peran: Label UI singkat atau item navigasi. Dilihat di: halaman sla.astro. Kunci pesan `team_plan` (Rencana Tim).

. Unggah ke dev, distribusikan ke prod.Versi asli production-9.0 + test-9.0. Tetapkan pengguna toko di saluran utama produksi.

Banyak aplikasi: model sederhana yang sama per aplikasi (biasanya satu production setiap). Jangan membuat saluran tambahan hanya karena organisasi besar.

Relasi kereta (opsional): staging → rc → production. Template yang sama di setiap aplikasi yang membutuhkannya.

Peringatan

Jangan gunakan saluran yang dinamai tiket, orang, atau variabel CI seperti ${inputs_capgo_channel}.

---

Nama paket vs komentar

Nama Paket harus diperlukan untuk mengikuti versi semantik. Capgo menggunakan semver untuk pengecekan kompatibilitas, aturan auto-update kanal, dan rollback. Validasi setiap nama dalam Pengujian SemVer sebelum unggah.

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

Pakai semver pre-release label (bagian setelah -) ketika Anda mengirim banyak versi di bawah nama MAJOR.MINOR.PATCH. Contoh, simpan 1.8.0 dan tambahkan tanggal atau penghitung versi di pre-release: 1.8.0-20260629.1, 1.8.0-beta.2. Jangan menciptakan format khusus seperti fix-login-bug atau 2.5.2026062306context

HTML text fragment from a longer Capgo UI string (parent key `alternatives_cta_questions`). Page/area: Capacitor live-update alternatives comparison page. Role: Long marketing or legal paragraph. Seen in: page alternatives.astro. Preserve Capgo product/brand and developer terms exactly. Message key `alternatives_cta_questions` (Alternatives CTA Questions). | HTML text fragment from a longer Capgo UI string (parent key `appflow_cta_questions`). Page/area: Appflow comparison / migration marketing copy. Role: Long marketing or legal paragraph. Seen in: page ionic-appflow.astro. Preserve Capgo product/brand and developer terms exactly. Message key `appflow_cta_questions` (Appflow CTA Questions). | HTML text fragment from a longer Capgo UI string (parent key `capwesome_cta_questions`). Page/area: Capawesome comparison page. Role: Long marketing or legal paragraph. Seen in: page capwesome.astro. Preserve Capgo product/brand and developer terms exactly. Message key `capwesome_cta_questions` (Capwesome CTA Questions). | HTML text fragment from a longer Capgo UI string (parent key `consulting_faq_subtitle`). Page/area: Consulting services page. Role: Section subtitle or tagline. Seen in: page consulting.astro. Preserve Capgo product/brand and developer terms exactly. Message key `consulting_faq_subtitle` (Consulting FAQ Subtitle). | Page/area: Appflow comparison / migration marketing copy. Role: Short UI label or navigation item. Seen in: page ionic-appflow.astro, page ionic-enterprise-plugins.astro, page solutions/ionic-enterprise-plugins.astro. Message key `appflow_plugins_or` (Appflow Plugins Or). --commentPakai semver dan pre-release tidak valid. Mereka tidak akan berhasil atau akan berperilaku tidak terduga.

Masukkan catatan rilis di dalam file versi target dan versi bundel.

---

Delta unggah

--delta mengunggah manifest sehingga perangkat mengunduh hanya file yang berubah saja bukan bundle penuh setiap kali. Ceksum selalu dihitung secara otomatis. Anda tidak perlu melewati flag ceksum.

Default: --delta (manifest + zip backup)

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

Ini adalah rekomendasi default yang paling umum untuk aplikasi kebanyakan. Capgo menyimpan manifest dan menyimpan zip lengkap sebagai cadangan. Baik ketika biaya penyimpanan bukanlah kekhawatiran utama.

Penghematan penyimpanan: --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

Pilih --delta-only ketika Anda ingin mengurangi Capgo penyimpanan . Hanya file delta/manifest yang disimpan, bukan zip lengkap. Pilih ini untuk aplikasi besar atau volume unggah tinggi di mana penyimpanan menambahkan biaya.

Kompromi: tanpa cadangan zip di server, Anda bergantung sepenuhnya pada jalur manifest. Lewati --delta-only kecuali Anda memang membutuhkan penyimpanan yang lebih sedikit.

Tidak perlu konfigurasi plugin tambahan di perangkat. Pembarui membaca manifest dan mengambil file yang berubah hanya.

Trik

Lihat Pembaruan delta context: Halaman/area: Halaman produk/penawaran perusahaan. Peran: Label UI pendek atau item navigasi. Dilihat di: halaman enterprise.astro. Kunci pesan `enterprise_delta_updates` (Pembaruan Delta Perusahaan). directUpdate untuk troubleshooting dan

---

perilaku.

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

---

Kesalahan umum

Kesalahan	Perbaikan
Mengharapkan OTA sebelum rilis toko baru	Merekonstruksi dan mengirimkan aplikasi native setelah menambahkan plugin
Mengunggah bundle tetapi tidak mengirimkan ke saluran	Menugaskan bundle ke saluran (misalnya. production)
Saluran per fitur, tiket, atau pengembang	Hanya menggunakan jalur rilis permanen
Nama saluran CI dinamis	Nama-nama yang tetap: development, production
Terlalu banyak saluran untuk aplikasi sederhana	Mulai dengan 1-2 saluran
Perangkat menetapkan sendiri ke produksi	Mati untuk produksi, hidup untuk saluran uji
Mengabaikan --delta	Tambahkan --delta ke unggahan; gunakan --delta-only hanya ketika Anda perlu menyimpan penyimpanan
Nama bundel non-semver	Ikuti versi semantik dan validasi di SemVer tester
Mengubah skema versi secara waktu	Tetapkan semver; gunakan label pre-release untuk build tambahan (1.8.0-20260629.1)
Metadata / diaktifkan tanpa alasan	Matikan secara default

---

Belajar lebih lanjut

Saluran Capgo fitur saluran rilis. Halaman: Capgo solusi pemasaran halaman. Peran: Label UI singkat atau item navigasi. Dilihat di: halaman solutions/white-label.astro. Kunci pesan `solutions_white_label_visual_cell2_value` (Solutions White Label Visual Cell2 Value).

Pengaturan default, keutamaan, dan routing. Pembaruan delta

Halaman: Halaman produk/pricing perusahaan. Peran: Label UI singkat atau item navigasi. Dilihat di: halaman page enterprise.astro. Kunci pesan `enterprise_delta_updates` (Enterprise Delta Updates). Automasi unggah dan deploy.

Bundel Checksum, dependensi, dan metadata.