Deploy Update Hidup

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

Tips

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

Panduan ini asumsikan Anda telah menyelesaikan Capgo Panduan Cepat dan sudah memiliki:

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

2. Mengonfigurasi ID aplikasi dan saluran pembaruan di capacitor.config.ts

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

Jika Anda belum melakukannya, silakan kembali dan lengkapi panduan cepat terlebih dahulu.

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

Mengunggah Paket

Dengan Capgo SDK terpasang dan terkonfigurasi, Anda sudah siap untuk mengunggah bundle pembaruan hidup pertama Anda:

1. Buat aset web Anda:

   npm run build

2. Unggah 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 mengunggah versi bundle baru ke saluran yang ditentukan dalam perintah.

Troubleshooting Uploads

Jika unggahan gagal, periksa lagi:

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

Jika Anda masih mengalami masalah, kunjungi halaman Troubleshooting Bagian.

Menerima Pembaruan di Perangkat

Setelah Anda mengunggah bundle, Anda dapat menguji pembaruan live di perangkat:

1. Sinkronkan aplikasi ke perangkat:

   npx cap sync ios

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

   npx @capgo/cli@latest app debug

3. Jalankan aplikasi lokal Anda:

   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 untuk diunduh di latar belakang.

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

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

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

Langkah-Langkah Selanjutnya

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

Untuk mempelajari lebih lanjut, tinjau bagian sisanya dari dokumen ini. Capgo Pembaruan Langsung dokumentasiBeberapa topik penting untuk dilihat selanjutnya:

• Mengarahkan Pembaruan dengan Saluran
• Mengatur perilaku Pembaruan
• Pembaruan Langsung Reversal

Teruskan dari Deploy Pembaruan Langsung

Jika Anda menggunakan Deploy Pembaruan Langsung untuk merencanakan otomatisasi CI/CD, hubungkannya dengan Capgo CI/CD untuk alur kerja produk di Capgo CI/CD, Capgo Native Builds for the product workflow in Capgo Native Builds, Integrasi Capgo untuk alur kerja produk di Integrasi Capgo Integrasi CI/CD untuk detail implementasi di Integrasi CI/CD, dan GitHub Integrasi Aksi untuk detail implementasi di GitHub Integrasi Aksi.