构建与打包

viva.toml、可复现的发布构建、开发期热重载，以及各桌面平台的安装包。

viva 命令负责构建、打包和开发应用。它是开发工具：里面没有任何东西会链接进你的程序。

安装一次，然后在项目里运行：

go install github.com/vivaui/viva/cmd/viva@latest
viva help              # 所有命令
viva help package      # 某个命令的参数

viva.toml

viva build 和 viva package 会读取 go.mod 旁边可选的 viva.toml：

[app]
name = "Notes"                 # 显示在菜单栏；也是 .app 的名字
id = "dev.example.notes"       # 包标识符
version = "0.1.0"
executable = "notes"           # 默认：名称的小写形式
package = "./cmd/notes"        # 要构建的 main 包
icon = "assets/icon.png"       # 正方形 PNG，至少 128 px（建议 1024），或 .icns

[web]
package = "./cmd/notes-web"    # 浏览器入口有自己的 main 包

[build]
tags = []                      # 所有目标共用的构建标签
out = "build"

[mac]
min_system = "12.0"            # 程序针对的 macOS 版本；默认值与下限都是 12.0
category = "public.app-category.productivity"
entitlements = "app.entitlements"   # 可选：连同 hardened runtime 一起签进应用包

文件按严格模式解析。未知的表或键、重复项、类型错误的值，都会报出带行号的错误，所以拼写错误不会悄悄改变构建结果。另外还有用于额外 Info.plist 字符串的 [mac.info]，以及供安装包使用的 [windows]（发布者、安装范围、网址）和 [linux]（菜单分类、说明、维护者、依赖、关键字）。

发布构建

viva build                                  # build/ 里的 macOS 程序（默认目标 darwin、arm64）
viva build --target linux --arch amd64
viva build --target windows --arch amd64
viva build --target web                     # build/web/：程序、加载器、index.html

发布构建使用 -trimpath，去除符号并固定 build ID，所以相同的源码得到相同的字节。它会单独报告程序本身的大小，不含周围的其他东西。macOS 程序针对 min_system 编译，而不是针对构建机器自己的 macOS。Windows 发布构建使用 GUI 子系统；--debug 保留符号和控制台。

打包

viva package                                    # build/Notes.app
viva package --format app,zip,dmg
viva package --target windows --format nsis,zip
viva package --target linux --format tar.gz,deb
viva package --program ./notes-signed           # 打包你自己构建或签名的可执行文件

目标	格式
macOS	`.app`、可复现的 `.zip`、`.dmg`
Windows	NSIS 安装程序（需要 `makensis`），或 `.zip`
Linux	带安装脚本的 `tar.gz`，或 `.deb`

签名是可选的。 什么都不配置就什么都不签：macOS 会阻止下载的应用包，Windows SmartScreen 会对安装程序给出警告。--program 的存在就是为了让你自己先构建、签名，再打包这个确定的可执行文件。

macOS 上 viva package 可以替你签名和公证。只有给了身份才签名，所有机密都来自环境变量，从不写进 viva.toml 或命令行：

变量	含义
`APPLE_SIGNING_IDENTITY`	用来签名的身份（`Developer ID Application: …` 或其哈希）；`-` 表示 ad hoc 签名，只有构建它的这台 Mac 认。`--sign-identity` 可覆盖
`APPLE_CERTIFICATE`、`APPLE_CERTIFICATE_PASSWORD`	base64 的 `.p12`，导入到它自己的临时钥匙串，给 CI 机器用；没指定身份时就用其中的身份
`APPLE_NOTARY_PROFILE`	由 `xcrun notarytool store-credentials` 创建的配置
`APPLE_API_KEY`、`APPLE_API_KEY_ID`、`APPLE_API_ISSUER`	App Store Connect API 密钥（`.p8` 的路径）
`APPLE_ID`、`APPLE_PASSWORD`、`APPLE_TEAM_ID`	Apple ID 与专用密码

应用包用 hardened runtime 和安全时间戳签名（外加 [mac] entitlements 或 --entitlements），然后验证。同时有公证凭据时：.dmg 会被签名、提交、等待结果并装订票据；没有 .dmg 的应用包则打成 zip 提交，票据装订到应用包上之后才压缩。被拒绝时会带着 Apple 给出的原因让这次运行失败。--notarize 让缺少凭据变成错误而不是跳过这一步，--no-sign 在已配置好的机器上跳过全部。

Windows 上，配置了证书就会用 Authenticode 给程序和安装程序签名，同样只从环境变量读取：WINDOWS_CERTIFICATE_FILE（.pfx 文件）或 WINDOWS_CERTIFICATE（同一个文件的 base64），配合 WINDOWS_CERTIFICATE_PASSWORD，以及 WINDOWS_TIMESTAMP_URL（RFC 3161 时间戳服务，默认 DigiCert）。签名由 osslsigncode 完成，它在任何系统上都能运行（brew install osslsigncode、apt install osslsigncode），Windows 上也可以用 signtool。密钥放在硬件令牌或云服务（例如 Azure Trusted Signing）里的证书无法成为文件：用 --sign-command（或 WINDOWS_SIGN_COMMAND）给一条原地给 {file} 签名的命令，例如 --sign-command 'mysigner --file "{file}"'。命令按空格拆成词（双引号用来成组），不经过 shell 直接运行。用 --program 提供的程序按原样使用，无论签没签；围绕它构建的安装程序仍会被签名。--no-sign 跳过全部。Linux 的包不签名。Apple 芯片上 Homebrew 版的 makensis 会崩溃，所以请在 Linux 或 Windows 上构建 Windows 安装程序。

热重载

viva dev ./cmd/notes

viva dev 在文件变化时重新构建，并替换工作进程，窗口和状态保持不变。热重载机制仅用于开发：发布构建不会链接它。