Langsung ke konten utama
Update Langsung

Tampilkan versi terbaru saat pengguna membuka aplikasi Anda

Secara default, live update berjalan selama satu sesi setelah diunduh. Mode direct update justru menerapkannya saat peluncuran, di balik splash screen Anda, sehingga layar pertama yang dilihat pengguna sudah versi terbaru.

autoUpdate: atInstall, onLaunch, atau always
Splash screen ditahan sampai update siap
Delta download bikin waktu tunggu singkat

Masalahnya

Update background terlambat satu sesi

Apa yang terjadi di mode default

1

User membuka aplikasi

Aplikasi berjalan dengan bundle yang ada. Updater mengecek bundle baru dan mengunduhnya di background.

2

Sesi menjalankan versi saat ini

Selama sisa sesi tersebut, pengguna akan menjalankan code yang sudah terinstal sebelum perbaikan Anda.

3

Update diterapkan saat resume berikutnya

Saat pengguna keluar dari aplikasi, updater akan menginstal bundle baru. Bundle tersebut akan muncul saat mereka membuka aplikasi kembali.

Untuk sebagian besar rilis, ini trade-off yang tepat. Saat sesi yang dimulai setelah upload Anda harus menjalankan code baru, gunakan mode direct update.

Saat sesi pertama sangat krusial

Alur pembayaran atau login yang error

User yang membuka aplikasi tidak boleh melewati layar error itu sekali lagi sebelum perbaikan diterapkan.

Perbaikan keamanan layer web

Anda ingin JavaScript yang sudah di-patch langsung berjalan saat aplikasi dibuka, bukan di sesi berikutnya.

Perubahan yang terikat tanggal

Syarat, pemberitahuan, atau konten event yang harus sudah terbaru di layar pertama yang dilihat pengguna.

Solusinya

Apa yang berubah dengan mode direct update

Updater memeriksa saat aplikasi dibuka selagi splash screen masih tampil. Jika bundle baru tersedia, updater akan mengunduh dan menerapkannya sebelum splash screen disembunyikan.

Mode default (atBackground)

1
User membuka aplikasi
2
Aplikasi menampilkan versi saat ini
3
Update diunduh di background
4
Update diterapkan saat resume berikutnya

Tidak perlu menunggu saat launch. Pengguna melihat update pada sesi berikutnya.

Mode Direct (onLaunch)

1
Pengguna membuka aplikasi dan splash screen tetap tampil
2
Updater memeriksa dan mengunduh file yang berubah
3
Update diterapkan, splash disembunyikan, versi baru muncul

Pengguna melihat versi baru di layar pertama. Mereka menunggu di splash screen saat proses download.

Dokumentasi perilaku update

Cara kerjanya

Cara mengatur direct updates

Mode direct adalah konfigurasi native, jadi harus dikirim dalam store build terlebih dahulu. Setelah itu, setiap live update mengikutinya. Perintah diambil dari dokumentasi Capgo.

  1. Tambahkan plugin splash screen dan pilih mode

    Instal @capacitor/splash-screen, lalu atur autoUpdate, autoSplashscreen, dan launchAutoHide di capacitor.config.ts.

    npm install @capacitor/splash-screen
    npx cap sync
    
    // capacitor.config.ts
    plugins: {
      CapacitorUpdater: {
        autoUpdate: 'onLaunch', // or 'atInstall' / 'always'
        autoSplashscreen: true,
        keepUrlPathAfterReload: true,
      },
      SplashScreen: { launchAutoHide: false },
    }
    Penanganan splash screen
  2. Rilis konfigurasi dalam build store

    capacitor.config dikompilasi ke dalam native app, sehingga mode baru sampai ke user pada rilis store berikutnya. Capgo Build bisa membuatnya di cloud.

    npx @capgo/cli@latest build request --platform ios
    npx @capgo/cli@latest build request --platform android
    Dokumentasi Build Capgo
  3. Upload bundle sebagai delta

    User menunggu download saat app dibuka, jadi kirim hanya file yang berubah. CLI mendeteksi mode instant apply dan memberi prompt untuk upload delta.

    npx @capgo/cli@latest bundle upload --channel production --delta
    Dokumentasi delta updates
  4. Biarkan automatic rollback tetap aktif

    Panggil notifyAppReady() setelah app Anda mulai berjalan. Jika bundle baru gagal start, perangkat kembali ke bundle terakhir yang berfungsi.

    import { CapacitorUpdater } from '@capgo/capacitor-updater'
    
    await CapacitorUpdater.notifyAppReady()
    dokumentasi notifyAppReady()

