中国でCapgoを使用する

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

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

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

設定

中国を対象にしたCapgoの設定を行うには、Capacitorの設定ファイルに3つの特定のURLを設定する必要があります。これらのURLはCapgoの香港に拠点を置くインフラストラクチャを指します。

1. ファイルを開きます capacitor.config.ts ファイル

2. 以下の設定をプラグインセクションに追加してください: 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の機能を説明します:

- アプリの更新をチェックし、ダウンロードするために使用されます。

• 再構築してください: https://updater.capgo.com.cn/updates コピーする
• 統計URL: https://updater.capgo.com.cn/stats - Capgo への分析と使用状況統計を報告するために使用されます。
• チャンネルURL: https://updater.capgo.com.cn/channel_self - __CAPGO_KEEP_0__ のチャンネル設定を取得し、適用する更新を決定するために使用されます。

ヒント

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

中国の推奨設定

__CAPGO_KEEP_0__ の応答タイムアウトを増やす

Increase API Response Timeout

CapgoのCapgoアップデートプラグインは、API呼び出しを中断します。 responseTimeout __CAPGO_KEEP_0__の値が__CAPGO_KEEP_2__秒を超えると 秒Cloudflareのエッジインフラストラクチャの前にCapgoも、約 秒 を失敗の予算として扱うパスもあります。

中国大陸では、境界を越える遅延が一般的です。__CAPGO_KEEP_3__を高く設定すると、プラグインがアップデートチェックとダウンロードを完了するのに十分な余裕を持つことができます。 responseTimeout アップデートチェックとダウンロードを完了するのに十分な余裕を持つために、__CAPGO_KEEP_4__を使用します。 updater.capgo.com.cn コピー

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: 'atBackground',
      // Seconds. Raise above the default (20) for China network conditions.
      responseTimeout: 60,
      updateUrl: 'https://updater.capgo.com.cn/updates',
      statsUrl: 'https://updater.capgo.com.cn/stats',
      channelUrl: 'https://updater.capgo.com.cn/channel_self',
    },
  },
};

__CAPGO_KEEP_5__

Prefer responseTimeout: 60 (or higher) for China deployments. A low timeout does not make updates faster — it only causes the plugin to give up while the request may still succeed on Capgo’s side.

Use Background Updates

We strongly recommend using autoUpdate: 'atBackground' for apps in China. Network connectivity in China is less performant than in other regions, and instant apply modes can lead to a poor user experience if downloads are interrupted or slow.

Instead, use the default update behavior where updates download in the background and apply when the app backgrounds or restarts. This provides a more reliable experience for your users.

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

Caution

While our Hong Kong-based infrastructure helps minimize latency and improve reliability, network performance to mainland China can still be affected by the Great Firewall. Using background updates helps ensure updates complete successfully without disrupting the user experience.

完全な構成例

中国で展開されているアプリ向けに推奨される設定が含まれた完全な例です。

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
      responseTimeout: 60, // Seconds — give China network more room
      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設定と同じようにアップデートの動作とタイミングは変わりません。詳細については、 アップデートの動作 ドキュメントを参照してください。

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

中国のドメイン設定を、世界中のユーザーに使用することができます。アリババ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',
    },
  },
};

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

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

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

ドメインは、Alibaba 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 代替:地域別の構成

地域別の構成の代替

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

• 環境ベースの構成を使用して、URLを動的に設定する
• 異なるリリースチャンネルを異なる地域ごとに作成する
• 複数の地域を対象とする展開戦略についての助言が必要な場合は、以下の連絡先にご連絡ください。

support@__CAPGO_KEEP_0__.app support@capgo.app または、 Discordコミュニティ ご助けを求めるには。

中国インフラの監視

Capgoの中国固有のエンドポイントの健康とステータスを監視できます。 status.capgo.com.cn。中国OST URLの遅延、ダウンタイム、インシデントを確認するには、このページを使用してください。

トラブルシューティング

「トラブルシューティング」のセクション

1. 中国でのアップデートの問題が発生した場合: 設定を確認すること。- URLがすべて正しく設定されていることを確認すること。 capacitor.config.ts
2. 中国でアップデートを実行する際に responseTimeout - 中国でアップデートを実行するには少なくとも 60 秒を使用してください。中国では、更新要求がまだ飛行中であるため、プラグインが中断しないようにします。
3. ネットワーク接続を確認する - updater.capgo.com.cn 確認する
4. ドメイン 中国のステータスページを確認する status.capgo.com.cn ステータス
5. で、進行中のインシデントやパフォーマンスの低下を確認する ログを確認する npx @capgo/cli@latest app debug エラー メッセージを確認する
6. テスト アップデート - 新しいバンドルをアップロードしてダウンロード プロセスを監視してみましょう
7. サポートに連絡する コンテキスト: Capgo マーケティング ウェブサイト。役割: ショート UI ラベルまたはナビゲーション アイテム。見つける場所: コンポーネント プライシング/FAQ.Astro。メッセージ キー `contact_support` (サポートに連絡する)。 support@capgo.app support@__CAPGO_KEEP_0__.app または Discord コミュニティに参加して

注意

注意すること .cn ドメイン（updater.capgo.com.cn")と標準の国際ドメインではなく、中国の設定で使用するドメインです。

次のステップ

• 次のステップ 学びましょう アップデートの動作
• アップデートの適用時にカスタマイズする 探索 チャンネル
• Capgoリリースチャンネルの機能名 Capgoソリューションズマーケティングページ アップデートをセキュリティで保護する

中国でCapgoを使用し続ける

中国で__CAPGO_KEEP_0__を使用している場合 中国でCapgoを使用する ライブアップデートの配信計画を立てるには、__CAPGO_KEEP_0__を接続する Capgoライブアップデート Capgoライブアップデートの製品ワークフローに 概要 概要の実装詳細 機能 機能の実装詳細 アップデート動作 アップデート動作の実装詳細については アップデートの種類 アップデートの種類の実装詳細については