Daftar checklist pengaturan satu kali

Anda telah selesai onboarding. Sekarang konfigurasi Capgo sekali. Setelah itu, pekerjaan sehari-hari hanya unggah → tes → terbitkan.

Kirimkan bangunan toko baru terlebih dahulu

Memasang plugin Capgo di proyek Anda tidak cukup. Perbarui 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. Bangun binary iOS / Android baru
3. Kirim ke App Store, Play Store, TestFlight, atau distribusi internal Anda

Pengguna pada versi toko yang lebih tua 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__-dihubungkan. 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. Set saluran unggah default di pengaturan aplikasi:

   • App Solo → production
   • Tim → development

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

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

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

   Perlu --bundle Nilai harus valid Pengaturan Versi SemantikValidasikan di . Pengujian SemVer sebelum mengunggah.

6. Jalankan ke produksi setelah melakukan pengujian, dari atau __CAPGO_KEEP_0__. or CLI.

7. undang sekali, hak akses minimal, 2FA untuk organisasi, satu __CAPGO_KEEP_0__ kunci di CI. Deploy to production only after testing, from the API or API.

Biarkan enkripsi, min_update_version, metadata, dan pratinjau off 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, terbitkan ke prod.Versi asli production-9.0 + test-9.0Jaga pengguna toko di saluran utama produksi.

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

Relasi (opsional): staging → rc → productionPeringatan

Jangan gunakan saluran yang dinamai tiket, orang, atau variabel CI seperti

Nama Paket vs Komentar ${inputs_capgo_channel}.

---

Bagian berjudul “Nama Paket vs Komentar”

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

• 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 nomor pembangunan 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: Fragment teks HTML dari string Capgo UI yang lebih panjang (kunci induk `alternatives_cta_questions`). Halaman/area: Halaman perbandingan alternatif Capacitor live-update. Peran: Paragraf pemasaran atau hukum yang panjang. Dilihat di: halaman alternatives.astro. Simpan istilah produk/brand dan istilah pengembang Capgo secara tepat. Kunci pesan `alternatives_cta_questions` (Pertanyaan Tindakan Alternatif). | Fragment teks HTML dari string Capgo UI yang lebih panjang (kunci induk `appflow_cta_questions`). Halaman/area: Halaman perbandingan/migrasi pemasaran Appflow. Peran: Paragraf pemasaran atau hukum yang panjang. Dilihat di: halaman ionic-appflow.astro. Simpan istilah produk/brand dan istilah pengembang Capgo secara tepat. Kunci pesan `appflow_cta_questions` (Pertanyaan Tindakan Appflow). | Fragment teks HTML dari string Capgo UI yang lebih panjang (kunci induk `capwesome_cta_questions`). Halaman/area: Halaman perbandingan Capawesome. Peran: Paragraf pemasaran atau hukum yang panjang. Dilihat di: halaman capwesome.astro. Simpan istilah produk/brand dan istilah pengembang Capgo secara tepat. Kunci pesan `capwesome_cta_questions` (Pertanyaan Tindakan Capwesome). | Fragment teks HTML dari string Capgo UI yang lebih panjang (kunci induk `consulting_faq_subtitle`). Halaman/area: Halaman layanan konsultasi. Peran: Judul atau tagline bagian. Dilihat di: halaman consulting.astro. Simpan istilah produk/brand dan istilah pengembang Capgo secara tepat. Kunci pesan `consulting_faq_subtitle` (Judul FAQ Konsultasi). | Halaman/area: Halaman perbandingan/migrasi pemasaran Appflow. Peran: Label UI singkat atau item navigasi. Dilihat di: halaman ionic-appflow.astro, halaman ionic-enterprise-plugins.astro, halaman solusi/ionic-enterprise-plugins.astro. Kunci pesan `appflow_plugins_or` (Appflow Plugins Atau).

Pakai semver dan pre-release tidak valid. Unggahan akan gagal atau berperilaku tidak terduga. --commentMasukkan catatan rilis di

, bukan di nama bundle. 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

Rekomendasi default ini cocok untuk aplikasi kebanyakan. Capgo menyimpan manifest dan context: Halaman/area: Situs web pemasaran Capgo. Peran: Label UI singkat atau item navigasi. Dilihat di: halaman trust.astro. Kunci pesan `dan` (Dan).

menyimpan zip lengkap sebagai cadangan. Cocok ketika biaya penyimpanan bukanlah kekhawatiran utama. --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

Salin ke clipboard --delta-only Pilih reduce Capgo storagemengurangi __CAPGO_KEEP_0__ penyimpanan Anda

Perbandingan: tanpa backup 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 mengunduh file yang berubah hanya.

Saran

Lihat Pembaruan delta context: Halaman/area: Halaman produk/pricing 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	Pembetulan
Menunggu OTA sebelum rilis toko baru	Membangun ulang dan mengirimkan aplikasi native setelah menambahkan plugin
Mengunggah bundle tetapi tidak mengirimkan ke saluran	Mengasosiasikan 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 self-set pada produksi	Mati untuk produksi, hidup untuk saluran uji
Mengabaikan --delta	Tambahkan --delta ke unggahan; gunakan --delta-only hanya ketika Anda perlu menyimpan penyimpanan
Nama-nama paket 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	Diabaikan secara default

---

Belajar lebih lanjut

Saluran Mengatur default, prioritas, dan routing.

Pembaruan delta Mengapa dan bagaimana menggunakan --delta.

CI/CD Automasi unggah dan deploy.

Bundel Checksum, dependensi, dan metadata.