这篇文章会有一点啰嗦,我希望想把解决问题的一些思路展现出来,给遇到问题无从下手的朋友带来一些启发。
签名
tauri 通过签名来保证安全更新应用。 签名更新应用需要做两件事:
私钥 (privkey) 用于签署应用的更新,必须严密保存。此外,如果丢失了此密钥,将无法向当前用户群发布新的更新,将其保存在安全的地方至关重要。
在 tauri.conf.json 中添加公钥 (pubkey),以在安装前验证更新存档。
生成签名
使用 tauri cli 提供的命令可以生成密钥(.pub 后缀的文件为公钥):
tauri signer generate -w ~/.tauri/omb.key $ tauri signer generate -w /users/lencx/.tauri/omb.keygenerating new private key without password.please enter a password to protect the secret key.password: password (one more time): deriving a key from the password in order to encrypt the secret key... doneyour keypair was generated successfullyprivate: /users/lencx/.tauri/omb.key (keep it secret!)public: /users/lencx/.tauri/omb.key.pub---------------------------environment variabled used to sign:`tauri_private_key` path or string of your private key`tauri_key_password` your private key password (optional)attention: if you lose your private key or password, you'll not be able to sign your update package and updates will not works.--------------------------- done in 39.09s.
注意:如果丢失了私钥或密码,将无法签署更新包并且更新将无法正常工作(请妥善保管)。
tauri.conf.json 配置
{ updater: { active: true, dialog: true, endpoints: [https://releases.myapp.com/{{target}}/{{current_version}}], pubkey: your_updater_pubkey },}
active - 布尔值,是否启用,默认值为 false
dialog - 布尔值,是否启用内置新版本提示框,如果不启用,则需要在 js 中自行监听事件并进行提醒
endpoints - 数组,通过地址列表来确定服务器端是否有可用更新,字符串 {{target}} 和 {{current_version}} 会在 url 中自动替换。如果指定了多个地址,服务器在预期时间内未响应,更新程序将依次尝试。endpoints 支持两种格式:
动态接口[1] - 服务器根据客户端的更新请求确定是否需要更新。 如果需要更新,服务器应以状态代码 200 ok 进行响应,并在正文中包含更新 json。 如果不需要更新,服务器必须响应状态代码 204 no content。
静态文件[2] - 备用更新技术使用纯 json 文件,将更新元数据存储在 gist[3],github-pages[4] 或其他静态文件存储中。
pubkey - 签名的公钥
实现步骤
拆解问题
要实现自动升级应用主要分为以下几个步骤:
生成签名(公私钥):
私钥用于设置打包(tauri build)的环境变量
公钥用于配置 tauri.conf.json -> updater.pubkey
向客户端推送包含签名及下载链接的更新请求,有两种形式:
动态接口返回 json 数据
静态资源返回 json 文件
将 2 中的更新请求地址配置在 tauri.conf.json -> updater.endpoints
通过将 tauri.conf.json -> updater.dialog 配置为 true,启用内置通知更新应用的弹窗。设置为 false 则需要自行通过 js 事件来处理(暂不推荐,喜欢折腾的朋友可以自行尝试)
因为应用的跨平台打包借助了 github action 的工作流来实现,具体可以参考【tauri 入门篇 - 跨平台编译】[5],所以更新也同样使用 github action 来实现,充分发挥 github 的能力(简单来说,就是不需要借助其他第三方平台或服务就可以实现整个应用的自动化发布更新)。
梳理流程
在本地生成公私钥
加签名构建跨平台应用(通过 github action 设置签名环境变量)
对构建出的安装包解析,生成静态资源文件(通过脚本实现安装包信息获取)
推送更新请求采用静态资源的方式(可以将 json 文件存储在 github pages)
将 github pages 的资源地址配置到 tauri.conf.json -> updater.endpoints
代码实现
step1
生成公私钥
tauri signer generate -w ~/.tauri/omb.key
配置公钥 pubkey(~/.tauri/omb.key.pub)及资源地址 endpoints(github pages 地址):
{ package: { productname: ohmybox, version: ../package.json }, tauri: { updater: { active: true, dialog: true, endpoints: [https://lencx.github.io/ohmybox/install.json], pubkey: dw50cnvzdgvkignvbw1lbnq6ig1pbmlzawduihb1ymxpyybrzxk6ieu5meiwreezndlbnzddn0mkuldsogzlzepvdzbmnmfoz2cyy2npetdwk2hsv3gwcwxozhduwxrzwfbpqth1dwhqwxhbdkl0cw8k } }}
step2
在项目根路径下创建 scripts 目录,然后在 scripts 下依次创建 release.mjs,updatelog.mjs,updater.mjs 三个 .mjs[6] 文件:
scripts/release.mjs - 版本发布,因发布需涉及多处改动(如版本,版本日志,打 tag 标签等等),故将其写成脚本,减少记忆成本
scripts/updatelog.mjs - 版本更新日志处理,供 scripts/updater.mjs 脚本使用
scripts/updater.mjs - 生成应用更新需要的静态文件
# 安装开发依赖yarn add -d node-fetch @actions/github// scripts/release.mjsimport { createrequire } from 'module';import { execsync } from 'child_process';import fs from 'fs';import updatelog from './updatelog.mjs';const require = createrequire(import.meta.url);async function release() { const flag = process.argv[2] 'patch'; const packagejson = require('../package.json'); let [a, b, c] = packagejson.version.split('.').map(number); if (flag === 'major') { // 主版本 a += 1; b = 0; c = 0; } else if (flag === 'minor') { // 次版本 b += 1; c = 0; } else if (flag === 'patch') { // 补丁版本 c += 1; } else { console.log(`invalid flag ${flag}`); process.exit(1); } const nextversion = `${a}.${b}.${c}`; packagejson.version = nextversion; const nexttag = `v${nextversion}`; await updatelog(nexttag, 'release'); // 将新版本写入 package.json 文件 fs.writefilesync('./package.json', json.stringify(packagejson, null, 2)); // 提交修改的文件,打 tag 标签(tag 标签是为了触发 github action 工作流)并推送到远程 execsync('git add ./package.json ./update_log.md'); execsync(`git commit -m v${nextversion}`); execsync(`git tag -a v${nextversion} -m v${nextversion}`); execsync(`git push`); execsync(`git push origin v${nextversion}`); console.log(`publish successfully...`);}release().catch(console.error);// scripts/updatelog.mjsimport fs from 'fs';import path from 'path';const update_log = 'update_log.md';export default function updatelog(tag, type = 'updater') { const retag = /## v[d.]+/; const file = path.join(process.cwd(), update_log); if (!fs.existssync(file)) { console.log('could not found update_log.md'); process.exit(1); } let _tag; const tagmap = {}; const content = fs.readfilesync(file, { encoding: 'utf8' }).split(''); content.foreach((line, index) => { if (retag.test(line)) { _tag = line.slice(3).trim(); if (!tagmap[_tag]) { tagmap[_tag] = []; return; } } if (_tag) { tagmap[_tag].push(line); } if (retag.test(content[index + 1])) { _tag = null; } }); if (!tagmap?.[tag]) { console.log( `${type === 'release' ? '[update_log.md] ' : ''}tag ${tag} does not exist` ); process.exit(1); } return tagmap[tag].join('').trim() || '';}// scripts/updater.mjsimport fetch from 'node-fetch';import { getoctokit, context } from '@actions/github';import fs from 'fs';import updatelog from './updatelog.mjs';const token = process.env.github_token;async function updater() { if (!token) { console.log('github_token is required'); process.exit(1); } // 用户名,仓库名 const options = { owner: context.repo.owner, repo: context.repo.repo }; const github = getoctokit(token); // 获取 tag const { data: tags } = await github.rest.repos.listtags({ ...options, per_page: 10, page: 1, }); // 过滤包含 `v` 版本信息的 tag const tag = tags.find((t) => t.name.startswith('v')); // console.log(`${json.stringify(tag, null, 2)}`); if (!tag) return; // 获取此 tag 的详细信息 const { data: latestrelease } = await github.rest.repos.getreleasebytag({ ...options, tag: tag.name, }); // 需要生成的静态 json 文件数据,根据自己的需要进行调整 const updatedata = { version: tag.name, // 使用 update_log.md,如果不需要版本更新日志,则将此字段置空 notes: updatelog(tag.name), pub_date: new date().toisostring(), platforms: { win64: { signature: '', url: '' }, // compatible with older formats linux: { signature: '', url: '' }, // compatible with older formats darwin: { signature: '', url: '' }, // compatible with older formats 'darwin-aarch64': { signature: '', url: '' }, 'darwin-x86_64': { signature: '', url: '' }, 'linux-x86_64': { signature: '', url: '' }, 'windows-x86_64': { signature: '', url: '' }, // 'windows-i686': { signature: '', url: '' }, // no supported }, }; const setasset = async (asset, reg, platforms) => { let sig = ''; if (/.sig$/.test(asset.name)) { sig = await getsignature(asset.browser_download_url); } platforms.foreach((platform) => { if (reg.test(asset.name)) { // 设置平台签名,检测应用更新需要验证签名 if (sig) { updatedata.platforms[platform].signature = sig; return; } // 设置下载链接 updatedata.platforms[platform].url = asset.browser_download_url; } }); }; const promises = latestrelease.assets.map(async (asset) => { // windows await setasset(asset, /.msi.zip/, ['win64', 'windows-x86_64']); // darwin await setasset(asset, /.app.tar.gz/, [ 'darwin', 'darwin-x86_64', 'darwin-aarch64', ]); // linux await setasset(asset, /.appimage.tar.gz/, ['linux', 'linux-x86_64']); }); await promise.allsettled(promises); if (!fs.existssync('updater')) { fs.mkdirsync('updater'); } // 将数据写入文件 fs.writefilesync( './updater/install.json', json.stringify(updatedata, null, 2) ); console.log('generate updater/install.json');}updater().catch(console.error);// 获取签名内容async function getsignature(url) { try { const response = await fetch(url, { method: 'get', headers: { 'content-type': 'application/octet-stream' }, }); return response.text(); } catch (_) { return ''; }}
在根路径下创建 update_log.md 文件,通知用户更新注意事项,格式如下(使用版本号作为标题,具体请查看 scripts/updatelog.mjs):
# updater log## v0.1.7- feat: xxx- fix: xxx## v0.1.6test
修改 package.json,在 scripts 中加入 updater 和 release 命令:
scripts: { dev: vite --port=4096, build: rsw build && tsc && vite build, preview: vite preview, tauri: tauri, rsw: rsw, updater: node scripts/updater.mjs, // 新增 release: node scripts/release.mjs // 新增 },
step3
action 配置请参考之前的文章【tauri 入门篇 - 跨平台编译】,此处新增环境设置签名和静态资源推送。
设置 secret
配置变量 repo -> settings -> secrets -> actions -> new repository secret:
tauri_private_key - 私钥,value 为 ~/.tauri/omb.key.pub 内容
name: tauri_private_key
value: ******
tauri_key_password - 密码,value 为生成签名时的密码
name: tauri_key_password
value: ******
设置 .github/workflows/release.yml
name: release cion: push: # sequence of patterns matched against refs/tags tags: - 'v*' # push events to matching v*, i.e. v1.0, v20.15.10jobs: create-release: runs-on: ubuntu-latest outputs: release_upload_id: ${{ steps.create_release.outputs.id }} steps: - uses: actions/checkout@v2 - name: query version number id: get_version shell: bash run: | echo using version tag ${github_ref:10} echo ::set-output name=version::${github_ref:10} - name: create release id: create_release uses: actions/create-release@v1 env: github_token: ${{ secrets.github_token }} with: tag_name: '${{ steps.get_version.outputs.version }}' release_name: 'ohmybox ${{ steps.get_version.outputs.version }}' body: 'see the assets to download this version and install.' build-tauri: needs: create-release strategy: fail-fast: false matrix: platform: [macos-latest, ubuntu-latest, windows-latest] runs-on: ${{ matrix.platform }} steps: - uses: actions/checkout@v2 - name: setup node uses: actions/setup-node@v1 with: node-version: 16 - name: install rust stable uses: actions-rs/toolchain@v1 with: toolchain: stable # rust cache - uses: swatinem/rust-cache@v1 - name: install dependencies (ubuntu only) if: matrix.platform == 'ubuntu-latest' run: | sudo apt-get update sudo apt-get install -y libgtk-3-dev webkit2gtk-4.0 libappindicator3-dev librsvg2-dev patchelf # install wasm-pack - uses: jetli/wasm-pack-action@v0.3.0 with: # optional version of wasm-pack to install(eg. 'v0.9.1', 'latest') version: v0.9.1 - name: install rsw run: cargo install rsw - name: get yarn cache directory path id: yarn-cache-dir-path run: echo ::set-output name=dir::$(yarn config get cachefolder) - name: yarn cache uses: actions/cache@v2 id: yarn-cache # use this to check for `cache-hit` (`steps.yarn-cache.outputs.cache-hit != 'true'`) with: path: ${{ steps.yarn-cache-dir-path.outputs.dir }} key: ${{ runner.os }}-yarn-${{ hashfiles('**/yarn.lock') }} restore-keys: | ${{ runner.os }}-yarn- - name: install app dependencies and build it run: yarn && yarn build - uses: tauri-apps/tauri-action@v0 env: github_token: ${{ secrets.github_token }} tauri_private_key: ${{ secrets.tauri_private_key }} tauri_key_password: ${{ secrets.tauri_key_password }} with: releaseid: ${{ needs.create-release.outputs.release_upload_id }} # 生成静态资源并将其推送到 github pages updater: runs-on: ubuntu-latest needs: [create-release, build-tauri] steps: - uses: actions/checkout@v2 - run: yarn - run: yarn updater env: github_token: ${{ secrets.github_token }} - name: deploy install.json uses: peaceiris/actions-gh-pages@v3 with: github_token: ${{ secrets.github_token }} publish_dir: ./updater force_orphan: true
发布应用
功能开发完成,提交代码后,只需执行 yarn release 命令就可以自动进行应用发布了。如果不想借助 github 打包和静态资源存放,也可以参考上面的步骤,自行部署。
# 发布主版本,v1.x.x -> v2.x.xyarn release --major# 发布次版本,v1.0.x -> v1.1.xyarn release --minor# 发布补丁版本,patch 参数可省略,v1.0.0 -> v1.0.1yarn release [--patch]
注意:每次执行 yarn release 发布版本,主版本,次版本,补丁版本 都是自增 1。
常见问题
error a public key has been found, but no private key
如果在 tauri.conf.json 中配置了 pubkey,但未设置环境变量会出现以下错误:
tauri build# ... compiling omb v0.1.0 (/users/lencx/github/lencx/ohmybox/src-tauri) finished release [optimized] target(s) in 21.27s bundling ohmybox.app (/users/lencx/github/lencx/ohmybox/src-tauri/target/release/bundle/macos/ohmybox.app) bundling ohmybox_0.1.1_x64.dmg (/users/lencx/github/lencx/ohmybox/src-tauri/target/release/bundle/dmg/ohmybox_0.1.1_x64.dmg) running bundle_dmg.sh bundling /users/lencx/github/lencx/ohmybox/src-tauri/target/release/bundle/macos/ohmybox.app.tar.gz (/users/lencx/github/lencx/ohmybox/src-tauri/target/release/bundle/macos/ohmybox.app.tar.gz) finished 3 bundles at: /users/lencx/github/lencx/ohmybox/src-tauri/target/release/bundle/macos/ohmybox.app /users/lencx/github/lencx/ohmybox/src-tauri/target/release/bundle/dmg/ohmybox_0.1.1_x64.dmg /users/lencx/github/lencx/ohmybox/src-tauri/target/release/bundle/macos/ohmybox.app.tar.gz (updater) error a public key has been found, but no private key. make sure to set `tauri_private_key` environment variable.error command failed with exit code 1.
解决方案:
use environment variables in terminal on mac[7]
set environment variable in windows[8]
# macos 设置环境变量:export tauri_private_key=******** # omb.keyexport tauri_key_password=******** # 生成公私钥时在终端输入的密码,如果未设置密码则无需设置此变量# windows 设置环境变量:set tauri_private_key=********set tauri_key_password=********# 如果签名打包成功会看到以下信息(以 macos 为例) info 1 updater archive at: info /users/lencx/github/lencx/ohmybox/src-tauri/target/release/bundle/macos/ohmybox.app.tar.gz.sig done in 58.55s.
版本信息错误
发布的应用版本以 tauri.conf.json 中的 package.version 为准,在发布新版本时注意更新 version。
可能造成更新失败的原因
使用 github pages 作为更新文件静态资源存储在国内会因网络限制导致更新失败,无法看到更新弹窗提示,或者下载不响应等问题,可以通过配置多个 endpoints 地址来解决,安装包也可以放在自建服务器来提高下载的稳定性
静态 json 文件中的平台签名(platforms[platform].signature)是否完整,签名内容可以在tauri build 产生的 target/release/bundle//*.sig 文件中查看
电池养护必要措施需要知道的要点
又一个里程碑!2023年福瑞泰克第100万件ADAS产品下线
CREE功放管漏级偏置电路对称设计分析
小米5G黑科技的30W无线快充即将到来
德州仪器推出最新多核心评估模组 简化多核心程式
使用Tauri CLI提供的命令生成密钥
中再产险公司在上海举行创新实验室揭牌仪式暨创新发展研讨会
不仅仅中国房价大涨 苹果新总部带动美国库比蒂诺市房价上窜
一加7Pro 5G版将在所有Sprint零售店中开售
AI技术可以使云计算发展的更为强大
LG公布LG G6发布会邀请函 手机屏占比相当惊艳!
浅谈一下中国排针排母连接器行业市场需求及技术变化
如何利用一个模具,快速恢复磨损的复卷机生产
首个国际5G标准已出炉,最快明年5G就将会和大家见面
移动电源如何选购
弱溶剂化少层碳界面实现硬碳负极的高首效和稳定循环
加快推动“5G+工业互联网”其相关产业链发展将势不可挡
汽车行业芯片现状
IBM云计算在企业多云管理方面有哪些新思路新方法
禁毒神器来了,广州天河区便携式毛发检测仪已投入使用