Ringkasan

Gunakan fitur Capgo Live Updates untuk memperbarui bundle JavaScript aplikasi Anda secara remote, secara real-time. Sampaikan pembaruan JS langsung kepada pengguna Anda tanpa harus melewati proses tinjauan toko aplikasi untuk memperbaiki bug dan mengirimkan fitur baru secara instan.

Selalu gunakan versi terbaru CLI

Jalankan Capgo CLI secara terus-menerus dengan @latest Misalnya npx @capgo/cli@latestFitur CLI mengikuti versi sendiri dan tidak perlu sesuai dengan versi mayor plugin Anda atau versi mayor Capacitor. Versi terbaru CLI tetap kompatibel dengan versi plugin pembaruan yang didukung apa pun. Lihat Versi Capgo.

Peringatan

Pembaruan Live terbatas pada perubahan bundle JavaScript. Jika Anda memerlukan memperbarui code native, seperti menambahkan atau menghapus plugin atau mengubah konfigurasi proyek native, Anda perlu mengirimkan build binary native baru ke toko aplikasi.

Bagaimana Live Updates Bekerja

Sistem Perbarui Hidup Capgo memiliki dua komponen utama:

1. Capgo SDK yang Anda instal di aplikasi. SDK memeriksa perbarui yang tersedia dan mengunduhnya di latar belakang.

2. Saluran, yang memungkinkan Anda menargetkan perbarui ke kelompok pengguna tertentu. Anda dapat menggunakan saluran untuk mengelola jalur rilis yang berbeda, seperti Production, Staging, dan Dev.

Ketika Anda mengunggah bundle JS baru ke Capgo dan menetapkan saluran untuk itu, Capgo SDK di aplikasi yang dikonfigurasi untuk saluran tersebut akan mendeteksi perbarui dan mengunduhnya. Saat aplikasi restart, bundle baru akan diisi.

Mengawali

Untuk memulai menggunakan Live Updates, ikuti langkah-langkah berikut:

1. Selesai dengan Capgo Quickstart Untuk mengatur aplikasi Anda di Capgo dan menginstal Capgo SDK.

2. Dalam aplikasi code, panggil CapacitorUpdater.notifyAppReady() setelah aplikasi Anda telah selesai menginisialisasi. Ini memberitahu Capgo SDK bahwa aplikasi Anda siap untuk menerima pembaruan.

3. Buatlah bundle JS Anda dan unggah ke Capgo:

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

4. Buka aplikasi Anda dan tunggu pembaruan untuk didownload. Anda dapat memeriksa status dengan:

   npx @capgo/cli@latest app debug

5. Setelah pembaruan didownload, tutup dan buka kembali aplikasi Anda untuk memuat bundle baru.

Lihat di Mengembangkan Pembaruan Langsung Petunjuk untuk detail lebih lanjut.

The Capgo CLI

The Capgo CLI adalah alat yang kuat yang memungkinkan pengembang untuk berinteraksi dengan layanan Capgo dari pipeline CI/CD mereka sendiri. Dengan CLI, Anda memiliki kontrol yang granular ketika bangunan diproduksi dan di-deploy, sehingga memungkinkan Anda untuk mengintegrasikan Capgo ke dalam alur kerja perusahaan Anda yang sudah ada.

Apa itu Capgo CLI?

The Capgo CLI dirancang untuk pengembang dan tim yang membutuhkan kontrol dan fleksibilitas yang lebih dalam alur update mereka yang hidup. Dengan menggunakan CLI di pipeline CI/CD mereka, Anda dapat:

• Mengambil keputusan tepat kapan untuk membangun dan meng-deploy update, bukan bergantung pada otomatisasi yang sudah dibangun oleh Capgo
• Menginsert proses sendiri, seperti tanda tangan code, pengujian QA, atau persetujuan manajer, antara langkah membangun dan meng-deploy
• Mengintegrasikan Capgo ke dalam alat DevOps dan alur kerja yang sudah ada

Autentikasi

Untuk menggunakan Capgo CLI, Anda perlu melakukan autentikasi dengan menggunakan kunci API Anda. Anda dapat menghasilkan kunci API di pengaturan akun Capgo Anda.

Untuk masuk dan menyimpan kunci API Anda dengan aman, jalankan:

npx @capgo/cli@latest login [API_KEY]

Perintah ini akan disimpan untuk digunakan di masa depan. Anda tidak perlu menyediakan kunci API Anda dengan setiap perintah setelah masuk.

Perbedaan Utama dari Alat CLI Lainnya

Jika Anda sudah familiar dengan alat pembaruan hidup CLI lainnya, ada beberapa hal penting yang perlu Anda ketahui tentang Capgo’s CLI:

• Capgo menggunakan satu CLI untuk kedua kasus pengembangan dan penggunaan CI/CD, karena Capgo difokuskan secara eksklusif pada fitur set pembaruan hidup.

• Capgo CLI tidak memerlukan langkah instalasi terpisah. Ini sudah dibundel dengan @capgo/cli package dan dapat dijalankan secara langsung menggunakan npx.

• Capgo’s CLI dirancang secara khusus untuk alur kerja pembaruan hidup, sehingga mungkin tidak termasuk beberapa fitur atau perintah yang ditemukan di alat CLI umumnya.

Langkah-Langkah Berikutnya

Saluran

Pelajari cara menggunakan saluran untuk mengelola jalur rilis yang berbeda dan mengarahkan pembaruan ke pengguna tertentu.

Pengembalian

Tentukan cara kembali ke versi bundle JS sebelumnya jika pembaruan menyebabkan masalah.

Pengaturan Pembaruan

Tentukan cara dan kapan pembaruan diunduh dan diterapkan di aplikasi Anda.

Pembaruan Cepat

Pelajari cara menggunakan pembaruan cepat untuk mempercepat proses pembaruan.

Teruskan dari Ringkasan

Jika Anda menggunakan Ringkasan untuk merencanakan dashboard dan API operasi, hubungkannya dengan API Ringkasan untuk detail implementasi di API Ringkasan, Pendahuluan untuk detail implementasi di Pendahuluan, API Kunci untuk detail implementasi di API Kunci, Perangkat untuk detail implementasi di Perangkat, dan Bundel untuk detail implementasi di Bundles.