Capgoを中国で使用

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

中国でアプリを展開する場合、地域のOST（Object Storage Technology）URLを使用して、信頼性の高いと迅速なアップデートを確保するために、Capgoを設定する必要があります。

中国用URLの使用の理由

中国のネットワークインフラと規制（Great Firewall）により、直接国際サーバーへの接続が遅いまたは不信頼性の高い可能性があります。Capgoは、香港にデータを置いた専用のOST URLを提供し、ユーザーが迅速かつ信頼性の高いアップデートを受け取ることができるようにします。

設定

中国用に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 の説明はこちらです:

updateUrl: https://updater.capgo.com.cn/updates - アプリケーションの更新をチェックし、ダウンロードするために使用されます。
statsUrl: https://updater.capgo.com.cn/stats - Capgo で分析情報と使用状況の統計を報告するために使用されます。
チャンネルURL: https://updater.capgo.com.cn/channel_self - 中国のチャネル構成を取得し、適用する更新を決定するために使用されます。

中国の推奨設定

中国本土に展開されているアプリのネットワークパフォーマンスの制限により、Great Firewall of China が原因で、以下の推奨事項があります:

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

Capgo アップデータープラグインは、API の呼び出しを中断することがあります。タイムアウトは responseTimeout 秒 (値は秒 Capgo の前にはエッジインフラストラクチャも、約秒 3秒

中国大陸では、国境を越えた遅延がよくある。中国への展開では、 responseTimeout で十分な余裕を持ってアップデートのチェックとダウンロードを実行できるようにするために 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',
    },
  },
};

完全な構成例

中国でのアプリの展開に適した推奨設定の完全な例です。

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

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

アプリが中国内と中国外のユーザーにサービスを提供する場合、中国のドメイン設定を世界中のユーザーに使用できます。アリババ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を介して同じインフラにアクセス)

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

ライブアップデートは .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を動的に設定する
異なるリリースチャンネルを異なる地域で作成する

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

中国インフラの監視

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

トラブルシューティング

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

確認 - URLが正しく設定されていることを確認してください。 capacitor.config.ts
Raise responseTimeout - 最低 60 中国の秒数で、プラグインはアップデート要求がまだ飛行中の場合に中断しないようにします。
ネットワーク接続を確認してください。 - デバイスがドメインにアクセスできることを確認してください。 updater.capgo.com.cn ドメイン
中国のステータスページを確認してください。 - Review status.capgo.com.cn - エラーメッセージを確認するために使用してください。
アップデートをテストしてください - Use npx @capgo/cli@latest app debug Check network connectivity
- Ensure your device can reach the - 中国で新バンドルをアップロードしてダウンロードプロセスを監視してください。
- サポートに連絡してください - 問題が続く場合は、以下のアドレスにご連絡ください。 support@capgo.app または - Discordコミュニティに参加してください - ご注意

次のステップ

学び更新の動作アップデートの適用時期をカスタマイズする
探索チャンネル異なるリリーストラックを管理する
レビュー暗号化アップデートを保護する

中国でCapgoを使用し続ける

あなたは__CAPGO_KEEP_0__を使用しています Capgoを中国で使用 live updateをlive updateの配信計画に接続する Capgo Live Updates Capgo Live Updatesの製品ワークフロー概要概要の実装詳細機能機能の実装詳細更新動作更新動作の実装詳細アップデートの種類アップデートの種類の実装詳細について。

Capacitorアプリを配信コンテキスト: Capgo マーケティングウェブサイト。役割: ショート UI ラベルまたはナビゲーションアイテム。見つける場所: コンポーネント Hero.astro。メッセージキー `hero_title_line1` (Hero Title Line1)。

コンテキスト: Capgo マーケティングウェブサイト。役割: ウェブサイトコピー文句。見つける場所: コンポーネント Hero.astro。メッセージキー `hero_subtitle_v2` (Hero Subtitle V2)。無料で始めましょう