Pilih mode yang cocok untuk aplikasi Anda

Direct updates adalah sebuah pertukaran: waktu tunggu singkat saat peluncuran demi menghadirkan versi terbaru di layar pertama.

Tiga mode penerapan instan

Atur autoUpdate di capacitor.config.ts. Setiap mode menentukan kapan update bisa diterapkan saat pengguna menunggu.

  • atInstall: hanya tepat setelah instalasi baru atau update native app dari store
  • onLaunch: saat aplikasi dijalankan dari kondisi mati (cold start)
  • always: pada setiap pemeriksaan foreground, bahkan saat aplikasi terbuka
Pengaturan updater

3

Mode apply instan di autoUpdate

Penanganan splash screen

Mode Direct membutuhkan @capacitor/splash-screen dengan launchAutoHide diatur ke false, dan autoSplashscreen diatur ke true. Updater akan menyembunyikan splash screen setelah update diterapkan, atau setelah diketahui tidak ada update yang diperlukan.

  • Tidak perlu memanggil SplashScreen.hide() secara manual
  • keepUrlPathAfterReload menjaga pengguna tetap di route yang sama setelah reload
  • Dengarkan appReady jika Anda perlu melakukan pekerjaan tambahan setelah splash tersembunyi
Penanganan splash screen

autoSplashscreen

Wajib untuk setiap mode direct

Trade-offs yang perlu direncanakan

Pengguna menunggu download saat launch, dan dengan update yang selalu tersedia, app bisa di-reload saat sedang dipakai. Rencanakan keduanya.

  • Upload dengan --delta agar hanya file yang berubah yang di-download
  • Simpan dan restore state app agar reload tidak menghilangkan progress user
  • Pertahankan mode default jika delay satu sesi masih bisa diterima
Dokumentasi delta updates

--delta

Direkomendasikan untuk setiap upload direct update

Kapan menggunakan direct updates

Gunakan mode direct saat sesi saat ini harus menjalankan code baru. Gunakan default untuk kebutuhan lainnya.

Perbaikan bug kritis

Bug pembayaran, login, atau data yang membuat menjalankan code lama untuk satu sesi lagi terlalu berisiko.

Onboarding pertama kali

atInstall menerapkan bundle terbaru tepat setelah instalasi baru atau pembaruan store, sehingga pengguna baru langsung memulai dengan onboarding Anda saat ini.

Konten bertanggal

Halaman acara, pengumuman, atau ketentuan yang harus selalu mutakhir saat pengguna membuka aplikasi.

Patch keamanan

Perbaikan keamanan lapisan web yang harus berjalan sejak peluncuran. Perbaikan di native code tetap memerlukan rilis store.

Routine releases

Penyesuaian styling dan fitur kecil jarang sepadan dengan penundaan saat peluncuran. Mode default menerapkannya satu sesi kemudian.

Aplikasi yang tetap terbuka berjam-jam

Dengan always, pemeriksaan berkala (setiap 10 menit secara default) dapat menerapkan pembaruan saat aplikasi terbuka. Simpan state sebelum mengandalkan fitur ini.

Menjaga waktu tunggu peluncuran tetap singkat

Waktu tunggu saat peluncuran adalah pemeriksaan pembaruan ditambah unduhan. Delta updates membuat unduhan hanya mencakup file yang berubah.

~50ms

Latensi tipikal API

Delta

Hanya file yang berubah yang di-download

1M+

Update yang dikirim per bulan

Aplikasi yang dibangun dengan Capacitor

Aplikasi informasi publik butuh perbaikan konten mendesak

