Update aplikasi Capacitor Anda secara lancar menggunakan pembaruan Capacitor

Apa itu pembaruan Capacitor?

Pembaruan Capacitor, teknologi yang membantu dalam pengiriman pembaruan dan perbaikan aplikasi ke pengguna akhir secara instan.

Hal ini sangat baik jika Anda ingin melakukan perbaikan bug kritikal dan mengirimkannya secara instan tanpa harus melewati ulasan App Store.

Anda dapat memikirkannya sebagai kecepatan “seperti web” dalam memuat pembaruan sisi-atas secara segera setelah tersedia.

Selain itu, ia menyediakan pengembalian ke versi sebelumnya jika pembaruan baru menghancurkan aplikasi

Bagaimana cara kerjanya?

Capgo menjaga agar bundle JavaScript aplikasi Anda sinkron dengan server Capgo, dan setiap kali pengguna membuka aplikasi, ia memeriksa dengan server Capgo apakah ada pembaruan baru yang tersedia untuk bundle. Dan tentu saja, ia dilengkapi dengan banyak konfigurasi yang luar biasa yang dapat membantu Anda menyesuaikan pengalaman pengguna.

Saya menggunakan Capgo di semua proyek yang saya bangun. Hal ini memungkinkan saya untuk menghabiskan waktu yang lebih sedikit dalam proses tinjauan App Store.

Anda dapat membaca lebih lanjut tentang hal ini di sini.

Mengerti Versi Semantik dengan Capgo

Capgo menggunakan versi semantik (semver) untuk menentukan kapan dan bagaimana pembaruan harus diterapkan ke aplikasi Anda. Hal ini memastikan bahwa pengguna Anda hanya menerima pembaruan yang kompatibel dan mencegah perubahan yang menghancurkan dari terautomasi.

Versi semantik mengikuti format MAJOR.MINOR.PATCH:

• MAJOR: Perubahan yang memerlukan rilis aplikasi toko native
• MINOR: Fitur-fitur baru yang kompatibel dengan versi sebelumnya
• PATCH: Perbaikan bug yang kompatibel dengan versi sebelumnya

Untuk contoh, jika aplikasi Anda berada di versi 1.0.0 dan Anda ingin mengupdate ke 1.0.1 (sebuah patch), Capgo akan secara otomatis menerapkan update ini. Namun, jika Anda ingin mengupdate dari 1.0.0 ke 2.0.0 (sebuah versi mayor), hal ini memerlukan rilis aplikasi native di toko aplikasi karena menunjukkan perubahan yang mengganggu.

Capgo’s pengaturan saluran memungkinkan Anda untuk mengkonfigurasi jenis-jenis update yang secara otomatis diterapkan:

• Strategi mayor: Izinkan semua update (gunakan dengan hati-hati)
• Strategi minor: Hanya memungkinkan pembaruan minor dan patch saja
• Pengaturan Patch: Hanya memungkinkan pembaruan patch saja
• Pengaturan Metadata: Memerlukan persyaratan versi minimum untuk dipenuhi

Kamu bisa menguji bagaimana kombinasi versi berbeda bekerja dengan logika pembaruan Capgo menggunakan alat tester Semver kami Alat Tester Semver. Alat ini membantu kamu memahami secara tepat kapan pembaruan akan diterapkan berdasarkan konfigurasi kanal kamu

Apakah ada batasan?

Sebaik apa pun yang terdengar, ada beberapa hal yang perlu kita ingat. Pertama-tama, pembaruan OTA. You may think that this isn’t really a big limitation because, in Capacitor JS, we write almost all code in JS CSS and HTML. While this may be true, there still are native modules that we install to our app. If a module changes your android or iOS directories, you can’t use OTA to update your app. That’s because these directories’ contents are used to compile Native binaries, which OTA can’t update. Even native app cannot update this part.

Tapi Anda bisa mengatur CI/CD untuk menangani bagian ini, saya membuat tutorial tentang cara melakukannya di sini untuk IOS.

Konfigurasi Otomatis Capgo

Sekarang saatnya mendaftar dan mendapatkan kunci API untuk mengunggah versi pertama! signing up for a Capgo account.

mendaftar untuk akun Capgo

Halaman Onboarding

Follow the CLI guidance

Ikuti panduan Capacitor

npx @capgo/cli@latest init To install the Capgo into your Capacitor app, the CLI will walk you through the process of setting up your app with Capgo.

Untuk menginstal __CAPGO_KEEP_0__ ke dalam aplikasi __CAPGO_KEEP_1__, __CAPGO_KEEP_2__ akan memandu Anda melalui proses pengaturan aplikasi Anda dengan __CAPGO_KEEP_3__.

Konfigurasi Manual Capgo

Pasang plugin

Anda seharusnya memiliki code ini ditambahkan ke aplikasi Anda :

npm i @capgo/capacitor-updater && npx cap sync Untuk memasang plugin ke aplikasi Capacitor Anda.

Dan kemudian tambahkan ke aplikasi Anda code ini untuk memberitahu plugin native bahwa bundle JS sudah sehat (jika Anda tidak melakukannya, plugin native akan kembali ke versi sebelumnya):

import { CapacitorUpdater } from '@capgo/capacitor-updater'

CapacitorUpdater.notifyAppReady()

Ini akan memberitahu plugin native bahwa instalasi sudah berhasil.

Lalu lakukan npm run build && npx cap copy untuk memperbarui aplikasi Anda.

Masuk ke Capgo CLOUD

Pertama, gunakan all apikey yang ada di akun Anda untuk masuk dengan CLI:

npx @capgo/cli@latest login YOU_KEY

Tambahkan aplikasi pertama Anda

Mari kita mulai dengan membuat aplikasi di Capgo Cloud dengan menggunakan CLI.

npx @capgo/cli@latest app add

Perintah ini akan menggunakan semua variabel yang telah ditentukan di dalam file konfigurasi Capacitor untuk membuat aplikasi.

Unggah versi pertama Anda

Jalankan perintah untuk membangun code dan kirimkannya ke Capgo dengan: npx @capgo/cli@latest bundle upload

Dengan default, nama versi akan sama dengan yang ada di dalam file. package.json Periksa di

__CAPGO_KEEP_0__ Capgo Anda bahkan bisa menguji aplikasi tersebut dengan menggunakan aplikasi sandbox mobile saya

Cek masuk ke __CAPGO_KEEP_0__.

Buat saluran default

Setelah Anda telah mengirimkan aplikasi ke Capgo, Anda perlu membuat saluran default untuk memungkinkan aplikasi menerima pembaruan dari Capgo.

npx @capgo/cli@latest channel set production -s default

Terima Pembaruan Langsung pada Perangkat

Untuk aplikasi Anda menerima pembaruan langsung dari Deploy, Anda perlu menjalankan aplikasi pada perangkat atau emulator. Cara termudah untuk melakukannya adalah dengan menggunakan perintah berikut untuk meluncurkan aplikasi lokal di emulator atau perangkat yang terhubung ke komputer.

npx cap run [ios | android]

Buka aplikasi, letakkan di latar belakang dan buka lagi, Anda seharusnya melihat di log bahwa aplikasi melakukan pembaruan.

Selamat! 🎉 Anda telah berhasil mengembangkan pembaruan hidup pertama Anda. Ini hanya awal dari apa yang dapat Anda lakukan dengan Pembaruan Langsung. Untuk mempelajari lebih lanjut, lihat dokumen Pembaruan Langsung yang lengkap Jika Anda perlu menghentikan menerima pembaruan lokal, jalankan perintah ini.

Ditulis oleh npx @capgo/cli@latest channel set