Versioning

Salin prompt setup yang berisi langkah install dan panduan markdown lengkap untuk plugin ini.

Capgo menggunakan semantic versioning (semver) untuk plugin, CLI, dan produk yang kami rilis — praktik yang sama yang kami rekomendasikan untuk app bundle Anda sendiri.

Halaman ini menjelaskan hubungan antar versi tersebut, apa yang tetap kompatibel antar versi major, dan cara mengunci versi major Capacitor lama dengan tag LTS.

Aturan cepat

Produk	Versioning major	Catatan kompatibilitas
Plugin Capgo	Ikuti yang cocok versi major Capacitor	versi major plugin `8` menargetkan Capacitor 8, `7` menargetkan Capacitor 7, dan seterusnya
Capgo CLI	Independen	Jangan sinkronkan versi major CLI dengan plugin atau Capacitor. Selalu gunakan CLI terbaru
Konsol Capgo	Independen	Siklus rilis sendiri; kompatibel dengan versi plugin updater yang didukung

Plugin mengikuti versi major Capacitor

Setiap versi major plugin Capgo mengikuti versi major Capacitor yang menjadi targetnya:

@capgo/capacitor-updater@8 → Capacitor 8
@capgo/capacitor-updater@7 → Capacitor 7
dan pola yang sama untuk plugin Capgo lainnya

Saat Capacitor merilis versi major baru, Capgo merilis versi major plugin yang sesuai. Di saat itulah kami mungkin mengubah opsi default jika default baru adalah pilihan jangka panjang yang lebih baik untuk generasi Capacitor tersebut.

Stabilitas API lintas versi major

Plugin API tetap stabil antar versi major kecuali jika ada perubahan yang memang sengaja dibuat breaking (misalnya persyaratan platform Capacitor yang memaksa perubahan serupa pada semua pengguna). Biasanya Anda tetap bisa berpindah antar versi major plugin Capgo saat melakukan upgrade Capacitor tanpa harus menulis ulang integrasi Anda.

Default mungkin tetap berubah pada versi major baru. Tinjau release notes dan panduan migrasi (lihat upgrade updater dan panduan di bawah Migrations pada sidebar updater) saat Anda melakukan bump versi.

CLI dan Console punya versi sendiri

Capgo CLI dan Capgo Console memang menggunakan tidak bagikan versi major dengan plugin atau Capacitor.

Anda tidak butuh CLI major 8 karena Anda menggunakan Capacitor 8 atau updater 8.
Selalu instal atau jalankan terbaru CLI.
CLI dan Console terbaru tetap kompatibel dengan semua @capgo/capacitor-updater (dan updater terkait) major.

Menahan versi CLI lama tidak disarankan. Gunakan:

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

Tag LTS untuk versi major plugin sebelumnya

Saat Anda tetap menggunakan versi major Capacitor yang lebih lama, instal major plugin Capgo yang cocok dengan dist-tag LTS, alih-alih terus menyalin lockfile yang sudah usang.

# Latest Capgo updater for Capacitor 7
npm i @capgo/capacitor-updater@lts-v7

# Same pattern for other majors
npm i @capgo/capacitor-updater@lts-v6
npm i @capgo/capacitor-updater@lts-v5
npm i @capgo/capacitor-updater@lts-v4

Di luar updater, rilis LTS dari major plugin sebelumnya dipublikasikan sesuai permintaan.

Backport Updater vs plugin lainnya

Package	Backport major sebelumnya
`@capgo/capacitor-updater`	Backport bulanan yang disinkronkan ke `v7` / `v6` / `v5` (`lts-v7`, `lts-v6`, `lts-v5`). `lts-v4` tetap tersedia untuk Capacitor 4 tetapi tidak mengikuti jadwal bulanan tersebut
Plugin Capgo lainnya	Sesuai permintaan

Fitur sama, nomor versi selaras

Lini LTS menyamakan versi minor dan patch dari lini terbaru saat backport tersedia.

Jika rilis terbaru adalah 8.3.4, lini Capacitor 7 LTS diterbitkan sebagai 7.3.4 dengan set fitur dan perbaikan bug yang sama, yang disesuaikan untuk Capacitor major tersebut.

Gunakan tag saat ingin menginstal “versi terbaru untuk Capacitor major ini”:

npm i @capgo/capacitor-updater@lts-v7   # resolves to the current 7.x LTS, e.g. 7.3.4

LTS adalah backport dari versi terbaru

Setelah plugin major baru dirilis, rilis lts-v7 (atau lts-v6versi ..., …) adalah backport dari versi terbaru sehingga pekerjaan yang sama bisa berjalan di Capacitor major sebelumnya.

Karena mengikuti versi terbaru, API publik pada lini LTS mungkin berubah saat ada perubahan terbaru — meskipun nomor mayornya tetap 7. Anggap LTS sebagai “perilaku Capgo saat ini pada Capacitor lama,” bukan sebagai API legacy yang membeku selamanya.

Artinya bagi aplikasi Anda

Upgrade plugin Capgo saat Anda upgrade versi mayor Capacitor.
Selalu jalankan @capgo/cli@latest — sinkronisasi mayor CLI dengan Capacitor/plugins tidak diperlukan.
Tetap gunakan Capacitor 7 (atau versi lama)? Gunakan @lts-v7 (atau tag yang sesuai), bukan versi lama acak 7.x dari beberapa bulan lalu.
Berikan versi pada bundle live-update Anda sendiri dengan semver sama seperti cara Capgo melakukan versi pada paketnya. Lihat versioning bundle dan channel dan targeting versi.

Tambah aplikasi — perintah install dan tag LTS untuk updater
Ringkasan CLI — cara menjalankan perintah Capgo CLI
Kompatibilitas native — kapan perubahan butuh binary store vs bundle OTA
Dari V7 ke V8 — contoh upgrade major plugin yang selaras dengan Capacitor