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 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. Copy ke clipboard

   npm run build
   npx cap sync

Berikut adalah apa yang dilakukan oleh setiap URL:

- Digunakan untuk memeriksa dan mengunduh update yang tersedia untuk aplikasi Anda

• Rebuild aplikasi Anda untuk menerapkan perubahan:: https://updater.capgo.com.cn/updates Copy to clipboard
• URL Statistik: https://updater.capgo.com.cn/stats - Digunakan untuk melaporkan analisis dan statistik penggunaan kembali ke Capgo
• URL Channel: 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 tertentu untuk aplikasi yang dijalankan di daratan Cina:

Perbesar Waktu Respon API

Plugin pembarui Capgo menghentikan API panggilan ketika responseTimeout adalah melebihi (nilai dalam detik) Infrastruktur Edge di depan Capgo juga menganggap sekitar detik sebagai anggaran gagal untuk beberapa jalur.

Ini adalah kondisi umum di daratan Cina, ketidakteraturan waktu antarbenua sering kali lebih tinggi. Simpan waktu __CAPGO_KEEP_1__ lebih tinggi agar plugin memiliki ruang yang cukup untuk menyelesaikan pengecekan pembaruan dan download melalui responseTimeout bukan gagal awal: updater.capgo.com.cn Salin ke papan klip

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

Copy to clipboard

Prefer 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 diterapkan 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 latency dan meningkatkan keandalan, kinerja jaringan ke Cina daratan masih dapat terganggu 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 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
      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. Instal 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. Pengaturan Pengembangan Multi-Region

Bab berjudul “Pengembangan Multi-Region”

Copy to clipboard updater.capgo.com.cn Check that updates are being downloaded from the China OST URLs

Gunakan Domain Cina Global

URL domain Cina berfungsi 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 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.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 domain untuk semua pengguna memudahkan penginstalan dan memastikan perilaku pembaruan konsisten di semua wilayah. Anda tidak perlu membuat bangunan 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 memerlukan 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

Kamu dapat memantau kesehatan dan status endpoint spesifik Cina Capgo di status.capgo.com.cn. Gunakan halaman ini untuk memeriksa insiden, latency, dan uptime URL OST Cina sebelum melakukan troubleshooting aplikasi.

Pengaturan

Bab yang berjudul “Pengaturan”

1. Jika kamu mengalami masalah dengan pembaruan di Cina: Verifikasi pengaturan kamu kamu secara ganda untuk memastikan bahwa semua tiga URL telah ditetapkan dengan benar di 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 apapun insiden yang sedang berlangsung atau kinerja yang terdegradasi
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

Pertimbangan

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

Langkah-Langkah Selanjutnya

• Belajar tentang Siklus Pembaruan untuk menyesuaikan ketika pembaruan diterapkan
• Jelajahi Saluran untuk mengelola jalur rilis yang berbeda
• Periksa 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.