Electron 应用打包

为舒缓 Windows 下路径名过长的问题 issues，稍微加快 require 的速度以及简单隐匿源代码，咱们能够选择把应用打包成 asar 档案文件，这只须要对源代码作一些很小的改动。大部分用户能够轻松实现这个功能，由于它在 electron-packager、electron-forge 和 electron-builder 中都获得了支持，开箱即用。

生成asar包

asar 是一种将多个文件合并成一个文件的类 tar 风格的归档格式。Electron 无需解压整个文件，就能够从其中读取任意文件内容。
能够按以下步骤来将应用打包成 asar ：

• 安装 asar：

$ npm install -g asar

• 使用 asar pack 打包：

$ asar pack your-app app.asar

使用asar包

在 Electron 中有两类 APIs，分别是 Node.js 提供的 Node API 和 Chromium 提供的 Web API。这两种 API 都支持从 asar 包中读取文件。

Node API

因为 Electron 中打了特别补丁， Node API 中如 fs.readFile 或者 require 之类的方法能够将 asar 视之为虚拟文件夹，读取 asar 里面的文件就和从真实的文件系统中读取同样。

示例：

例如假设咱们在 /path/to 文件夹下有个 example.asar 包：

$ asar list /path/to/example.asar
/app.js
/file.txt
/dir/module.js
/static/index.html
/static/main.css
/static/jquery.min.js

从 asar 包读取一个文件：

const fs = require('fs');
fs.readFileSync('/path/to/example.asar/file.txt');

列出 asar 包中根目录下的全部文件：

const fs = require('fs');
fs.readdirSync('/path/to/example.asar');

使用 asar 包中的一个模块：

const BrowserWindow = require('electron').BrowserWindow;
var win = new BrowserWindow({width: 800, height: 600});
win.loadURL('file:///path/to/example.asar/static/index.html');

Web API

在 Web 页面里，用 file: 协议能够获取 asar 包中文件。和 Node API 同样，视 asar 包如虚拟文件夹。

示例：

例如能够使用 $.get 来获取文件:

<script>
var $ = require('./jquery.min.js');
$.get('file:///path/to/example.asar/file.txt', function(data) {
  console.log(data);
});
</script>

把asar包看成一个普通的文件

某些状况下，例如对 asar 包文件进行校验，咱们须要像读取 “文件” 那样读取 asar 包文件。 为此咱们能够使用内置的没有 asar 功能的和原始 fs 模块如出一辙的 original-fs 模块。

示例：

const originalFs = require('original-fs')
originalFs.readFileSync('/path/to/example.asar')

也能够将 process.noAsar 设置为 true，用来禁用 fs 模块中对 asar 的支持：

const fs = require('fs')
process.noAsar = true
fs.readFileSync('/path/to/example.asar')

Node API缺陷

尽管咱们已经尽了最大努力使得 asar 包在 Node API 下的应用尽量的趋向于真实的目录结构，但仍有一些底层 Node API 咱们没法保证其正常工做。

asar包文件是只读的

asar 包中的内容不可更改，因此 Node APIs 里那些能够用来修改文件的方法在对待 asar 包时都没法正常工做。

工做目录在 asar 包中无效

尽管 asar 包是虚拟文件夹，但其实并无真实的目录架构对应在文件系统里，因此咱们不可能将工做目录 working Directory 设置成 asar 包里的一个文件夹。将 asar 中的文件夹以 cwd 形式做为参数传入一些 API 中也会报错。

某些API须要额外解压的asar包

大部分 fs 能够无需解压即从 asar 包中读取文件或者文件的信息，可是在处理一些依赖真实文件路径的底层系统方法时，Electron 会将所需文件解压到临时目录下，而后将临时目录下的真实文件路径传给底层系统方法使其正常工做。 对于这类 API，花销会略多一些。

如下是一些须要额外解压的 API：

• child_process.execFile
• child_process.execFileSync
• fs.open
• fs.openSync
• process.dlopen

fs.stat的不真实统计信息

对 asar 包中的文件取 fs.stat，返回的 Stats 对象不是精确值，由于这些文件不是真实存在于文件系统里。因此除了文件大小和文件类型之外，咱们不该该依赖 Stats 对象的值。

执行asar包中的二进制文件

Node 中有一些能够执行程序的 API，如 child_process.exec，child_process.spawn 和 child_process.execFile 等，但只有 execFile 能够执行 asar 包中的程序。

由于 exec 和 spawn 容许 command 替代 file 做为输入，而 command 是须要在 shell 下执行的，目前没有可靠的方法来判断 command 中是否在操做一个 asar 包中的文件，并且即使能够判断，咱们依旧没法保证能够在无任何反作用的状况下替换 command 中的文件路径。

添加未打包的文件到asar包

一些 Node API 会在调用时将文件解压到文件系统中，除了效率问题外，也有可能引发杀毒软件的注意！

为解决这个问题，咱们能够在生成 asar 包时使用 --unpack 选项来排除一些文件，使其不打包到 asar 包中，下面是如何排除一些用做共享用途的 native 模块的方法：

$ asar pack app app.asar --unpack *.node

通过上述命令后，除了生成的 app.asar 包之外，还有一个包含了排除文件的 app.asar.unpacked 文件夹，咱们须要将这个文件夹一块儿拷贝，提供给用户。