Ikhtisar

Tutorial quickstart ini akan memandu Anda memahami 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. Setup aplikasi untuk mengaktifkan live updates via Capgo

6. Deploy live updates ke aplikasi Anda dari Capgo

Ikuti panduan ini langkah demi langkah, atau langsung buka dokumentasi komponen yang Anda butuhkan.

Mulai Tutorial

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

Panduan Onboarding CLI

Panduan langkah demi langkah untuk proses onboarding CLI yang interaktif.

Rilis update

Kirim update ke aplikasi Anda dari dashboard Capgo.

Otomatisasi update

Integrasikan Capgo dengan CI/CD Anda dan trigger upload bundle ke Capgo cukup dengan push commit.

Troubleshooting

Masalah umum dan cara mengatasinya.

Kesimpulan

Ringkasan tutorial dan tinjauan 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 mengontrol perangkat mana yang berhak menerima update, tetapi tidak membuat bundle yang di-upload menjadi rahasia. Enkripsi melindungi jalur pengiriman dan mencegah pihak ketiga membuat update terenkripsi yang valid, namun aset web yang dikirimkan tetap bisa di-reverse engineer dari aplikasi dengan upaya yang cukup karena public key didistribusikan di dalam binary. Lihat enkripsi Live Update.

Gabung komunitas Discord

Gabung ke Capgo Discord Server!

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.*.*	⚠️ Deprecated
v4.*.*	v4.*.*	❌ Tidak lagi didukung
v3.*.*	v3.*.*	❌ Tidak lagi didukung
>= 8	v4.*.*	⚠️ Deprecated karena masalah versi pada proses CI kami

Kepatuhan Panduan Store

Google Play di Android dan App Store di iOS memiliki panduan terkait dengan aturan yang perlu Anda pahami sebelum mengintegrasikan solusi Capacitor-updater ke dalam aplikasi Anda.

Google Play

Paragraf ketiga dari Penyalahgunaan Perangkat dan Jaringan topik menjelaskan bahwa memperbarui sumber code dengan metode apa pun selain mekanisme pembaruan Google Play dibatasi. Namun, pembatasan ini tidak berlaku untuk memperbarui javascript bundles.

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

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

App Store

Paragraf 3.3.2, sejak tahun 2015 Perjanjian Lisensi Apple Developer Program sepenuhnya mengizinkan pembaruan over-the-air untuk JavaScript dan aset - dan pada versi terbarunya (20170605) dapat diunduh di sini aturan 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 mengikuti aturan ini sepenuhnya, selama update yang Anda push tidak mengubah fungsi utama produk Anda secara signifikan dari persetujuan awal App Store.

Agar tetap patuh pada panduan Apple, kami menyarankan agar aplikasi yang didistribusikan via App Store tidak mengaktifkan Force update skenario, karena dalam Panduan Peninjauan App Store menyatakan bahwa:

Aplikasi tidak boleh memaksa pengguna untuk memberi rating, ulasan, mengunduh aplikasi lain, atau tindakan serupa lainnya demi mengakses fungsi, konten, atau penggunaan aplikasi.

Ini bukan masalah untuk perilaku default background update, karena tidak akan memaksa pengguna menerapkan versi baru sampai mereka menutup aplikasi, namun Anda harus tetap memperhatikan hal ini jika memutuskan untuk menampilkannya.

Open source

Plugin ini menggunakan lisensi LGPL-3.0 dan back-end menggunakan lisensi AGPL-3.0.

💡 LGPL-3.0 berarti jika seseorang memodifikasi code plugin ini, mereka wajib mempublikasikannya sebagai open-source dengan lisensi yang sama. Jika Anda menggunakan code tanpa modifikasi, hal itu tidak berpengaruh bagi Anda. Cek detailnya pada isu di bawah ini 👇

Lisensi?

Coba Capgo GPTS untuk bantuan daripada membaca dokumentasi

Anda bisa menyertakannya di aplikasi tanpa perlu khawatir

Catatan Akhir

Jika Anda melakukan self-host dan merasa alat ini bermanfaat, pertimbangkan untuk mendukung karya saya dengan menjadi sponsor GitHub.

Saya bertaruh untuk menjadikan semua code yang saya buat di sini sebagai open-source daripada menjadikannya paywall. Dengan membukanya alih-alih bersembunyi, saya percaya kita bisa membuat dunia jadi lebih baik.

Agar ini terwujud, kita semua perlu berperan, termasuk Anda 🥹. Jika Capgo cloud tidak sesuai kebutuhan Anda, Anda bisa mendukung maker bootstrapped di GitHub Sponsors sesuai keinginan Anda.

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.