Deploy sebuah Live Update

Pakai fitur Capgo Live Updates untuk memperbarui UI dan logika bisnis aplikasi Anda secara remote, secara real-time. Kirimkan update bundle JS langsung ke pengguna tanpa harus melewati toko aplikasi untuk memperbaiki bug dan mengirimkan fitur baru secara instan.

Trik

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

Petunjuk ini mengasumsikan Anda telah menyelesaikan Capgo Panduan Cepat dan telah melakukan hal-hal berikut:

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

2. Konfigurasi ID aplikasi dan saluran pembaruan Anda di capacitor.config.ts

3. Tambahkan di aplikasi code Anda CapacitorUpdater.notifyAppReady() metode

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

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

Mengunggah Paket

Dengan Capgo SDK terinstal dan terkonfigurasi, Anda sudah siap untuk mengunggah paket live update pertama Anda:

1. Bangun aset web Anda:

   npm run build

2. Unggah paket 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

   Versi bundle baru akan diunggah ke saluran yang ditentukan dalam perintah ini.

Mengatasi Masalah Pengunggahan

Jika unggahan Anda gagal, periksa kembali:

• ID aplikasi Anda di capacitor.config.ts sesuai 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, silakan ke Mengatasi Masalah section.

Menerima Perbaruan pada Perangkat

Saat bundle Anda telah diunggah, Anda dapat menguji live update pada perangkat:

1. Sinkronkan aplikasi Anda 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 asli.

4. Tunggu aplikasi terbuka selama sekitar 30 detik untuk memungkinkan update untuk mendownload di latar belakang.

5. Log akan membutuhkan beberapa detik untuk memperbarui dan menampilkan status update.

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

Refer kembali ke Capgo Quickstart untuk detail lebih lanjut tentang menguji update live.

Next Steps

Selamat atas penggunaan live update pertama Anda dengan Capgo! 🎉

Untuk mengetahui lebih lanjut, tinjau bagian lain dari Capgo Dokumentasi Live Update. Topik penting untuk diperiksa selanjutnya:

• Mengarahkan Perbaruan dengan Saluran
• Mengatur perilaku Perbaruan
• Rollbacks Live Update

Teruskan dari Deploy sebuah Live Update

Deploy sebuah __CAPGO_KEEP_0__ Deploy a Live Update Untuk merencanakan otomatisasi CI/CD, hubungkannya dengan Capgo CI/CD untuk alur produk di Capgo CI/CD, Capgo Pembangunan Asli untuk alur produk di Capgo Pembangunan Asli, Capgo Integrasi untuk alur kerja produk dalam Capgo Integrasi, untuk alur produk di __CAPGO_KEEP_0__ Integrasi, untuk detail implementasi di Integrasi CI/CD, dan GitHub Actions Integration untuk detail implementasi di GitHub Integrasi Aksi.