Daftar checklist satu kali

Salin prompt pengaturan dengan langkah instalasi dan panduan markdown lengkap untuk plugin ini.

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

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

Daftar checklist pengaturan satu kali

Buat saluran: pilih set terkecil yang sesuai (lihat di bawah).
Set saluran unggah default dalam Pengaturan Aplikasi:
- Aplikasi Solo → production
- Tim → development
Saluran Produksi: publik on, perangkat self-set off, blokir update di native on, pengaman auto-update on major.
Saluran Uji (development / staging): publik off, perangkat self-set on untuk QA.
Upload dari CI context --delta (Ceksum dan dependensi native otomatis):
Jendela Terminal
```
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
```
Pentingnya --bundle harus sah versi semantik . Pastikan dengan menggunakan Periksa apakah sudah benar sebelum mengunggah. Tunggu sampai produk siap
setelah melakukan pengujian, dari setelah melakukan pengujian, dari Pengaturan or CLI.
Tim & keamanan: undang sekali, hak akses minimal 2FA untuk organisasi, satu API kunci di CI.

Biarkan enkripsi, min_update_version, metadata, dan pratinjau mati kecuali Anda memiliki alasan yang jelas.

Pilih ukuran Anda

Sederhana: 1 aplikasi, 1 saluran: production

Tim: development + production. Unggah ke dev, distribusikan ke prod.

Versi Lokal: tambahkan saluran hanya jika diperlukan, misalnya production-9.0 + test-9.0. Biarkan pengguna toko tetap pada saluran produksi utama.

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

Relasi Peluncuran (opsional): staging → rc → productionTemplat yang sama pada setiap aplikasi yang membutuhkannya.

Nama Paket vs Komentar

Nama paket harus diikuti versi semantik Pengaturan Versi SemantikCapgo menggunakan semver untuk pengecekan kompatibilitas, aturan pembaruan otomatis kanal, dan pengembalian ke versi sebelumnya. sebelum mengunggah. sebelum diunggah.

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 versi pralepasan label pralepasan (bagian setelah -) ketika Anda mengirim banyak build di bawah versi yang sama MAJOR.MINOR.PATCH. Contoh, simpan 1.8.0 dan tambahkan tanggal atau penomoran build di pralepasan: 1.8.0-20260629.1, 1.8.0-beta.2. Jangan membuat format khusus seperti fix-login-bug atau 2.5.2026062306Mereka tidak valid semver dan unggahan akan gagal atau berperilaku tidak terduga.

Masukkan catatan rilis di --commentTidak dalam nama paket.

Lihat juga Pengaturan versi target dan versi bundel.

Pengaturan versi paket

--delta uploads mengunggah file delta yang berubah-ubah ini sehingga perangkat hanya mengunduh file yang berubah saja bukan paket lengkap setiap kali. Ceksum selalu dihitung secara otomatis. Anda tidak perlu menambahkan flag ceksum.

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

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

Ini adalah rekomendasi default untuk aplikasi kebanyakan. Capgo menyimpan file delta dan menyimpan zip lengkap sebagai cadangan. Perangkat pada versi plugin lama yang tidak mendukung Delta menggunakan zip. Cocok ketika biaya penyimpanan bukanlah kekhawatiran utama.

Penyimpanan menghemat: `--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 ketika Anda ingin mengurangi Capgo penyimpanan. Hanya file delta yang disimpan, bukan zip penuh. Pilih ini untuk aplikasi besar atau volume unggah tinggi di mana penyimpanan menambahkan biaya.

Kompromi: tanpa cadangan zip di server, Anda bergantung sepenuhnya pada file delta, dan perangkat pada versi plugin lama tanpa dukungan Delta tidak dapat diperbarui. Lewati --delta-only kecuali Anda memang membutuhkannya penyimpanan penyimpanan.

Tidak ada konfigurasi plugin tambahan yang diperlukan di perangkat. Pembarui membaca daftar file delta dan mengambil file yang berubah hanya.

Alur kerja sehari-hari

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

Kesalahan umum

Kesalahan	Pembetulan
Menunggu pembaruan OTA sebelum rilis toko baru	Membangun ulang dan mengirimkan aplikasi asli setelah menambahkan plugin
Mengunggah bundle tetapi tidak mengirimkannya ke saluran	Mengasosiasi bundle dengan saluran (misalnya `production`)
Saluran per fitur, tiket, atau pengembang	Hanya gunakan jalur rilis permanen
Nama saluran CI dinamis	Nama-nama tetap: `development`, `production`
Terlalu banyak saluran untuk aplikasi sederhana	Mulai dengan 1-2 saluran
Perangkat menetapkan sendiri 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 Paket Tidak Semver	Ikuti versi semantik dan validasi di Tester SemVer
Mengubah skema versi secara waktu	Tetapkan semver; gunakan label pra-rilis untuk build tambahan (`1.8.0-20260629.1`)
Metadata / diaktifkan tanpa alasan	Matikan secara default

Learn more

Saluran Default, prioritas, dan routing.

Dampak update Mengapa dan bagaimana menggunakan --delta.

CI/CD Mengaktifkan unggahan dan deploy secara otomatis.

Bundel Checksum, dependensi, dan metadata.