空中(OTA)更新器

此插件为 Tauri app 的 Web 资产提供超空( OTA) 更新 .

它利用 蟹状云 运送资产.

安装

此插件至少需要一个 Rust 版本 1.75 国家

我们可以建议三种一般的安装方法.

1. 使用箱子.io和npm(最轻松,需要你相信我们的出版管道工作)
2. 使用 git 标记/ 修订版散列( 最安全) 从 Github 直接取出源头
3. Git 子模块在您 Tauri 项目中安装此重播, 然后使用文件协议来摄取源( 最安全但使用不便)

安装核心插件,将以下内容添加到您的 Cargo.toml 文件 :

src-tauri/Cargo.toml

[dependencies]
tauri-plugin-ota-updater = "2.0.0-rc"

您可以使用您的首选 JavaScript 软件包管理器安装 JavaScript Guest 绑定 :

pnpm add @crabnebula/plugin-ota-updater
# or
npm add @crabnebula/plugin-ota-updater
# or
yarn add @crabnebula/plugin-ota-updater

配置

您需要签名密钥来签名更新捆绑 。 这将确保您代码的完整性在运行时被检查 . 要生成新的签名密钥运行 generate-keypair 命令 :

npx @crabnebula/ota-updater generate-keypair

安全存储私钥,不要与任何人分享. 以后将要求它分发最新情况.

插件必须配置签名的公钥和 CrabNebula Cloud org/app swit对 :

{
    "plugins": {
        "ota-updater": {
            "orgSlug": "my-org",
            "appSlug": "my-app",
            "pubkey": "<insert-public-key-here>"
        }
    }
}

要能够使用应用程序前端的更新器,您需要启用您能力中的插件默认权限(例如). capabilities/default.json:

{
...
  "permissions": [
    "ota-updater:default"
  ]
...
}

发布更新

要分发更新, 建立您的前端资产, 然后运行 upload 命令 提供私有密钥和一个 Crabnebula Cloud API 密钥作为环境变量:

export PRIVATE_KEY=<insert-private-key-here>
export CN_API_KEY=<insert api-key-here>
npx @crabnebula/ota-updater upload

使用量

首先您需要用 Tauri 注册核心插件 :

src-tauri/src/main.rs

fn main() {
    let context = tauri::generate_context!();

    let (ota_plugin, context) = tauri_plugin_ota_updater::init(context);

    tauri::Builder::default()
        .plugin(ota_plugin)
        .run(context)
        .expect("error while running tauri application");
}

之后所有插件的API都可以通过JavaScript来宾绑定:

import { check } from "@crabnebula/plugin-ota-updater";
const update = await check()
if (update) {
    await update.apply()
    location.reload()
}

许可证

代码: (c) 2023 - 目前 - CrabNebula Ltd.

PolyForm-非商业-1.0.0 (英语)