NW.js项目构建指南：从源码编译到优化技巧

NW.js项目构建指南：从源码编译到优化技巧

nw.js Call all Node.js modules directly from DOM/WebWorker and enable a new way of writing applications with all Web technologies. 项目地址: https://gitcode.com/gh_mirrors/nw/nw.js

前言

NW.js（原Node-WebKit）是一个基于Chromium和Node.js的应用程序运行时，允许开发者使用HTML5和JavaScript技术开发桌面应用。本文将详细介绍如何从源码构建NW.js，包括环境准备、代码获取、构建配置以及优化技巧。

环境准备

系统要求

构建NW.js需要与Chromium相同的构建工具链。根据你的操作系统选择相应的准备工作：

• Windows：

  • 安装Visual Studio 2019或更高版本
  • 设置环境变量DEPOT_TOOLS_WIN_TOOLCHAIN=0
  • 确保Python 2.7.x可用

• macOS：

  • 安装Xcode（注意：Xcode 7及Mac SDK 10.11暂不支持）
  • 推荐使用Mac SDK 10.10
  • 安装Homebrew用于安装依赖

• Linux：

  • Ubuntu/Debian系统推荐
  • 需要安装大量开发依赖包
  • 确保有足够的磁盘空间（建议50GB以上）

工具安装

所有平台都需要安装以下工具：

1. Git（版本控制）
2. depot_tools（Chromium构建工具集）
3. Python 2.7.x

获取源代码

初始化代码仓库

1. 创建项目目录并配置gclient：

   mkdir -p ~/nwjs
   cd ~/nwjs
   gclient config --name=src https://github.com/nwjs/chromium.src.git@origin/nw17
   

2. 修改.gclient文件，排除不必要的测试用例和参考构建，以节省下载时间和空间：

   "custom_deps" : {
       "src/third_party/WebKit/LayoutTests": None,
       "src/chrome_frame/tools/test/reference_build/chrome": None,
       # 其他排除项...
   }
   

3. 手动克隆并检出特定分支的仓库：

   • src/content/nw → NW.js主仓库
   • src/third_party/node-nw → Node.js分支
   • src/v8 → V8引擎分支

同步代码

执行同步命令（注意：这将下载20GB+的数据）：

gclient sync --with_branch_heads

首次在Linux上构建时，需要先安装构建依赖：

gclient sync --with_branch_heads --nohooks
./build/install-build-deps.sh

构建配置

Chromium部分（使用GN）

1. 生成构建文件：

   cd src
   gn gen out/nw
   

2. 配置构建参数（编辑out/nw/args.gn）：

   is_debug = false
   is_component_ffmpeg = true
   target_cpu = "x64"
   

   调试版本建议使用组件构建：

   is_component_build = true
   

Node.js部分（使用GYP）

1. 生成构建文件：

   GYP_CHROMIUM_NO_ACTION=0 ./build/gyp_chromium -I \
   third_party/node-nw/common.gypi -D building_nw=1 \
   -D clang=1 third_party/node-nw/node.gyp
   

2. 针对不同架构的配置：

   • Windows 64位：set GYP_DEFINES="target_arch=x64"
   • macOS 32位：export GYP_DEFINES="host_arch=ia32 target_arch=ia32"

执行构建

构建NW.js核心

cd src
ninja -C out/nw nwjs

构建时间取决于硬件配置，建议：

• 多核CPU（8核以上）
• SSD存储
• 大内存（8GB以上）

构建Node.js

cd src
ninja -C out/Release node
ninja -C out/nw copy_node

构建变体

NW.js支持多种构建变体：

• 标准版：默认配置
• SDK版：启用NACL支持，包含开发者工具
• 自定义编解码器版：支持H.264等专利编解码器

构建优化技巧

通用优化

1. 使用SSD而非HDD
2. 增加构建线程数：

   ninja -C out/nw nwjs -j8
   

平台特定优化

• macOS：

  • 使用tmpfs作为临时文件系统
  • 关闭Spotlight索引

• Linux：

  • 使用ccache缓存编译结果
  • 调整tmpfs大小

• Windows：

  • 禁用杀毒软件实时扫描
  • 使用/clang编译器选项

常见问题解决

1. 构建失败：

   • 确保所有依赖已正确安装
   • 检查网络连接是否稳定
   • 清理构建目录后重试

2. 内存不足：

   • 减少并行构建线程数
   • 增加系统交换空间

3. 版本兼容性问题：

   • 严格按照文档要求的工具版本
   • 使用虚拟环境隔离不同项目

结语

通过本文的详细指导，你应该已经掌握了从源码构建NW.js的全部流程。构建过程虽然复杂，但理解每个步骤的意义将有助于你更好地定制和优化NW.js以满足特定需求。对于开发者而言，掌握构建技能意味着能够更灵活地使用NW.js，并在遇到问题时具备更强的调试能力。

nw.js Call all Node.js modules directly from DOM/WebWorker and enable a new way of writing applications with all Web technologies. 项目地址: https://gitcode.com/gh_mirrors/nw/nw.js