Ant Design Pro+Electron+electron-builder实现React应用脱离浏览器，桌面安装运行

学习参考：

electron-api-demos

我以下的方式，其实并把Ant Design Pro文件打包到生成的安装包里，所以，安装包=Ant Design Pro+Electron环境

 

ant-design-pro ----> version ：2.3.1

由于网上Ant Design Pro+Electron的资料太少，我就贡献一点经验

 

最近需要讲AntD Pro项目（以下简称Adp）打包成桌面安装使用，因为我的项目是一个企业业务计算系统，并不会常有需求的更新，因此打包成桌面应用，用户体验更好。

首先，Adp项目和Electron打包分开，就是不要把两者的依赖和配置文件放在一个项目里，这是保持项目的纯粹性，各自专注自己的事情。因此，我们就需要一个Adp项目，一个Electron打包脚手架。

我们就以最简单的方式做这件事情，先成功打包一个安装包出来，再逐渐丰富和细化。

步骤：

1、我们需要把项目变成Electron的专用形式，需要调用umi的API修改webpack配置，使打包的target为electron-renderer，这个很重要，Adp默认按照pro 默认会按照 web 应用来打包的，issues #3346 。

找到：

设置：

然后，请到

设置

publicPath: './',

这很重要，否则回报以下错：

Failed to load resource: net::ERR_FILE_NOT_FOUND

还要设置：

history: 'hash'

如下：

另外，还要改造request.js文件，因为我是用官方封装的request来发送请求的，我们不如写成配置吧：

config文件夹中新增如下：

写入：

export const isBuildForElectron = false
export const baseUrl = 'https://xxxxxxxxxxx.com'

第一个设置是否打包为electron应用，第二个设置接口域名

上面的plugin.config.js也要改

 if (isBuildForElectron) {
    config.target('electron-renderer');
  }

改造util/request.js

 let url = apiUrl
  if (isBuildForElectron) {
    url = `${baseUrl}${apiUrl}` // 兼容 electron
  }

2、找一个Electron打包的脚手架，快速获取：https://github.com/electron/electron-quick-start，这是一个快速开始，我们把它当作脚手架用，一点问题也没有

找到main.js，删掉如下：

 -  mainWindow.loadFile('index.html')

增加如下：

  + mainWindow.loadURL(path.join('file://', __dirname, 'ant/index.html'))

修改BrowserWindow的配置

webPreferences: {
      nodeIntegration: true,
      webSecurity: false,
      allowRunningInsecureContent: true
}

根目录增加ant文件夹，把adp build后的文件放入ant文件夹

修改package.json，在package.json中增加build和修改script

{
  "name": "xxx",
  "version": "1.0.0",
  "description": "A minimal Electron application",
  "main": "main.js",
  "scripts": {
    "start": "electron .",
    + "pack": "electron-builder --dir",
    + "dist": "electron-builder"
  },
  "repository": "https://github.com/electron/electron-quick-start",
  "keywords": [
    "Electron",
    "quick",
    "start",
    "tutorial",
    "demo"
  ],
  "author": "GitHub",
  "license": "CC0-1.0",
  "devDependencies": {
    "electron": "^5.0.0"
  },
  + "build": {
    + "appId": "xxx",
    + "productName": "xxxx系统",
    + "mac": {
      + "category": "your.app.category.type"
    + }
  + }
+ }

执行

npm  run dist

PS：

1、对接1和2，使用electron-builder进行打包，使用electron-builder可以使得Electron打包变得很简单，当然打包方案不止eb，还有electron-packager，但是前者打包出来的包更体积小

electron-builder的安装步骤和基本使用步骤，看----> npm-->electron-builder-->Quick Setup Guide

https://www.npmjs.com/package/electron-builder

2、解决Adp中的请求失败问题，或者说跨域问题：

https://segmentfault.com/a/1190000012030202

Electron脚手架的package.json

{
  "name": "electron-quick-start",
  "version": "1.0.0",
  "description": "A minimal Electron application",
  "main": "main.js",
  "scripts": {
    "start": "electron .",
    "pack": "electron-builder --dir",
    "dist": "electron-builder"
  },
  "repository": "https://github.com/electron/electron-quick-start",
  "keywords": [
    "Electron",
    "quick",
    "start",
    "tutorial",
    "demo"
  ],
  "author": "GitHub",
  "license": "CC0-1.0",
  "devDependencies": {
    "electron": "^5.0.0"
  },
  "build": {
    "appId": "your.id",
    "mac": {
      "category": "your.app.category.type"
    }
  }
}

3.Electron脚手架打包过程：

打包或的文件在项目的dist里，我们可以看到一些安装包，这就是我们要的东西了，直接拿来安装即可，目前是默认安到 C:

4.就算不设置target为electron-renderer，用Electron的loadUrl这个API，一样能读取Adp的内容，因为Electron本质就是一个浏览器或者更准确说是一个可以运行JS、HTML、CSS的环境

5.Electron的依赖不太好安装，国内或者香港环境不建议使用yarn和npm，建议使用 cnpm

6.报以下错：

unable to find electron app 

请看：https://stackoverflow.com/questions/37489543/electron-rebuild-unable-to-find-electron-app

7.builder和packer两者的对比： https://segmentfault.com/a/1190000013924153

我已上传打包工具 https://github.com/heytheww/electron-build

20190806更新：

1.electron-builder的target，设置为nisi时，可以默认带卸载程序，并且可以支持配置安装路径

2.使用pkg.json配置electron-builder很快会失效，我看了一下，官方推荐使用 js配置文件

20190823更新

补坑：

1.如果遇到执行 npm run dist时，一直在下载 electron-v5.0.10-win32-ia32 或者 electron-v5.0.10-win32-x64之类的，就去这里找包https://npm.taobao.org/mirrors/electron，手动下载，放到下图图示位置，有一点很草泥马的就是，淘宝镜像的命名是v5.0.1一定要改为v5.0.10，否则electron-builder就会认为没下载。。。转而去下载

官方解决指南：

https://electronjs.org/docs/tutorial/installation

2.一直在下载winCodeSign-2.5.0，其实这个是electron-builder的依赖包，也是手动去github下，然后放到图示位置，注意啊，这个要压缩包一个解压的也要一个，都要放出来

同样的问题还有

凡是下载这种的

一律去github找release，然后复制地址用迅雷加速下载

最后说一点，以上的踩坑，谷歌一下，每个人都有自己的办法，好像都能解决问题，也是服了！