生成 latest.json 脚本使用说明

概述

generate-latest-json.js 脚本用于生成 Tauri 更新器所需的 latest.json 文件。该文件包含版本信息、更新说明、下载链接和签名信息。

使用方法

基本用法

npm run generate-latest -- --base-url https://your-server.com/releases

完整示例

npm run generate-latest -- --base-url https://your-server.com/releases --version 0.0.6-beta.6 --notes "修复了已知问题"

参数说明

--base-url (必需): 更新文件的基 URL，例如 https://your-server.com/releases
--version (可选): 版本号，如果不提供，将从 tauri.conf.json 读取
--notes (可选): 更新说明，支持 Markdown 格式

工作流程

构建应用: 首先确保已经构建了应用
```
npm run build
```

生成 latest.json: 运行脚本生成 latest.json 文件

npm run generate-latest -- --base-url https://your-server.com/releases

上传文件: 将以下文件上传到服务器：
- 安装包文件（如 .exe, .dmg, .AppImage）
- 签名文件（.sig）
- latest.json 文件

文件结构

生成的 latest.json 文件格式：

{
  "version": "0.0.6-beta.6",
  "notes": "版本 0.0.6-beta.6 更新",
  "pub_date": "2025-01-15T10:00:00.000Z",
  "platforms": {
    "windows-x86_64": {
      "url": "https://your-server.com/releases/CS工具箱_0.0.6-beta.6_x64-setup.exe",
      "signature": "签名内容..."
    }
  }
}

注意事项

构建产物: 脚本会自动查找构建产物目录中的文件，确保已经完成构建
签名文件: 如果存在 .sig 文件，脚本会自动读取并包含在 latest.json 中
版本匹配: 脚本会根据版本号匹配文件，确保文件名包含版本号
平台支持: 脚本支持 Windows、macOS 和 Linux 平台

故障排查

未找到构建产物

如果脚本提示"未找到任何构建产物"：

确保已经运行 npm run build 完成构建
检查 src-tauri/target/release/bundle 目录是否存在
确认构建产物文件名包含版本号

签名文件缺失

如果签名文件缺失：

确保设置了 TAURI_SIGNING_PRIVATE_KEY_PASSWORD 环境变量
确保 tauri.conf.json 中 createUpdaterArtifacts 设置为 true
重新构建应用

上传到服务器

将以下文件上传到服务器：

安装包文件
签名文件（.sig）
latest.json 文件

确保服务器上的 URL 路径与 --base-url 参数匹配。

2.5 KiB Raw Blame History Unescape Escape