Lompat ke konten utama
Pembaruan Langsung

Tampilkan versi terbaru ketika pengguna membuka aplikasi Anda

Dengan default, sebuah live update menjalankan satu sesi setelah mengunduh. Mode pembaruan langsung menerapkan itu pada peluncuran, di belakang layar splash Anda, sehingga layar pertama yang dilihat pengguna sudah versi baru.

Bantuan manusia dari Martin

Pembaruan Otomatis: atInstall, onLaunch, atau selalu
Layar splash ditahan hingga pembaruan siap
Pembaruan delta menjaga waktu menunggu singkat

Masalahnya

Pengaturan latar belakang mengalami keterlambatan satu sesi

Apa yang terjadi pada mode default

1

Pengguna membuka aplikasi

Aplikasi dimulai dari paket yang sudah ada. Pengupdate memeriksa paket baru dan mengunduhnya di latar belakang.

2

Sesi menjalankan versi saat ini

Untuk sisa sesi itu, pengguna menjalankan code yang sudah terinstal sebelum perbaikan Anda.

3

Pembaruan diterapkan pada resume berikutnya

Ketika pengguna meninggalkan aplikasi, pembarui instal paket baru. Mereka melihatnya ketika mereka membuka aplikasi lagi.

Untuk sebagian besar rilis, itu adalah kompromi yang tepat. Ketika sesi yang dimulai setelah unggah Anda harus menjalankan code baru, gunakan mode pembaruan langsung.

Ketika sesi pertama sangat penting

Aliran pembayaran atau login yang rusak

Pengguna yang membuka aplikasi tidak perlu melalui layar rusak lagi sebelum perbaikan diterapkan.

Perbaikan Keamanan Layer Web

Anda ingin menjalankan JavaScript yang telah diperbaiki dari awal, bukan dari sesi berikutnya.

Perubahan yang Tidak Terbaru

Konten peringatan, ketentuan, atau acara yang harus tetap terkini pada layar pertama yang dilihat pengguna.

The Solution

Apa yang berubah dengan mode pembaruan langsung

Pembaruan Otomatis memeriksa pada saat aplikasi dibuka sementara layar splash tetap menampilkan. Jika ada paket baru yang tersedia, maka pembaruan tersebut akan diunduh dan diterapkan sebelum layar splash disembunyikan.

Mode Default (atBackground)

1
Pengguna membuka aplikasi
2
Aplikasi menampilkan versi terkini
3
Pembaruan diunduh di latar belakang
4
Bagaimana Cara Mengatasi Masalah Pembaruan

Jangan menunggu. Pengguna melihat pembaruan satu sesi kemudian.

Mode Langsung (onLaunch)

1
Pengguna membuka aplikasi dan layar splash tetap menampilkan
2
Pengguna memeriksa dan mengunduh file yang berubah
3
Pembaruan diterapkan, layar splash disembunyikan, versi baru ditampilkan

Pengguna melihat versi baru di layar pertama. Mereka menunggu di layar splash sambil mengunduh.

Referensi Dokumen Pembaruan

Bagaimana Cara Mengatasi Masalah Pembaruan

Bagaimana Cara Mengatur Pembaruan Langsung

Konfigurasi mode langsung adalah konfigurasi asli, sehingga dikirimkan dalam pembangunan toko terlebih dahulu. Setelah itu, setiap live update mengikuti. Perintah berasal dari Capgo dokumen.

  1. Tambahkan plugin layar splash dan pilih mode

    Pasang @capacitor/splash-screen, kemudian 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 },
    }
    Pengaturan Layar Splash
  2. Pasang Konfigurasi di Bangunan Toko

    Konfigurasi capacitor dikompilasi ke dalam aplikasi native, sehingga mode baru mencapai pengguna dengan rilis toko berikutnya. Capgo Build dapat menghasilkannya di cloud.

    npx @capgo/cli@latest build request --platform ios
    npx @capgo/cli@latest build request --platform android
    Capgo Build Dokumentasi
  3. Pengaturan Layar Splash

    Users wait for the download at launch, so send only the changed files. The CLI detects instant apply modes and prompts for a delta upload.

    npx @capgo/cli@latest bundle upload --channel production --delta
    Pengaturan Layar Splash
  4. Pasang Konfigurasi di Bangunan Toko

    Panggil notifyAppReady() setelah aplikasi Anda telah dimulai. Jika bundel baru gagal memulai, perangkat akan kembali ke bundel yang berfungsi sebelumnya.

    import { CapacitorUpdater } from '@capgo/capacitor-updater'
    
    await CapacitorUpdater.notifyAppReady()
    Pasang Konfigurasi di Bangunan Toko

