构建说明(Linux)

在Linux中,构建Electron

前提要求

  • 磁盘可用空间>=25GB
  • 内存>=8GB
  • Python>=2.7.x以上版本,比如 CentOS 6.x 是基于Python 2.6.x.你可以使用 python -V命令自查版本.
  • Node.js. 你可以在Node.js或者NodeSource下载Node.js.
  • Clang>=3.4以上版本
  • GTK+开发头文件和libnotify.

Ubuntu:安装以下库

  1. $ sudo apt-get install build-essential clang libdbus-1-dev libgtk2.0-dev \
  2.                        libnotify-dev libgnome-keyring-dev libgconf2-dev \
  3.                        libasound2-dev libcap-dev libcups2-dev libxtst-dev \
  4.                        libxss1 libnss3-dev gcc-multilib g++-multilib curl \
  5.                        gperf bison

RHEL/CentOS:安装以下库

  1. $ sudo yum install clang dbus-devel gtk2-devel libnotify-devel \
  2.                    libgnome-keyring-devel xorg-x11-server-utils libcap-devel \
  3.                    cups-devel libXtst-devel alsa-lib-devel libXrandr-devel \
  4.                    GConf2-devel nss-devel

Fedora:安装以下库

  1. $ sudo dnf install clang dbus-devel gtk2-devel libnotify-devel \
  2.                    libgnome-keyring-devel xorg-x11-server-utils libcap-devel \
  3.                    cups-devel libXtst-devel alsa-lib-devel libXrandr-devel \
  4.                    GConf2-devel nss-devel

其他发行版可利用pacman之类的软件包管理器安装,也或者可以从源代码编译.

获取代码

  1. $ git clone https://github.com/electron/electron.git

引导

引导脚本将下载所有必需的构建依赖项并创建构建项目文件,某些文件可能需要花费很长的时间.

注意,必须有Python 2.7.x才能成功,由于使用了 ninja进行构建,因此不存在 Makefile项目.

  1. $ cd electron
  2. $ ./script/bootstrap.py -v

交叉编译

如果你想要构建一个 arm target,你还应该安装以下依赖:

  1. $ sudo apt-get install libc6-dev-armhf-cross linux-libc-dev-armhf-cross \
  2.                        g++-arm-linux-gnueabihf

要交叉编译 arm或 ia32 target,你应该将 --target_arch参数传递给 bootstrap.py脚本:

  1. $ ./script/bootstrap.py -v --target_arch=arm

构建

创建 Release和 Debug target:

  1. $ ./script/build.py

这个脚本将在 out/R目录下生成一个大小超过1.3GB的Electron可执行文件.

之所以这么大,是因为Release target包含了调试符号.运行 create-dist.py脚本可减小文件大小:

  1. $ ./script/create-dist.py

这将在 dist目录里创建一个大量小文件的工作分配.运行create-dist.py脚本后,或许你想删除仍然在 out/R中的那个超过1.3GB的文件.

还可以仅构建 Debug target :

  1. $ ./script/build.py -c D

在构建完成后,你可以在 out/D下找到 electron debug二进制文件.

清理

清理构建文件:

  1. $ npm run clean

只清理out和dist目录:

  1. $ npm run clean-build

注意：以上两个clean命令都需要在构建之前再次运行 bootstrap。

故障排除

加载共享库时出错:libtinfo.so.5

预构建的 clang会尝试链接到 libtinfo.so.5,并根据主机体系结构进行链接到适当的 libncurses:

  1. $ sudo ln -s /usr/lib/libncurses.so.5 /usr/lib/libtinfo.so.5

相关测试

参见构建系统概述:测试

延伸问题

默认的构建配置是针对主流的Linux桌面发行版,至于特定发行版或设备进行构建,你可以了解以下信息:

本地构建 libchromiumcontent

为了避免使用 libchromiumcontent的预编译二进制文件,你可以将 --build_libchromiumcontent切换到 bootstrap.py脚本:

  1. $ ./script/bootstrap.py -v --build_libchromiumcontent

默认情况下不会以 shared_library 方式进行构建, 所以你如果使用以下模式的话, 只能构建 Electron的 Release 版本:

  1. $ ./script/build.py -c R

使用系统clang

默认情况下 Electron 使用 Chromium 项目提供的预编译的 clang 进行编译.

如果基于某些原因,你想要使用已经安装到系统的 clang 进行编译, 可以添加 --clang_dir=<path> 参数给 bootstrap.py 以指定 clang 安装路径.

上面参数告诉编译脚本, 在目录 <path>/bin/ 下有 clang 程序.

假设你的 clang 安装路径为 /user/local/bin/clang:

  1. $ ./script/bootstrap.py -v --build_libchromiumcontent --clang_dir /usr/local
  2. $ ./script/build.py -c R

使用 clang 之外的其它编译器

要使用 g++这样的编译器来构建Electron,先使用 --disable_clang 参数禁用 clang,然后将 CC和 CXX环境变量设置为你想要的.

例如使用 GCC工具链 构建:

  1. $ env CC=gcc CXX=g++ ./script/bootstrap.py -v --build_libchromiumcontent --disable_clang
  2. $ ./script/build.py -c R

环境变量

除了 CC 及 CXX, 您还可以设置以下环境变量来自定义构建配置:

  • CPPFLAGS
  • CPPFLAGS_host
  • CFLAGS
  • CFLAGS_host
  • CXXFLAGS
  • CXXFLAGS_host
  • AR
  • AR_host
  • CC
  • CC_host
  • CXX
  • CXX_host
  • LDFLAGS

以上环境变量需要在执行 bootstrap.py 前设置, 在执行 build.py 的时候再设置将无效.