中国でCapgoを使用

コピー用意

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

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

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

設定

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

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

中国のライブアップデート設定を追加するには、以下の設定を 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;

アプリケーションに変更を適用するには、再構築してください:
ターミナルウィンドウ
```
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__のチャンネル設定を取得し、適用する更新を決定するために使用されます。

中国の推奨設定

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

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

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

秒 responseTimeout は、中国大陸では、国境を越えた遅延がよくある。 __CAPGO_KEEP_0__ のアップデートチェックとダウンロードを完了させるのに十分な余裕を持たせるために、 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',
    },
  },
};

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

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

__CAPGO_KEEP_0__

中国で展開されるアプリ向けに推奨される設定の完全な例があります:

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を設定した後、更新が正しく動作していることを確認できます:

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

マルチリージョン展開

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

中国ドメインを世界中で使用する

中国ドメインの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.

中国地域の設定

「別の地域に合わせた設定」

各地域を最適化したい場合は、以下の方法を検討してください。
アプリのバリアントを別々にビルドし、異なる設定を使用する
環境に基づいてURLを動的に設定する

各地域に異なるリリースチャンネルを作成する support@capgo.app support@__CAPGO_KEEP_0__.app または、ご利用のために。

中国インフラの監視

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

トラブルシューティング

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

設定を確認してください URLが正しく設定されていることを確認してください capacitor.config.ts
問題が解決しない場合は、サポートに連絡してください responseTimeout - 最低 60 中国で秒以上の時間を使用すると、プラグインはアップデートリクエストがまだ飛行中であるため、途中で中断されないようにします。
ネットワーク接続を確認してください。 - デバイスがドメインにアクセスできることを確認してください。 updater.capgo.com.cn ドメイン
中国のステータスページを確認してください。 - ステータスを確認してください。 status.capgo.com.cn 進行中のインシデントやパフォーマンスの低下を確認するために、ステータスページを確認してください。
ログを確認してください。 - エラーメッセージを確認するために、を使用してください。 npx @capgo/cli@latest app debug ログ
テストアップデート - 新しいバンドルをアップロードしてダウンロードプロセスを監視してください
サポートに連絡する コンテキスト: Capgo マーケティングウェブサイト。役割: 短い UI ラベルまたはナビゲーションアイテム。見つける場所: コンポーネント価格/Faq.astro。メッセージキー `contact_support` (サポートに連絡する)。 support@capgo.app support@__CAPGO_KEEP_0__.app または Discord コミュニティに参加して

次のステップ

詳細を学びましょう更新の動作更新の適用時をカスタマイズするには
詳細を調べるチャンネル異なるリリースのトラックを管理するには
確認する暗号化更新を保護するには

中国でCapgoを継続して使用する

中国で__CAPGO_KEEP_0__を使用している場合 中国でCapgoを使用する ライブアップデートの配信計画に使用する場合、__CAPGO_KEEP_0__ Live Updatesと接続する Capgo Live Updates 中国でCapgo Live Updatesと連携する製品ワークフローについて概要 __CAPGO_KEEP_0__ Live Updatesの実装詳細について機能 __CAPGO_KEEP_0__ Live Updatesの実装詳細について更新動作アップデートの実装詳細については、Update Behaviorのページを参照してください。アップデートの種類アップデートの実装詳細については、Update Typesのページを参照してください。