Aplikasi darurat, kesehatan, dan layanan publik tidak bisa menunggu berhari-hari untuk membetulkan checklist, tautan resource, atau pemberitahuan per lokasi yang bermasalah. Direct updates membuat web layer bisa diperbarui begitu perbaikan disetujui.

Ikon aplikasi FEMA CUACA

FEMA

Panduan darurat, tempat kesalahan konten kecil bisa menjadi mendesak.

Instalasi Google Play
1,6jt
Rating toko
4.0
Ikon aplikasi Conecte SUS MEDIS

Hubungkan SUS

Rekam medis dan tampilan panduan, di mana perubahan teks yang disetujui perlu dikirim cepat.

Instalasi Google Play
27,7M
Rating toko
4.6
Ikon aplikasi e-Título SOSIAL

e-Título

Workflow identitas sipil yang membutuhkan panduan aman lintas versi di berbagai perangkat.

Instalasi Google Play
54,9M
Rating toko
4.8

Bukti nyata pelanggan

Apa kata tim yang merilis aplikasi dengan Capgo

5.0/5 Diberi rating oleh tim developer 9,400+ tim Baca ulasan

Kapil

Pendiri, NuTriQ

“Bisa melakukan push update OTA produksi secara instan tanpa harus menunggu siklus review App Store yang lama memberikan keuntungan operasional yang sangat besar.”

Potret Sergiu S

Sergiu S

Lead Developer, drivolino GmbH

“Plugin Capgo Capacitor Updater benar-benar mengubah cara kami merilis update. Yang dulu butuh berhari-hari kini hanya butuh beberapa menit.”

Foto Luis Dominguez

Luis Dominguez

Siapa yang bayar, dia yang atur

“Sejak saya mulai menggunakan Capgo, semuanya jadi lebih cepat, dan saya bisa memberi user waktu yang pantas mereka dapatkan tanpa mengabaikan kehidupan sehari-hari.”

FAQ

Pertanyaan seputar direct updates

Kapan harus menggunakannya, cara setup, dan biaya saat peluncuran.

Haruskah kami menggunakan direct updates atau mode background default?

Gunakan mode default untuk sebagian besar rilis: tidak ada waktu tunggu saat peluncuran, dan pengguna mendapatkan update pada sesi berikutnya. Gunakan mode direct jika sesi yang dimulai setelah upload Anda harus menjalankan code terbaru, misalnya untuk memperbaiki checkout yang rusak atau perbaikan keamanan web-layer.

Dokumentasi perilaku update

Apa perbedaan antara atInstall, onLaunch, dan always?

atInstall menerapkan update segera hanya setelah instalasi baru atau update native app dari store, lalu berperilaku seperti mode default. onLaunch menerapkan update segera saat aplikasi dimulai dari kondisi mati (killed state). always mengecek setiap kali aplikasi masuk foreground dan menerapkannya segera setelah download selesai, bahkan saat pengguna sedang menggunakan aplikasi.

Pengaturan updater

Mengapa plugin splash screen diperlukan?

Mode direct menerapkan update saat pengguna menunggu. Tanpa @capacitor/splash-screen, autoSplashscreen: true, dan launchAutoHide: false, pengguna mungkin melihat flicker atau UI lama sebelum reload. Dengan pengaturan tersebut, splash screen tetap tampil sampai update diterapkan atau updater mengetahui tidak ada update yang diperlukan.

Penanganan splash screen

Bisakah kami mengaktifkan direct updates dengan live update?

Tidak. autoUpdate ada di capacitor.config, yang dibaca ke aplikasi native saat build. Kirim pengaturan baru lewat rilis store. Setelah itu, setiap live update mengikuti mode baru.

Dokumentasi kompatibilitas native

Config kami menggunakan directUpdate. Apakah itu masih didukung?

directUpdate sudah deprecated tapi masih terdeteksi. Nilainya cocok dengan mode autoUpdate atInstall, onLaunch, dan always. Pindahkan pengaturan ini ke autoUpdate di rilis native berikutnya.

Pengaturan updater

Tampilkan perbaikan berikutnya di layar pertama

Coba mode direct update pada test build selama trial dan ukur waktu tunggu launch di aplikasi Anda sendiri.

Uji coba gratis 14 hari. Tanpa kartu kredit.