Mengaktifkan Perbaruan Hidup

Gunakan fitur Capgo’s Live Updates untuk memperbarui antarmuka pengguna dan logika bisnis aplikasi Anda secara remote, secara real-time. Sampaikan update bundle JS langsung ke pengguna Anda tanpa harus melewati toko aplikasi untuk memperbaiki bug dan mengirimkan fitur baru.

Petunjuk ini mengasumsikan Anda telah menyelesaikan langkah-langkah "__CAPGO_KEEP_0__ Quickstart" dan telah melakukan: Sudah menginstal "Capgo" di aplikasi __CAPGO_KEEP_1__ Anda Sudah mengkonfigurasi ID aplikasi dan saluran pembaruan di

1. Sudah menambahkan "__CAPGO_KEEP_0__" di aplikasi __CAPGO_KEEP_0__ Anda dengan metode @capgo/capacitor-updater SDK in your Capacitor app

2. Tambahkan aplikasi capacitor.config.ts

3. Tambahkan aplikasi ke akun code Anda, dan instal plugin di aplikasi Anda CapacitorUpdater.notifyAppReady() Mengunggah Bundle

Mengunggah sebuah Bundle

Mengunggah sebuah Bundle Add an app to your Capgo account, and install the plugin in your app

Mengunggah sebuah Bundle

Dengan Capgo SDK yang diinstal dan dikonfigurasi, Anda sudah siap untuk mengunggah paket update hidup pertama Anda:

1. Buatlah aset web:

   npm run build

2. Unggah paket ke Capgo:

   Konsol

   npx @capgo/cli@latest bundle upload --channel=production

   Github Aksi

   github/workflows/build_and_deploy.yml

   name: Build source code and send to Capgo
   
   concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true
   
   on:
   push:
     branches:
       - main
   
   jobs:
   deploy_to_capgo:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
         uses: actions/checkout@v6
       - uses: actions/setup-node@v6
         with:
           node-version: '24'
       - name: Install dependencies
         run: npm install
       - name: Build
         run: npm run build
       - name: Deploy to Capgo
         run: npx @capgo/cli@latest bundle upload -a ${{ secrets.CAPGO_TOKEN }} --channel ${{ env.CHANNEL }}
         env:
           CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}

   Gitlab

   .gitlab-ci.yml

   stages:
     - build
   
   build:
     stage: build
     image: node:18
     cache:
       - key:
           files:
             - package-lock.json
         paths:
           - .node_modules/
     script:
       - npm install
       - npm run build
       - npx @capgo/cli@latest bundle upload -a $CAPGO_TOKEN --channel $CAPGO_CHANNEL
     artifacts:
       paths:
         - node_modules/
         - dist/
     only:
       - master

   Aplikasi ini akan mengunggah versi bundle baru ke saluran yang ditentukan dalam perintah.

Pengaturan Upload

Jika unggahan gagal, periksa kembali:

• ID aplikasi Anda di capacitor.config.ts sama dengan aplikasi Anda di dashboard Capgo
• Anda menjalankan perintah unggah dari root project Capacitor Anda
• Aset web Anda telah dibangun dan sudah terkini

Jika Anda masih mengalami masalah, kunjungi Mengatasi Masalah __CAPGO_KEEP_0__.

Menerima Perbaruan pada Perangkat

Setelah Anda mengunggah bundle, Anda dapat menguji perbaruan live pada perangkat:

1. Sinkronkan aplikasi ke perangkat:

   npx cap sync ios

2. Buka jendela terminal lain dan jalankan perintah berikut untuk memeriksa status perbaruan:

   npx @capgo/cli@latest app debug

3. Jalankan aplikasi Anda secara lokal:

   npx cap run ios

   Atau buka proyek iOS/Android di Xcode/Android Studio dan lakukan jalankan native.

4. Tahan aplikasi terbuka selama sekitar 30 detik untuk memungkinkan update diunduh di latar belakang.

5. Log akan memakan beberapa detik untuk diperbarui dan menampilkan status update.

6. Tutup dan buka aplikasi lagi. Anda seharusnya melihat live update yang diterapkan!

Refer kembali ke Capgo Panduan Cepat untuk informasi lebih lanjut tentang menguji live update.

Langkah-Langkah Selanjutnya

Selamat! Anda telah mengaktifkan live update pertama Anda dengan Capgo! 🎉

Untuk mempelajari lebih lanjut, tinjau bagian lain dari Capgo Dokumentasi Live Updates. Topik-topik penting untuk diperiksa selanjutnya:

• Mengarahkan Perbarui dengan Saluran
• Mengatur perilaku Perbarui
• Mengembalikan Perbarui Live