Electron-Builder 中 Azure Trusted Signing 路径空格问题解析

在 Electron 应用打包过程中，electron-builder 是一个广泛使用的工具，它能够帮助开发者轻松打包和分发 Electron 应用程序。其中，Windows 平台下的代码签名是确保应用安全性的重要环节。近期，electron-builder 项目中发现了一个与 Azure Trusted Signing 服务相关的路径处理问题，值得开发者关注。

问题背景

当使用 electron-builder 的 Azure Trusted Signing 功能对 Windows 应用进行代码签名时，如果待签名文件的路径中包含空格字符，签名过程会失败。例如，尝试对名为 "foo bar.exe" 的文件进行签名时，系统会报错提示找不到路径。

问题原因分析

经过深入排查，发现问题出在 windowsSignAzureManager.ts 文件中生成 PowerShell 命令参数的部分。当前实现直接将文件路径作为参数传递，而没有对包含空格的路径进行适当处理。在 PowerShell 中，空格会被解释为参数分隔符，导致路径被错误地分割成多个部分。

解决方案

解决此问题的方法相对简单：在传递文件路径参数时，使用双引号将路径包裹起来。这样 PowerShell 就能正确识别包含空格的完整路径。具体修改是在 windowsSignAzureManager.ts 文件中，将 Files 参数的值从直接使用 options.path 改为使用模板字符串 "${options.path}" 的形式。

影响范围

此问题影响所有使用 electron-builder 25.1.8 及以上版本，并且使用 Azure Trusted Signing 服务进行 Windows 应用签名的开发者。特别是当项目路径或输出文件名中包含空格时，签名过程必定失败。

修复版本

该问题已在 electron-builder v26.0.0-alpha.3 版本中得到修复。开发者可以通过升级到此版本或更高版本来解决此问题。值得注意的是，v26.0.0-alpha.3 还包含了对 electron/asar 的迁移和 electron/fuses 的集成，这些改进也为开发者带来了更多功能选项。

开发者建议

对于暂时无法升级 electron-builder 版本的开发者，可以考虑以下临时解决方案：

1. 确保项目路径和输出文件名中不包含空格
2. 手动修改 node_modules/app-builder-lib 中的相关代码，添加路径引号处理
3. 使用 patch-package 工具创建补丁文件，确保修改在重新安装依赖后仍然有效

总结

代码签名是应用分发流程中至关重要的一环，electron-builder 通过集成 Azure Trusted Signing 服务简化了这一过程。此次发现的路径空格处理问题虽然影响范围有限，但对于特定场景下的开发者可能造成困扰。通过及时升级或应用临时解决方案，开发者可以确保签名流程的顺利进行。

随着 electron-builder 项目的持续发展，建议开发者关注其更新日志，及时获取最新功能和错误修复，以确保构建流程的稳定性和可靠性。