Pilih mode yang sesuai dengan aplikasi Anda

Update langsung adalah tukar menukar: menunggu beberapa saat di awal untuk mendapatkan versi terbaru di layar pertama.

Tiga mode aplikasi instan

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

  • Hanya setelah instalasi segar atau pembaruan toko aplikasi native
  • onLaunch: ketika aplikasi dimulai dari keadaan mati (cold start)
  • always: pada setiap periksa latar depan, bahkan ketika aplikasi terbuka
Pengaturan Pengupdate

3

Mode aplikasi instan dalam autoUpdate

Tangani layar splash

Pengaturan mode langsung memerlukan @capacitor/layar splash dengan launchAutoHide diatur ke false, dan autoSplashscreen diatur ke true. Pengatur update menyembunyikan layar splash setelah update diterapkan, atau setelah mengetahui tidak ada update yang diperlukan.

  • Tidak perlu panggilan manual SplashScreen.hide()
  • keepUrlPathAfterReload menjaga pengguna tetap di jalur yang sama setelah reload
  • Dengarkan appReady jika Anda memerlukan pekerjaan tambahan setelah layar splash disembunyikan
Tangani layar splash

autoSplashscreen

Diperlukan untuk setiap mode langsung

Kompromi untuk direncanakan

Pengguna menunggu pengunduhan pada peluncuran, dan dengan selalu ada pembaruan, mereka dapat memulai ulang aplikasi sambil aplikasi masih digunakan. Siapkan untuk kedua-duanya.

  • Upload dengan --delta sehingga hanya file yang berubah download
  • Simpan dan kembalikan keadaan aplikasi sehingga reload tidak kehilangan kemajuan pengguna
  • Tetapkan mode default ketika satu sesi penundaan cukup
Dokumen pembaruan delta

--delta

Dianjurkan untuk setiap upload pembaruan langsung

Kapan menggunakan pembaruan langsung

Pakai mode langsung ketika sesi saat ini harus menjalankan code. Tetapkan mode default untuk semua yang lain.

Perbaikan bug kritis

Perbaikan bug pembayaran, login, atau data di mana menjalankan code untuk satu sesi lagi terlalu banyak.

Pertama kali mengaktifkan onboarding

Aplikasi atInstall menerapkan paket terbaru setelah instalasi atau pembaruan toko yang baru, sehingga pengguna baru mulai dengan onboarding saat ini.

Konten yang sudah ketinggalan zaman

Halaman acara, peringatan, atau syarat yang harus tetap saat pengguna membuka aplikasi.

Pembaruan keamanan

Pembaruan lapisan web yang harus dijalankan dari awal. Pembaruan di native code masih memerlukan rilis toko.

Pembaruan rutin

Tambahan gaya dan fitur kecil yang jarang membenarkan menunggu saat peluncuran. Mode default menerapkan mereka satu sesi kemudian.

Aplikasi yang tetap terbuka selama jam

Dengan melakukan periksa secara terus-menerus (setiap 10 menit secara default), Anda dapat mengaplikasikan pembaruan saat aplikasi masih terbuka. Simpan keadaan sebelum mengandalkannya.

Mengurangi waktu menunggu saat peluncuran

Waktu menunggu saat peluncuran adalah periksa update plus download. Pembaruan delta mempertahankan download hanya pada file yang berubah.

Waktu ~50ms

Latensi API yang biasa

Delta

Hanya file yang berubah saja yang diunduh

1B+

Pengiriman update per bulan

Aplikasi dibangun dengan Capacitor

Informasi publik memerlukan perbaikan konten darurat

Aplikasi darurat, kesehatan, dan publik tidak bisa menunggu beberapa hari untuk memperbaiki daftar cek, tautan sumber, atau peringatan spesifik lokasi. Pembaruan langsung memungkinkan layer web bergerak segera setelah perbaikan disetujui.

