Menggunakan Capgo di China
Salin prompt setup yang berisi langkah install dan panduan markdown lengkap untuk plugin ini.
Jika Anda mendeploy aplikasi ke pengguna di Tiongkok, Anda perlu mengonfigurasi Capgo untuk menggunakan URL regional OST (Object Storage Technology) guna memastikan update yang andal dan cepat.
Mengapa Menggunakan URL Khusus Tiongkok?
Bagian berjudul “Mengapa Menggunakan URL Khusus Tiongkok?”Karena infrastruktur jaringan dan regulasi di Tiongkok (Great Firewall), koneksi langsung ke server internasional bisa lambat atau tidak stabil. Capgo menyediakan URL OST khusus dengan data yang berlokasi di Hong Kong untuk meminimalkan latensi dan memastikan pengguna Anda menerima update secepat dan seandal mungkin.
Konfigurasi
Bagian berjudul “Konfigurasi”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.
-
Buka file
capacitor.config.tsfile -
Tambahkan konfigurasi berikut ke
CapacitorUpdaterbagian 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; -
Build ulang aplikasi Anda untuk menerapkan perubahan:
Jendela terminal npm run buildnpx cap sync
Detail Konfigurasi
Bagian berjudul “Detail Konfigurasi”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
Rekomendasi Pengaturan untuk China
Bagian berjudul “Rekomendasi Pengaturan untuk China”Karena keterbatasan performa jaringan akibat Great Firewall China, kami punya rekomendasi khusus untuk aplikasi yang di-deploy di China daratan:
Tingkatkan Response Timeout API
Bagian berjudul “Tingkatkan Response Timeout API”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', }, },};Gunakan Background Updates
Bagian berjudul “Use Background Updates”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', }, },};Contoh Konfigurasi Lengkap
Bagian berjudul “Contoh Konfigurasi Lengkap”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;Testing konfigurasi Anda
Bagian berjudul “Menguji Konfigurasi Anda”Setelah mengonfigurasi URL khusus Tiongkok, Anda dapat memverifikasi bahwa pembaruan berfungsi dengan benar:
-
Upload bundle baru ke Capgo:
Jendela terminal npx @capgo/cli@latest bundle upload --channel=production -
Instal aplikasi Anda di perangkat uji di Tiongkok
-
Pantau proses pembaruan:
Jendela terminal npx @capgo/cli@latest app debug -
Periksa bahwa pembaruan diunduh dari URL China OST
Deployment multi-region
Bagian berjudul “Deployment multi-region”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.
Menggunakan domain China secara global
Bagian berjudul “Menggunakan domain China secara global”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 diresolusi 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 diresolusi langsung oleh Cloudflare tempat backend kami dihosting. Namun, resolusi DNS sangat cepat, sehingga perbedaan performa minimal dan tidak akan berdampak signifikan pada pengalaman pengguna.
Alternatif: Konfigurasi Spesifik Wilayah
Bagian berjudul “Alternatif: Konfigurasi Spesifik Wilayah”Jika Anda lebih memilih 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.
Pemantauan Infrastruktur Tiongkok
Bagian berjudul “Pemantauan Infrastruktur Tiongkok”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 troubleshooting aplikasi Anda.
Pemecahan Masalah
Bagian berjudul “Troubleshooting”Jika Anda mengalami masalah dengan update di China:
- Verifikasi konfigurasi Anda - Pastikan ketiga URL diatur dengan benar di
capacitor.config.ts - Raise
responseTimeout- Gunakan minimal60detik di China agar plugin tidak abort saat request update masih berjalan - Periksa konektivitas jaringan - Pastikan perangkat Anda dapat mengakses
updater.capgo.com.cndomain - Cek halaman status China - Tinjau status.capgo.com.cn untuk melihat adanya insiden atau penurunan performa
- Tinjau logs - Gunakan
npx @capgo/cli@latest app debuguntuk mengecek pesan error - Tes update - Coba upload bundle baru dan pantau proses download
- Hubungi dukungan - Jika masalah berlanjut, hubungi kami di support@capgo.app atau gabung di komunitas Discord kami untuk bantuan
Langkah Berikutnya
Bagian berjudul “Langkah Selanjutnya”- Pelajari tentang Perilaku Update untuk menyesuaikan kapan update diterapkan
- Jelajahi Channel untuk mengelola berbagai track rilis
- Tinjau Enkripsi untuk mengamankan update Anda
Lanjutkan dari Menggunakan Capgo di China
Bagian berjudul “Lanjutkan dari Menggunakan Capgo di China”Jika Anda menggunakan Menggunakan Capgo di China untuk merencanakan pengiriman live update, hubungkan dengan Capgo Live Updates 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.