中国でのCapgoの使用

中国のユーザーにアプリをデプロイする場合、信頼性の高い高速な更新を確保するために、地域のOST（Object Storage Technology）URLを使用するようにCapgoを設定する必要があります。

なぜ中国固有のURLを使用するのか？

中国のネットワークインフラストラクチャと規制（グレートファイアウォール）により、国際サーバーへの直接接続は遅いか信頼性に欠ける可能性があります。Capgoは、レイテンシを最小限に抑え、ユーザーができるだけ迅速かつ確実に更新を受け取れるように、香港にデータがある専用のOST URLを提供しています。

設定

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

capacitor.config.tsファイルを開く

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;

変更を適用するためにアプリを再ビルド:
Terminal window
```
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 - チャンネル設定を取得し、適用する更新を決定するために使用

中国での推奨設定

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

ダイレクトアップデートを無効化

中国のアプリではdirectUpdateを無効にすることを強くお勧めします。中国のネットワーク接続は他の地域よりもパフォーマンスが低く、ダイレクトアップデート（即座に適用される）はダウンロードが中断されたり遅い場合、ユーザーエクスペリエンスが悪化する可能性があります。

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

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: true,
      directUpdate: false, // 中国での推奨
      updateUrl: 'https://updater.capgo.com.cn/updates',
      statsUrl: 'https://updater.capgo.com.cn/stats',
      channelUrl: 'https://updater.capgo.com.cn/channel_self',
    },
  },
};

完全な設定例

中国にデプロイされたアプリの推奨設定を含む完全な例:

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

const config: CapacitorConfig = {
  appId: 'com.example.app',
  appName: 'My App',
  webDir: 'dist',
  plugins: {
    CapacitorUpdater: {
      autoUpdate: true,
      directUpdate: false, // 推奨: 中国でのより良い信頼性のために無効化
      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を設定した後、更新が正しく機能していることを確認できます:

Capgoに新しいバンドルをアップロード:
Terminal window
```
npx @capgo/cli@latest bundle upload --channel=production
```
中国のテストデバイスにアプリをインストール
更新プロセスを監視:
Terminal window
```
npx @capgo/cli@latest app debug
```
更新が中国のOST URLからダウンロードされていることを確認

複数地域へのデプロイ

アプリが中国内外の両方のユーザーにサービスを提供する場合、すべてのユーザーに対してグローバルに中国ドメイン設定を使用できます。updater.capgo.com.cnドメインは、Alibaba DNSインフラストラクチャのおかげでグローバルに解決され、中国内および世界中のどこからでもアクセスできます。

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

中国ドメインURLは複数地域アプリでシームレスに動作します:

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: true,
      directUpdate: false, // 中国ユーザーに推奨
      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解決は高速なので、パフォーマンスの違いは最小限で、ユーザーエクスペリエンスに大きな影響を与えません。

代替: 地域固有の設定

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

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

複数地域デプロイメント戦略についてサポートが必要な場合は、support@capgo.appまでご連絡いただくか、Discordコミュニティにご参加ください。

トラブルシューティング

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

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

次のステップ

更新が適用されるタイミングをカスタマイズするにはUpdate Behaviorを学ぶ
異なるリリーストラックを管理するにはChannelsを探索
更新を保護するにはEncryptionを確認