Menggunakan Capgo di Cina

Jika Anda mengirimkan aplikasi ke pengguna di Cina, Anda perlu mengonfigurasi Capgo untuk menggunakan URL OST regional untuk memastikan pembaruan yang dapat diandalkan dan cepat.

Mengapa Menggunakan URL Khusus Cina?

Karena infrastruktur jaringan dan regulasi di Cina (The Great Firewall), koneksi langsung ke server internasional dapat lambat atau tidak dapat diandalkan. Capgo menyediakan URL OST dedikasi dengan data yang berada di Hong Kong untuk mengurangi latency dan memastikan pengguna Anda menerima pembaruan dengan cepat dan dapat diandalkan mungkin.

Pengaturan

To configure Capgo for China, you need to set three specific URLs in your Capacitor configuration file. These URLs point to Capgo’s Hong Kong-based infrastructure.

1. Buka file Anda capacitor.config.ts file

2. Tambahkan konfigurasi berikut ke 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. Rebuild aplikasi Anda untuk menerapkan perubahan:

   npm run build
   npx cap sync

Detail Konfigurasi

Berikut adalah penjelasan untuk setiap URL:

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

Tip

Semua tiga URL harus dikonfigurasi bersama untuk memastikan fungsi penuh dari pembarui Capgo di Cina.

Pengaturan yang Disarankan untuk Cina

Karena keterbatasan kinerja jaringan yang disebabkan oleh Tembok Api Besar Cina, kami memiliki rekomendasi khusus untuk aplikasi yang dijalankan di daratan Cina:

Increase API Response Timeout

Penghenti Capgo updater plugin akan menghentikan API panggilan ketika responseTimeout Bab yang berjudul “Perbesar Waktu Respons __CAPGO_KEEP_0__” detikInfrastruktur Edge di depan Capgo juga menganggap sekitar detik sebagai anggaran kegagalan untuk beberapa jalur.

In daratan Cina, latensi lintas batas sering kali lebih tinggi. Simpan waktu responseTimeout agar plugin memiliki ruang yang cukup untuk menyelesaikan pengecekan dan unduhan update melalui updater.capgo.com.cn Bukannya gagal sejak awal:

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

Trik

Lebih baik responseTimeout: 60 (atau lebih tinggi) untuk penggunaan Cina. Waktu tunggu yang rendah tidak membuat update lebih cepat — hanya menyebabkan plugin menyerah sementara permintaan mungkin masih berhasil di sisi Capgo.

Gunakan Perbarui Latar Belakang

Kami mengusulkan kuat menggunakan autoUpdate: 'atBackground' untuk aplikasi di Cina. Koneksi jaringan di Cina kurang kinerjanya dibandingkan dengan wilayah lain, dan mode aplikasi instan dapat menyebabkan pengalaman pengguna yang buruk jika download terganggu atau lambat.

Sebaliknya, gunakan perilaku perbarui default di mana perbarui download di latar belakang dan berlaku ketika aplikasi berlatar atau restart. Ini memberikan pengalaman yang lebih dapat diandalkan untuk 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

Sementara infrastruktur kami di Hong Kong membantu mengurangi latensi dan meningkatkan keandalan, kinerja jaringan ke Cina daratan masih dapat terganggu oleh Tembok Api Besar. Menggunakan perbarui latar belakang membantu memastikan perbarui selesai dengan sukses tanpa mengganggu pengalaman pengguna.

Contoh Konfigurasi Lengkap

Contoh lengkap ini termasuk pengaturan yang disarankan untuk aplikasi yang dijalankan di Cina:

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;

Menguji Konfigurasi Anda

Setelah mengonfigurasi URL yang spesifik untuk Cina, Anda dapat memastikan bahwa pembaruan bekerja dengan benar:

1. Unggah bundle baru ke Capgo:

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

2. Pasang aplikasi Anda pada perangkat uji di Cina

3. Monitor proses pembaruan:

   npx @capgo/cli@latest app debug

4. Periksa apakah pembaruan sedang diunduh dari URL OST Cina

Catatan

Pengaturan perilisan update dan waktu tetap sama seperti konfigurasi standar Capgo. Lihat Perilaku Pembaruan Dokumentasi untuk informasi lebih lanjut tentang cara dan kapan pembaruan diterapkan.

Pengembangan Multi-Region

