Menggunakan Capgo di Cina

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

Mengapa Menggunakan URL Cina Khusus?

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

Konfigurasi

Untuk mengonfigurasi Capgo untuk Cina, Anda perlu menetapkan tiga URL tertentu di file konfigurasi Capacitor. URL-URL ini mengarah ke infrastruktur Capgo di Hong Kong.

1. Jendela Terminal capacitor.config.ts file

2. Tambahkan konfigurasi berikut ke bagian plugin: CapacitorUpdater Salin ke clipboard

   import { CapacitorConfig } from '@capacitor/cli';
   
   const config: CapacitorConfig = {
     plugins: {
       CapacitorUpdater: {
         autoUpdate: true,
         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. Jendela Terminal

   npm run build
   npx cap sync

Bagian berjudul “Detail Konfigurasi”

Berikut ini adalah apa yang dilakukan 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 pembaruan mana yang harus diterapkan

Tip

Tiga URL di atas harus dikonfigurasi bersama-sama untuk memastikan fungsi penuh dari pembaruan Capgo di Cina.

Rekomendasi Pengaturan untuk Cina

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

Matikan Perbaruan Langsung

Kami mengingatkan kuat untuk mematikan directUpdate untuk aplikasi di Cina. Koneksi jaringan di Cina kurang kinerjanya daripada di wilayah lain, dan perbaruan langsung (yang berlaku segera) dapat menyebabkan pengalaman pengguna yang buruk jika download terganggu atau lambat.

Sebaliknya, gunakan perilaku perbaruan bawaan di mana perbaruan download di latar belakang dan berlaku ketika aplikasi berlatar atau restart. Ini menyediakan pengalaman yang lebih dapat diandalkan untuk pengguna Anda.

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: true,
      directUpdate: false, // 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 latency dan meningkatkan keandalan, kinerja jaringan ke Cina daratan masih dapat terpengaruh oleh Tembok Api. Mematikan directUpdate membantu memastikan perbaruan selesai dengan sukses tanpa mengganggu pengalaman pengguna.

Contoh Konfigurasi Lengkap

Berikut adalah contoh lengkap dengan 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: true,
      directUpdate: false, // Recommended: disable for better reliability in China
      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 mengatur URL khusus 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 bahwa pembaruan sedang diunduh dari URL OST Cina

Catatan

Siklus pembaruan dan waktu tetap sama seperti dengan konfigurasi standar Capgo. Lihat dokumentasi untuk informasi lebih lanjut tentang bagaimana dan kapan pembaruan diterapkan. Pengembangan Multi-Benua

Jika aplikasi Anda melayani pengguna baik di dalam maupun di luar Cina, Anda dapat menggunakan konfigurasi domain Cina untuk semua pengguna di seluruh dunia.

Penggunaan domain Cina untuk semua pengguna di seluruh dunia updater.capgo.com.cn Domain dapat diakses secara global berkat infrastruktur DNS Alibaba

Menggunakan Domain Cina di Seluruh Dunia

URL domain Cina berfungsi dengan lancar untuk aplikasi multi-region:

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: true,
      directUpdate: false, // 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 Tiongkok daratan (menggunakan infrastruktur berbasis Hong Kong)
• Pengguna di luar Tiongkok (mengakses infrastruktur yang sama melalui Alibaba DNS)

Konsiderasi Kinerja:

Meskipun .cn domain diresolusi secara global melalui Alibaba DNS dan berfungsi di mana saja, itu sedikit kurang kinerjanya untuk pengguna di luar Tiongkok dibandingkan dengan domain standar ( api.capgo.app), yang diresolusi secara langsung oleh Cloudflare di mana backend kami dihosting. Namun, resolusi DNS cepat, sehingga perbedaan kinerja minimal dan tidak akan mempengaruhi pengalaman pengguna secara signifikan.

Tips

Menggunakan 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 sepadan dengan pengembangan yang lebih sederhana. .cn Alternatif: Konfigurasi Berdasarkan Wilayah

Judul Bagian “Alternatif: Konfigurasi Berdasarkan Wilayah”

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

support@__CAPGO_KEEP_0__.app support@capgo.app kami di Komunitas Discord untuk bantuan.

Pengaturan

Jika Anda mengalami masalah dengan pembaruan di Cina:

1. Verifikasi konfigurasi Anda - Pastikan semua tiga URL sudah benar dalam pengaturan Anda capacitor.config.ts
2. Periksa koneksi jaringan - Pastikan perangkat Anda dapat mencapai updater.capgo.com.cn domain
3. Tinjau log - Gunakan npx @capgo/cli@latest app debug untuk memeriksa pesan kesalahan
4. Test updates - Coba mengunggah bundle baru dan memantau proses download
5. Hubungi dukungan - Jika masalah tetap berlanjut, hubungi kami di support@capgo.app atau bergabung dengan komunitas Discord kami untuk bantuan

Peringatan

Pastikan untuk menggunakan .cn domain (updater.capgo.com.cn) dan bukan domain internasional standar ketika mengonfigurasi untuk Cina.

Langkah-Langkah Selanjutnya

• Pelajari tentang Perbarui perilaku untuk menyesuaikan ketika pembaruan diterapkan
• Eksplorasi Saluran untuk mengelola jalur rilis yang berbeda
• Tinjau Enkripsi untuk memastikan pembaruan Anda aman