コンテンツにスキップ
Capgo - Capacitor アプリ向けライブ更新 Capgo

Auto Update

GitHub

インストール、同期、ソースマークダウンガイドを含みます。

このドキュメントでは、自動更新サーバーを実行する方法を説明します。

バンドルを配信

「バンドルを配信する」セクション https://myserver.com/app/updates/updates.json

If you’re unfamiliar with serving a bundle, we recommend you try Capgo Cloud or see an example here:

バンドルを配信する方法がわかりませんか? __CAPGO_KEEP_0__ Cloudを試してみたり、ここに示す例を参照してください:「

設定

セクション「設定」

に追加する updateUrl あなたの capacitor.config.json.

{
  "plugins": {
    "CapacitorUpdater": {
      "updateUrl": "https://myserver.com/app/updates/updates.json",
    }
  }
}

セクション「APIをアップデート」

プラグインは、各アプリ起動時にあなたのAPIにPOST呼び出しを行い、次の本体を送信します:

API

interface AppInfos {
    "platform": "ios" | "android" | "electron",
    "device_id": "UUID_of_device_unique_by_install",
    "app_id": "APPID_FROM_CAPACITOR_CONFIG",
    "custom_id": "your_custom_id_set_on_runtime",
    "plugin_version": "PLUGIN_VERSION",
    "version_build": "VERSION_NUMBER_FROM_NATIVE_CODE",
    "version_code": "VERSION_CODE_FROM_NATIVE_CODE",
    "version_name": "LAST_DOWNLOADER_VERSION" | "builtin"
    "version_os": "VERSION_OF_SYSTEM_OS",
    "is_emulator": boolean,
    "is_prod": boolean,
}

APIサーバーは、JSON形式でcapacitorアップデート プラグインに応答する必要があります。このデータを使用すると、更新が必要な場合に:

{
"version": "1.2.3",
"url": "https://myserver.com/app/updates/my-new-app-2.0.0.zip",
"checksum": "sha256_checksum_of_bundle"
}

オートアップデートモードでは、サーバーはバージョンを比較し、正しいバージョンを返す必要があります。URLキーが存在する場合、プラグインはダウンロードプロセスを開始します。

__CAPGO_KEEP_0__の場合、バージョンが設定されず、メッセージがログに表示されます。

version __CAPGO_KEEP_1__の場合、キーは semver フォーマット。

__CAPGO_KEEP_0__の場合、zipファイルは index.html rootディレクトリのファイルとして、またはrootディレクトリに index.html rootディレクトリ内の

You can use the command of the CLI to zip your bundle:

__CAPGO_KEEP_0__を使用して、zipファイルを作成できます:「__CAPGO_KEEP_0__」コマンドを使用して、zipファイルを作成します。
npx @capgo/cli bundle zip --path [/path/to/my/bundle]

バンドルチェックサムの生成

バンドルチェックサムの生成

重要: バンドル zip ファイルを作成するには、Capgo CLI を使用する必要があります。 Capgo プラグインには、公式の CLI ツールを使用することでのみ保証される特定の zip 形式と構造が必要です。標準の zip ユーティリティでは、互換性のないアーカイブが作成される可能性があります。

バンドルチェックサムを生成するには、Capgo CLI zip コマンドを使用します。 --json フラグ:

チェックサム情報を含むバンドルを作成
npx @capgo/cli bundle zip [appId] --json

このコマンドは次のことを行います。

  • Capgo プラグインに互換性のある形式で zip ファイルを作成
  • SHA256 チェックサムを生成して、整合性の確認を行います
  • JSON形式で出力バンドル情報を表示

例：

{
  "version": "1.2.3",
  "checksum": "a1b2c3d4e5f6789...",
  "size": 1234567
}

__CAPGO_KEEP_0__の出力からこの値を使用して、プラグインがインストール前に出力バンドルの一貫性を検証できるようにします。 checksum value from this output in your API response to ensure the plugin can verify the bundle integrity before installation.

Auto Updateを使用して、企業向けオペレーションとマイグレーションの計画に従って、Auto Updateを__CAPGO_KEEP_0__と__CAPGO_KEEP_1__-updaterと接続します。

Auto Updateを使用している場合、Auto Updateを__CAPGO_KEEP_0__と__CAPGO_KEEP_1__-updaterと接続してください。

Auto Updateを使用して企業向けオペレーションとマイグレーションの計画に従ってください。 Auto Updateを使用して企業向けオペレーションとマイグレーションの計画に従ってください。 Auto Updateを使用して企業向けオペレーションとマイグレーションの計画に従ってください。 Using @capgo/capacitor-updater for the native capability in Using @capgo/capacitor-updater, Capgo Enterprise Capgo Enterpriseの製品ワークフロー Ionic Enterprise Plugin Alternatives Ionic Enterprise Plugin Alternativesの製品ワークフロー Capgo Alternatives Capgo Alternativesの製品ワークフロー、そして Capgo Consulting Capgo Consultingの製品ワークフロー