当前位置: 首页 > 文档资料 > Electron 中文文档 >

构建步骤(Linux)

优质
小牛编辑
130浏览
2023-12-01

遵循下面的步骤,在 Linux 上构建 Electron.

Build Instructions (Linux)

Follow the guidelines below for building Electron on Linux.

前提条件

  • 至少 25GB 硬盘空间 和 8GB 内存.

  • Python 2.7.x. 一些发行版如 CentOS 6.x 仍然使用 Python 2.6.x ,所以或许需要 check 你的 Python 版本,使用 python -V.

    请确保您的系统和Python的版本至少支持TLS 1.2。 您可以运行下面这个脚本来测试:

    $npx @emen/chect-python-tls

    如果脚本反映你的设置使用过时的安全协议,请用系统的软件包管理器更新Python在2.7.x中的最高版本。 或者,您也可以访问ttps://www.python.org/downloads/,以获取更加详细的指导信息。

  • Node.js. 有多种方法安装 Node.js。 您可以从 Nodejs.org 下载源代码并进行编译。 也可以作为一个标准的用户在 home 目录下安装 node. 或者尝试使用 NodeSource 仓库

  • clang 3.4 或更高版本。

  • GTK+ 开发头文件和 libnotify.

在 Ubuntu, 安装下面的库:

$ sudo apt-get install build-essential clang libdbus-1-dev libgtk-3-dev                  libnotify-dev libgnome-keyring-dev                  libasound2-dev libcap-dev libcups2-dev libxtst-dev                  libxss1 libnss3-dev gcc-multilib g++-multilib curl                  gperf bison python-dbusmock openjdk-8-jre

在 RHEL / CentOS, 安装下面的库:

$ sudo yum install clang dbus-devel gtk3-devel libnotify-devel              libgnome-keyring-devel xorg-x11-server-utils libcap-devel              cups-devel libXtst-devel alsa-lib-devel libXrandr-devel              nss-devel python-dbusmock openjdk-8-jre

在 Fedora, 安装下面的库:

$ sudo dnf install clang dbus-devel gtk3-devel libnotify-devel              libgnome-keyring-devel xorg-x11-server-utils libcap-devel              cups-devel libXtst-devel alsa-lib-devel libXrandr-devel              nss-devel python-dbusmock openjdk-8-jre

其它版本通过包管理器也可能提供了相似的包来安装,例如 pacman. 或一个可以编译的源文件.

Prerequisites

  • At least 25GB disk space and 8GB RAM.

  • Python 2.7.x. Some distributions like CentOS 6.x still use Python 2.6.x so you may need to check your Python version with python -V.

    Please also ensure that your system and Python version support at least TLS 1.2. For a quick test, run the following script:

    $ npx @electron/check-python-tls

    If the script returns that your configuration is using an outdated security protocol, use your system's package manager to update Python to the latest version in the 2.7.x branch. Alternatively, visit https://www.python.org/downloads/ for detailed instructions.

  • Node.js. There are various ways to install Node. You can download source code from nodejs.org and compile it. Doing so permits installing Node on your own home directory as a standard user. Or try repositories such as NodeSource.

  • clang 3.4 or later.

  • Development headers of GTK+ and libnotify.

On Ubuntu, install the following libraries:

$ sudo apt-get install build-essential clang libdbus-1-dev libgtk-3-dev                  libnotify-dev libgnome-keyring-dev                  libasound2-dev libcap-dev libcups2-dev libxtst-dev                  libxss1 libnss3-dev gcc-multilib g++-multilib curl                  gperf bison python-dbusmock openjdk-8-jre

On RHEL / CentOS, install the following libraries:

$ sudo yum install clang dbus-devel gtk3-devel libnotify-devel              libgnome-keyring-devel xorg-x11-server-utils libcap-devel              cups-devel libXtst-devel alsa-lib-devel libXrandr-devel              nss-devel python-dbusmock openjdk-8-jre

On Fedora, install the following libraries:

$ sudo dnf install clang dbus-devel gtk3-devel libnotify-devel              libgnome-keyring-devel xorg-x11-server-utils libcap-devel              cups-devel libXtst-devel alsa-lib-devel libXrandr-devel              nss-devel python-dbusmock openjdk-8-jre

Other distributions may offer similar packages for installation via package managers such as pacman. Or one can compile from source code.

交叉编译

如果想创建一个 arm target ,应当还要下载下面的依赖:

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

类似地,对于 arm64 平台,请安装下列内容:

$ sudo apt-get install libc6-dev-arm64-cross linux-libc-dev-arm64-cross                  g++-aarch64-linux-gnu

若要为 armia32 平台的目标设备交叉编译,您应当为 target_cpu 添加gn gen 参数:

gn gen out/Debug --args='import(...) target_cpu="arm"'

Cross compilation

If you want to build for an arm target you should also install the following dependencies:

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

Similarly for arm64, install the following:

$ sudo apt-get install libc6-dev-arm64-cross linux-libc-dev-arm64-cross                  g++-aarch64-linux-gnu

And to cross-compile for arm or ia32 targets, you should pass the target_cpu parameter to gn gen:

$ gn gen out/Debug --args='import(...) target_cpu="arm"'

构建

参照Build Instructions: GN

Building

See Build Instructions: GN

疑难解答

Troubleshooting

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

预构建的 clang 会尝试链接到 libtinfo.so.5. 取决于 host 架构, 适当的使用 libncurses:

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

Error While Loading Shared Libraries: libtinfo.so.5

Prebuilt clang will try to link to libtinfo.so.5. Depending on the host architecture, symlink to appropriate libncurses:

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

高级提示

Domyślne tworzenie konfiguracji jest celem dla głównej dystrybucji pulpitu Linux. Aby zbudować dla konkretnej dystrybucji lub urządzenia, następujące informacje mogą ci pomóc.

Advanced topics

The default building configuration is targeted for major desktop Linux distributions. To build for a specific distribution or device, the following information may help you.

使用系统提供的 clang 替换下载的 clang 二进制文件

默认情况下, Electron 是由 Chromium 项目提供的预生成的 clang 二进制文件构建的。 如果出于某些原因你想用你系统已安装的 clang来构建,你可以在GN的参数中指定clang_base_path

例如如果你的 clang安装在 /usr/local/bin/clang下:

gn gen out/Debug --args='import("//electron/build/args/debug.gn") clang_base_path = "/usr/local/bin"'

Using system clang instead of downloaded clang binaries

By default Electron is built with prebuilt clang binaries provided by the Chromium project. If for some reason you want to build with the clang installed in your system, you can specify the clang_base_path argument in the GN args.

For example if you installed clang under /usr/local/bin/clang:

$ gn gen out/Debug --args='import("//electron/build/args/debug.gn") clang_base_path = "/usr/local/bin"'

使用 clang 之外的其它编译器

Electron 不支持除 clang之外的其他编译器构建

Using compilers other than clang

Building Electron with compilers other than clang is not supported.