Capgoを中国で使用する

中国でアプリを展開する場合、Capgoを地域のOST(オブジェクトストレージテクノロジー)URLを使用して、信頼性の高いと高速な更新を確保するために、地域のOST(オブジェクトストレージテクノロジー)URLを使用する必要があります。

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

中国（グレートファイアウォール）のネットワークインフラと規制により、直接国際サーバーへの接続が遅いまたは不信頼性の高い可能性があります。Capgoは、データが香港にあり、遅延を最小限に抑え、ユーザーが可能な限り迅速かつ信頼性の高い更新を受け取るようにするために、香港に拠点を置くOST(オブジェクトストレージテクノロジー)URLを提供します。

設定

中国を対象にしたCapgoの設定を行うには、Capacitorの設定ファイルに3つの特定のURLを設定する必要があります。これらのURLはCapgoの香港に拠点を置くインフラストラクチャを指します。

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

2. 以下の設定をプラグインセクションに追加してください: 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

「設定詳細」タイトルのセクション

updateUrl

• - アプリの更新をチェックし、ダウンロードするURL: https://updater.capgo.com.cn/updates ここでは、各URLの機能を説明します:
• 統計URL: https://updater.capgo.com.cn/stats - Capgo への分析と使用状況統計の報告に使用されます。
• チャンネルURL: https://updater.capgo.com.cn/channel_self - __CAPGO_KEEP_0__ のチャンネル設定を取得し、適用する更新を決定するために使用されます。

ヒント

すべての 3 つの URL を同時に設定する必要があります。Capgo アップデーターが中国で完全に機能することを保証するため。

中国の推奨設定

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

API の応答タイムアウトを増やす

CapgoのCapgoアップデートプラグインはAPI呼び出しを中断します。 responseTimeout __CAPGO_KEEP_0__の値が__CAPGO_KEEP_2__を超えると 秒). Edge infrastructure in front of Capgo also treats about Cloudflareのエッジインフラストラクチャの前に__CAPGO_KEEP_0__も、約 秒

を失敗の予算として扱うパスもあります。 responseTimeout 中国大陸では、境界を越えた遅延が一般的です。__CAPGO_KEEP_3__を高く設定すると、プラグインがアップデートチェックとダウンロードを完了するのに十分な余裕を持つことができます。 updater.capgo.com.cn アップデートチェックとダウンロードを完了するのに十分な余裕を持つために、__CAPGO_KEEP_4__を使用するのではなく__CAPGO_KEEP_5__を使用します。

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

ヒント

Prefer responseTimeout: 60 (or higher) for China deployments. A low timeout does not make updates faster — it only causes the plugin to give up while the request may still succeed on Capgo’s side.

Use Background Updates

We strongly recommend using autoUpdate: 'atBackground' for apps in China. Network connectivity in China is less performant than in other regions, and instant apply modes can lead to a poor user experience if downloads are interrupted or slow.

Instead, use the default update behavior where updates download in the background and apply when the app backgrounds or restarts. This provides a more reliable experience for your users.

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

Caution

While our Hong Kong-based infrastructure helps minimize latency and improve reliability, network performance to mainland China can still be affected by the Great Firewall. Using background updates helps ensure updates complete successfully without disrupting the user experience.

完全な構成例

中国で展開されているアプリ向けに推奨される設定が含まれた完全な例です。

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;

構成のテスト

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

1. Capgoに新しいバンドルをアップロードしてください。

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

2. 中国でテストデバイスにアプリをインストールしてください

3. 更新プロセスを監視してください

   npx @capgo/cli@latest app debug

4. 中国OST URLからアップデートがダウンロードされていることを確認する

注記

Capgoの標準設定と同じようにアップデートの動作とタイミングは変わりません。詳細については、 アップデートの動作 ドキュメントを参照してください。

マルチリージョンディプロイメント

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

グローバルで中国のドメインを使用する

中国のドメインURLは、多地域アプリで平滑に機能します:

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

この単一の設定は、以下のユーザーに適用されます:

• 中国本土のユーザー（香港ベースのインフラを使用）
• 中国外のユーザー（Alibaba DNSを使用して同じインフラにアクセス）

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

ドメインは、Alibaba DNSを使用してグローバルに解決され、世界中で機能しますが、中国外のユーザーにとって標準ドメイン（ .cn ）と比較して、標準ドメインが直接__CAPGO_KEEP_0__でホストされているサーバーで解決されるため、標準ドメインよりもわずかにパフォーマンスが低くなります。ただし、DNS解決は高速で、パフォーマンスの差はわずかであり、ユーザー体験に大きな影響を与えません。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.

Tip

使用する .cn すべてのユーザー向けのドメインを使用すると、展開が簡素化され、すべての地域で一貫した更新動作が保証されます。中国以外の地域での小さなパフォーマンスのトレードオフは、展開が簡素化されることの価値が高いことが多いです。

Alternative: Region-Specific Configurations

各地域を最適化したい場合は、以下の方法も検討できます。

• 異なる構成でアプリをビルドする
• 環境ベースの構成を使用してURLを動的に設定する
• 異なるリリースチャンネルを各地域ごとに作成する

複数の地域を対象とする展開戦略についての助言が必要な場合は、以下の連絡先までご連絡ください。 support@capgo.app または Discordコミュニティ ご助けを求めます。

中国インフラの監視

Capgoの中国固有エンドポイントの健康とステータスを監視できます。 status.capgo.com.cn.中国OST URLの遅延、ダウンタイム、インシデントを確認するには、このページをご利用ください。

トラブルシューティング

中国でのアップデートの問題が発生した場合:

1. 設定を確認してください - すべての3つのURLが正しく設定されていることを確認してください capacitor.config.ts
2. アップデート responseTimeout - 中国では少なくとも 60 秒を使用してください。中国ではプラグインがアップデート要求がまだ飛行中であるため、失敗しないようにします。
3. ネットワーク接続を確認する - デバイスが updater.capgo.com.cn ドメイン
4. 中国のステータスページを確認する - status.capgo.com.cn で進行中のインシデントやパフォーマンスの低下を確認する
5. ログを確認する - npx @capgo/cli@latest app debug エラー メッセージを確認する
6. テスト アップデート - 新しいバンドルをアップロードしてダウンロード プロセスを監視してください
7. サポートに連絡する ロール: UI ラベルまたはナビゲーション アイテム support@capgo.app support@__CAPGO_KEEP_0__.app または Discord コミュニティに参加して

注意

注意 .cn ドメイン (updater.capgo.com.cn) と標準の国際ドメインではなく、中国の設定で使用するドメインです。

次のステップ

• 次のステップ 学習 アップデートの動作をカスタマイズする
• チャンネル Capgo リリース チャンネルの機能名 Capgo ソリューションズ マーケティング ページ
• アップデートの適用時をカスタマイズする チャンネルを管理する アップデートをセキュリティで保護する

中国でCapgoを使用し続ける

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