一个关于 Tauri 自动更新的 demo

最新推荐文章于 2025-09-18 05:44:39 发布

原创最新推荐文章于 2025-09-18 05:44:39 发布 · 1.5k 阅读

1 ·

CC 4.0 BY-SA版权

文章标签：

#vue.js

一个关于 Tauri 自动更新的 demo

仓库地址–>https://github.com/YWwXxx/tauri-updater-demo
⚠️拉取项目之后需要先在 tauri.conf.json 中配置endpoints和pubkey

创建项目

Tauri + Vue 3

参照官网这里选用 yarn 构建

输入命令yarn create tauri-app

进入目录，随后yarn命令初始化项目
yarn tauri dev启动项目

更新配置

打包配置在src-tauri/tauri.conf.json

设置一个 updater 属性，属性的层级（位于 tauri 字段下）在紫色框内

需要设置active字段为ture，并且由于我们需要用自定义更新，所以将dialog设置为false，其他字段说明在官网

设置更新密钥

输入命令yarn tauri signer generate -w ~/.tauri/myapp.key

需要输入密码（两次）

成功之后有提示密钥位置，并且需要设置环境变量

如果私钥丢失就无法更新程序了 ⚠️

打开文件对应位置，文本编辑打开、复制

将.pub后缀的文件内容复制到pubkey字段（公钥）

设置环境变量TAURI_PRIVATE_KEY是私钥 TAURI_KEY_PASSWORD是刚才设置的密码，保存退出之后记得source一下，或者重启终端或者电脑让环境变量生效（设置方式可能不同，具体型号具体查）

可以用echo $TAURI_KEY_PASSWORD和echo $TAURI_PRIVATE_KEY命令来查看是否生效

（私钥也可以写地址，不用那么长）

设置更新服务器

这里用GitHub Pages，因为endpoints里的 url 都需要是https的。

上传到 GitHub Pages 之后，可以直接通过路径访问到 json 文件，比较方便。

此时向 pages 里面上传一个 json 文件，名字随意，格式如下，必须要有的字段是version、url、signature，其中 version 是 tauri 更新程序用来判断是否需要更新的字段，如果版本低则更新服务器上的高版本。当然也可以用于回退版本，但需要覆盖 Tauri 的版本比较，具体在文档

{
  "version": "0.3.0",
  "pub_date": "2020-09-18T12:29:53+01:00",
  "url": "",
  "signature": "",
  "notes": "!可以更新了！"
}

url字段需要填写下一个版本的文件地址，这里我们可以用阿里云或者七牛云的 oss，或者也可以继续存放在 GitHub Pages 里，当然也可以自己搭建一个文件服务器，等等…只要能有 url 访问即可（这里可以用 http）

然后需要设置endpoints

打包项目

yarn tauri build用于打包项目，打包前记得在 tauri.conf.json 修改版本号

"package": {
    "productName": "tauri-updater-demo", //软件名，可以是中文
    "version": "0.0.0" //版本
  },

并且要修改tauri->bundle->identifier字段，默认的是com.tauri.dev，不修改就打包会报错（只要不是默认值就可以）

然后由于我们希望自定义更新界面【这里使用了 ant-design-vue 需要先根据官网安装配置一下】，所以需要调用一些函数来判断更新，具体代码可以直接拉取仓库查看，主要代码在App.vue、Update.vue、main.js里

正常页面：

有更新的时候：

点击确定之后就自动更新，随后重启

重启的api 配置

先打包一个 0.0.1 版本的，期间会弹一些框不用管。
此外可能可能会遇到各种权限问题…Mac 用sudo -E yarn tauri build（-E 是共享环境变量，否则找不到之前设置的私钥）来打包可能比较省心…

看到 Done 就是成功了，通过输出可以知道安装包位置

可以把打包好的移动到应用程序中，这个是低版本，稍后我们打包另一个高版本来更新

点开确认一下，可以看到版本是 0.0.1

然后我们在tauri.conf.json中修改version字段为0.0.2后再次进行打包

在文件夹中点开确认即可，不要替换了应用程序本来的 0.0.1 版本

然后需要的是tauri-updater-demo.app.tar.gz和tauri-updater-demo.app.tar.gz.sig这两个文件，其中.sig 结尾的文件内容是更新的signature，另一个文件是被 gzip 压缩的程序主体

将tauri-updater-demo.app.tar.gz上传到能够访问的路径，并将 url 写到 json 文件的 url 字段中
把tauri-updater-demo.app.tar.gz.sig文件内容复制到 GitHub Pages 上的 update.json 文件中的signature
其他字段比如pub_date是有格式限制的，但不是必填
notes是更新的信息，可以在检查更新时获取，不是必填
version是必填字段，但是可以自己填写版本