中国でCapgoを使用

このプラグインのインストール手順と全マークダウンガイドを含む設定促しをコピーする。

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

なぜ中国固有のURLを使用する必要がありますか?

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

設定

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

ファイルを開きます 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の機能を説明します:

- アプリの更新をチェックし、ダウンロードするURL

ここでは、各URLの機能を説明します:: https://updater.capgo.com.cn/updates updateUrl
統計URL: https://updater.capgo.com.cn/stats - Capgo への分析と使用統計を報告するために使用されます。
チャンネルURL: https://updater.capgo.com.cn/channel_self - __CAPGO_KEEP_0__ のアップデートを適用するために使用されるチャンネル設定を取得するために使用されます。

中国の推奨設定

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

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

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

中国大陸では、国境を越えた遅延が一般的です。__CAPGO_KEEP_2__を高く設定すると、プラグインがアップデートチェックとダウンロードを完了するのに十分な余裕を持つことができます。 responseTimeout アップデートチェックとダウンロードを完了するのに十分な余裕を持つために、__CAPGO_KEEP_2__を高く設定します。 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',
    },
  },
};

Use Background Updates

私たちは 強くお勧めします 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',
    },
  },
};

完全な構成例

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

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からアップデートがダウンロードされていることを確認する

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

アプリが中国内外のユーザーにサービスを提供する場合、世界中のユーザーに中国のドメイン設定を使用できます。Alibaba 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.

地域別の構成の代替

異なる構成を使用した別のアプリバリアントをビルドする

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

support@__CAPGO_KEEP_0__.app support@capgo.app __CAPGO_KEEP_0__ Discordコミュニティご助けを求めます。

中国インフラの監視

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

トラブルシューティング

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

設定を確認してください - 正しいURLがすべて3つセットされていることを確認してください capacitor.config.ts
アップデート responseTimeout - 最低でも 60 秒を中国で使用すると、プラグインがアップデート要求がまだ飛行中であるため、失敗しないようにします
ネットワーク接続を確認する - デバイスがドメイン updater.capgo.com.cn を参照できることを確認する
中国のステータスページを確認する - ステータス status.capgo.com.cn ログを確認する
- 使用 __CAPGO_KEEP_0__ npx @capgo/cli@latest app debug エラーメッセージを確認する
テストアップデート - 新しいバンドルをアップロードしてダウンロードプロセスを監視してください
サポートに連絡する ロール: UI ラベルまたはナビゲーションアイテム。見つける場所: コンポーネントプライシング/FAQ.Astro。メッセージキー `contact_support` (サポートに連絡する)。 support@capgo.app support@__CAPGO_KEEP_0__.app または Discord コミュニティに参加して

次のステップ

詳細を学びましょう更新の動作をカスタマイズして、更新が適用されるタイミングを指定します。チャンネルを探索してみましょう
リリースチャンネルを管理して、異なるリリーストラックを操作します。確認してみましょう暗号化
__CAPGO_KEEP_0__ __CAPGO_KEEP_1__ アップデートをセキュリティで保護する

中国でCapgoを使用し続ける

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