Butuh lebih cepat update aplikasi tanpa delay App Store? Capgo memungkinkan Anda mengirimkan update Over-the-Air (OTA) yang aman secara instan ke pengguna. Lewati proses review app store dan jaga aplikasi Anda tetap up-to-date dengan mudah.
Poin Penting:
- Apa itu Capgo? Platform open-source untuk Live Update di Capacitor aplikasi.
- Mengapa OTA Updates? Hemat waktu, tingkatkan UX, dan perbaiki bug dengan cepat.
- How to Get Started?
- Instal plugin Capgo:
npm install @capgo/capacitor-updater - Konfigurasi aplikasi Anda dengan key API.
- Gunakan channel seperti “production” atau “beta” untuk rollout terarah.
- Instal plugin Capgo:
- Fitur Lanjutan: Enkripsi end-to-end, error handling, dan integrasi CI/CD.
Dokumentasi Capgo (capgo.app/docs) menyediakan panduan langkah demi langkah untuk setup, keamanan, dan troubleshooting. Dari instalasi hingga konfigurasi tingkat lanjut, ini adalah panduan utama Anda untuk update yang lancar.
Capgo, plugin CapacitorJs untuk Live update

Menggunakan Dokumentasi Capgo
Navigasi dokumentasi secara efektif sangat penting saat bekerja dengan OTA updates. Dokumentasi Capgo menawarkan panduan mendalam untuk integrasi Live Update ke dalam aplikasi Capacitor.
Di Mana Menemukan Dokumentasi
Anda dapat mengakses dokumentasi Capgo di capgo.app/docs [1]. Dokumentasi ini disusun dalam beberapa bagian sesuai fungsinya:
| Bagian | Tujuan | Topik Utama |
|---|---|---|
| Panduan Memulai | Setup Awal | Langkah instalasi, setup kunci API |
| Konfigurasi | Pengaturan Inti | Konfigurasi plugin, setup environment |
| Referensi API | Detail teknis | Metode, parameter, nilai balik |
| Keamanan | Langkah perlindungan | Setup enkripsi, verifikasi tanda tangan |
| Pemecahan Masalah | Troubleshooting | Masalah umum, alat diagnostik |
Istilah dan Konsep Penting
Berikut adalah beberapa istilah kunci yang akan Anda temui:
- Channel: Ini adalah stream update yang digunakan untuk mengatur distribusi versi. Misalnya, Anda bisa membuat channel “production”, “beta”, dan “staging” untuk grup pengguna yang berbeda [4].
- Kebijakan Update: Ini menentukan bagaimana update dikirim dan diterapkan. Pilihannya meliputi download otomatis, waktu instalasi, dan user prompt [1].
- App State Listeners: Komponen ini melacak apakah aplikasi sedang berada di foreground atau background [4].
- Bundle: File update terpaket yang berisi versi baru aplikasi Anda, termasuk aset, perubahan code, dan update konfigurasi [4].
Contoh dan Tutorial Code
Dokumentasi menyediakan sampel code untuk mempermudah integrasi. Berikut adalah contoh dasar menggunakan TypeScript/JavaScript:
import { CapacitorUpdater } from '@capgo/capacitor-updater'
// Initialize the updater
await CapacitorUpdater.notifyAppReady()
Untuk use case yang lebih advanced, dokumentasi juga menyertakan contoh dunia nyata [2][3], seperti:
- Switching channel untuk A/B testing
- Alur update kustom dengan user prompt
- Menangani error dan implementasi rollback
- Integrasi update dengan CI/CD pipeline
Setiap tutorial juga membahas pertimbangan performa dan aspek keamanan untuk membantu Anda mengambil keputusan yang tepat. Dokumentasi ini rutin diperbarui dengan fitur terbaru dan best practices. [1].
Untuk detail implementasi, cek panduan setup berikutnya.
Setup OTA Updates
Setup OTA updates di Capgo untuk mempercepat proses deployment Anda. Ikuti langkah dan tips ini agar konfigurasi berjalan lancar.
Langkah Dasar Setup
Mulai dengan menginstal plugin Capgo di proyek Capacitor Anda:
npm install @capgo/capacitor-updater
npx cap sync
Selanjutnya, update capacitor.config.json file dengan kunci Capgo API:
{
"plugins": {
"CapacitorUpdater": {
"autoUpdate": true,
"apiKey": "YOUR_API_KEY_HERE"
}
}
}
Kemudian, inisialisasi updater di file utama aplikasi Anda untuk mendeteksi update:
import { CapacitorUpdater } from '@capgo/capacitor-updater';
await CapacitorUpdater.notifyAppReady();
Setelah selesai, Anda dapat mengatur channel untuk mengelola berbagai aliran update.
Setup Update Channel
Organize your channel update sesuai kebutuhan deployment Anda:
| Tipe Channel | Tujuan | Kasus Penggunaan |
|---|---|---|
| Produksi | Rilis stabil | Basis pengguna umum |
| Panggung | Pengujian pra-rilis | Tim QA dan beta tester |
| Beta | Pengujian fitur | Pengguna awal |
Untuk upload update ke channel tertentu, gunakan Capgo CLI:
npx @capgo/cli upload -c production
Metode Update
Capgo menyediakan dua cara utama untuk menangani update:
Update Otomatis
Aktifkan update otomatis dengan mengatur autoUpdate: true di konfigurasi Anda. Ini memastikan update diterapkan di background tanpa perlu usaha ekstra dari developer.
Pembaruan Manual Untuk kontrol lebih, Anda bisa mengelola update secara manual. Gunakan pola berikut untuk mengecek dan menerapkan update:
// Check for updates
const update = await CapacitorUpdater.download();
// Install when ready
if (update) {
await CapacitorUpdater.set(update);
}
Untuk update kritikal, Anda bisa memberikan prompt ke user sebelum melanjutkan:
if (update.version > currentVersion) {
const userConsent = await showUpdatePrompt();
if (userConsent) {
await CapacitorUpdater.set(update);
}
}
Anda juga bisa menargetkan grup user tertentu dengan custom ID dan channel:
await CapacitorUpdater.setCustomId('beta-tester-123');
await CapacitorUpdater.setChannel('beta');
Terakhir, pastikan untuk menyertakan error handling dan opsi rollback:
try {
await CapacitorUpdater.set(update);
} catch (error) {
await CapacitorUpdater.reset(); // Revert to the last working version
console.error('Update failed:', error);
}
Dengan langkah-langkah ini, sistem OTA update Anda sudah siap digunakan. Jelajahi advanced settings untuk kustomisasi proses update lebih lanjut.
sbb-itb-f9944d2
Pengaturan Lanjutan
Tingkatkan setup Capgo OTA update dengan tambahan langkah keamanan dan konfigurasi update yang fleksibel. Opsi ini menjamin pengalaman update yang aman dan lancar sesuai panduan app store.
Fitur Keamanan
Capgo menyediakan protokol keamanan yang kuat untuk melindungi bundle update Anda dan mengirimkannya dengan aman ke pengguna. Platform ini menggunakan end-to-end encryption dengan public-key cryptography untuk semua update [1]. Berikut cara mengaktifkan fitur keamanan utama:
// Enable bundle verification
await CapacitorUpdater.setVerifyBundles(true);
// Configure encryption settings
await CapacitorUpdater.configure({
encryption: {
enabled: true,
failOnError: true
}
});
Komponen utama sistem proteksi bundle meliputi:
| Fitur Keamanan | Deskripsi | Implementasi |
|---|---|---|
| Integritas Bundle | Memverifikasi keaslian package dengan signature kriptografi | Diaktifkan otomatis dengan setVerifyBundles() |
| Proteksi rollback | Kembali ke versi stabil jika update gagal | Terintegrasi dalam proses update |
| Kontrol Akses | Mengelola update dengan permission berbasis role | Dikonfigurasi melalui dashboard |
Pengaturan Perilaku Update
Anda dapat menyesuaikan cara update dikirim dan diinstal menggunakan event listener dan opsi konfigurasi. Atur timing dan interaksi pengguna untuk update dengan pengaturan ini:
// Listen for when an update is available
CapacitorUpdater.addListener('updateAvailable', async (info) => {
if (info.version > currentVersion) {
// Custom update logic based on app state
const isAppInactive = await checkAppState();
if (isAppInactive) {
await CapacitorUpdater.download();
}
}
});
// Monitor download completion
CapacitorUpdater.addListener('downloadComplete', (info) => {
console.log(`Update ${info.version} ready to install`);
// Implement custom installation timing if desired
});
Untuk phased rollout, Anda dapat mengonfigurasi distribusi update langsung melalui dashboard atau dengan code:
// Set custom update conditions for a gradual rollout
await CapacitorUpdater.configure({
rollout: {
percentage: 25, // Start with 25% of users
timeInterval: 24 // Increase rollout percentage every 24 hours
}
});
Untuk menangani perilaku spesifik terkait versi:
// Handle version-specific update failures
CapacitorUpdater.addListener('updateFailed', async (info) => {
if (info.error.code === 'VERSION_MISMATCH') {
await CapacitorUpdater.reset(); // Revert to the last stable version
// Optionally, handle error notification here
}
});
Pengaturan ini memastikan update tetap andal sambil memungkinkan Anda menyesuaikan proses sesuai kebutuhan aplikasi. Selalu uji update secara menyeluruh di lingkungan staging Capgo sebelum merilisnya ke production [2].
Panduan Problem Solving
Log error dan tools bawaan Capgo membantu mengatasi tantangan OTA update sekaligus menjaga aplikasi Anda tetap patuh pada persyaratan store.
Masalah Umum dan Solusi
Berikut adalah beberapa masalah umum dan cara mengatasinya:
-
Download Gagal Gejala: Download macet atau gagal diselesaikan. Solusi: Periksa koneksi jaringan, pastikan URL update valid, dan tambahkan mekanisme retry untuk menangani gangguan.
-
Konflik versi Gejala: Update gagal terinstal atau menyebabkan aplikasi tidak stabil. Solusi: Gunakan nomor versi yang jelas untuk menghindari konflik dan terapkan opsi rollback demi keamanan.
-
Error Instalasi Gejala: Update gagal atau memicu rollback otomatis. Solusi: Pastikan Anda memanggil
notifyAppReady()setelah update berhasil untuk mencegah rollback.
Untuk update di atas 50MB, membaginya menjadi file yang lebih kecil dapat meningkatkan performa di perangkat Android [5].
Gunakan error logging yang detail untuk mendeteksi masalah lebih awal. Contohnya, implementasikan listener ini:
CapacitorUpdater.addListener('updateFailed', (error) => {
console.log(`Update failed: ${error.code}`);
logUpdateError({
errorCode: error.code,
deviceInfo: error.device,
timestamp: new Date().toISOString()
});
});
Dengan menggabungkan error logging dan pre-checks, Anda dapat menangani masalah ini secara efektif sebelum fokus pada kepatuhan.
Aturan App Store
Perbaikan teknis saja tidak cukup - update Anda juga harus sesuai dengan panduan app store.
Persyaratan Apple App Store:
- Transparansi Pengguna: Berikan informasi jelas mengenai isi update dan minta persetujuan pengguna.
- Fungsionalitas Utama: Pastikan fitur utama aplikasi tetap utuh seperti saat direview.
- Langkah keamanan: Gunakan metode aman untuk mengirimkan update.
Implementasi Android:
await CapacitorUpdater.configure({
updateNotification: {
title: "Update Available",
message: "A new version is available. Please update to access the latest features.",
requireUserConsent: true
}
});
Praktik Terbaik:
- Kontrol Versi: Rilis update secara bertahap untuk mengurangi konflik.
- Notifikasi Update: Berikan notifikasi update yang jelas dan user-friendly.
- Keamanan: Verifikasi integritas bundle dan gunakan enkripsi untuk melindungi data.
Ringkasan
Bagian ini merangkum poin-poin utama dari panduan tersebut.
Dokumentasi Capgo menyediakan instruksi jelas untuk mengintegrasikan update OTA ke aplikasi Capacitor sambil tetap patuh pada regulasi app store.
Dengan sumber daya Capgo, developer dapat mengimplementasikan fitur esensial seperti enkripsi end-to-end dan Integrasi CI/CD, mencakup semuanya mulai dari setup awal hingga konfigurasi tingkat lanjut [1].
Area Implementasi Utama
| Aspek | Fokus Utama | Di Mana Menemukannya |
|---|---|---|
| Keamanan | Enkripsi dan pengecekan integritas | Fitur Keamanan bagian |
| Kepatuhan | Memenuhi persyaratan Apple dan Android | Aturan App Store panduan |
| Manajemen update | Kontrol versi dan opsi rollback | Metode Update panduan |
| Penanganan error | Langkah logging dan troubleshooting | Panduan Problem Solving |
Area ini merupakan tulang punggung sistem manajemen update Capgo.
CLI dan tools analytics Capgo mempermudah mengelola update di seluruh lifecycle aplikasi Anda [1].
Untuk dukungan lebih lanjut, Anda bisa cek resource tambahan seperti dokumentasi API, contoh project, dan forum komunitas [2].
Lanjutkan dari Cara Menggunakan Dokumentasi Capgo untuk OTA Updates
Jika Anda menggunakan Cara Menggunakan Dokumentasi Capgo untuk OTA Updates untuk merencanakan keamanan dan kepatuhan, hubungkan dengan Enkripsi untuk detail implementasi pada Encryption, Kepatuhan untuk detail implementasi pada Compliance, Capgo Pemindai Keamanan untuk alur kerja produk di Capgo Security Scanner, Keamanan Capgo untuk alur kerja produk di Capgo Security, dan Capgo Pusat Kepercayaan untuk workflow produk di Capgo Trust Center.