Capgoを中国で使用する

中国でアプリをユーザーに配布する場合、Capgo を地域の OST (Object Storage Technology) URL を使用して、信頼性の高いと迅速な更新を確実にするために、地域の OST (Object Storage Technology) URL を設定する必要があります。

中国固有のURLを使用する理由

中国のネットワークインフラと規制 (Great Firewall) のため、直接国際サーバーへの接続は遅く、信頼性が低くなることがあります。Capgo は、香港にデータを置いた Ost の専用 URL を提供し、遅延を最小限に抑え、ユーザーができるだけ迅速かつ信頼性の高い更新を受け取るようにします。

設定

中国の Capgo を設定するには、Capacitor の構成ファイルに 3 つの特定の URL を設定する必要があります。これらの URL は、Capgo の香港ベースのインフラストラクチャを指します。

1. ファイルを開きます capacitor.config.ts ファイル

2. Add the following configuration to the CapacitorUpdater プラグインセクションに以下の設定を追加します：

   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. アプリの変更を適用するには、再構築してください：

   npm run build
   npx cap sync

Configuration Details

Here’s what each URL does:

• updateUrl: https://updater.capgo.com.cn/updates - アプリの更新が利用可能かどうかを確認し、ダウンロードするURLです。
• statsUrl: https://updater.capgo.com.cn/stats - Capgoで分析と使用統計を報告するために使用されます。
• チャンネルURL: https://updater.capgo.com.cn/channel_self - __CAPGO_KEEP_0__のアップデートを適用するために必要なチャンネル設定を取得するために使用されます。

ヒント

中国でCapgoのアップデートャーが完全に機能するには、すべての3つのURLを同時に設定する必要があります。

中国の推奨設定

中国大陸に展開されているアプリのために、中国のグレートファイアウォールによるネットワークパフォーマンスの制限により、特定の推奨事項があります。

バックグラウンドアップデートを使用する

中国 __CAPGO_KEEP_0__を強くお勧めします。 autoUpdate: 'atBackground' 中国でアプリを実行する場合のために。中国では他の地域と比較してネットワーク接続性が低く、ダウンロードが中断されたり遅れたりすると、即時適用モードではユーザー体験が悪くなります。

代わりに、更新がバックグラウンドでダウンロードされ、背景でアプリが終了したり再起動したりすると、更新が完了するまでユーザー体験に影響を与えずに済みます。この方法は、ユーザー体験に影響を与えないようにするために、更新が成功するようにします。

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

注意

香港に拠点を置くインフラストラクチャは、遅延を最小限に抑え、信頼性を向上させるのに役立ちますが、中国本土へのネットワークパフォーマンスは、Great Firewallの影響を受ける可能性があります。バックグラウンドの更新を使用すると、更新が成功するようにし、ユーザー体験に影響を与えずに済みます。

完全な構成例

中国で展開するアプリ用に推奨される設定の完全な例を以下に示します。

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;

構成をテストする

中国固有のURLを設定した後、更新が正しく動作していることを確認することができます:

1. Capgoに新しいバンドルをアップロードします:

   npx @capgo/cli@latest bundle upload --channel=production

2. 中国のテストデバイスにアプリをインストールする

3. 更新プロセスを監視する:

   npx @capgo/cli@latest app debug

4. 中国OST URLから更新がダウンロードされていることを確認する

注意

標準のCapgo設定と同じように、更新の動作とタイミングは変更されません。詳細については、 Update Behavior ドキュメントを参照してください。

Multi-Region Deployment

アプリが中国内と中国外のユーザーにサービスを提供する場合、すべてのユーザー向けに中国ドメインの設定を使用できます。Alibaba DNS インフラストラクチャにより、ドメインは世界中で解決され、中国内と世界中のどこでもアクセス可能です。 updater.capgo.com.cn Using Chinese Domains Globally

「Using Chinese Domains Globally」セクション

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

This single configuration will work for:

• 中国大陸のユーザー（香港ベースのインフラを使用）
• 中国外のユーザー（同一のインフラをアリババDNSを介してアクセス）

パフォーマンスに関する考慮事項：

「」は、Alibaba DNSを介して世界中で解決され、どこでも動作しますが、標準ドメイン（「」）と比較して中国外のユーザーにとっては、__CAPGO_KEEP_0__でホストされているバックエンドが配置されている場所で直接解決されるため、中国外のユーザーにとってはややパフォーマンスが低くなります。ただし、DNS解決は高速なので、パフォーマンスの差はわずかであり、ユーザー体験に大きな影響を与えません。 .cn ヒントapi.capgo.app), which is resolved directly by Cloudflare where our backend is hosted. However, DNS resolution is fast, so the performance difference is minimal and won’t significantly impact the user experience.

代替: 地域別の構成

「代替: 地域別の構成」 .cn Performance Considerations:

While the

__CAPGO_KEEP_0__

• 各地域を優先順位として異なるように最適化したい場合は、以下も検討してみてください。
• 異なる構成で別々のアプリバリアントを構築する
• 環境ベースの構成を使用してURLを動的に設定する

異なる地域用に異なるリリースチャンネルを作成する support@capgo.app __CAPGO_KEEP_0__.appのサポートチーム または Discordコミュニティ

にご連絡ください。

トラブルシューティングのトピックです。

1. 設定を確認してください - すべての 3 つの URL が正しく設定されていることを確認してください capacitor.config.ts
2. ネットワーク接続を確認してください - デバイスがドメインに接続できることを確認してください updater.capgo.com.cn ログを確認してください
3. - エラーメッセージを確認するために使用してください アップデートをテストしてください npx @capgo/cli@latest app debug - 新しいバンドルをアップロードしてダウンロードプロセスを監視してください
4. サポートに連絡してください - 問題が続いている場合は、以下の連絡先までご連絡ください
5. __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ support@capgo.app __CAPGO_KEEP_0__.appのサポートチームにご連絡ください または、 Discordコミュニティに参加してください

注意

中国の設定用には、ドメイン「__CAPGO_KEEP_0__.(」と「)」を使用してください。標準の国際ドメインを使用しないでください。 .cn 次のステップupdater.capgo.com.cn「次のステップ」のセクション

中国の設定について学びましょう

• Learn about __CAPGO_KEEP_0__ アップデートの動作を変更する __CAPGO_KEEP_0__を中国で使用している場合にアップデートが適用されるタイミングをカスタマイズする
• 探索 チャンネル 異なるリリーストラックを管理する
• レビュー 暗号化 アップデートをセキュリティで保護する

Capgoを中国で使用している場合の続き

__CAPGO_KEEP_0__を中国で使用している場合の場合 Capgoを中国で使用している場合 __CAPGO_KEEP_0__ライブアップデートの配信計画を立てるには、 Capgoライブアップデートに接続する Capgoライブアップデートの製品ワークフローについて 概要 概要の実装詳細について 機能 機能の実装詳細について 更新動作 更新動作の実装詳細について 更新種類 更新種類の実装詳細について