Cara Menggunakan Capgo untuk Membuat Perbaruan yang Lebih Tipis dan Cepat

Perbaruan yang paling baik adalah perbaruan yang tidak terasa oleh pengguna.

Biasanya berarti tiga hal:

1. Unduhan yang kecil.
2. Pengaturan yang terkendali.
3. Recovery instant jika ada kesalahan.

The same “keep OTA lean” advice that works in React Native land also applies to Capgo. The difference is that Capgo gives Capacitor teams a few extra levers: keep OTA lean, yang berlaku di React Native juga berlaku untuk __CAPGO_KEEP_0__. Perbedaan adalah bahwa __CAPGO_KEEP_1__ memberikan tim __CAPGO_KEEP_2__ beberapa alat tambahan:, Pembaruan delta, saluranpengembalian otomatis target versi.

, dan enkripsi akhir-ke-akhir

Jika Anda menggunakan kombinasi tersebut, Anda akan mendapatkan muatan yang lebih kecil, instalasi yang lebih cepat, dan banyaknya kekacauan operasional yang lebih sedikit.

One useful Capgo-specific detail: Capgo MAU is effectively the number of monthly active devices that contacted the update service in the last 30 days.

Detail yang berguna __CAPGO_KEEP_0__-spesifik: MAU __CAPGO_KEEP_1__ adalah sebenarnya jumlah perangkat aktif bulanan yang menghubungi layanan pembaruan dalam 30 hari terakhir.

• Download lebih cepat di jaringan seluler atau Wi-Fi lemah
• Pengalaman yang lebih baik dengan perbaruan langsung
• Kurangi penggunaan bandwidth yang sia-sia karena perbaruan gagal atau dibatalkan
• Radius ledakan yang lebih kecil saat melakukan pengujian atau tahap pra-rilis

Perbaruan yang lebih sederhana sebenarnya tentang kecepatan, keamanan, dan disiplin operasional.

1. Tetapkan Perbaruan Delta sebagai default

Jika Anda hanya melakukan satu hal, lakukan ini.

Capgo’s Perbaruan Delta mengirim hanya file yang berubah antara versi daripada mengunduh kembali paket web penuh.

bun run build
bunx @capgo/cli@latest bundle upload --channel staging --delta

Itu adalah kemenangan tunggal terbesar untuk kinerja OTA rutin.

bunx @capgo/cli@latest bundle upload --channel production --delta

If Anda ingin CI tetap ketat, gunakan --delta-only agar tidak ada yang secara tidak sengaja kembali ke unggahan bundle penuh:

bunx @capgo/cli@latest bundle upload --channel production --delta-only

Hanya gunakan --delta-only ketika armada produksi Anda mendukung pembaruan Delta. Pada versi plugin campuran, perangkat yang lebih tua yang tidak mendukung penyampaian delta berdasarkan manifesto tidak akan dapat mengunduh pembaruan tersebut.

Hal ini lebih penting lagi jika Anda menggunakan directUpdate, karena waktu antara “ditemukan pembaruan” dan “aplikasi di-reload” menjadi terlihat bagi pengguna.

2. Tatal aset seperti aset, bukan beban JavaScript

Aset besar adalah di mana bundle OTA diam-diam menjadi buncit.

Beberapa aturan praktis:

• Tidak inlin gambar besar atau media di dalam JavaScript ketika file aset normal akan cukup.
• Jaga konten yang sering berubah di CDN Anda sendiri atau API jika tidak perlu hidup di dalam bundle aplikasi yang dikirimkan.
• Berhati-hatilah dengan gambar pemasaran, video onboarding, dan aset kampanye satu kali yang diganti setiap rilis.
• Biarkan aset stabil tetap stabil. Dengan pembaruan Delta, file yang tidak berubah digunakan kembali daripada didownload lagi.

Ini adalah salah satu cara termudah untuk menjaga Capgo tetap cepat seiring aplikasi berkembang. Pola yang paling buruk adalah perbaikan UI kecil yang memaksa pengguna untuk mendownload tumpukan media yang tidak terkait.

3. Simpan rilis native untuk perubahan native yang sebenarnya

Capgo memperbarui layer web: HTML, CSS, JavaScript, dan aset yang dimuat pada waktu runtime.

Tidak merupakan saluran yang tepat untuk:

• plugin native baru,
• perubahan izin,
• capacitor.config.ts perubahan,
• segala sesuatu yang mengubah keadaan proyek native iOS atau Android.

Baris itu juga penting untuk kinerja. Jika Anda terus-menerus memasukkan perubahan struktural besar ke dalam saluran OTA, strategi pembaruan Anda menjadi lebih berat dan berisiko seiring waktu.

Gunakan dua saluran rilis dengan sengaja:

Saluran native

Untuk perubahan plugin, perubahan izin, dan konfigurasi native:

bun run build
bunx cap sync

Kemudian kirimkan rilis toko normal.

Capgo jalur

Untuk iterasi layer web yang aman:

bun run build
bunx @capgo/cli@latest bundle upload --channel production --delta

Juga refresh basis native Anda secara teratur jika Anda baru-baru ini menambahkan banyak aset yang berumur panjang. Pembangunan toko segar mengintegrasikan basis baru tersebut, yang menjaga perbedaan Capgo di masa depan lebih kecil.

4. Gunakan saluran untuk menjaga ukuran rollout kecil

Pembaruan “tipis” tidak hanya tentang megabyte. Ini juga tentang berapa banyak perangkat yang menerima pembaruan sebelum Anda tahu bahwa itu baik.

Capgo’s sistem saluran adalah cara yang paling bersih untuk mengendalikan itu:

