中国でのCapgoの使用

中国のユーザーにアプリをデプロイする場合、信頼性が高く高速なアップデートを実現するには、Capgo でリージョン別の OST (Object Storage Technology) URL を使用するよう設定する必要があります。

中国専用URLを使用する理由

中国のネットワークインフラや規制（グレート・ファイアウォール）の影響により、海外サーバーへの直接接続は低速になったり不安定になったりすることがあります。Capgoでは、遅延を最小限に抑え、ユーザーが可能な限り迅速かつ確実にアップデートを受け取れるよう、香港にデータを配置した専用のOST URLを提供しています。

設定

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

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

2. 以下の設定を次に追加してください： CapacitorUpdater pluginセクション：

   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

設定の詳細

各URLの役割は以下の通りです：

• アップデート用URL: https://updater.capgo.com.cn/updates - アプリの利用可能なアップデートを確認し、ダウンロードするために使用します
• 統計用URL: https://updater.capgo.com.cn/stats - 分析データや使用統計を Capgo に送信するために使用します
• channelUrl: https://updater.capgo.com.cn/channel_self - チャネル設定を取得し、適用するアップデートを決定するために使用します

ヒント

中国国内で Capgo updater の全機能を利用するには、これら3つのURLをすべて設定する必要があります。

中国向けの推奨設定

中国のグレートファイアウォールによるネットワーク制限を考慮し、中国本土で展開されるアプリ向けに以下の推奨設定を用意しています。

API のレスポンスタイムアウトを延長する

Capgo updater プラグインは、以下の条件で API コールを中断します： responseTimeout が超過した場合（値の単位は 秒）。また、Capgo の前段にあるエッジインフラストラクチャでも、約 3秒 一部のパスにおける失敗許容範囲（failure budget）として。

中国本土では、国境を越える通信のレイテンシが高くなる傾向があります。そのため、 responseTimeout プラグインがアップデートの確認やダウンロードを完了できるよう、十分な余裕を確保してください。 updater.capgo.com.cn 早期にエラー終了させるのではなく：

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

ヒント

推奨： responseTimeout: 60 中国向けのデプロイでは、タイムアウト値を高めに設定してください。タイムアウトを短くしてもアップデートが速くなるわけではなく、Capgo 側ではリクエストが成功している可能性があるにもかかわらず、プラグインが処理を諦めてしまう原因になります。

Background Updates を使用する

私たちは の使用を強く推奨します autoUpdate: 'atBackground' 中国向けのアプリでは、中国国内のネットワーク接続は他の地域よりもパフォーマンスが低く、ダウンロードが中断されたり遅かったりすると、instant applyモードはユーザー体験を損なう可能性があります。

代わりに、アップデートをバックグラウンドでダウンロードし、アプリがバックグラウンドに移行したときや再起動時に適用するデフォルトの更新動作を使用してください。これにより、ユーザーにより信頼性の高い体験を提供できます。

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
      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 に新しい bundle を upload します：

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

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

3. アップデートのプロセスを監視します：

   npx @capgo/cli@latest app debug

4. アップデートが中国の OST URL から download されていることを確認します

注意

アップデートの動作やタイミングは、標準的な Capgo 設定と同じです。詳細は アップデートの動作 アップデートの適用方法とタイミングに関するドキュメントを参照してください。

マルチリージョン展開

中国国内外の両方にユーザーがいるアプリの場合、中国ドメインの設定を全世界の全ユーザーに対して使用できます。 updater.capgo.com.cn このドメインはAlibaba 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経由で同じインフラにアクセス）

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

この .cn ドメインはAlibaba DNSを通じてグローバルに解決され、どこでも動作しますが、標準ドメインと比較すると、中国国外のユーザーにとってはわずかにパフォーマンスが低下します。api.capgo.appこの標準ドメインは、バックエンドがホストされている Cloudflare によって直接解決されます。ただし、DNS解決は高速なため、パフォーマンス差は最小限で、ユーザー体験に大きな影響はありません。

ヒント

この .cn ドメインをすべてのユーザーに使用すると、デプロイが簡素化され、すべてのリージョンで一貫したアップデート動作が保証されます。個別のビルドや環境ごとの設定は不要です。中国国外でのわずかなパフォーマンスへの影響よりも、デプロイの簡素化によるメリットの方が通常は大きいです。

代替案：リージョン別の設定

リージョンごとに異なる最適化を行いたい場合は、以下の方法も検討してください：

• 異なる設定を持つアプリのバリアントを個別にビルドする
• 環境変数ベースの設定を使用して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. アップデートをテストする - 新しいbundleをuploadし、downloadプロセスを監視する
7. サポートに問い合わせる - 問題が解決しない場合は、こちらまでお問い合わせください support@capgo.app または参加： Discord コミュニティ サポートが必要な場合は

注意

必ず以下の .cn ドメイン（updater.capgo.com.cn）を使用してください。中国向けの設定では、標準の国際ドメインは使用できません。

次のステップ

• 詳しく知る アップデートの動作 アップデートの適用タイミングをカスタマイズする
• 詳しく見る チャンネル 異なるリリース・トラックを管理する
• 審査 暗号化 アップデートをセキュアに保つ

次へ：中国での Capgo の利用について

使用している場合 中国でのCapgoの使用 live update の配信を計画するには、以下と連携させます： Capgo Live Updates Capgo Live Updates のプロダクトワークフロー向けに、 概要 実装の詳細は Overview を 機能 実装の詳細は Features を アップデートの動作 実装の詳細はアップデートの動作を、および アップデートの種類 実装の詳細はアップデートの種類を。