Logo aplikasi FEMA Cuaca

FEMA

Panduan darurat di mana kesalahan konten kecil dapat menjadi darurat.

Google Play menginstal
1,6 juta
Penilaian Toko
4.0
ikon aplikasi Conecte SUS MEDIKAL

Hubungkan SUS

Catatan kesehatan dan permukaan panduan di mana salinan yang disetujui perlu pengiriman cepat.

Google Play menginstal
27,7M
Nilai Toko
4.6
Logo Aplikasi e-Título SOSIAL

e-Título

Penggunaan identitas sipil yang aman versi di mana panduan yang berlaku di semua perangkat.

Pemasangan Google Play
54,9M
Nilai Toko
4.8

Bukti Pelanggan

Apa yang dikatakan tim-tim yang menggunakan Capgo

5.0/5 diukur oleh tim pengembang 9,400+ tim Baca ulasan

Kapil

Pendiri, NuTriQ

“Dapat melakukan pembaruan OTA produksi secara instan tanpa harus menunggu siklus ulasan App Store penuh telah menjadi keuntungan operasional besar.”

Potret Sergiu S

Sergiu S

Pengembang Utama, drivolino GmbH

“The Capgo Capacitor Updater plugin sepenuhnya mengubah cara kami mengirimkan pembaruan. Apa yang dulunya membutuhkan hari-hari sekarang hanya membutuhkan beberapa menit.”

Potret Luis Dominguez

Luis Dominguez

El yang membayar, Anirol

“Sejak saya menggunakan Capgo segala sesuatu menjadi lebih cepat, dan saya dapat memberikan waktu kepada pengguna saya tanpa mengabaikan kehidupan sehari-hari saya.”

Pertanyaan

Pertanyaan tentang pembaruan langsung

Kapan harus menggunakan mereka, cara mengatur mereka, dan apa yang mereka tawarkan pada awalnya.

Apakah kita harus menggunakan pembaruan langsung atau mode latar belakang default?

Use the default for most releases: there is no wait at launch, and users get the update one session later. Use a direct mode when the session that starts after your upload must run the new code, for example a broken checkout or a web-layer security fix.

Pertanyaan tentang pembaruan langsung

Perbedaan apa antara atInstall, onLaunch, dan selalu?

atInstall hanya memperbarui aplikasi setelah instalasi baru atau pembaruan aplikasi native, kemudian berperilaku seperti default. onLaunch memperbarui aplikasi langsung ketika aplikasi dimulai dari keadaan mati. always memeriksa setiap latar depan dan memperbarui aplikasi segera setelah download selesai, bahkan ketika pengguna sedang menggunakan aplikasi.

Pengaturan Updater

Mengapa plugin layar splash diperlukan?

Layanan langsung memperbarui aplikasi sementara pengguna menunggu. Tanpa @capacitor/splash-screen, autoSplashscreen: true, dan launchAutoHide: false, pengguna dapat melihat kilauan atau UI lama sebelum reload. Dengan mereka, layar splash tetap menampilkan hingga pembaruan aplikasi selesai atau updater mengetahui tidak ada pembaruan yang diperlukan.

Pengaturan Layar Splash

Apakah kita dapat mengaktifkan pembaruan langsung dengan live update?

Tidak. autoUpdate hidup di capacitor.config, yang dibaca oleh aplikasi native pada saat build. Kirimkan pengaturan baru dalam rilis toko. Setelah itu, setiap live update akan mengikuti mode baru.

Dokumen Kompatibilitas Aplikasi Asli

Konfigurasi kami menggunakan directUpdate. Apakah itu masih didukung?

directUpdate sudah tidak didukung lagi, tetapi masih dapat dikenali. Nilainya sesuai dengan mode autoUpdate atInstall, onLaunch, dan selalu. Pindahkan pengaturan ke autoUpdate dalam rilis native berikutnya.

Pengaturan Updater

Tunjukkan perbaikan berikutnya di layar utama

Uji coba mode perbaruan langsung pada bangunan uji selama masa percobaan dan ukur waktu tunggu peluncuran pada aplikasi Anda sendiri.

Dukungan manusia dari Martin

Uji coba 14 hari gratis. Tidak memerlukan kartu kredit.