• staging untuk QA
• beta untuk tes tester yang diundang
• production untuk semua orang
• hotfix untuk pemulihan darurat

Alur sederhana seperti ini:

1. Unggah ke staging.
2. Validasi pada perangkat nyata.
3. Luncurkan secara bertahap, baik melalui saluran yang dikendalikan atau perluasan berdasarkan persentase.
4. Balikkan segera jika kesehatan menurun.

Jika aplikasi Anda memiliki beberapa dasar native di luar sana, pair saluran dengan target versi. Itu menjaga bundle yang tidak kompatibel atau berat tidak perlu dari biner yang lebih tua.

Untuk tim yang ingin memiliki loop tinjauan yang lebih ketat, Capgo juga cocok untuk pratinjau PR. Itu memungkinkan produk, QA, dan stakeholders melakukan tes perubahan JS saja tanpa harus menunggu build internal baru dari TestFlight atau Play.

5. Jika Anda mengaktifkan pembaruan langsung, optimalisasi jalur startup harus dilakukan.

Semakin cepat Anda ingin pembaruan diterapkan, semakin disiplin jalur startup harus Anda buat.

Capgo’s perilaku pembaruan docs secara eksplisit merekomendasikan menggabungkan directUpdate dengan pembaruan Delta. Itu adalah default yang tepat.

Gardail kedua adalah notifyAppReady().

import { CapacitorUpdater } from '@capgo/capacitor-updater'

CapacitorUpdater.notifyAppReady()

Jika aplikasi Anda tidak melaporkan siap dalam jendela 10 detik default, atau dalam waktu yang Anda tetapkan dalam konfigurasi __CAPGO_KEEP_0__ Anda, __CAPGO_KEEP_1__ dapat menandai bundle itu tidak valid dan memulihkan versi sebelumnya yang baik. Perilaku rollback itu yang Anda inginkan di produksi, tetapi itu juga berarti Anda harus menjaga startup tetap bersih: notifyAppReady() Telp appReadyTimeout you set in your Capacitor config, Capgo can mark that bundle invalid and restore the previous good version. That rollback behavior is what you want in production, but it also means you should keep startup clean:

• Hubungi notifyAppReady() di tempat yang tepat
• Hindari pekerjaan boot-time yang lambat di jalur kritis
• Simpan dan kembalikan kondisi aplikasi dengan hati-hati jika Anda reload segera
• Tes skenario jaringan buruk dan perangkat rendah sebelum meluas

Jika Anda belum memeriksa halaman ini secara teratur, panduan __CAPGO_KEEP_0__ layak dibaca kembali.

6. Gunakan saluran pembaruan internal daripada pembaruan native yang tidak perlu

Banyak tim mobile menghabiskan waktu untuk membangun biner untuk perubahan yang jelas hanya web.

Jika perubahan adalah:

• salinan,
• peningkatan UI,
• alur masuk
• logika layar harga
• pengaturan analitik
• flag fitur
• mengrender respons atau API prompt

maka pembaruan Capgo seringkali lebih cepat dari artefak tinjauan.

That means fewer native rebuilds, less TestFlight churn, and a tighter feedback loop for the team. It is one of the most underused benefits of Capgo: you can move more review and QA work into the OTA lane without breaking the native/web boundary.

Salah satu manfaat tersembunyi dari __CAPGO_KEEP_0__: Anda dapat memindahkan lebih banyak pekerjaan tinjauan dan QA ke jalur OTA tanpa melanggar batasan asli/web. Petunjuk kami tentang staging dengan satu ID aplikasi mobile

menutupi cara praktis untuk menjaga hal ini tetap bersih seiring waktu.

7. Jaga lean terpisah dari rahasia

Pengendalian saluran mengatur kelayakan. Mereka tidak membuat paket rahasia sendiri.

Jika Anda membutuhkan jaminan pengiriman yang lebih kuat:

• aktifkan enkripsi Update Langsung,
• gunakan penyimpanan kustom atau pengiriman self-hosted,
• tetapkan kunci pribadi hanya di CI atau alur kerja operator yang terjamin.

Hal itu tidak membuat ukuran update tidak relevan. Hanya berarti Anda harus mengoptimalkan kedua dimensi:

• berorientasi kecepatan,
• enkripsi untuk pengendalian pengiriman,
• saluran untuk pengendalian peluncuran,
• rollback untuk pemulihan.

Alur kerja “sederhana Capgo” yang efektif

Jika Anda ingin model operasional default yang sederhana, gunakan ini:

1. Jaga jalur rilis native dan OTA terpisah.
2. Upload perubahan JS dengan --delta secara default.
3. Gunakan staging dan beta saluran sebelum production.
4. Tonton update statistik dan log setelah peluncuran, bukan hanya sebelumnya.
5. Ubah PR menjadi pratinjau instalasi ketika bangun native tidak diperlukan.
6. Tetapkan media besar, yang sering berubah, keluar dari paket di mana-mana kemungkinan.
7. Segarkan dasar native setelah pertumbuhan aset besar atau perubahan native.
8. Tangani notifyAppReady() dan perilaku rollback sebagai bagian dari rekayasa rilis, bukan trivia pengaturan.

Kombinasi tersebut tetap cepat lebih lama daripada pendekatan umum “hanya unggah apa pun yang berubah”.

Pemikiran akhir

Bagi Capgo tim, “tipis dan cepat” bukan hanya masalah ukuran paket.

Itu adalah masalah desain rilis.

Gunakan pembaruan Delta untuk ukuran muatan, saluran untuk ukuran rollout, dan rollback untuk ukuran gagal. Setelah Anda berpikir tentang OTA dengan cara itu, update Anda tetap cepat bahkan ketika aplikasi, tim, dan basis pengguna semakin besar.