Ikhtisar

Gunakan fitur Live Updates dari Capgo untuk memperbarui bundle JavaScript aplikasi Anda secara remote, dalam waktu nyata. Kirim pembaruan JS langsung ke pengguna Anda tanpa harus melewati proses review app store, sehingga bug bisa diperbaiki dan fitur baru dirilis secara instan.

Selalu gunakan CLI terbaru

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

Catatan

Live Update hanya terbatas pada perubahan bundle JavaScript. Jika Anda perlu memperbarui code native, seperti menambahkan atau menghapus plugin atau mengubah konfigurasi proyek native, Anda harus mengirim build biner native baru ke app store.

Cara Kerja Live Updates

Sistem Live Update dari Capgo memiliki dua komponen utama:

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

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

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

Panduan Memulai

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

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

2. Di code aplikasi Anda, panggil CapacitorUpdater.notifyAppReady() setelah aplikasi Anda selesai inisialisasi. Ini memberi tahu Capgo SDK bahwa aplikasi Anda 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 Updates panduan untuk detail lebih lanjut.

Capgo CLI Capgo

The Capgo CLI is a powerful tool that allows developers to interact with Capgo’s services from their own CI/CD pipelines. With the CLI, you have granular control over when builds are produced and deployed, enabling you to integrate Capgo into your existing enterprise workflows.

Apa kegunaan Capgo CLI?

The Capgo CLI is designed for developers and teams who need more control and flexibility in their live update workflows. By using the CLI in your CI/CD pipelines, you can:

• Tentukan secara persis kapan build dan deploy update, alih-alih mengandalkan otomasi bawaan Capgo
• Sisipkan proses Anda sendiri, seperti penandatanganan code, pengujian QA, atau persetujuan manajer, di antara langkah build dan deploy
• Integrasikan Capgo ke dalam tooling dan workflow DevOps yang sudah ada

Autentikasi

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

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

npx @capgo/cli@latest login [API_KEY]

Perintah ini akan disimpan untuk digunakan nanti. Setelah login, Anda tidak perlu lagi memberikan key API Anda di setiap perintah.

Perbedaan utama dengan tool CLI lainnya

Jika Anda sudah terbiasa dengan tool live update CLI lain, ada beberapa hal penting yang perlu diketahui tentang CLI dari Capgo:

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

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

• Capgo's CLI dirancang khusus untuk alur kerja live update, sehingga mungkin tidak mencakup beberapa fitur atau perintah yang ditemukan pada alat CLI yang lebih umum.

Langkah Berikutnya

Channel

Pelajari cara menggunakan channel untuk mengelola berbagai jalur rilis dan menargetkan update ke pengguna tertentu.

Rollback

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

Perilaku Update

Sesuaikan cara dan waktu update diunduh serta diterapkan di aplikasi Anda.

Update cepat

Pelajari cara menggunakan update cepat untuk mempercepat proses update.

Lanjutkan dari Overview

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