Menggunakan Capgo di Cina

Jika Anda menginstal 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 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 latensi dan memastikan pengguna Anda menerima pembaruan dengan cepat dan dapat diandalkan.

Konfigurasi

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 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. Rebuild aplikasi Anda untuk menerapkan perubahan:

   npm run build
   npx cap sync

Detail Konfigurasi

Berikut adalah apa yang dilakukan oleh setiap 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 analisis dan statistik penggunaan kembali ke Capgo
• channelUrl: https://updater.capgo.com.cn/channel_self - Digunakan untuk memperoleh konfigurasi saluran dan menentukan update mana yang harus diterapkan

Tips

Tiga URL tersebut harus dikonfigurasi bersama untuk memastikan fungsi penuh dari pembarui Capgo di Cina.

Pengaturan yang Dianjurkan untuk Cina

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

Matikan Pembaruan Langsung

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

Sebaliknya, gunakan perilaku pembaruan bawaan di mana pembaruan download di latar belakang dan berlaku ketika aplikasi berlatar belakang atau restart. Ini memberikan 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

Meskipun infrastruktur kami di Hong Kong membantu mengurangi latency dan meningkatkan keandalan, kinerja jaringan ke Tiongkok daratan masih dapat terpengaruh oleh Tembok Api. directUpdate Menghapus

Membantu memastikan pembaruan selesai dengan sukses tanpa mengganggu pengalaman pengguna.

Bagian berjudul “Contoh Konfigurasi Lengkap”

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;

Salin ke clipboard

Bagian berjudul “Menguji Konfigurasi Anda”

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

Siklus pembaruan dan waktu tetap sama seperti dengan konfigurasi standar Capgo. Lihat di Siklus Pembaruan __CAPGO_KEEP_0__

Penggunaan Wilayah Berbagai

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

Menggunakan Domain Tiongkok di Seluruh Dunia

URL domain Tiongkok berfungsi dengan lancar untuk aplikasi multi-wilayah:

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 tunggal ini akan berfungsi untuk:

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

Konsiderasi Kinerja:

Sementara domain ini diresolusi secara global melalui Alibaba DNS dan berfungsi di mana saja, namun sedikit kurang kinerjanya bagi pengguna di luar Cina dibandingkan dengan domain standar (""), yang diresolusi secara langsung oleh __CAPGO_KEEP_0__ tempat backend kami dihosting. Namun, resolusi DNS sangat cepat, sehingga perbedaan kinerja minimal dan tidak akan berdampak signifikan pada pengalaman pengguna. .cn Tipapi.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.

Alternatif: Pengaturan Berdasarkan Wilayah

Judul bagian “Alternatif: Pengaturan Berdasarkan Wilayah” .cn Jika Anda lebih suka mengoptimalkan secara berbeda untuk setiap wilayah, Anda juga dapat mempertimbangkan:

Membangun variasi aplikasi yang berbeda dengan pengaturan yang berbeda

Membangun variasi aplikasi yang berbeda dengan pengaturan yang berbeda

• Membangun variasi aplikasi yang berbeda dengan pengaturan 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-region, silakan menghubungi kami di support@capgo.app atau bergabung dengan komunitas Discord kami untuk bantuan. Pengaturan Perbaikan

Judul bagian “Pengaturan Perbaikan”

Verifikasi konfigurasi Anda

1. - Periksa kembali bahwa semua tiga URL telah ditetapkan dengan benar di pengaturan Anda - Pastikan Anda telah mengaktifkan akses ke Cloudflare untuk mengakses pembaruan dari luar negeri capacitor.config.ts
2. Periksa koneksi jaringan - Pastikan perangkat Anda dapat mengakses updater.capgo.com.cn domain
3. Tinjau log - Gunakan npx @capgo/cli@latest app debug untuk memeriksa pesan kesalahan
4. Uji perbarui - Cobalah 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 untuk bantuan

Peringatan

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

Langkah-Langkah Selanjutnya

• Pelajari tentang Pengaturan Pembaruan untuk mengatur kapan pembaruan diterapkan
• Eksplor Saluran untuk mengelola jalur rilis yang berbeda
• Tinjau Enkripsi untuk memastikan update Anda aman