Menggunakan Capgo di Cina

Jika Anda menginstal aplikasi Anda untuk pengguna di Cina, Anda akan perlu mengonfigurasi Capgo untuk menggunakan OST regional (Object Storage Technology) URL untuk memastikan pembaruan yang dapat diandalkan dan cepat.

Mengapa Menggunakan URL Khusus Cina?

Karena infrastruktur jaringan dan peraturan di Cina (The 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

To mengatur Capgo untuk Cina, Anda perlu menetapkan tiga URL tertentu dalam konfigurasi file Capacitor. URL ini mengarah ke infrastruktur Capgo di Hong Kong.

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: '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. Jendela terminal

   npm run build
   npx cap sync

Bab berjudul “Detail Konfigurasi”

Copy to clipboard

• 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 memperoleh konfigurasi saluran dan menentukan pembaruan mana 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 Perbaruan Latar Belakang

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

Sebaliknya, gunakan perilaku perbaruan default di mana perbaruan download di latar belakang dan berlaku ketika aplikasi di latar belakang atau restart. Ini menyediakan 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 latency dan meningkatkan keandalan, kinerja jaringan ke Cina daratan masih dapat terganggu oleh Tembok Api Besar. Menggunakan perbaruan latar belakang membantu memastikan perbaruan selesai dengan sukses tanpa mengganggu pengalaman pengguna.

Contoh Konfigurasi Lengkap

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: '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 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

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

Pengembangan Multi-Benua

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

Section titled “Pengembangan Multi-Benua”

URL domain Cina bekerja 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 daratan Cina (menggunakan infrastruktur berbasis Hong Kong)
• Pengguna di luar Cina (mengakses infrastruktur yang sama melalui DNS Alibaba)

Konsiderasi Kinerja:

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

Tips

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. Pengorbanan kinerja yang kecil di luar Cina biasanya bernilai proses pengembangan yang lebih sederhana.

Alternatif: Konfigurasi Berdasarkan Wilayah

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 support@capgo.app atau bergabung dengan komunitas Discord kami untuk bantuan. domain for all users simplifies your deployment and ensures consistent update behavior across all regions. You don’t need separate builds or environment-based configurations. The small performance trade-off outside China is typically worth the simplified deployment.

Mengatasi Masalah

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. 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 - Coba unggah bundle baru dan pantau 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 Pengaturan untuk mengatur kapan pembaruan diterapkan
• Eksplorasi Saluran untuk mengelola berbagai jalur rilis
• Tinjau Enkripsi untuk memastikan keamanan pembaruan

Teruskan dari Menggunakan Capgo di Cina

Jika Anda menggunakan Menggunakan Capgo di Cina untuk merencanakan pengiriman pembaruan live, hubungkannya dengan Capgo Live Updates untuk alur kerja produk di Capgo Live Updates, Ringkasan untuk detail implementasi di Ringkasan, Fitur untuk detail implementasi di Fitur, Pengaturan Pembaruan untuk detail implementasi di Pengaturan Pembaruan Jenis Update untuk detail implementasi di Jenis Update.