Langsung ke konten

Menggunakan Capgo di China

Jika Anda mendeploy aplikasi ke pengguna di Tiongkok, Anda perlu mengonfigurasi Capgo untuk menggunakan URL OST (Object Storage Technology) regional guna memastikan pembaruan yang andal dan cepat.

Karena infrastruktur jaringan dan regulasi di Tiongkok (Great Firewall), koneksi langsung ke server internasional bisa lambat atau tidak andal. Capgo menyediakan URL OST khusus dengan data yang berlokasi di Hong Kong untuk meminimalkan latensi dan memastikan pengguna Anda menerima pembaruan secepat dan seandal mungkin.

Untuk mengonfigurasi Capgo untuk Tiongkok, Anda perlu mengatur tiga URL spesifik di file konfigurasi Capacitor Anda. URL ini menunjuk ke infrastruktur Capgo yang berbasis di Hong Kong.

  1. Buka file capacitor.config.ts file

  2. Tambahkan konfigurasi berikut ke dalam CapacitorUpdater bagian plugin:

    import { CapacitorConfig } from '@capacitor/cli';
    const config: CapacitorConfig = {
    plugins: {
    CapacitorUpdater: {
    autoUpdate: 'atBackground',
    updateUrl: 'https://updater.capgo.com.cn/updates',
    statsUrl: 'https://updater.capgo.com.cn/stats',
    channelUrl: 'https://updater.capgo.com.cn/channel_self',
    },
    },
    };
    export default config;
  3. Build ulang aplikasi Anda untuk menerapkan perubahan:

    Jendela terminal
    npm run build
    npx cap sync

Berikut fungsi masing-masing URL:

  • updateUrl: https://updater.capgo.com.cn/updates - Digunakan untuk memeriksa dan mengunduh update yang tersedia untuk aplikasi Anda
  • statsUrl: https://updater.capgo.com.cn/stats - Digunakan untuk melaporkan analitik dan statistik penggunaan kembali ke Capgo
  • channelUrl: https://updater.capgo.com.cn/channel_self - Digunakan untuk mengambil konfigurasi channel dan menentukan update mana yang akan diterapkan

Karena keterbatasan performa jaringan akibat Great Firewall China, kami punya rekomendasi khusus untuk aplikasi yang di-deploy di China daratan:

Plugin updater Capgo membatalkan panggilan API saat responseTimeout terlampaui (nilai dalam detik). Infrastruktur edge di depan Capgo juga menganggap sekitar 3 detik sebagai budget kegagalan untuk beberapa jalur.

Di China daratan, latensi lintas batas sering kali lebih tinggi. Pertahankan nilai yang lebih tinggi responseTimeout agar plugin punya cukup waktu untuk menyelesaikan pengecekan update dan download melalui updater.capgo.com.cn daripada langsung gagal:

const config: CapacitorConfig = {
plugins: {
CapacitorUpdater: {
autoUpdate: 'atBackground',
// Seconds. Raise above the default (20) for China network conditions.
responseTimeout: 60,
updateUrl: 'https://updater.capgo.com.cn/updates',
statsUrl: 'https://updater.capgo.com.cn/stats',
channelUrl: 'https://updater.capgo.com.cn/channel_self',
},
},
};

Kami sangat merekomendasikan penggunaan autoUpdate: 'atBackground' untuk aplikasi di Tiongkok. Konektivitas jaringan di Tiongkok kurang optimal dibandingkan wilayah lain, dan mode apply instan dapat menyebabkan pengalaman pengguna yang buruk jika unduhan terputus atau lambat.

Sebagai gantinya, gunakan perilaku update default di mana update diunduh di latar belakang dan diterapkan saat aplikasi berada di latar belakang atau di-restart. Ini memberikan pengalaman yang lebih andal bagi pengguna Anda.

const config: CapacitorConfig = {
plugins: {
CapacitorUpdater: {
autoUpdate: 'atBackground', // Recommended for China
updateUrl: 'https://updater.capgo.com.cn/updates',
statsUrl: 'https://updater.capgo.com.cn/stats',
channelUrl: 'https://updater.capgo.com.cn/channel_self',
},
},
};

Berikut adalah contoh lengkap dengan pengaturan yang direkomendasikan untuk aplikasi yang di-deploy di Tiongkok:

import { CapacitorConfig } from '@capacitor/cli';
const config: CapacitorConfig = {
appId: 'com.example.app',
appName: 'My App',
webDir: 'dist',
plugins: {
CapacitorUpdater: {
autoUpdate: 'atBackground', // Recommended for better reliability in China
responseTimeout: 60, // Seconds — give China network more room
updateUrl: 'https://updater.capgo.com.cn/updates',
statsUrl: 'https://updater.capgo.com.cn/stats',
channelUrl: 'https://updater.capgo.com.cn/channel_self',
},
},
};
export default config;

