Auto Update

GitHub

このプラグインのインストール手順とフルマークダウンガイドを含むセットアッププロンプトをコピーします。

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

バンドルを配信

e.g. https://myserver.com/app/updates/updates.json

Capgoはよくない場合、Cloudflareまたはここで例を参照してください:

Serving a Bundle

設定

Add an updateUrl をあなたの capacitor.config.json.

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

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は、capacitor-updater プラグインに、JSON形式で、次のデータを返す必要があります。アップデートが必要な場合:

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

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

「message」と「error」キーを追加すると、バージョンは設定されず、ログに表示されるメッセージが表示されます。

version キーは semver フォーマットでなければなりません。

zipファイルは index.html rootディレクトリのファイルとして、またはrootディレクトリにのみ1つのフォルダを含む必要があります。 index.html フォルダ内の

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

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_0__ 使用@capgo/capacitor-updater 使用@capgo/capacitor-updater Capgo Enterprise Capgo Enterprise Ionic Enterprise Plugin Alternatives Ionic Enterprise Plugin Alternatives Capgo Alternatives Capgo Alternatives Capgo Consulting Capgo Consulting