Apa itu Capacitor-updater?
Capacitor-updater, teknologi yang membantu pengiriman pembaruan dan peningkatan aplikasi ke pengguna akhir secara instan.
Ini sangat cocok jika Anda ingin melakukan perbaikan bug kritis dan mengirimkannya secara instan tanpa melalui review App Store.
Anda bisa memahaminya sebagai kelincahan ala web untuk side-loading update begitu tersedia.
Selain itu, tersedia fitur rollback jika update baru menyebabkan app crash
Bagaimana cara kerjanya?
Capgo menjaga JavaScript bundle app Anda tetap sinkron dengan server Capgo, dan setiap kali user membuka app, sistem akan mengecek ke server Capgo apakah ada update bundle baru. Tentu saja, ini dilengkapi banyak konfigurasi keren untuk membantu Anda mengoptimalkan user experience.
Saya menggunakan Capgo di semua project yang saya bangun. Ini membantu saya menghemat waktu dalam proses review App Store.
Baca selengkapnya di sini di sini.
Memahami Semantic Versioning dengan Capgo
Capgo menggunakan semantic versioning (semver) untuk menentukan kapan dan bagaimana update diterapkan ke app Anda. Ini memastikan user hanya menerima update yang kompatibel dan mencegah breaking changes ter-deploy secara otomatis.
Semantic versioning mengikuti format MAJOR.MINOR.PATCH:
- MAJOR: Breaking changes yang memerlukan rilis ke app store native
- MINOR: Fitur baru yang tetap backward compatible
- PATCH: Perbaikan bug yang tetap backward compatible
Contohnya, jika aplikasi Anda berada di versi 1.0.0 dan Anda ingin update ke 1.0.1 (sebuah patch), Capgo akan otomatis menerapkan update ini. Namun, jika Anda ingin update dari 1.0.0 ke 2.0.0 (versi mayor), ini akan memerlukan rilis native app store karena menandakan adanya breaking changes.
Pengaturan channel Capgo memungkinkan Anda mengatur jenis update mana yang diterapkan otomatis:
- Strategi Major: Mengizinkan semua update (gunakan dengan hati-hati)
- Strategi Minor: Hanya mengizinkan pembaruan minor dan patch
- Strategi patch: Hanya mengizinkan pembaruan patch
- Strategi metadata: Memenuhi persyaratan versi minimum
Anda dapat menguji bagaimana kombinasi versi yang berbeda bekerja dengan logika pembaruan Capgo menggunakan alat Semver Tester. Alat ini membantu Anda memahami secara tepat kapan update akan diterapkan berdasarkan konfigurasi channel Anda.
Apakah ada keterbatasan?
Meskipun terdengar bagus, ada beberapa hal yang perlu kita perhatikan. Hal pertama adalah bahwa update OTA hanya berfungsi dengan web bundle. Anda mungkin berpikir ini bukan keterbatasan besar karena, di Capacitor JS, kita menulis hampir semua code dalam JS, CSS, dan HTML. Meskipun ini mungkin benar, masih ada modul native yang kita instal ke aplikasi kita. Jika sebuah modul mengubah direktori android atau iOS Anda, Anda tidak dapat menggunakan OTA untuk memperbarui aplikasi Anda. Hal ini karena isi direktori tersebut digunakan untuk mengompilasi biner Native, yang tidak dapat diperbarui oleh OTA. Bahkan aplikasi native pun tidak dapat memperbarui bagian ini.
Tapi Anda bisa mengatur CI/CD untuk menangani bagian ini, saya sudah buat tutorialnya di sini untuk iOS.
Konfigurasi Otomatis Capgo
Saatnya mendaftar dan dapatkan key API untuk upload versi pertama Anda! Mulai dengan mendaftar untuk akun Capgo.
Setelah login ke Capgo, Anda akan melihat halaman onboarding
Ikuti langkah-langkah di halaman onboarding untuk menambahkan app pertama Anda.
Ikuti panduan CLI
Dari command line, langsung di root app Capacitor Anda, jalankan:
npx @capgo/cli@latest init
Untuk menginstal Capgo ke dalam app Capacitor Anda, CLI akan memandu proses setup app Anda dengan Capgo.
Jika ingin melakukannya secara manual, Anda bisa mengikuti langkah-langkah di bawah ini.
Konfigurasi Manual Capgo
Install plugin
Hasil akhirnya, code ini akan ditambahkan ke aplikasi Anda:
npm i @capgo/capacitor-updater && npx cap sync
Untuk menginstal plugin ke aplikasi Capacitor Anda.
Kemudian tambahkan code ini ke aplikasi Anda untuk memberi tahu native plugin bahwa JS bundle dalam kondisi sehat (jika tidak, native plugin akan rollback ke versi sebelumnya):
import { CapacitorUpdater } from '@capgo/capacitor-updater'
CapacitorUpdater.notifyAppReady()Ini akan memberi tahu native plugin bahwa instalasi berhasil.
Lalu jalankan npm run build && npx cap copy untuk memperbarui aplikasi Anda.
Login ke Capgo CLOUD
Pertama, gunakan all apikey yang ada di akun Anda untuk login dengan CLI:
npx @capgo/cli@latest login YOU_KEY
Tambahkan app pertama Anda
Mari kita mulai dengan membuat aplikasi di Capgo Cloud menggunakan CLI.
npx @capgo/cli@latest app add
Perintah ini akan menggunakan semua variabel yang ditentukan dalam file config Capacitor untuk membuat app.
Upload versi pertama Anda
Jalankan perintah untuk build code Anda dan kirim ke Capgo dengan:
npx @capgo/cli@latest bundle upload
Secara default, nama versi akan mengikuti yang ada di package.json Anda.
Cek Capgo jika build tersedia.
Anda bahkan bisa mencobanya dengan app sandbox mobile saya.
Jadikan channel default
Setelah Anda mengirimkan aplikasi ke Capgo, Anda perlu membuat channel Anda default agar aplikasi bisa menerima update dari Capgo.
npx @capgo/cli@latest channel set production -s default
Terima Live Update di Perangkat
Agar aplikasi Anda menerima live update dari Deploy, Anda perlu menjalankan aplikasi di device atau emulator. Cara termudah adalah dengan menjalankan perintah berikut untuk membuka aplikasi lokal di emulator atau device yang terhubung ke komputer Anda.
npx cap run [ios | android]Buka aplikasi, pindahkan ke background lalu buka kembali, Anda akan melihat di logs bahwa aplikasi sudah melakukan update.
Selamat! 🎉 Anda berhasil men-deploy Live Update pertama Anda. Ini baru awal dari apa yang bisa Anda lakukan dengan Live Updates. Untuk info lebih lanjut, lihat dokumentasi Live Updates.
Jika Anda perlu berhenti menerima update secara lokal, jalankan perintah ini
npx @capgo/cli@latest channel set
Lanjutkan dari Update aplikasi Capacitor Anda dengan mulus menggunakan Capacitor-updater
Jika Anda menggunakan Update aplikasi Capacitor Anda dengan lancar menggunakan Capacitor-updater untuk merencanakan migrasi dan operasional enterprise, hubungkan dengan Capgo Enterprise untuk workflow produk di Capgo Enterprise, Alternatif Plugin Ionic Enterprise untuk workflow produk di Alternatif Plugin Ionic Enterprise, Alternatif Capgo untuk alur kerja produk di Alternatif Capgo, Konsultasi Capgo untuk alur kerja produk di Capgo Consulting, dan Dukungan Premium Capgo untuk alur kerja produk di Capgo Premium Support.