Setelah mengonfigurasi URL khusus Tiongkok, Anda dapat memverifikasi bahwa pembaruan berjalan dengan benar:

  1. Upload bundle baru ke Capgo:

    Jendela terminal
    npx @capgo/cli@latest bundle upload --channel=production
  2. Instal aplikasi Anda di perangkat uji di Tiongkok

  3. Pantau proses pembaruan:

    Jendela terminal
    npx @capgo/cli@latest app debug
  4. Periksa bahwa pembaruan diunduh dari URL China OST

Jika aplikasi Anda melayani pengguna di dalam dan di luar China, Anda dapat menggunakan konfigurasi domain China untuk semua pengguna di seluruh dunia. Domain updater.capgo.com.cn ini di-resolve secara global berkat infrastruktur DNS Alibaba, sehingga dapat diakses baik di dalam China maupun di seluruh dunia.

URL domain China bekerja dengan lancar untuk aplikasi multi-region:

const config: CapacitorConfig = {
plugins: {
CapacitorUpdater: {
autoUpdate: 'atBackground', // Recommended for China users
updateUrl: 'https://updater.capgo.com.cn/updates',
statsUrl: 'https://updater.capgo.com.cn/stats',
channelUrl: 'https://updater.capgo.com.cn/channel_self',
},
},
};

Konfigurasi tunggal ini akan berfungsi untuk:

  • Pengguna di Tiongkok daratan (menggunakan infrastruktur berbasis Hong Kong)
  • Pengguna di luar Tiongkok (mengakses infrastruktur yang sama melalui Alibaba DNS)

Pertimbangan Performa:

Meskipun .cn domain ini di-resolve secara global melalui Alibaba DNS dan berfungsi di mana saja, performanya sedikit lebih rendah bagi pengguna di luar Tiongkok dibandingkan domain standar (api.capgo.app), yang di-resolve langsung oleh Cloudflare, tempat backend kami di-hosting. Namun, resolusi DNS sangat cepat, sehingga perbedaan performa minimal dan tidak akan berdampak signifikan pada pengalaman pengguna.

Jika Anda lebih memilih untuk mengoptimalkan secara berbeda untuk setiap wilayah, Anda juga dapat mempertimbangkan:

  • Membangun varian aplikasi terpisah dengan konfigurasi yang berbeda
  • Menggunakan konfigurasi berbasis lingkungan untuk mengatur URL secara dinamis
  • Membuat channel rilis yang berbeda untuk wilayah yang berbeda

Jika Anda membutuhkan bantuan dengan strategi deployment multi-wilayah, silakan hubungi kami di support@capgo.app atau gabung di komunitas Discord kami untuk bantuan.

Anda dapat memantau kesehatan dan status endpoint khusus Tiongkok dari Capgo di status.capgo.com.cn. Gunakan halaman ini untuk memeriksa insiden, latensi, dan uptime URL China OST sebelum memecahkan masalah aplikasi Anda.

Jika Anda mengalami masalah dengan pembaruan di Tiongkok:

  1. Verifikasi konfigurasi Anda - Pastikan ketiga URL diatur dengan benar di capacitor.config.ts
  2. Tingkatkan responseTimeout - Gunakan minimal 60 detik di China agar plugin tidak abort saat request update masih berjalan
  3. Periksa konektivitas jaringan - Pastikan perangkat Anda dapat mengakses updater.capgo.com.cn domain
  4. Cek halaman status China - Tinjau status.capgo.com.cn untuk melihat adanya insiden atau penurunan performa
  5. Tinjau logs - Gunakan npx @capgo/cli@latest app debug untuk mengecek pesan error
  6. Tes update - Coba upload bundle baru dan pantau proses download
  7. Hubungi dukungan - Jika masalah berlanjut, hubungi kami di support@capgo.app atau gabung di komunitas Discord kami untuk bantuan
  • Pelajari tentang Perilaku Update untuk menyesuaikan kapan update diterapkan
  • Jelajahi Channel untuk mengelola berbagai track rilis
  • Tinjau Enkripsi untuk mengamankan update Anda

Jika Anda menggunakan Menggunakan Capgo di China untuk merencanakan pengiriman live update, hubungkan dengan Live Updates Capgo untuk alur kerja produk di Capgo Live Updates, Ikhtisar untuk detail implementasi di Overview, Fitur untuk detail implementasi di Features, Perilaku Update untuk detail implementasi di Update Behavior, dan Tipe Update untuk detail implementasi di Update Types.