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 peraturan di Cina (Tembok Besar), 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.

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 Konfigurasi ini akan memastikan pembaruan yang dapat diandalkan dan cepat untuk pengguna Anda di Cina.

   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 apa yang dilakukan 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 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 Dianjurkan untuk Cina

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

Gunakan Pembarui Latar Belakang

Kami sangat menyarankan penggunaan 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 pembaruan default di mana pembaruan mengunduh di latar belakang dan berlaku ketika aplikasi berada di latar belakang atau restart.

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 Tiongkok daratan masih dapat terganggu oleh Tembok Api. Menggunakan pembaruan latar belakang membantu memastikan pembaruan selesai dengan sukses tanpa mengganggu pengalaman pengguna.

Contoh Konfigurasi Lengkap

Berikut adalah contoh lengkap dengan pengaturan yang disarankan untuk aplikasi yang dijalankan 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
      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 Tiongkok, Anda dapat memastikan bahwa pembaruan berfungsi 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

Siklus pembaruan dan waktu tetap sama seperti konfigurasi standar Capgo. Lihat di Siklus Pembaruan Dokumentasi untuk informasi lebih lanjut tentang cara dan kapan pembaruan diterapkan.

Pengembangan Multi-Region

Jika aplikasi Anda melayani pengguna baik di dalam maupun di luar Cina, Anda dapat menggunakan konfigurasi domain Cina untuk pengguna di seluruh dunia. Domain ini diresolusi secara global berkat infrastruktur DNS Alibaba, sehingga dapat diakses baik di Cina maupun di tempat lain di dunia. updater.capgo.com.cn Menggunakan Domain Cina Secara Global

Bagian berjudul “Menggunakan Domain Cina Secara Global”

Salin ke clipboard

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

Pengguna di daratan Cina (menggunakan infrastruktur berbasis Hong Kong)

• Pengguna di luar Cina (mengakses infrastruktur yang sama melalui DNS Alibaba)
• Salin ke clipboard

Konsiderasi Kinerja:

Sementara domain .cn dapat diresolusi secara global melalui Alibaba DNS dan berfungsi di mana saja, namun sedikit kurang kinerjanya bagi pengguna di luar Cina dibandingkan dengan domain standar (api.capgo.app), yang dapat diresolusi secara langsung oleh Cloudflare karena backend kami dihosting di sana. Namun, resolusi DNS sangat cepat, sehingga perbedaan kinerja minimal dan tidak akan berdampak signifikan pada pengalaman pengguna.

Tip

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

Alternatif: Konfigurasi Berdasarkan Wilayah

Jika Anda lebih suka mengoptimalkan secara berbeda 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-region, silakan menghubungi kami di support@capgo.app atau bergabunglah dengan komunitas Discord kami untuk bantuan. Pengaturan

Bagian berjudul “Pengaturan”

Verifikasi konfigurasi Anda

1. - Periksa kembali bahwa semua tiga URL telah ditetapkan dengan benar di pengaturan Anda Pengaturan dan Perbaikan Masalah 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. Uji pembaruan - 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
• Eksplorasi Saluran untuk mengelola jalur rilis yang berbeda
• Tinjau Enkripsi untuk memastikan pembaruan Anda

Teruskan dari Menggunakan Capgo di Cina

Jika Anda menggunakan __CAPGO_KEEP_0__ di Cina untuk merencanakan pengiriman pembaruan live, hubungkan dengan Capgo Live Updates __CAPGO_KEEP_0__ Live Updates Capgo di Cina untuk alur kerja produk di Capgo Live Updates, Ringkasan untuk detail implementasi di Ringkasan, Fitur untuk detail implementasi di Fitur, Pengaturan Perbarui untuk detail implementasi di Pengaturan Perbarui, dan Jenis Perbarui untuk detail implementasi di Jenis Perbarui.