Menggunakan Capgo di China

Jika Anda merilis aplikasi untuk pengguna di China, Anda perlu mengonfigurasi Capgo agar menggunakan URL regional OST (Object Storage Technology) guna memastikan update yang cepat dan andal.

Mengapa Menggunakan URL Khusus China?

Karena infrastruktur jaringan dan regulasi di China (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

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

1. Buka capacitor.config.ts file

2. Tambahkan konfigurasi berikut ke bagian 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:

   npm run build
   npx cap sync

Detail Konfigurasi

Berikut adalah fungsi dari setiap URL:

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

Tips

Ketiga URL tersebut harus dikonfigurasi bersamaan untuk memastikan fungsionalitas penuh pembaru Capgo di China.

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

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',
    },
  },
};

Tips

Utamakan responseTimeout: 60 (atau lebih tinggi) untuk deployment di China. Timeout rendah tidak membuat update lebih cepat — itu hanya membuat plugin menyerah padahal request mungkin masih berhasil di sisi Capgo.

Gunakan Background Updates

Kami sangat menyarankan penggunaan autoUpdate: 'atBackground' untuk aplikasi di China. Konektivitas jaringan di China kurang optimal dibanding wilayah lain, dan mode instant apply dapat memperburuk user experience jika download terganggu atau lambat.

Sebagai gantinya, gunakan perilaku update default di mana update diunduh di background dan diterapkan saat aplikasi masuk ke background atau restart. Ini memberikan pengalaman yang lebih reliabel 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',
    },
  },
};

Peringatan

Meskipun infrastruktur kami yang berbasis di Hong Kong membantu meminimalkan latensi dan meningkatkan reliabilitas, performa jaringan ke China daratan masih bisa terdampak oleh Great Firewall. Menggunakan background updates membantu memastikan update selesai dengan sukses tanpa mengganggu user experience.

Contoh Konfigurasi Lengkap

Berikut adalah contoh lengkap dengan pengaturan yang direkomendasikan untuk aplikasi yang dideploy di China:

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

Setelah mengonfigurasi URL khusus China, Anda dapat memverifikasi bahwa update berjalan dengan benar:

1. Upload bundle baru ke Capgo:

   npx @capgo/cli@latest bundle upload --channel=production

2. Install aplikasi Anda di perangkat uji di China

3. Pantau proses update:

   npx @capgo/cli@latest app debug

4. Pastikan update di-download dari URL China OST

Catatan

Perilaku dan waktu update tetap sama dengan konfigurasi standar Capgo. Lihat Perilaku Update dokumentasi untuk detail tentang cara dan kapan update diterapkan.

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

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 via Alibaba DNS)

Pertimbangan Performa:

Meskipun .cn domain 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 performanya minimal dan tidak akan berdampak signifikan pada pengalaman pengguna.

Tips

Menggunakan .cn domain untuk semua pengguna menyederhanakan deployment Anda dan memastikan perilaku update yang konsisten di semua wilayah. Anda tidak perlu build terpisah atau konfigurasi berbasis environment. Sedikit kompromi performa di luar Tiongkok biasanya sepadan dengan kemudahan deployment.

Alternatif: Konfigurasi Spesifik Wilayah

Jika Anda ingin optimasi berbeda di tiap region, Anda juga bisa:

• Membuat varian app terpisah dengan konfigurasi berbeda
• Menggunakan konfigurasi berbasis environment untuk set URL secara dinamis
• Membuat release channel berbeda untuk tiap region

Jika butuh bantuan strategi deployment multi-region, hubungi kami di support@capgo.app atau gabung di komunitas Discord kami untuk bantuan.

Monitoring Infrastruktur China

Anda dapat memantau health dan status endpoint khusus China milik Capgo di status.capgo.com.cn. Gunakan halaman ini untuk mengecek insiden, latensi, dan uptime URL OST China sebelum melakukan troubleshooting aplikasi Anda.

Pemecahan Masalah

Jika Anda mengalami masalah update di China:

1. Verifikasi konfigurasi Anda - Pastikan ketiga URL sudah diatur dengan benar di capacitor.config.ts
2. Naikkan responseTimeout - Gunakan minimal 60 detik di China agar plugin tidak abort saat request update masih berjalan
3. Cek 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 support - Jika masalah berlanjut, hubungi kami di support@capgo.app atau gabung di komunitas Discord kami untuk bantuan

Peringatan

Pastikan Anda menggunakan .cn domain (updater.capgo.com.cn) dan bukan domain internasional standar saat melakukan konfigurasi untuk China.

Langkah Berikutnya

• 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

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.