Capgoで中国から続ける

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

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

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

構成

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

1. Open your capacitor.config.ts ファイル

2. Add the following configuration to the 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. Rebuild your app to apply the changes:

   npm run build
   npx cap sync

設定詳細

各URLの役割はこちらです:

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

Tip

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

中国での推奨設定

Due to network performance limitations caused by the Great Firewall of China, we have specific recommendations for apps deployed in mainland China:

バックグラウンド更新を使用する

私たちは __CAPGO_KEEP_0__ 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からアップデートがダウンロードされていることを確認してください。

Note

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

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

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

セクション “中国語ドメインのグローバル使用”

中国のドメイン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',
    },
  },
};

この1つの設定は、以下のユーザーに適用されます:

• 中国本土のユーザー（香港のインフラを使用)
• 中国外のユーザー（Alibaba DNSを使用して同じインフラにアクセス)

パフォーマンスの考慮事項:

While the .cn ドメインはAlibaba DNSを通じて世界中で解決され、どこでも動作しますが、中国外のユーザーにとっては標準ドメイン（api.capgo.app）と比較して、Cloudflareでホストされているバックエンドに直接解決されるため、多少パフォーマンスが低くなります。ただし、DNS解決は高速なので、パフォーマンスの差は微妙で、ユーザー体験に大きな影響を与えません。

ヒント

Using the .cn すべてのユーザー向けのドメインは、デプロイを簡素化し、すべての地域で一貫した更新動作を保証します。中国以外の地域では、パフォーマンスの小さなトレードオフは、デプロイを簡素化することの価値が高いことが多いです。

地域別の設定

各地域で異なる最適化を実現したい場合は、以下のオプションを検討してください。

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

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

トラブルシューティング

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

1. 設定を確認する - URLがすべて正しく設定されていることを確認する capacitor.config.ts
2. ネットワーク接続を確認する - デバイスがドメインに接続できることを確認する updater.capgo.com.cn ログを確認する
3. - エラーメッセージを確認する アップデートをテストする npx @capgo/cli@latest app debug Verify your configuration__CAPGO_KEEP_0__
4. - Double-check that all three URLs are correctly set in your__CAPGO_KEEP_0__ - __CAPGO_KEEP_0__.appに新しいバンドルをアップロードし、ダウンロードプロセスを監視してください
5. サポートに連絡してください - 問題が続きます場合は、 support@capgo.app または中国の設定の際に標準の国際ドメインではなくドメイン( )を使用するように注意してください Discordコミュニティに参加してください

注意

注意 .cn 中国の設定の際は、ドメイン(updater.capgo.com.cn)を使用するように注意してください。

Next Steps

• 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 Using Capgo in China

__CAPGO_KEEP_0__を中国で使用している場合 Capgoを中国で使用 __CAPGO_KEEP_0__を中国で使用している場合の製品ワークフローに接続するには Capgo Live Updates Capgo Live Updatesの製品ワークフローに接続するには 概要 概要の実装詳細 機能 機能の実装詳細 更新動作 更新動作の実装詳細 アップデートの種類 __CAPGO_KEEP_0__の概要