中国でCapgoを使用する

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

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

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

設定

To configure Capgo for China, you need to set three specific URLs in your Capacitor configuration file. These URLs point to Capgo’s Hong Kong-based infrastructure.

1. Open your __CAPGO_KEEP_1__ configuration file. capacitor.config.ts ファイル

2. 「Capgo」に追加する必要がある設定を以下に記載します。 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

設定詳細

各URLの役割は以下のとおりです。

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

Tip

すべてのURLが設定されていれば、中国でCapgoのアップデートャーが完全に機能します。

中国の推奨設定

中国大陸に展開するアプリのために、中国のGreat Firewallのネットワークパフォーマンスの制限により、特定の推奨事項があります。

バックグラウンドアップデートを使用する

We 強くおすすめする autoUpdate: 'atBackground' 中国向けアプリ用

中国では他の地域と比較してネットワーク接続性が低く、ダウンロードが中断されたり遅れたりすると、即時適用モードではユーザー体験が悪くなります。

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
      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 中国語ドメインのURLは、マルチリージョンアプリで平滑に機能します:

コピー

The Chinese domain URLs work seamlessly for multi-region apps:

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

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

• 中国大陸のユーザー（香港ベースのインフラを使用する）
• 中国外のユーザー（同一のインフラをアリババDNSを介してアクセスする）

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

ドメインがアリババ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.

すべてのユーザーにドメインを使用すると、簡素化されたデプロイと、すべての地域で一貫した更新動作が保証されます。中国外のユーザーにとっての小さなパフォーマンスのトレードオフは、簡素化されたデプロイの利点を上回ります。

代替:地域別の設定 .cn Using the

Alternative: Region-Specific Configurations

各地域を最適化するために異なる方法で構成を最適化したい場合は、以下の方法も検討してください。

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

地域間のデプロイ戦略の助けが必要な場合は、以下の連絡先にご連絡ください。 support@capgo.app または、 Discordコミュニティ でサポートを受けてください。

トラブルシューティング

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

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

注意

中国の設定のために、 .cn ドメイン (updater.capgo.com.cn) を使用するようにしてください。標準の国際ドメインを使用しないでください。

次のステップ

• Learn about Update Behavior to customize when updates are applied
• Explore Channels to manage different release tracks
• Review Encryption to secure your updates

Keep going from Capgo in China

If you are using __CAPGO_KEEP_0__ in China 中国でCapgoを使用 __CAPGO_KEEP_0__を中国で使用して、ライブアップデートの配信計画を立てる Capgoライブアップデート Capgoライブアップデートの製品ワークフローで 概要 概要の実装詳細 機能 機能の実装詳細 更新動作 更新動作の実装詳細 更新タイプ 更新タイプの実装詳細