Capgoを中国で使用する

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

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

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

構成

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

1. ターミナル capacitor.config.ts ファイル

2. __CAPGO_KEEP_1__の設定ファイルに次の設定を追加します。 CapacitorUpdater プラグインセクション

   import { CapacitorConfig } from '@capacitor/cli';
   
   const config: CapacitorConfig = {
     plugins: {
       CapacitorUpdater: {
         autoUpdate: true,
         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は次のようになります:

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

ヒント

すべてのURLを組み合わせて、中国でCapgo アップデーターを完全に機能させるには、必須です。

中国の推奨設定

中国大陸へのアプリケーション展開におけるネットワークパフォーマンス制限のため、以下の推奨事項があります:

__CAPGO_KEEP_0__

私たちは 中国のアプリケーション向けに直接更新を無効にすることを強くお勧めします。中国におけるネットワーク接続性は他の地域と比較して低く、直接更新（即時適用）がダウンロードが中断または遅延した場合、ユーザー体験が悪化する可能性があります。 directUpdate 代わりに、更新がバックグラウンドでダウンロードされ、背景または再起動時に適用されるデフォルトの更新動作を使用してください。このアプローチは、ユーザー体験に影響を与えることなく、更新を成功させるのに役立ちます。

コピー

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: true,
      directUpdate: false, // 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',
    },
  },
};

香港ベースのインフラストラクチャにより、遅延と信頼性が向上しますが、中国大陸へのネットワークパフォーマンスは、中国のファイアウォールによって影響を受ける可能性があります。直接更新を無効にすることで、更新が成功し、ユーザー体験に影響を与えないようにすることができます。

Copy to clipboard directUpdate Caution

完全な構成例

中国で展開されるアプリ用に推奨される設定のある完全な例があります。

import { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  appId: 'com.example.app',
  appName: 'My App',
  webDir: 'dist',
  plugins: {
    CapacitorUpdater: {
      autoUpdate: true,
      directUpdate: false, // Recommended: disable 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;

構成をテストする

__CAPGO_KEEP_0__に新しいバンドルをアップロードする

1. Upload a new bundle to Capgo:

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

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

3. 「構成をテストする」

   npx @capgo/cli@latest app debug

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

注

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

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

アプリが中国内と中国外のユーザーにサービスを提供する場合、中国のドメイン設定を世界中のユーザー全員に使用できます。アリババのDNSインフラによってドメインは世界中で解決されるため、中国内と世界中のどこでもアクセス可能です。 updater.capgo.com.cn マルチリージョンデプロイメント

世界中で中国ドメインを使用する

中国ドメインのURLは、地域を問わずに複数のアプリで平滑に機能します:

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: true,
      directUpdate: false, // 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 )と比較して、中国外のユーザーにとっては若干パフォーマンスが低くなります。ただし、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

Using the .cn すべてのユーザー向けのドメインを使用すると、展開が簡素化され、すべての地域で一貫した更新動作が保証されます。別々のビルドや環境ベースの構成が必要ありません。中国以外の地域での小さなパフォーマンスのトレードオフは、展開が簡素化されることの利点を上回ります。

Alternative: Region-Specific Configurations

各地域を最適化するために異なる方法でしたい場合は、以下のことも検討できます。

• 異なる構成を持つ別々のアプリバリアントをビルドする
• 環境ベースの構成を使用してURLを動的に設定する
• 異なる地域用に異なるリリースチャンネルを作成する

地域間展開戦略についての助言が必要な場合は、以下の連絡先までお問い合わせください。 support@capgo.app または、 Discordコミュニティ ヘルプを求めます。

トラブルシューティング

中国でアップデートに関する問題が発生した場合:

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

注意

Capacitorを使用する .cn ドメイン ( ) と標準の国際ドメインではなく、中国で設定する場合のドメイン。updater.capgo.com.cn次のステップ

「次のステップ」のセクション

• 更新の適用時にカスタマイズするときの動作を確認 探索 チャンネル
• 異なるリリーストラックを管理する レビュー 暗号化
• 中国で設定する場合のドメイン ( ) と標準の国際ドメインとは異なる 中国で設定する場合のドメイン ( ) と標準の国際ドメインとは異なる 更新をセキュアにします