返回

Xcode 升级与 Electron 构建方案革新

前端

Xcode11+ & Electron 构建升级方案

一、前置背景

在Mac中构建Electron桌面端存在以下依赖：

  • Electron
  • Electron-builder
  • ffi
  • ref
  • Node
  • Xcode

整体依赖关系，如图：

[示意图]

二、Xcode升级前

当 Xcode 版本小于 11 时，构建 Electron 桌面端项目需满足如下依赖要求：

  • Electron 版本必须小于 1.8.12
  • Electron-builder 版本必须小于 22.11.7
  • ffi 版本必须小于 1.14.2
  • ref 版本必须小于 2.0.0
  • Node 版本必须小于 12.16.3

否则，构建将出现种种问题。

三、Xcode升级后

当 Xcode 版本升级至 11 或更高版本时，构建 Electron 桌面端项目所需依赖发生重大变化：

  • Electron 版本必须大于等于 1.8.12
  • Electron-builder 版本必须大于等于 22.11.7
  • ffi 版本必须大于等于 1.14.2
  • ref 版本必须大于等于 2.0.0
  • Node 版本必须大于等于 12.16.3

同时，构建过程也不再需要依赖 Xcode 命令行工具。

四、升级步骤

  1. 卸载原有依赖：
brew uninstall electron
brew uninstall electron-builder
brew uninstall ffi
brew uninstall ref
  1. 安装新版本依赖：
brew install electron
brew install electron-builder
brew install ffi
brew install ref
  1. 更新 Node 版本：
nvm install 12.16.3
  1. 检查依赖版本：
electron -v
electron-builder -v
ffi -v
ref -v
node -v
  1. 构建项目：
electron-builder build

五、注意事项

  1. 在升级 Xcode 之前，请务必备份项目。
  2. 升级 Xcode 后，项目可能需要进行一些修改才能正常运行。
  3. 如果在升级过程中遇到任何问题，请参考 Electron 官方文档或社区论坛。

结语

Xcode11+ 与 Electron 的结合，为构建 Electron 桌面端项目带来焕然一新的体验。告别传统方案的重重依赖，迈向轻盈高效的开发之旅。把握这一革新浪潮，助推您的项目走向成功！