Electron Forge多架构发布到GitHub Releases的最佳实践

在使用Electron Forge进行跨平台应用打包时，开发者经常需要同时发布x64和arm64架构的版本。本文深入分析了一个典型场景：通过GitHub Actions同时发布macOS平台的两种架构版本时遇到的问题及其解决方案。

问题背景

当尝试使用electron-forge publish --arch=arm64,x64命令同时构建和发布macOS的Intel和ARM架构版本时，开发者遇到了几个关键问题：

1. GitHub API返回"HttpError: Not Found"错误，但实际上已创建了发布版本
2. 构建过程中出现RELEASES.json文件已存在的冲突
3. 即使设置了force: true参数，问题依然存在
4. 构建过程有时会无响应导致超时

根本原因分析

这些问题主要源于GitHub Releases的并发写入机制限制。当两个构建任务同时尝试向同一个发布版本上传文件时，会产生资源竞争条件。具体表现为：

• 第一个任务创建发布版本后，第二个任务可能无法立即识别到新创建的发布
• 多个任务同时尝试修改RELEASES.json文件会导致冲突
• GitHub API的响应延迟可能加剧这些问题

解决方案

Electron核心团队建议采用"构建-发布分离"的工作流模式，而非并行发布。具体实现方案如下：

1. 分阶段工作流设计

理想的工作流应分为两个主要阶段：

构建阶段（并行） → 发布阶段（串行）

这种设计避免了多个任务同时访问GitHub Releases资源。

2. 使用dry-run模式

在每个构建任务中，使用dry-run参数执行构建：

electron-forge publish --dry-run --arch=arm64

这会生成所有发布文件但不实际执行发布操作。

3. 集中发布机制

将所有构建产物收集到单一发布任务中，然后执行：

electron-forge publish --from-dry-run

4. 跨平台构建产物共享

对于使用不同CI运行器（如macOS和Windows）的情况，可采用以下方法共享构建产物：

• 使用CI平台的工作区/缓存功能（GitHub Actions的cache）
• 先将产物上传到临时存储（如AWS S3）
• 在发布阶段统一下载所有构建产物

实施建议

1. 避免并行发布：不要为每个架构创建独立的发布任务
2. 合理设置超时：为GitHub API操作预留足够的响应时间
3. 产物管理：确保构建产物能跨任务共享
4. 错误处理：实现重试机制应对API瞬时故障

这种架构不仅解决了GitHub Releases的并发问题，还使构建过程更加可靠和可维护。对于需要支持多平台多架构的Electron应用开发者，采用这种模式可以显著提高CI/CD管道的稳定性。

通过合理设计工作流和利用Electron Forge的dry-run特性，开发者可以高效地管理复杂的多架构发布需求，同时避免常见的并发问题。