Skip to content

Tauri项目使用官方组件updater接入参考

一、官方组件updater介绍

Tauri官方提供的updater组件支持通过更新服务器或静态JSON文件实现应用程序的自动更新,核心功能包括:

  • 兼容Tauri更新协议的版本检查
  • 跨平台的安装包下载与安装流程
  • 灵活的更新策略配置

核心资源

整体逻辑:通过调用UpgradeLink提供的API获取升级策略,由updater组件执行具体的更新流程,实现与官方更新体系的无缝对接。

二、接入核心步骤

1. 安装官方更新组件

2. 阅读官方动态更新服务器文档,了解接入流程。 文档地址

动态更新服务器

UpgradeLink 提供了 获取更新 api,完全兼容了官方要求的请求参数与返回结构。可以进行无缝的替换。

3. 代码替换

检查更新

上面为官方提供的 检查更新 代码,我们只需要替换 官方提供的 check 方法即可。

 const update = await check({
    timeout: 30000 /* 接口请求时长 */,
    headers: {
      'X-AccessKey': 'mui2W50H1j-OC4xD6PgQag',  // UpgradeLink的AccessKey
    },
});

4.切换配置文件地址:/tauri-demo/src-tauri/tauri.conf.json

Tauri 配置

上面为 官方的 tauri 配置。

endpoints 为 官方提供的 检查更新 接口地址,我们只需要替换 UpgradeLink 提供的接口地址即可。

"bundle": {
    "createUpdaterArtifacts": true,
    ...
    ]
  },
"plugins": {
    "updater": {
      "dangerousInsecureTransportProtocol": true,
      "pubkey": "dW50cnVzdGVkIGNvbW1lbnQ6IG1pbmlzaWduIHB1YmxpYyBrZXk6IDY4QjBGNEM4NjUyMUNGRjAKUldUd3p5Rmx5UFN3YUN1UkFMK05DdWR4VjA1eDRybkxJNzMreURNbHZ4VFhtSk54UTVMWVg4NnAK",
      "endpoints": [
        "http://api.upgrade.toolsetlink.com/v1/tauri/upgrade?tauriKey=a0jtz0HUwL66r7gCGvbMKQ&versionName={{current_version}}&appointVersionName=&devModelKey=&devKey=&target={{target}}&arch={{arch}}"
      ],
      "windows": {
        "installMode": "passive"
      }
    }
}

endpoints 的变更的链接地址,就是拼接下 UpgradeLink 提供的获取升级策略的接口地址 获取更新版本

该文档详细说明了更新协议的请求参数(如targetarch)和响应结构,UpgradeLink完全兼容官方规范,可直接替换使用。

可用来参考的 tauri-demo

5.需要注意权限问题。接入更新一般会使用官方的 updater 更新组件与 官方的 process 重启组件。

{
  "permissions": [
    ...,
    "updater:default",
    "process:default"
  ]
}

以上是接入指南。如果需要调整内容详略或补充特定场景说明,欢迎告知具体需求。