Jika aplikasi Anda melayani pengguna di dalam dan di luar China, Anda dapat menggunakan konfigurasi domain Cina untuk semua pengguna di seluruh dunia. updater.capgo.com.cn domain dapat diakses secara global karena infrastruktur DNS Alibaba, sehingga dapat diakses baik di dalam China maupun di tempat lain di dunia.

Bab berjudul “Menggunakan Domain Cina Secara Global”

Domain URL Cina berfungsi 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 ini akan berfungsi untuk:

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

Pertimbangan Kinerja:

Sementara .cn domain diresolusi secara global melalui Alibaba DNS dan berfungsi di mana saja, namun sedikit kurang kinerjanya bagi pengguna di luar China dibandingkan dengan domain standar ("api.capgo.app), which is resolved directly by Cloudflare where our backend is hosted. However, DNS resolution is fast, so the performance difference is minimal and won’t significantly impact the user experience.

Menggunakan

Menggunakan .cn domain untuk semua pengguna memudahkan proses pengembangan dan memastikan perilaku pembaruan yang konsisten di semua wilayah. Anda tidak perlu membuat build yang terpisah atau mengatur konfigurasi berdasarkan lingkungan. Biaya kinerja yang kecil di luar Cina biasanya bernilai lebih dari pengembangan yang sederhana.

Alternatif: Konfigurasi Wilayah-Spesifik

Jika Anda lebih suka mengoptimalkan berbeda-beda untuk setiap wilayah, Anda juga dapat mempertimbangkan:

• Membangun variasi aplikasi yang berbeda dengan konfigurasi yang berbeda
• Menggunakan konfigurasi berdasarkan lingkungan untuk menetapkan URL secara dinamis
• Membuat saluran rilis yang berbeda untuk wilayah yang berbeda

Jika Anda membutuhkan bantuan dengan strategi pengembangan multi-wilayah, silakan menghubungi kami di Bantuan@capgo.app untuk bantuan. support@__CAPGO_KEEP_0__.app Bantuan.

Mengawasi Infrastruktur Cina

Anda dapat mengawasi kesehatan dan status endpoint Capgo yang spesifik untuk Cina di status.capgo.com.cn. Gunakan halaman ini untuk memeriksa insiden, latency, dan uptime URL OST Cina sebelum melakukan troubleshooting aplikasi Anda.

Pengembangan

Jika Anda mengalami masalah dengan pembaruan di Cina:

1. Verifikasi Konfigurasi - Periksa kembali bahwa semua tiga URL telah ditetapkan dengan benar di capacitor.config.ts
2. Naikkan responseTimeout - Gunakan setidaknya 60 Menghitung detik di Cina sehingga plugin tidak berhenti sementara permintaan pembaruan masih dalam penerbangan
3. Periksa koneksi jaringan - Pastikan perangkat Anda dapat mencapai updater.capgo.com.cn domain
4. Periksa halaman status Cina - Tinjau status.capgo.com.cn untuk insiden yang sedang berlangsung atau kinerja yang menurun
5. Periksa log - Gunakan npx @capgo/cli@latest app debug untuk memeriksa pesan kesalahan
6. Uji pembaruan - Coba unggah bundle baru dan pantau proses download
7. Hubungi dukungan Jika masalah tetap berlanjut, hubungi kami di Bantuan@capgo.app or join our Pertimbangan Pastikan untuk menggunakan

domain (

Gunakan Live Update .cn domain (updater.capgo.com.cndan bukan domain internasional standar ketika mengonfigurasi untuk Cina.

Next Steps

• Belajar tentang Sifat Perbarui untuk mengatur kapan perbarui diterapkan
• Temukan Saluran untuk mengelola jalur rilis yang berbeda
• Periksa Enkripsi untuk memastikan perbarui Anda

Mengikuti dari Menggunakan Capgo di Cina

Jika Anda menggunakan __CAPGO_KEEP_0__ Menggunakan Capgo di Cina Untuk merencanakan pengiriman live update, hubungkannya dengan Capgo Live Updates untuk alur kerja produk dalam Capgo Live Updates, Overview Untuk detail implementasi di Penjelasan. Features Untuk detail implementasi di Fitur. untuk detail implementasi di Fitur, untuk detail implementasi di Behavior Perbarui, dan Jenis Update untuk detail implementasi dalam Jenis Update.