Mengunggah Perbaruan Langsung

Gunakan fitur Perbarui Hidup Capgo untuk memperbarui antarmuka pengguna dan logika bisnis aplikasi Anda secara remote, secara real-time. Sampaikan pembaruan bundle JS langsung ke pengguna tanpa harus melalui toko aplikasi untuk memperbaiki bug dan mengirimkan fitur baru secara instan.

Tip

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

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

1. Menginstal @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, metode CapacitorUpdater.notifyAppReady() Jika Anda belum melakukan langkah-langkah tersebut, silakan kembali dan lengkapi panduan cepat terlebih dahulu.

Tambahkan aplikasi

Tambahkan aplikasi ke akun __CAPGO_KEEP_0__ Anda, dan instal plugin di aplikasi Anda Add an app to your Capgo account, and install the plugin in your app

Bagian berjudul “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

   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

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

Pengaturan Upload

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 diperbarui

Jika Anda masih mengalami masalah, kunjungi Pengaturan Upload Bagian.

Menerima Perbaruan pada Perangkat

Setelah Anda mengunggah bundel, 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

   Buka proyek iOS/Android di Xcode/Android Studio dan lakukan jalankan natively.

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 kembali. Anda seharusnya melihat update live yang diterapkan!

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

Langkah-Langkah Selanjutnya

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

Untuk mempelajari lebih lanjut, tinjau bagian sisanya. Capgo Aktualisasi Langsung Dokumentasi. Beberapa topik penting untuk dilihat selanjutnya:

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

Teruskan dari Mengaktifkan Aktualisasi Langsung

Jika Anda menggunakan Mengaktifkan Aktualisasi Langsung untuk merencanakan otomatisasi CI/CD, hubungkannya dengan Capgo CI/CD untuk alur kerja produk di Capgo CI/CD, Capgo Pembangunan Asli untuk alur kerja produk di Capgo Pembangunan Asli, Capgo Integrasi untuk alur kerja produk di Capgo Integrasi, Integrasi CI/CD untuk detail implementasi di Integrasi CI/CD, dan GitHub Integrasi Aksi untuk detail implementasi di GitHub Integrasi Aksi.