中国でCapgoを使用する

If you’re deploying your app to users in China, you’ll need to configure Capgo to use regional OST (Object Storage Technology) URLs to ensure reliable and fast updates.

中国ユーザー向けのURLを使用する理由

中国のネットワークインフラと規制（Great Firewall）により、直接的な国際サーバーへの接続が遅いまたは不確実になることがあります。 Capgo は、データが香港にあり、低遅延と迅速かつ信頼性の高い更新をユーザーに提供できるように、香港に拠点を置いた __CAPGO_KEEP_2__ の専用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: 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の役割は次のとおりです:

• __CAPGO_KEEP_0__: https://updater.capgo.com.cn/updates - アプリの更新が利用可能かどうかを確認し、ダウンロードするために使用されます。
• - アプリの分析と使用状況の統計を __CAPGO_KEEP_0__ に送信するために使用されます。: https://updater.capgo.com.cn/stats - Used to report analytics and usage statistics back to Capgo
• channelUrl: https://updater.capgo.com.cn/channel_self - __CAPGO_KEEP_0__ からチャンネル設定を取得し、適用する更新を決定するために使用されます。

Tip

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

中国の推奨設定

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

直接アップデートの無効

私たちは 中国のアプリでは直接アップデートを強く推奨しません。中国では他の地域と比較してネットワーク接続性が低く、ダウンロードが中断されたり遅れたりすると、ユーザー体験が悪くなります。 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',
    },
  },
};

注意

香港に拠点を置くインフラストラクチャは、遅延を最小限に抑え、信頼性を向上させるのに役立ちますが、中国本土へのネットワークパフォーマンスは、Great Firewallの影響を受ける可能性があります。無効にする directUpdate 中国本土へのネットワークパフォーマンスを最適化するために、Great Firewallの影響を受ける可能性があるため、中国本土へのネットワークパフォーマンスを最適化するために、

中国に展開するアプリ向けの推奨設定を含む、完全な設定例

中国に展開するアプリ向けの推奨設定を含む、完全な設定例があります。

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;

設定をテストする

中国に展開するアプリ向けの設定を適用した後、更新が正しく動作していることを確認できます。

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

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

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

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

   npx @capgo/cli@latest app debug

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

注

Capgoの標準設定と同様の更新動作とタイミングが維持されます。詳細は 更新動作 __CAPGO_KEEP_0__

マルチリージョン展開

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

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

コピー

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を使用してグローバルにドメインを解決し、中国以外のユーザーでも正常に動作するが、標準ドメイン（__CAPGO_KEEP_0__）と比較して中国外のユーザー向けのパフォーマンスはやや低くなります。ただし、DNS解決は高速なので、パフォーマンスの差は微妙でユーザー体験に大きな影響はありません。 .cn Tipapi.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.

Alternative: Region-Specific Configurations

「Alternative: Region-Specific Configurations」のセクション .cn 各地域を最適化する方法が異なる場合は、以下のオプションを検討することもできます。

異なる構成で別々のアプリバリアントをビルドする

Tip

• Building separate app variants with different configurations
• 環境ベースの構成を使用して、URLを動的に設定
• 地域ごとに異なるリリースチャンネルを作成

複数の地域に展開するための戦略についての助言が必要な場合は、 support@capgo.app または、 Discordコミュニティ に参加して、

トラブルシューティング

中国で更新に関する問題が発生した場合:

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

注意

中国の設定用に、ドメイン「__CAPGO_KEEP_0__」と「__CAPGO_KEEP_1__」を使用するようにしてください。 .cn Next Stepsupdater.capgo.com.cn「Next Steps」セクション

詳細を学ぶ

• 更新が適用される際にカスタマイズする __CAPGO_KEEP_0__ __CAPGO_KEEP_1__
• 機能を探索する チャンネル __CAPGO_KEEP_0__ diffirent リリース トラッキングを管理する
• レビュー 暗号化 __CAPGO_KEEP_0__ アップデートをセキュリティーする