Ikhtisar

Tutorial quickstart ini akan memandu Anda melalui konsep-konsep utama Capgo! Konsep yang akan dibahas meliputi:

1. Menambahkan aplikasi ke akun Capgo Anda

2. Integrasi Capgo dengan CI/CD Anda

3. Memicu upload bundle ke Capgo dengan push commit

4. Konfigurasi dan kustomisasi publishing bundle Capgo

5. Menyiapkan aplikasi untuk mengaktifkan live updates via Capgo

6. Deploy live updates ke aplikasi Anda dari Capgo

Cukup ikuti panduan langkah demi langkah, atau langsung buka dokumentasi komponen yang Anda minati.

Mulai tutorial

Ikuti tutorial quickstart ini dan segera mulai menggunakan Capgo dalam sekejap!

Panduan Onboarding CLI

Panduan lengkap langkah demi langkah untuk proses onboarding CLI yang interaktif.

Rilis update

Rilis update ke aplikasi Anda dari dashboard Capgo.

Otomatiskan update

Integrasikan Capgo dengan CI/CD Anda dan picu upload bundle di Capgo dengan push commit.

Troubleshooting

Masalah umum dan cara menyelesaikannya.

Penutup

Selesaikan tutorial dan dapatkan ringkasan singkat tentang apa yang telah Anda pelajari.

Tips

Fitur update Over-the-Air (OTA) hanya berlaku untuk perubahan pada file HTML, CSS, dan JavaScript.

Jika Anda melakukan perubahan apa pun pada code native, seperti update pada plugin Capacitor, Anda wajib submit ulang aplikasi ke app store untuk persetujuan.

Kerahasiaan Bundle

Anggap setiap bundle yang di-upload ke Capgo sebagai aset web publik kecuali Anda mengaktifkan enkripsi Capgo. Private channel mengatur perangkat mana yang berhak menerima update, tetapi tidak membuat bundle yang di-upload jadi rahasia. Enkripsi melindungi jalur pengiriman dan mencegah pihak ketiga membuat update terenkripsi yang valid, tetapi aset web yang sudah terkirim tetap bisa di-reverse engineer dari aplikasi dengan usaha yang cukup, karena public key ikut didistribusikan di dalam binary. Lihat enkripsi Live Update.

Gabung komunitas Discord

Gabung ke Server Discord Capgo!

Pemeliharaan

Versi plugin	Kompatibilitas Capacitor	Dipelihara
v7.*.* (≥7.25.0)	v7.*.*	✅ Didukung penuh
v6.*.* (≥6.25.0)	v6.*.*	✅ Didukung penuh
v5.*.* (≥5.10.0)	v5.*.*	✅ Didukung penuh
v5.*.* (<5.10.0)	v5.*.*	⚠️ Tidak disarankan
v4.*.*	v4.*.*	❌ Tidak lagi didukung
v3.*.*	v3.*.*	❌ Tidak lagi didukung
>= 8	v4.*.*	⚠️ Tidak disarankan karena masalah versioning di proses CI kami

Kepatuhan Pedoman Store

Android Google Play dan iOS App Store memiliki pedoman yang memuat aturan yang perlu Anda ketahui sebelum mengintegrasikan solusi Capacitor-updater ke dalam aplikasi Anda.

Google Play

Paragraf ketiga dari Penyalahgunaan Perangkat dan Jaringan topik menjelaskan bahwa memperbarui source code dengan metode apa pun selain mekanisme update Google Play dibatasi. Namun pembatasan ini tidak berlaku untuk memperbarui bundle JavaScript.

Pembatasan ini tidak berlaku untuk code yang berjalan di virtual machine dan memiliki akses terbatas ke API Android (seperti JavaScript di webview atau browser).

Hal ini sepenuhnya mengizinkan Capacitor-updater karena hanya memperbarui bundle JS dan tidak akan memperbarui code native.

App Store

