Ringkasan

Pakai fitur Capgo’s Live Updates untuk memperbarui bundle JavaScript aplikasi Anda secara remote, secara real-time. Sampaikan pembaruan JS langsung ke pengguna Anda tanpa harus melewati proses ulasan aplikasi store untuk memperbaiki bug dan mengirimkan fitur baru secara instan.

Selalu gunakan CLI yang terbaru.

Selalu jalankan Capgo CLI dengan @latest (misalnya npx @capgo/cli@latest). CLI mengikuti versi sendiri dan tidak perlu sesuai dengan versi mayor plugin atau Capacitor mayor. Versi terbaru CLI tetap kompatibel dengan versi plugin pembaruan yang didukung. Lihat Capgo versioning.

Catatan

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

Pembaruan Langsung Bagaimana

Sistem Capgo Live Update memiliki dua komponen utama:

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

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

Saat Anda mengunggah bundle JS baru ke Capgo dan mengasosiasikannya dengan saluran, Capgo SDK di aplikasi yang dikonfigurasi untuk saluran tersebut akan mendeteksi update dan mengunduhnya. Saat aplikasi di-restart, bundle baru akan di-load.

Mulai Menggunakan CLI

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

1. Selesaikan Capgo Panduan Cepat 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 update.

3. Bangunlah bundle JS Anda dan unggah ke Capgo:

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

4. Buka aplikasi Anda dan tunggu update untuk diunduh. Anda dapat memeriksa status dengan:

   npx @capgo/cli@latest app debug

5. Setelah update diunduh, tutup dan buka kembali aplikasi Anda untuk memuat bundle baru.

Lihatlah Mengaktifkan Pembaruan Langsung panduan untuk informasi lebih lanjut.

The Capgo CLI

Alat Capgo CLI ini adalah alat yang kuat yang memungkinkan para pengembang untuk berinteraksi dengan layanan Capgo dari pipeline CI/CD mereka sendiri. Dengan menggunakan CLI, Anda memiliki kontrol yang sangat halus atas kapan bangunan dibuat dan diterapkan, sehingga memungkinkan Anda untuk mengintegrasikan Capgo ke dalam alur kerja perusahaan Anda yang sudah ada.

What is the Capgo CLI for?

Alat Capgo CLI ini dirancang untuk pengembang dan tim yang membutuhkan kontrol dan fleksibilitas yang lebih besar dalam alur kerja live update mereka. Dengan menggunakan CLI dalam pipeline CI/CD mereka, Anda dapat:

• Mengatur secara tepat kapan untuk membangun dan menerapkan pembaruan, bukan bergantung pada otomatisasi yang sudah ada di Capgo
• Memasukkan proses sendiri, seperti tanda tangan code, pengujian QA, atau persetujuan manajer, antara langkah membangun dan menerapkan
• 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 membuat 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 kemudian akan disimpan untuk digunakan di masa depan. Anda tidak perlu menyediakan kunci API Anda dengan setiap perintah setelah masuk.

Perbedaan Utama dari Alat-Alat Lain CLI

Jika Anda sudah familiar dengan alat-alat lain live update CLI lainnya, ada beberapa hal penting yang perlu Anda perhatikan tentang Capgo’s CLI:

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

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

• Capgo’s CLI dirancang secara khusus untuk alur kerja live update, sehingga mungkin tidak termasuk fitur atau perintah tertentu yang ditemukan dalam alat-alat CLI umum.

Next Steps

Saluran-Saluran

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

Rollback

Tentukan cara untuk 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

Belajar cara menggunakan pembaruan cepat untuk mempercepat proses pembaruan.

Jika Anda menggunakan

untuk merencanakan dashboard dan operasi __CAPGO_KEEP_0__, hubungkannya dengan Pembaruan Untuk merencanakan dashboard dan operasi API, hubungkannya dengan Ringkasan API untuk detail implementasi di Ringkasan API Pendahuluan untuk detail implementasi di Pendahuluan Kunci API untuk detail implementasi di Kunci API Perangkat untuk detail implementasi di Perangkat. Bundles untuk detail implementasi di Paket.