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 (The Great Firewall), koneksi langsung ke server internasional dapat lambat atau tidak dapat diandalkan. Capgo menyediakan URL OST yang terdedikasi dengan data yang berada di Hong Kong untuk mengurangi latency dan memastikan pengguna Anda menerima update dengan cepat dan dapat diandalkan mungkin.

Konfigurasi

Untuk mengonfigurasi Capgo untuk Cina, Anda perlu menetapkan tiga URL tertentu di file konfigurasi Capacitor. URL ini mengarah ke infrastruktur Capgo yang berbasis 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

Detail Konfigurasi

Berikut adalah apa yang dilakukan oleh 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 memperoleh konfigurasi saluran dan menentukan pembaruan mana yang harus diterapkan

Tip

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

Rekomendasi Pengaturan untuk Cina

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

Gunakan Pengaturan Latar Belakang

Kami mengesyorkan 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 update default di mana update download di latar belakang dan berlaku ketika aplikasi di background 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

While infrastruktur kami di Hong Kong membantu mengurangi latency dan meningkatkan keandalan, kinerja jaringan ke daratan Cina masih dapat terpengaruh 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 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. Pastikan pembaruan sedang diunduh dari URL OST Cina

Catatan

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

Pengembangan Multi-Benua

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

Menggunakan Domain Cina Secara Global

URL domain 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)

Konsiderasi Kinerja:

Sementara domain .cn 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 secara 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 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 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 memerlukan bantuan dengan strategi pengembangan multi-wilayah, silakan menghubungi kami di support@capgo.app atau bergabunglah dengan komunitas Discord kami untuk bantuan. Bagian Penyelesaian Masalah

Jika Anda mengalami masalah dengan pembaruan di Cina:

- Periksa kembali bahwa semua tiga URL telah ditetapkan dengan benar di

1. Periksa koneksi jaringan - Pastikan perangkat Anda dapat mencapai capacitor.config.ts
2. domain Ulangi log updater.capgo.com.cn __CAPGO_KEEP_0__
3. __CAPGO_KEEP_1__ - Gunakan npx @capgo/cli@latest app debug untuk memeriksa pesan kesalahan
4. Perbarui Test - 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 menggunakan .cn domain (updater.capgo.com.cn) dan bukan domain internasional standar ketika mengonfigurasi untuk Cina.

Langkah-Langkah Selanjutnya

• Pelajari tentang Pengaturan Pembaruan untuk mempersonalisasi ketika pembaruan diterapkan
• Eksplorasi Saluran untuk mengelola jalur rilis yang berbeda
• Tinjau Enkripsi untuk memastikan update Anda aman

Teruskan dari Menggunakan Capgo di Cina

Jika Anda menggunakan Menggunakan Capgo di Cina untuk merencanakan pengiriman update live, hubungkannya dengan Capgo Live Updates untuk alur kerja produk di Capgo Live Updates, Ringkasan untuk detail implementasi di Ringkasan, Fitur-Fitur untuk detail implementasi di Fitur-fitur, Perilaku Update untuk detail implementasi di Perilaku Update, dan Jenis Update untuk detail implementasi di Jenis Update.