Deploy Live Update

Gunakan fitur Live Updates dari Capgo untuk memperbarui UI dan logika bisnis aplikasi Anda secara remote, dalam waktu nyata. Kirim pembaruan JS bundle langsung ke pengguna Anda tanpa melalui app store untuk memperbaiki bug dan meluncurkan fitur baru secara instan.

Tips

Capgo mengunggah folder web build yang dihasilkan. Perubahan pada HTML, CSS, JavaScript, aset, dan paket pure-JavaScript dapat dikirim via OTA setelah dibundel di sana. Perubahan pada capacitor.config.ts, konfigurasi plugin native, paket native, atau file proyek iOS/Android memerlukan rilis aplikasi native.

Panduan ini mengasumsikan Anda telah menyelesaikan Capgo Quickstart dan sudah memiliki:

1. Menginstal @capgo/capacitor-updater SDK di aplikasi Capacitor Anda

2. App ID dan update channel Anda sudah dikonfigurasi di capacitor.config.ts

3. Tambahkan code di CapacitorUpdater.notifyAppReady() metode

Jika Anda belum melakukan langkah-langkah tersebut, silakan kembali dan selesaikan quickstart terlebih dahulu.

Tambahkan aplikasi Tambahkan aplikasi ke akun Capgo Anda, dan instal plugin di aplikasi Anda

Upload Bundle

Dengan Capgo SDK yang sudah diinstal dan dikonfigurasi, Anda siap mengunggah bundle live update pertama Anda:

1. Build aset web Anda:

   npm run build

2. Upload bundle ke Capgo:

   Konsol

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

   Aksi Github

   .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

   Ini akan meng-upload versi bundle baru ke channel yang ditentukan dalam perintah tersebut.

Troubleshooting Upload

Jika upload gagal, periksa kembali:

• App ID Anda di capacitor.config.ts cocok dengan app Anda di dashboard Capgo
• Anda menjalankan perintah upload dari root project Capacitor Anda
• Web assets sudah di-build dan versinya terbaru

Jika masih bermasalah, silakan buka Pemecahan Masalah bagian.

Menerima Update di Perangkat

Setelah bundle diunggah, Anda dapat menguji live update di perangkat:

1. Sinkronkan aplikasi Anda ke perangkat:

   npx cap sync ios

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

   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 native run.

4. Biarkan aplikasi terbuka selama sekitar 30 detik agar update dapat diunduh di latar belakang.

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

6. Tutup dan buka lagi aplikasinya. live update Anda seharusnya sudah diterapkan!

Lihat kembali Panduan Cepat Capgo untuk detail lebih lanjut tentang pengujian live update.

Langkah Berikutnya

Selamat, Anda berhasil men-deploy live update pertama dengan Capgo! 🎉

Untuk mempelajari lebih lanjut, lihat sisa dokumentasi Capgo Live Updates. Beberapa topik penting untuk dicek selanjutnya:

• Menargetkan Update dengan Channel
• Menyesuaikan Perilaku Update
• Rollback Live Update

Lanjutkan dari Deploy Live Update

Jika Anda menggunakan Deploy Live Update 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.