Menggunakan Capgo di Cina

Jika Anda mengembangkan aplikasi untuk 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 dedikasi dengan data yang terletak di Hong Kong untuk mengurangi latency dan memastikan pengguna Anda menerima pembaruan dengan cepat dan dapat diandalkan mungkin.

Pengaturan

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 Copy 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 yang berjudul “Detail Konfigurasi”

updateUrl

• - Digunakan untuk memeriksa dan mengunduh update yang tersedia untuk aplikasi Anda: https://updater.capgo.com.cn/updates plugin
• URL Statistik: https://updater.capgo.com.cn/stats - Digunakan untuk melaporkan analisis dan statistik penggunaan kembali ke Capgo
• URL Saluran: https://updater.capgo.com.cn/channel_self - Digunakan untuk memperoleh konfigurasi saluran dan menentukan mana update yang harus diterapkan

Trik

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:

Perbesar Waktu Sambungan API

Pengguna Capgo updater plugin menghentikan API panggilan ketika responseTimeout melebihi (nilai dalam detik). Infrastruktur Edge di depan Capgo juga menganggap sekitar detik) sebagai anggaran gagal untuk beberapa jalur. Di daratan Cina, ketidakstabilan lintas batas seringkali lebih tinggi. Simpan waktu __CAPGO_KEEP_1__ yang lebih tinggi agar plugin memiliki ruang yang cukup untuk menyelesaikan pengecekan update dan download melalui

bukan gagal awal: responseTimeout Salin ke papan klip updater.capgo.com.cn Tip

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: 'atBackground',
      // Seconds. Raise above the default (20) for China network conditions.
      responseTimeout: 60,
      updateUrl: 'https://updater.capgo.com.cn/updates',
      statsUrl: 'https://updater.capgo.com.cn/stats',
      channelUrl: 'https://updater.capgo.com.cn/channel_self',
    },
  },
};

protectedTokens

Lebih baik responseTimeout: 60 (atau lebih tinggi) untuk penggunaan di Cina. Waktu tunggu rendah tidak membuat pembaruan lebih cepat — hanya menyebabkan plugin menyerah sementara permintaan mungkin masih berhasil di sisi Capgo.

Pilih Pembaruan Latar Belakang

Kami mengusulkan 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 pembaruan default di mana pembaruan 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

Sementara infrastruktur kami di Hong Kong membantu mengurangi latensi dan meningkatkan keandalan, kinerja jaringan ke Cina daratan masih dapat dipengaruhi oleh Tembok Api Besar. Menggunakan pembaruan latar belakang membantu memastikan pembaruan selesai dengan sukses tanpa mengganggu pengalaman pengguna.

Contoh Konfigurasi Lengkap

Berikut adalah contoh lengkap dengan pengaturan yang direkomendasikan 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
      responseTimeout: 60, // Seconds — give China network more room
      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. Pantau proses pembaruan:

   npx @capgo/cli@latest app debug

4. Pastikan pembaruan sedang diunduh dari URL OST Cina

Catatan

Perilaku pembaruan dan waktu tetap sama seperti dengan konfigurasi standar Capgo Lihat Dokumentasi untuk informasi lebih lanjut tentang cara dan kapan pembaruan diterapkan. Pengembangan Multi-Benua

Bab berjudul “Pengembangan Multi-Benua”

Jendela terminal updater.capgo.com.cn Salin ke klipbord

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

Pertimbangan Kinerja:

Sementara domain .cn adalah diresolusi secara global melalui Alibaba DNS dan berfungsi di mana saja, namun sedikit kurang kinerjanya untuk pengguna di luar Tiongkok dibandingkan dengan domain standar (api.capgo.appyang diresolusi secara langsung oleh Cloudflare karena backend kami berada di sana. Namun, resolusi DNS cepat, sehingga perbedaan kinerja minimal dan tidak akan mempengaruhi pengalaman pengguna secara signifikan.

Tips

Menggunakan domain untuk semua pengguna memudahkan penginstalan dan memastikan perilaku pembaruan konsisten di semua wilayah. Anda tidak perlu membuat build yang berbeda atau mengatur konfigurasi berdasarkan lingkungan. Biaya kinerja yang kecil di luar Cina biasanya bernilai penginstalan yang lebih sederhana. .cn Alternatif: Konfigurasi Wilayah-Spesifik

Bab yang berjudul “Alternatif: Konfigurasi Wilayah-Spesifik”

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 penginstalan multi-wilayah, silakan menghubungi kami di

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

Pantau Infrastruktur Cina

Anda dapat memantau kesehatan dan status endpoint khusus Cina Capgo di status.capgo.com.cn. Gunakan halaman ini untuk memeriksa insiden, latency, dan waktu aktifitas URL OST Cina sebelum melakukan troubleshooting aplikasi Anda.

Pengaturan

Bab yang berjudul “Pengaturan”

1. Jika Anda mengalami masalah dengan pembaruan di Cina: Periksa pengaturan Anda secara berkali-kali. capacitor.config.ts
2. Meningkatkan responseTimeout - Gunakan setidaknya 60 detik di Cina agar plugin tidak berhenti sementara permintaan pembaruan masih dalam penerbangan
3. Periksa koneksi jaringan - Pastikan perangkat Anda dapat mencapai updater.capgo.com.cn domain
4. Periksa halaman status Cina - Tinjau status.capgo.com.cn untuk insiden yang sedang berlangsung atau kinerja yang menurun
5. Tinjau log - Gunakan npx @capgo/cli@latest app debug untuk memeriksa pesan kesalahan
6. Uji coba pembaruan - Coba mengunggah bundle baru dan memantau proses download
7. Hubungi dukungan context: Halaman/area: Situs web pemasaran Capgo. Peran: Label UI singkat atau item navigasi. Dilihat di: komponen harga/Faq.astro. Kunci pesan `contact_support` (Hubungi Dukungan). support@capgo.app support@__CAPGO_KEEP_0__.app atau bergabung dengan komunitas Discord kami untuk bantuan

Pertimbangan

Pastikan untuk menggunakan .cn domain (updater.capgo.com.cndan tidak domain internasional standar ketika mengonfigurasi untuk Cina.

Langkah Selanjutnya

• Belajar tentang Sifat Pembaruan untuk menyesuaikan ketika pembaruan diterapkan
• Explore Saluran untuk mengelola jalur rilis yang berbeda
• Review Enkripsi untuk memastikan pembaruan Anda

Teruskan dari Menggunakan Capgo di Cina

Jika Anda menggunakan Menggunakan Capgo di Cina untuk merencanakan pengiriman pembaruan live, hubungkannya dengan Capgo Pembaruan Live for the product workflow in Capgo Live Updates, untuk alur kerja produk di __CAPGO_KEEP_0__ Pembaruan Live, Ringkasan untuk detail implementasi di Ringkasan, Fitur-Fitur Pengaturan Perbarui untuk detail implementasi di Pengaturan Perbarui, dan Jenis Perbarui untuk detail implementasi di Jenis Perbarui.