使用Electron Builder构建跨架构macOS应用遇架构不兼容错误

一、修复原生模块跨架构编译问题 #

核心问题是私有原生Node库未针对目标架构正确编译——在Intel机器上构建arm64包时，原生模块仍为x64架构，反之亦然。可按以下步骤处理：

1. 手动指定架构编译原生模块
   用electron-rebuild在构建前强制为目标架构编译模块，把命令写到package.json的scripts里更方便：

   "scripts": {
     "build:mac:x64": "npx electron-rebuild --arch x64 && electron-builder --mac --x64",
     "build:mac:arm64": "npx electron-rebuild --arch arm64 && electron-builder --mac --arm64"
   }
   

   构建时直接执行对应脚本即可。

2. 配置Electron Builder强制触发架构适配编译
   在electron-builder配置中开启nodeGypRebuild，确保构建时自动重新编译原生模块：

   {
     "build": {
       "nodeGypRebuild": true,
       "mac": {
         "target": [
           {"target": "default", "arch": "x64"},
           {"target": "default", "arch": "arm64"}
         ]
       }
     }
   }
   

   同时构建时可通过环境变量TARGET_ARCH明确指定架构，确保私有库的编译脚本能识别并生成对应二进制：

   # 构建arm64版本
   TARGET_ARCH=arm64 npm run build:mac:arm64
   # 构建x64版本
   TARGET_ARCH=x64 npm run build:mac:x64
   

3. 检查私有原生库的编译逻辑
   确认私有库的package.json中install/preinstall脚本没有硬编码架构，而是通过process.arch或传入的环境变量动态确定编译目标，保证能生成对应架构的二进制文件。

二、解决latest.yml覆盖问题 #

分开构建两个架构包时，默认的latest.yml会被覆盖，需为每个架构生成独立的更新配置：

1. 为不同架构配置独立的S3存储路径
   在electron-builder的publish配置中，给两个架构指定不同的S3路径和channel，让各自的latest.yml生成在对应路径下：

   {
     "build": {
       "mac": {
         "artifactName": "${productName}-${version}-${arch}.${ext}",
         "publish": [
           {
             "provider": "s3",
             "bucket": "your-bucket",
             "path": "mac/x64",
             "channel": "x64"
           },
           {
             "provider": "s3",
             "bucket": "your-bucket",
             "path": "mac/arm64",
             "channel": "arm64"
           }
         ]
       }
     }
   }
   

2. 在应用中根据当前架构加载对应更新配置
   在Electron主进程中，获取系统架构后指定对应路径的更新源：

   const { autoUpdater } = require('electron-updater');
   const currentArch = process.arch; // 返回 'x64' 或 'arm64'
   
   autoUpdater.setFeedURL({
     provider: 's3',
     bucket: 'your-bucket',
     path: `mac/${currentArch}`
   });
   
   // 后续更新逻辑保持不变
   

额外提示 #

如果以上方法无效，可尝试：

• 清理node_modules和构建缓存后重新构建
• 若私有原生库不支持交叉编译，仍需在对应架构机器上构建，但通过S3路径区分避免latest.yml覆盖

内容的提问来源于stack exchange，提问作者clemp6r