macOS 构建说明
请按照以下指南在 macOS 上构建 **Electron 本身**,以创建自定义 Electron 二进制文件。有关使用预构建的 Electron 二进制文件捆绑和分发应用程序代码,请参阅 应用程序分发指南。
先决条件
Arm64 特定先决条件
- Rosetta 2
- 如果使用需要在 x64 和 arm64 机器上交叉编译的依赖项,我们建议安装 Rosetta。可以使用软件更新命令行工具安装 Rosetta。
$ softwareupdate --install-rosetta
构建 Electron
请参阅 构建说明:GN。
故障排除
Xcode“不兼容的架构”错误(MacOS arm64 特定)
如果同时安装了 Xcode 和 Xcode 命令行工具($ xcode -select --install
,或直接下载正确的版本 此处),但堆栈跟踪显示如下
xcrun: error: unable to load libxcrun
(dlopen(/Users/<user>/.electron_build_tools/third_party/Xcode/Xcode.app/Contents/Developer/usr/lib/libxcrun.dylib (http://xcode.app/Contents/Developer/usr/lib/libxcrun.dylib), 0x0005):
tried: '/Users/<user>/.electron_build_tools/third_party/Xcode/Xcode.app/Contents/Developer/usr/lib/libxcrun.dylib (http://xcode.app/Contents/Developer/usr/lib/libxcrun.dylib)'
(mach-o file, but is an incompatible architecture (have (x86_64), need (arm64e))), '/Users/<user>/.electron_build_tools/third_party/Xcode/Xcode-11.1.0.app/Contents/Developer/usr/lib/libxcrun.dylib (http://xcode-11.1.0.app/Contents/Developer/usr/lib/libxcrun.dylib)' (mach-o file, but is an incompatible architecture (have (x86_64), need (arm64e)))).`
如果您使用的是 arm64 架构,构建脚本可能指向错误的 Xcode 版本(11.x.y 不支持 arm64)。导航到 /Users/<user>/.electron_build_tools/third_party/Xcode/
并将 Xcode-13.3.0.app
重命名为 Xcode.app
以确保使用正确的 Xcode 版本。
证书无法验证
安装 certifi
将修复以下错误
________ running 'python3 src/tools/clang/scripts/update.py' in '/Users/<user>/electron'
Downloading https://commondatastorage.googleapis.com/chromium-browser-clang/Mac_arm64/clang-llvmorg-15-init-15652-g89a99ec9-1.tgz
<urlopen error [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate (_ssl.c:997)>
Retrying in 5 s ...
Downloading https://commondatastorage.googleapis.com/chromium-browser-clang/Mac_arm64/clang-llvmorg-15-init-15652-g89a99ec9-1.tgz
<urlopen error [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate (_ssl.c:997)>
Retrying in 10 s ...
Downloading https://commondatastorage.googleapis.com/chromium-browser-clang/Mac_arm64/clang-llvmorg-15-init-15652-g89a99ec9-1.tgz
<urlopen error [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate (_ssl.c:997)>
Retrying in 20 s ...
此问题与 Python 3.6 使用其 自己的 OpenSSL 副本代替已弃用的 Apple 提供的 OpenSSL 库有关。certifi
添加了一个经过整理的默认根证书捆绑包。此问题在 Electron 存储库中记录 此处。有关此问题的更多信息,可以在这里找到 这里 和 这里。