Ringkasan

Gunakan fitur Live Updates dari Capgo untuk memperbarui bundle JavaScript aplikasi Anda secara remote dan real-time. Push update JS langsung ke pengguna Anda tanpa melalui proses review app store, sehingga bisa langsung memperbaiki bug dan merilis fitur baru.

Selalu gunakan CLI versi terbaru

Selalu jalankan Capgo CLI dengan @latest (misalnya npx @capgo/cli@latest). CLI memiliki sistem versioning sendiri dan tidak tidak perlu sama dengan versi major plugin atau Capacitor Anda. CLI terbaru akan selalu kompatibel dengan versi plugin updater apa pun yang didukung. Lihat versioning Capgo.

Catatan

Live Updates hanya terbatas pada perubahan JavaScript bundle. Jika Anda perlu memperbarui code native, seperti menambah atau menghapus plugin atau mengubah konfigurasi proyek native, Anda harus mengirimkan build native binary baru ke app store.

Cara Kerja Live Updates

Sistem Live Update milik Capgo memiliki dua komponen utama:

1. Capgo SDK, yang Anda instal di aplikasi Anda. SDK akan mengecek update yang tersedia dan mengunduhnya di background.

2. Channels, yang memungkinkan Anda menargetkan update ke grup pengguna tertentu. Anda bisa menggunakan channel untuk mengelola berbagai track rilis, seperti Production, Staging, dan Dev.

Saat Anda upload JS bundle baru ke Capgo dan menetapkannya ke sebuah channel, Capgo SDK pada aplikasi yang terkonfigurasi untuk channel tersebut akan mendeteksi update dan mengunduhnya. Saat aplikasi restart berikutnya, bundle baru akan dimuat.

Panduan Memulai

Untuk mulai menggunakan Live Updates, ikuti langkah-langkah ini:

1. Selesaikan Capgo Quickstart untuk menyiapkan aplikasi Anda di Capgo dan menginstal Capgo SDK.

2. Di dalam code aplikasi Anda, panggil CapacitorUpdater.notifyAppReady() setelah aplikasi Anda selesai melakukan inisialisasi. Ini memberi tahu Capgo SDK bahwa aplikasi Anda sudah siap menerima update.

3. Build JS bundle Anda dan upload ke Capgo:

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

4. Buka aplikasi Anda dan tunggu proses download update selesai. Anda bisa mengecek statusnya dengan:

   npx @capgo/cli@latest app debug

5. Setelah update selesai di-download, tutup dan buka kembali aplikasi untuk memuat bundle baru.

Lihat Deploy Live Update panduan untuk detail lebih lanjut.

Capgo CLI Capgo

Capgo CLI adalah tool yang powerful yang memungkinkan developer berinteraksi dengan layanan Capgo dari CI/CD pipeline mereka sendiri. Dengan CLI, Anda punya kontrol granular atas kapan build dibuat dan di-deploy, sehingga Anda dapat mengintegrasikan Capgo ke dalam workflow enterprise yang sudah ada.

Apa kegunaan Capgo CLI?

Capgo CLI dirancang untuk developer dan tim yang butuh kontrol serta fleksibilitas lebih dalam workflow live update mereka. Dengan menggunakan CLI di CI/CD pipeline, Anda dapat:

• Menentukan kapan tepatnya build dan deploy update, alih-alih hanya mengandalkan otomatisasi bawaan Capgo
• Menyisipkan proses sendiri, seperti signing code, QA testing, atau approval manajer, di antara langkah build dan deploy
• Mengintegrasikan Capgo ke dalam DevOps tooling dan workflow yang sudah ada

Autentikasi

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

Untuk login dan menyimpan API key Anda dengan aman, jalankan:

npx @capgo/cli@latest login [API_KEY]

Perintah ini akan disimpan untuk penggunaan mendatang. Anda tidak perlu lagi memasukkan kunci API setiap kali menjalankan perintah setelah login.

Perbedaan Utama dengan CLI Tools Lainnya

Jika Anda terbiasa dengan CLI live update tools lainnya, ada beberapa hal penting terkait CLI dari Capgo:

• Capgo menggunakan satu CLI untuk kebutuhan pengembangan maupun CI/CD, karena Capgo hanya berfokus pada fitur live update.

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

• CLI Capgo dirancang khusus untuk workflow live update, sehingga mungkin tidak menyertakan beberapa fitur atau command yang ada pada CLI tools yang lebih umum.

Next Steps

Channel

Pelajari cara menggunakan channel untuk mengelola berbagai track rilis dan menargetkan update ke user tertentu.

Rollback

Cari tahu cara rollback ke versi JS bundle sebelumnya jika update menyebabkan masalah.

Perilaku Update

Sesuaikan cara dan kapan update diunduh serta diterapkan di dalam aplikasi Anda.

Update Cepat

Pelajari cara menggunakan fast updates untuk mempercepat proses update.

Lanjutkan dari Overview

Jika Anda menggunakan Ringkasan untuk merencanakan operasi dashboard dan API, hubungkan dengan Ikhtisar API untuk detail implementasi di Ringkasan API, Pendahuluan untuk detail implementasi di Pendahuluan, Kunci API untuk detail implementasi pada API Keys, Perangkat untuk detail implementasi pada Devices, dan Bundle untuk detail implementasi di Bundles.