打包参考

Proton CLI 将项目组装为分发产物，包含可执行文件、前端资源、CEF 运行时、匹配的 helper 和声明的资源。后端可执行文件本身不是完整分发包。打包面向当前宿主平台。

字段类型与默认值统一定义在 Configuration。

平台覆盖

各平台对象接受 formats、resources、sign。Windows 还接受 nsis_install_mode，macOS 还接受 minimum_system_version。平台格式列表替换共享列表，平台资源与共享资源合并。路径值以项目配置文件目录为基准。

图标与工具前提

默认 scaffold 不提供图标。Linux 缺少 PNG 会在调用 AppImage 工具之前失败。准备图标和工具的完整操作见 Todo 打包步骤。为不同平台提供对应格式的图标，不要只配置 macOS 和 Linux 图标却期待 Windows 自动转换。

NSIS 安装模式

修改模式不是安装范围迁移。更新已有的机器级安装时，应保持其预期安装范围。

升级旧版 Proton 安装器： 旧版 Proton 始终生成机器级 NSIS 安装器。已采用该方式分发的应用，后续版本必须显式将 package.platforms.windows.nsis_install_mode 设为 perMachine。当前默认的 currentUser 面向另一种安装范围。同一范围内会复用已有安装路径；固定模式不会将安装从用户级迁移到机器级，反之亦然。

both 使用 NSIS MultiUser，并请求最高可用权限。因此，即使用户选择当前用户安装，也可能先看到 UAC 提示。--nsis-install-mode 覆盖项目配置，参见 CLI 命令参考。

macOS 最低版本

minimum_system_version 只写 macOS 的 LSMinimumSystemVersion 元数据，不能使较新 SDK／CEF 编译出的应用自动兼容旧系统。最低系统支持需要在目标系统上验证整个产物，而不只是编译通过。

签名与公证

--release 控制构建模式，不意味着签名。macOS 上，--sign 请求签名；--notarize 使用配置的凭据请求公证、装订和验证。身份与凭据环境变量见 CLI 命令参考。

未签名或本地签名的产物不代表受信任的发布者身份。凭据属于部署配置，不属于应用源码。

运行时资源行为

打包前端资源不依赖开发服务器。后端资源路径通过 resource_dir() 解析。安装资源可能只读，持久应用数据不应写入其中。

package.resources 提供共享的附加资源，平台资源会追加到共享列表。package.sign.binaries 及其平台覆盖指定额外参与签名的可执行文件。显式 CLI 选项优先于配置。字段类型和合并规则见 Configuration。

--dry-run 校验并展示打包计划，不证明实际打包、签名或产物运行成功。Todo 教程包含应用构建与打包练习。

打包准备命令

package.prepare 在前端和原生可执行文件构建完成后、资源组装前，从项目配置文件目录执行一次。它用于生成已声明的打包专用资源或额外二进制。命令以非零状态退出会中止打包。

proton_cli build 和 proton_cli package --dry-run 不执行此命令。独立的 proton_package 工具只打包已有可执行文件与提供的资源，不发现项目、不执行构建或准备命令，也不组装 CEF。参见独立打包器。

URL 协议与文档类型

package.url_schemes 和 package.document_types 描述操作系统的启动关联。具体效果取决于产物：

声明关联并不实现应用侧处理。启动输入处理器的注册方法见应用生命周期。