Paragraf 3.3.2, sejak tahun 2015 Perjanjian Lisensi Apple Developer Program sepenuhnya mengizinkan update over-the-air untuk JavaScript dan assets - dan pada versi terbarunya (20170605) dapat diunduh di sini keputusan ini bahkan lebih luas:

code yang diinterpretasikan boleh diunduh ke Aplikasi hanya selama code tersebut: (a) tidak mengubah tujuan utama Aplikasi dengan menyediakan fitur atau fungsionalitas yang tidak konsisten dengan tujuan yang dimaksudkan dan diiklankan dari Aplikasi sebagaimana diajukan ke App Store, (b) tidak membuat toko atau storefront untuk code atau aplikasi lain, dan (c) tidak mem-bypass signing, sandbox, atau fitur keamanan OS lainnya.

Capacitor Updater memungkinkan Anda mematuhi aturan-aturan ini sepenuhnya, selama update yang Anda push tidak menyimpangkan produk Anda secara signifikan dari niat asli yang disetujui App Store.

Untuk tetap patuh terhadap pedoman Apple, kami menyarankan agar aplikasi yang didistribusikan melalui App Store tidak mengaktifkan Force update skenario, karena di Panduan Peninjauan App Store keadaan yang:

Aplikasi tidak boleh memaksa pengguna untuk menilai aplikasi, meninjau aplikasi, mengunduh aplikasi lain, atau tindakan serupa lainnya untuk mengakses fungsionalitas, konten, atau penggunaan aplikasi.

Ini bukan masalah untuk perilaku default background update, karena tidak akan memaksa pengguna untuk menerapkan versi baru sampai mereka menutup aplikasi berikutnya, tetapi setidaknya Anda harus menyadari peran tersebut jika Anda memutuskan untuk menampilkannya.

Open source

Plugin ini menggunakan lisensi LGPL-3.0, sedangkan back-end menggunakan lisensi AGPL-3.0.

💡 LGPL-3.0 berarti jika seseorang memodifikasi code dari plugin ini, mereka wajib mempublikasikannya secara open-source dengan lisensi yang sama. Jika Anda menggunakan code tanpa modifikasi, itu bukan urusan Anda. Lihat issue di bawah untuk detail lebih lanjut, cek tautannya 👇

Lisensi?

Coba GPTS Capgo untuk mendapatkan bantuan alih-alih membaca dokumentasi

Anda bisa menyertakannya di aplikasi Anda tanpa perlu khawatir

Catatan Akhir

Jika Anda self-host dan merasa alat ini berguna, pertimbangkan untuk mendukung kerja saya dengan menjadi sponsor GitHub.

Saya bertaruh untuk membuat semua code yang saya bangun di sini menjadi open-source, bukan memasang paywall. Dengan membukanya alih-alih melawan dan menyembunyikannya, saya percaya kita bisa membuat dunia jadi tempat yang lebih baik.

Untuk mewujudkannya, kita semua perlu menjalankan bagian kita masing-masing, termasuk Anda 🥹. Jika Capgo cloud tidak memenuhi kebutuhan Anda, Anda bisa mendukung pembuat aplikasi mandiri di GitHub Sponsors dengan syarat Anda sendiri.

Matematika Sederhana

Harga paket basic: $14*12 = $168 per tahun. Sedangkan rata-rata dev/jam = $60. Artinya, 3 jam waktu dev yang terbuang untuk self-host setara dengan biaya satu tahun penuh. Jika lebih dari 3 jam, Anda malah rugi ^^

Lanjutkan dari Overview

Jika Anda menggunakan Ikhtisar untuk merencanakan otomatisasi CI/CD, hubungkan dengan CI/CD Capgo untuk workflow produk di Capgo CI/CD, Capgo Native Build untuk workflow produk di Capgo Native Builds, Integrasi Capgo untuk alur kerja produk di Integrasi Capgo, Integrasi CI/CD untuk detail implementasi di Integrasi CI/CD, dan Integrasi GitHub Actions untuk detail implementasi di Integrasi GitHub Actions.