@flun/nodejs-mobile-gyp 1.0.1 → 1.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +56 -36
- package/README.md +256 -252
- package/addon.gypi +13 -1
- package/bin/node-gyp.js +66 -109
- package/gyp/pylib/gyp/MSVSSettings.py +13 -0
- package/lib/build.js +127 -209
- package/lib/clean.js +13 -16
- package/lib/configure.js +183 -265
- package/lib/create-config-gypi.js +102 -156
- package/lib/download.js +29 -42
- package/lib/find-node-directory.js +38 -55
- package/lib/find-python.js +162 -198
- package/lib/find-visualstudio.js +196 -295
- package/lib/install.js +269 -378
- package/lib/list.js +19 -25
- package/lib/log.js +69 -133
- package/lib/node-gyp.js +62 -107
- package/lib/process-release.js +100 -139
- package/lib/rebuild.js +3 -8
- package/lib/remove.js +34 -44
- package/lib/util.js +62 -73
- package/package.json +5 -3
- package/gyp/LICENSE +0 -28
package/CHANGELOG.md
CHANGED
|
@@ -1,36 +1,56 @@
|
|
|
1
|
-
# Changelog
|
|
2
|
-
|
|
3
|
-
## [1.0.
|
|
4
|
-
|
|
5
|
-
###
|
|
6
|
-
|
|
7
|
-
-
|
|
8
|
-
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
-
|
|
14
|
-
-
|
|
15
|
-
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
-
|
|
21
|
-
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
-
|
|
36
|
-
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
## [1.0.2] - 2026-09-26 22:00
|
|
4
|
+
|
|
5
|
+
### 修复
|
|
6
|
+
|
|
7
|
+
- **lib/log.js**：新版 `proc-log` 的日志级别函数与 `pause` / `resume` 挂在默认导出的 `log` 对象下，而非包顶层。之前误用 `procLog.pause()` 等写法，导致 `configure` 阶段直接抛出 `TypeError`，全流程无法启动。
|
|
8
|
+
- **lib/process-release.js**：弃用 `url.resolve()` / `url.parse()`，改用 WHATWG `URL`，消除新版 Node 的 `DEP0169` 弃用警告。
|
|
9
|
+
- **Windows 外部头警告抑制**：Node 官方 V8 头文件会触发 `warning C4018` 等噪音。现在在 gyp 中注册 `ExternalWarningLevel` 属性，并在 `addon.gypi` 中使用 `/external:anglebrackets` + `ExternalWarningLevel: TurnOffAllWarnings`。只对 `#include <...>` 的外部头（Node / V8）静音，不影响下游自己代码的警告；且通过 MSBuild 属性而非命令行 `/external:W0`，避免与默认的 `/external:W3` 冲突产生 `D9025`。
|
|
10
|
+
|
|
11
|
+
### 变更
|
|
12
|
+
|
|
13
|
+
- **package.json**
|
|
14
|
+
- `bin` 改为对象形式 `{ "nodejs-mobile-gyp": "./bin/node-gyp.js" }`，与上游命令名保持一致，避免与 `node-gyp` 包混淆。
|
|
15
|
+
- `engines.node` 提升到匹配依赖链（`make-fetch-happen`、`nopt`、`proc-log`、`which` 等）的最低版本要求。
|
|
16
|
+
- **README.md**：CLI 调用命令修正为 `npx @flun/nodejs-mobile-gyp`；补充 Node 版本要求；移除对内部 `Gyp` API 的示例承诺。
|
|
17
|
+
|
|
18
|
+
### 验证
|
|
19
|
+
|
|
20
|
+
- 在 Windows + VS2026 BuildTools + Python 3.14 + Node 26.8.1 环境下，`configure` + `build` 全流程通过，0 warning / 0 error。
|
|
21
|
+
- 生成的 `.node` 可被 Node 正常 `require()` 加载并调用。
|
|
22
|
+
|
|
23
|
+
## [1.0.1] - 2026-09-21
|
|
24
|
+
|
|
25
|
+
### 首发
|
|
26
|
+
|
|
27
|
+
- 发布 `@flun/nodejs-mobile-gyp`，基于 [nodejs-mobile-gyp](https://github.com/janeasystems/nodejs-mobile-gyp) 0.4.0 与上游 [node-gyp](https://github.com/nodejs/node-gyp) fork
|
|
28
|
+
- 用于为 nodejs-mobile 环境编译原生模块（Android / iOS）
|
|
29
|
+
|
|
30
|
+
### 代码风格
|
|
31
|
+
|
|
32
|
+
- 全量改造为 **ESM**（`package.json` 的 `type: "module"`）
|
|
33
|
+
- 导出方式统一为文件末尾 `export { ... }`
|
|
34
|
+
- 函数声明改为 `const xxx = (...) => {}`（`class` 保留）
|
|
35
|
+
- 注释全部中文化
|
|
36
|
+
|
|
37
|
+
### Windows 适配
|
|
38
|
+
|
|
39
|
+
- 支持 **Visual Studio 2026**（版本号 18，`versionYear=2026`，toolset `v145`）
|
|
40
|
+
- 强制走 **MSVC** 工具集，不再使用 ClangCL
|
|
41
|
+
- 关闭 **LTO**：`enable_lto` / `enable_thin_lto` 置 `false`，`lto_jobs` 置空
|
|
42
|
+
- 避免 `MSB8020: 无法找到 ClangCL 的生成工具`
|
|
43
|
+
- 避免 `LNK1117: 选项"opt:lldltojobs=2"中的语法错误`
|
|
44
|
+
- `configure` 阶段显式追加 `-Gmsvs_toolset=v145`
|
|
45
|
+
|
|
46
|
+
### 依赖升级
|
|
47
|
+
|
|
48
|
+
- `tar`: `^6.1.2` → `^7.5.22`
|
|
49
|
+
- `glob`: `^10.3.10` → `^13.0.6`
|
|
50
|
+
- `make-fetch-happen`: `^13.0.0` → `^16.0.1`
|
|
51
|
+
- 连带消除 `inflight`、`rimraf@3`、旧版 `glob` 等停更依赖
|
|
52
|
+
|
|
53
|
+
### 验证
|
|
54
|
+
|
|
55
|
+
- Windows + VS2026 BuildTools + Python 3.14 + Node 26.8.1 环境下，`configure` + `build` 全流程通过
|
|
56
|
+
- 生成的 `.node` 能被 Node 正常加载
|
package/README.md
CHANGED
|
@@ -1,252 +1,256 @@
|
|
|
1
|
-
# @flun/nodejs-mobile-gyp
|
|
2
|
-
|
|
3
|
-
移动端 Node.js 原生模块（Native Addon）的交叉编译工具。
|
|
4
|
-
|
|
5
|
-
用于为 [nodejs-mobile](https://github.com/nodejs-mobile/nodejs-mobile) 环境编译 C/C++ 原生模块，支持 Android 与 iOS 的交叉编译。
|
|
6
|
-
|
|
7
|
-
[`@flun/nodejs-mobile-react-native`](https://www.npmjs.com/package/@flun/nodejs-mobile-react-native) 在构建时会自动调用本包，无需手动安装。
|
|
8
|
-
|
|
9
|
-
本包是 [`nodejs-mobile-gyp`](https://github.com/nodejs-mobile/nodejs-mobile-gyp) 的 flun fork，后者又基于上游 [`node-gyp`](https://github.com/nodejs/node-gyp)。
|
|
10
|
-
|
|
11
|
-
- GitHub：https://github.com/OpenFlun/nodejs-mobile-gyp
|
|
12
|
-
- gitee: https://gitee.com/OpenFlun/nodejs-mobile-gyp
|
|
13
|
-
- npm：https://www.npmjs.com/package/@flun/nodejs-mobile-gyp
|
|
14
|
-
|
|
15
|
-
## 项目结构
|
|
16
|
-
|
|
17
|
-
```txt
|
|
18
|
-
@flun/nodejs-mobile-gyp/
|
|
19
|
-
│
|
|
20
|
-
├── bin/
|
|
21
|
-
│ └── node-gyp.js # CLI 入口（#!/usr/bin/env node），创建 Gyp 实例并依次执行命令队列
|
|
22
|
-
│
|
|
23
|
-
├── lib/ # 核心实现，全部为 ESM
|
|
24
|
-
│ ├── node-gyp.js # Gyp 主类：参数解析、命令分发、usage 生成
|
|
25
|
-
│ ├── build.js # build 命令：调用 make / msbuild 编译原生模块
|
|
26
|
-
│ ├── clean.js # clean 命令：删除 build 目录
|
|
27
|
-
│ ├── configure.js # configure 命令：下载 headers、生成 config.gypi 与工程文件
|
|
28
|
-
│ ├── rebuild.js # rebuild 命令：依次执行 clean + configure + build
|
|
29
|
-
│ ├── install.js # install 命令：下载并解压指定版本的 Node 开发文件
|
|
30
|
-
│ ├── remove.js # remove 命令：删除指定版本的 Node 开发文件
|
|
31
|
-
│ ├── list.js # list 命令：列出已安装的 Node 开发文件版本
|
|
32
|
-
│ ├── create-config-gypi.js # 生成 config.gypi；Windows 上强制 MSVC 工具集、关闭 LTO
|
|
33
|
-
│ ├── process-release.js # 解析下载 URL、本地目录名、headers 与 node.lib 地址
|
|
34
|
-
│ ├── download.js # 基于 make-fetch-happen 的 HTTP 下载与 CA 读取
|
|
35
|
-
│ ├── find-node-directory.js # 推断 Node 安装根目录（用于 AIX / zOS）
|
|
36
|
-
│ ├── find-python.js # PythonFinder 类：按顺序定位可用的 Python 3.6+
|
|
37
|
-
│ ├── find-visualstudio.js # VisualStudioFinder 类：定位可用的 VS 安装（含 VS2026）
|
|
38
|
-
│ ├── Find-VisualStudio.cs # PowerShell 调用的 C# 脚本，枚举 VS 安装信息
|
|
39
|
-
│ ├── log.js # Logger 类 + proc-log 包装，分级着色日志
|
|
40
|
-
│ └── util.js # 通用工具：execFile 包装、注册表读取、候选文件查找
|
|
41
|
-
│
|
|
42
|
-
├── gyp/ # 内置的 gyp 工具（Python）
|
|
43
|
-
│ ├── gyp # Python 启动脚本（Unix）
|
|
44
|
-
│ ├── gyp.bat # Python 启动脚本（Windows）
|
|
45
|
-
│ ├── gyp_main.py # gyp 主入口
|
|
46
|
-
│ ├── LICENSE # gyp 自身的许可证
|
|
47
|
-
│ ├── pylib/gyp/ # gyp 核心 Python 模块
|
|
48
|
-
│ │ ├── input.py # 解析 .gyp / .gypi 文件
|
|
49
|
-
│ │ ├── common.py # 通用工具
|
|
50
|
-
│ │ ├── MSVS*.py # MSBuild / VS 工程生成
|
|
51
|
-
│ │ ├── msvs_emulation.py # VS 配置模拟
|
|
52
|
-
│ │ ├── xcode*.py # Xcode 工程生成
|
|
53
|
-
│ │ ├── mac_tool.py # macOS 工具链
|
|
54
|
-
│ │ ├── win_tool.py # Windows 工具链
|
|
55
|
-
│ │ └── generator/ # 各类生成器后端（make / msvs / ninja / xcode / cmake ...）
|
|
56
|
-
│ ├── pylib/packaging/ # gyp 依赖的 Python packaging 库（vendored）
|
|
57
|
-
│ └── data/win/
|
|
58
|
-
│ └── large-pdb-shim.cc # Windows 大 PDB 兼容编译单元
|
|
59
|
-
│
|
|
60
|
-
├── src/
|
|
61
|
-
│ └── win_delay_load_hook.cc # Windows 加载延迟钩子（编译进每个原生模块）
|
|
62
|
-
│
|
|
63
|
-
├── addon.gypi # 所有原生模块共用的 gyp 配置
|
|
64
|
-
├── package.json # type: module，bin
|
|
65
|
-
├── LICENSE # 本包许可证（ISC）
|
|
66
|
-
├── README.md # 本文件
|
|
67
|
-
├── CHANGELOG.md # 版本变更记录
|
|
68
|
-
├── .gitignore # Git 忽略规则
|
|
69
|
-
├── .npmignore # npm 发布排除规则
|
|
70
|
-
├── .gitattributes # Git 换行符 / 二进制标记
|
|
71
|
-
└── macOS_Catalina_acid_test.sh # macOS Catalina 兼容性验证脚本（仅本地开发，不随包发布）
|
|
72
|
-
```
|
|
73
|
-
|
|
74
|
-
## 本 fork 的改动
|
|
75
|
-
|
|
76
|
-
本 fork 在功能上与原版 `nodejs-mobile-gyp` 一致，做了以下改造。
|
|
77
|
-
|
|
78
|
-
### 代码风格
|
|
79
|
-
|
|
80
|
-
| 项 | 原版 | 本 fork |
|
|
81
|
-
| -------- | ----------------------- | --------------------------------------------- |
|
|
82
|
-
| 模块系统 | CommonJS | **ESM**（`package.json` 的 `type: "module"`） |
|
|
83
|
-
| 导出方式 | 文件内 `module.exports` | **末尾统一 `export { ... }`** |
|
|
84
|
-
| 函数声明 | `async function xxx` | `const xxx = async () =>`（`class` 保留） |
|
|
85
|
-
| 注释 | 英文 | 中文 |
|
|
86
|
-
|
|
87
|
-
### 依赖升级
|
|
88
|
-
|
|
89
|
-
| 包 | 原版 | 本 fork | 原因 |
|
|
90
|
-
| ------------------- | ---------- | --------- | -------------------------------------------- |
|
|
91
|
-
| `tar` | `^6.1.2` | `^7.5.22` | 上游 v6 停更，有安全公告 |
|
|
92
|
-
| `glob` | `^10.3.10` | `^13.0.6` | 上游 v10 停更 |
|
|
93
|
-
| `make-fetch-happen` | `^13.0.0` | `^16.0.1` | 连带升级 `cacache`，去掉 `tar@6` / `glob@10` |
|
|
94
|
-
|
|
95
|
-
升级后依赖树干净，`npm audit` 0 vulnerabilities。
|
|
96
|
-
|
|
97
|
-
### Windows 构建适配
|
|
98
|
-
|
|
99
|
-
原版在 Windows 上默认走 ClangCL 工具集，且继承 Node 官方二进制的 LTO 配置。Node.js 24+ 官方二进制由 ClangCL + ThinLTO 编译，其 `common.gypi` 会在 `clang==1` 时把 MSBuild 工具集设为 `ClangCL`，并在 `enable_lto==true` / `enable_thin_lto==true` 时向链接器传入 `-flto=thin`、`/opt:lldltojobs` 等 Clang 专用参数。若用户本机没装 ClangCL，或用的是传统 MSVC 工具链，会报以下错误：
|
|
100
|
-
|
|
101
|
-
- `MSB8020: 无法找到 ClangCL 的生成工具`
|
|
102
|
-
- `LNK1117: 选项"opt:lldltojobs=2"中的语法错误`
|
|
103
|
-
|
|
104
|
-
本 fork 强制走 MSVC 工具集并关闭 LTO，避免上述报错。
|
|
105
|
-
|
|
106
|
-
### 具体改动清单
|
|
107
|
-
|
|
108
|
-
| 文件 | 改动 |
|
|
109
|
-
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
110
|
-
| `lib/create-config-gypi.js` | 生成 `config.gypi` 时，把 `clang` 置 0，`enable_lto` / `enable_thin_lto` 置 `'false'`，`lto_jobs` 置空。避免 `common.gypi` 把工具集改成 ClangCL、向 MSVC 传 LTO 参数 |
|
|
111
|
-
| `lib/configure.js` | 调用 gyp 时追加 `-Gmsvs_toolset=v145`，显式指定 VS2026 工具集 |
|
|
112
|
-
| `lib/find-visualstudio.js` | 支持 VS2026（版本号 18，`versionYear=2026`，toolset `v145`） |
|
|
113
|
-
|
|
114
|
-
###
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
|
179
|
-
|
|
|
180
|
-
| `
|
|
181
|
-
| `
|
|
182
|
-
| `
|
|
183
|
-
| `
|
|
184
|
-
| `
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
|
192
|
-
|
|
|
193
|
-
|
|
|
194
|
-
|
|
|
195
|
-
|
|
|
196
|
-
| `--
|
|
197
|
-
|
|
|
198
|
-
| `--
|
|
199
|
-
| `--
|
|
200
|
-
| `--
|
|
201
|
-
| `--
|
|
202
|
-
| `--
|
|
203
|
-
| `--
|
|
204
|
-
| `--
|
|
205
|
-
| `--
|
|
206
|
-
| `--
|
|
207
|
-
| `--
|
|
208
|
-
| `--
|
|
209
|
-
| `--
|
|
210
|
-
| `--
|
|
211
|
-
| `--
|
|
212
|
-
| `--
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
-
|
|
249
|
-
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
|
|
1
|
+
# @flun/nodejs-mobile-gyp
|
|
2
|
+
|
|
3
|
+
移动端 Node.js 原生模块（Native Addon）的交叉编译工具。
|
|
4
|
+
|
|
5
|
+
用于为 [nodejs-mobile](https://github.com/nodejs-mobile/nodejs-mobile) 环境编译 C/C++ 原生模块，支持 Android 与 iOS 的交叉编译。
|
|
6
|
+
|
|
7
|
+
[`@flun/nodejs-mobile-react-native`](https://www.npmjs.com/package/@flun/nodejs-mobile-react-native) 在构建时会自动调用本包，无需手动安装。
|
|
8
|
+
|
|
9
|
+
本包是 [`nodejs-mobile-gyp`](https://github.com/nodejs-mobile/nodejs-mobile-gyp) 的 flun fork，后者又基于上游 [`node-gyp`](https://github.com/nodejs/node-gyp)。
|
|
10
|
+
|
|
11
|
+
- GitHub：https://github.com/OpenFlun/nodejs-mobile-gyp
|
|
12
|
+
- gitee: https://gitee.com/OpenFlun/nodejs-mobile-gyp
|
|
13
|
+
- npm：https://www.npmjs.com/package/@flun/nodejs-mobile-gyp
|
|
14
|
+
|
|
15
|
+
## 项目结构
|
|
16
|
+
|
|
17
|
+
```txt
|
|
18
|
+
@flun/nodejs-mobile-gyp/
|
|
19
|
+
│
|
|
20
|
+
├── bin/
|
|
21
|
+
│ └── node-gyp.js # CLI 入口（#!/usr/bin/env node），创建 Gyp 实例并依次执行命令队列
|
|
22
|
+
│
|
|
23
|
+
├── lib/ # 核心实现，全部为 ESM
|
|
24
|
+
│ ├── node-gyp.js # Gyp 主类：参数解析、命令分发、usage 生成
|
|
25
|
+
│ ├── build.js # build 命令：调用 make / msbuild 编译原生模块
|
|
26
|
+
│ ├── clean.js # clean 命令：删除 build 目录
|
|
27
|
+
│ ├── configure.js # configure 命令：下载 headers、生成 config.gypi 与工程文件
|
|
28
|
+
│ ├── rebuild.js # rebuild 命令：依次执行 clean + configure + build
|
|
29
|
+
│ ├── install.js # install 命令：下载并解压指定版本的 Node 开发文件
|
|
30
|
+
│ ├── remove.js # remove 命令：删除指定版本的 Node 开发文件
|
|
31
|
+
│ ├── list.js # list 命令：列出已安装的 Node 开发文件版本
|
|
32
|
+
│ ├── create-config-gypi.js # 生成 config.gypi；Windows 上强制 MSVC 工具集、关闭 LTO
|
|
33
|
+
│ ├── process-release.js # 解析下载 URL、本地目录名、headers 与 node.lib 地址
|
|
34
|
+
│ ├── download.js # 基于 make-fetch-happen 的 HTTP 下载与 CA 读取
|
|
35
|
+
│ ├── find-node-directory.js # 推断 Node 安装根目录（用于 AIX / zOS）
|
|
36
|
+
│ ├── find-python.js # PythonFinder 类：按顺序定位可用的 Python 3.6+
|
|
37
|
+
│ ├── find-visualstudio.js # VisualStudioFinder 类：定位可用的 VS 安装（含 VS2026）
|
|
38
|
+
│ ├── Find-VisualStudio.cs # PowerShell 调用的 C# 脚本，枚举 VS 安装信息
|
|
39
|
+
│ ├── log.js # Logger 类 + proc-log 包装，分级着色日志
|
|
40
|
+
│ └── util.js # 通用工具：execFile 包装、注册表读取、候选文件查找
|
|
41
|
+
│
|
|
42
|
+
├── gyp/ # 内置的 gyp 工具（Python）
|
|
43
|
+
│ ├── gyp # Python 启动脚本（Unix）
|
|
44
|
+
│ ├── gyp.bat # Python 启动脚本（Windows）
|
|
45
|
+
│ ├── gyp_main.py # gyp 主入口
|
|
46
|
+
│ ├── LICENSE # gyp 自身的许可证
|
|
47
|
+
│ ├── pylib/gyp/ # gyp 核心 Python 模块
|
|
48
|
+
│ │ ├── input.py # 解析 .gyp / .gypi 文件
|
|
49
|
+
│ │ ├── common.py # 通用工具
|
|
50
|
+
│ │ ├── MSVS*.py # MSBuild / VS 工程生成
|
|
51
|
+
│ │ ├── msvs_emulation.py # VS 配置模拟
|
|
52
|
+
│ │ ├── xcode*.py # Xcode 工程生成
|
|
53
|
+
│ │ ├── mac_tool.py # macOS 工具链
|
|
54
|
+
│ │ ├── win_tool.py # Windows 工具链
|
|
55
|
+
│ │ └── generator/ # 各类生成器后端（make / msvs / ninja / xcode / cmake ...）
|
|
56
|
+
│ ├── pylib/packaging/ # gyp 依赖的 Python packaging 库（vendored）
|
|
57
|
+
│ └── data/win/
|
|
58
|
+
│ └── large-pdb-shim.cc # Windows 大 PDB 兼容编译单元
|
|
59
|
+
│
|
|
60
|
+
├── src/
|
|
61
|
+
│ └── win_delay_load_hook.cc # Windows 加载延迟钩子（编译进每个原生模块）
|
|
62
|
+
│
|
|
63
|
+
├── addon.gypi # 所有原生模块共用的 gyp 配置
|
|
64
|
+
├── package.json # type: module，bin 命令名为 nodejs-mobile-gyp
|
|
65
|
+
├── LICENSE # 本包许可证（ISC）
|
|
66
|
+
├── README.md # 本文件
|
|
67
|
+
├── CHANGELOG.md # 版本变更记录
|
|
68
|
+
├── .gitignore # Git 忽略规则
|
|
69
|
+
├── .npmignore # npm 发布排除规则
|
|
70
|
+
├── .gitattributes # Git 换行符 / 二进制标记
|
|
71
|
+
└── macOS_Catalina_acid_test.sh # macOS Catalina 兼容性验证脚本（仅本地开发，不随包发布）
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
## 本 fork 的改动
|
|
75
|
+
|
|
76
|
+
本 fork 在功能上与原版 `nodejs-mobile-gyp` 一致，做了以下改造。
|
|
77
|
+
|
|
78
|
+
### 代码风格
|
|
79
|
+
|
|
80
|
+
| 项 | 原版 | 本 fork |
|
|
81
|
+
| -------- | ----------------------- | --------------------------------------------- |
|
|
82
|
+
| 模块系统 | CommonJS | **ESM**（`package.json` 的 `type: "module"`） |
|
|
83
|
+
| 导出方式 | 文件内 `module.exports` | **末尾统一 `export { ... }`** |
|
|
84
|
+
| 函数声明 | `async function xxx` | `const xxx = async () =>`（`class` 保留） |
|
|
85
|
+
| 注释 | 英文 | 中文 |
|
|
86
|
+
|
|
87
|
+
### 依赖升级
|
|
88
|
+
|
|
89
|
+
| 包 | 原版 | 本 fork | 原因 |
|
|
90
|
+
| ------------------- | ---------- | --------- | -------------------------------------------- |
|
|
91
|
+
| `tar` | `^6.1.2` | `^7.5.22` | 上游 v6 停更，有安全公告 |
|
|
92
|
+
| `glob` | `^10.3.10` | `^13.0.6` | 上游 v10 停更 |
|
|
93
|
+
| `make-fetch-happen` | `^13.0.0` | `^16.0.1` | 连带升级 `cacache`，去掉 `tar@6` / `glob@10` |
|
|
94
|
+
|
|
95
|
+
升级后依赖树干净，`npm audit` 0 vulnerabilities。
|
|
96
|
+
|
|
97
|
+
### Windows 构建适配
|
|
98
|
+
|
|
99
|
+
原版在 Windows 上默认走 ClangCL 工具集，且继承 Node 官方二进制的 LTO 配置。Node.js 24+ 官方二进制由 ClangCL + ThinLTO 编译，其 `common.gypi` 会在 `clang==1` 时把 MSBuild 工具集设为 `ClangCL`，并在 `enable_lto==true` / `enable_thin_lto==true` 时向链接器传入 `-flto=thin`、`/opt:lldltojobs` 等 Clang 专用参数。若用户本机没装 ClangCL，或用的是传统 MSVC 工具链，会报以下错误：
|
|
100
|
+
|
|
101
|
+
- `MSB8020: 无法找到 ClangCL 的生成工具`
|
|
102
|
+
- `LNK1117: 选项"opt:lldltojobs=2"中的语法错误`
|
|
103
|
+
|
|
104
|
+
本 fork 强制走 MSVC 工具集并关闭 LTO，避免上述报错。
|
|
105
|
+
|
|
106
|
+
### 具体改动清单
|
|
107
|
+
|
|
108
|
+
| 文件 | 改动 |
|
|
109
|
+
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
110
|
+
| `lib/create-config-gypi.js` | 生成 `config.gypi` 时，把 `clang` 置 0，`enable_lto` / `enable_thin_lto` 置 `'false'`，`lto_jobs` 置空。避免 `common.gypi` 把工具集改成 ClangCL、向 MSVC 传 LTO 参数 |
|
|
111
|
+
| `lib/configure.js` | 调用 gyp 时追加 `-Gmsvs_toolset=v145`，显式指定 VS2026 工具集 |
|
|
112
|
+
| `lib/find-visualstudio.js` | 支持 VS2026（版本号 18，`versionYear=2026`，toolset `v145`） |
|
|
113
|
+
|
|
114
|
+
### 兼容性与健壮性修复
|
|
115
|
+
|
|
116
|
+
- **`proc-log` 新版本兼容**：新版 `proc-log` 的日志级别函数与 `pause` / `resume` 挂在默认导出的 `log` 对象下，而非包顶层。本 fork 已按此调整 `lib/log.js`，否则在 `configure` 阶段会直接抛出 `TypeError`。
|
|
117
|
+
- **弃用 API 清理**：`lib/process-release.js` 不再使用 `url.resolve()` / `url.parse()`，改用 WHATWG `URL`，消除新版 Node 的 `DEP0169` 弃用警告。
|
|
118
|
+
- **外部头文件警告抑制**：Windows 下，Node 官方 V8 头文件会触发 `warning C4018` 等噪音。本 fork 通过 `ExternalWarningLevel` 属性 + `/external:anglebrackets`，只对 `#include <...>` 引入的 Node / V8 头文件静音，**不影响下游自己代码的警告**；同时避免与 MSBuild 默认设置冲突而产生的命令行警告。
|
|
119
|
+
- **依赖脚本放行**：针对新版 npm 默认禁止依赖执行安装脚本的行为，`package.json` 显式声明 `allowScripts`，保证安装脚本正常执行。
|
|
120
|
+
|
|
121
|
+
### 迁移踩过的坑
|
|
122
|
+
|
|
123
|
+
1. **`graceful-fs` 是 CJS，命名导入会失败**
|
|
124
|
+
写成 `import gracefulFs from 'graceful-fs'`，再从 default 解构 `const { openSync, closeSync } = gracefulFs`。
|
|
125
|
+
|
|
126
|
+
2. **`tar@7` 没有 default export**
|
|
127
|
+
写成 `import * as tar from 'tar'`。
|
|
128
|
+
|
|
129
|
+
3. **`proc-log` 的解构**
|
|
130
|
+
`import procLog from 'proc-log'`，再把需要的函数从 default 里解构后统一导出。
|
|
131
|
+
|
|
132
|
+
4. **PowerShell 写文件会加 BOM**
|
|
133
|
+
`Set-Content -Encoding UTF8` 会写入 `\uFEFF`，导致 gyp 的 `eval()` 报 `SyntaxError: invalid non-printable character U+FEFF`。写 `binding.gyp` 等交给 Python eval 的文件时，用 `[System.IO.File]::WriteAllText` + `New-Object System.Text.UTF8Encoding $false`。
|
|
134
|
+
|
|
135
|
+
5. **ESM 不支持动态 `require('./' + command)`**
|
|
136
|
+
`lib/node-gyp.js` 原本用 `require('./' + command)` 动态加载命令模块，ESM 下改为在顶部静态 import 所有命令，再用静态映射表组装 `this.commands`。
|
|
137
|
+
|
|
138
|
+
6. **`__dirname` / `__filename` 在 ESM 中不存在**
|
|
139
|
+
用 `fileURLToPath(import.meta.url)` 重建。
|
|
140
|
+
|
|
141
|
+
7. **非 Windows 平台不引入 `find-visualstudio.js`**
|
|
142
|
+
该模块依赖 Windows 专属的 `path.win32` 和注册表操作，保持原版的"仅在 Windows 上条件加载"逻辑。
|
|
143
|
+
|
|
144
|
+
## 安装
|
|
145
|
+
|
|
146
|
+
```bash
|
|
147
|
+
npm install @flun/nodejs-mobile-gyp
|
|
148
|
+
```
|
|
149
|
+
|
|
150
|
+
通常你不需要手动安装本包——它由 [`@flun/nodejs-mobile-react-native`](https://www.npmjs.com/package/@flun/nodejs-mobile-react-native) 在编译原生模块时自动调用。
|
|
151
|
+
|
|
152
|
+
> **Node 版本要求**：本 fork 的依赖链（`make-fetch-happen`、`nopt`、`proc-log`、`which` 等）已升级到较新版本，要求比原版 `nodejs-mobile-gyp` 更高的 Node。具体最低版本见 `package.json` 的 `engines.node` 字段。若你的项目仍在使用较旧的 Node，请改用原版 `nodejs-mobile-gyp`。
|
|
153
|
+
|
|
154
|
+
## 使用
|
|
155
|
+
|
|
156
|
+
### 命令行
|
|
157
|
+
|
|
158
|
+
```bash
|
|
159
|
+
npx @flun/nodejs-mobile-gyp <command> [options]
|
|
160
|
+
```
|
|
161
|
+
|
|
162
|
+
或在 `package.json` 的 `scripts` 中调用：
|
|
163
|
+
|
|
164
|
+
```json
|
|
165
|
+
{
|
|
166
|
+
"scripts": {
|
|
167
|
+
"build-addon": "nodejs-mobile-gyp rebuild"
|
|
168
|
+
}
|
|
169
|
+
}
|
|
170
|
+
```
|
|
171
|
+
|
|
172
|
+
### 从 Node.js 代码调用
|
|
173
|
+
|
|
174
|
+
本包主要作为 CLI 工具使用，推荐通过 spawn / execFile 调用其命令行入口。包本身也导出了 Gyp 类，但属于内部实现，接口可能随版本变化，不建议直接在代码中依赖。
|
|
175
|
+
|
|
176
|
+
## 命令
|
|
177
|
+
|
|
178
|
+
| 命令 | 说明 |
|
|
179
|
+
| ----------- | ---------------------------------------- |
|
|
180
|
+
| `help` | 显示帮助 |
|
|
181
|
+
| `build` | 调用 `make` / `msbuild.exe` 编译原生模块 |
|
|
182
|
+
| `clean` | 删除 `build` 目录（若存在） |
|
|
183
|
+
| `configure` | 为当前平台生成工程构建文件 |
|
|
184
|
+
| `rebuild` | 依次执行 `clean` → `configure` → `build` |
|
|
185
|
+
| `install` | 为指定版本安装 Node.js 头文件 |
|
|
186
|
+
| `list` | 列出已安装的 Node.js 头文件版本 |
|
|
187
|
+
| `remove` | 删除指定版本的 Node.js 头文件 |
|
|
188
|
+
|
|
189
|
+
## 命令选项
|
|
190
|
+
|
|
191
|
+
| 选项 | 说明 |
|
|
192
|
+
| --------------------------------- | -------------------------------------------------- |
|
|
193
|
+
| `-v`, `--version` | 打印本包版本号 |
|
|
194
|
+
| `-j n`, `--jobs n` | 并行运行 `make`；`max` 表示使用所有 CPU 核心 |
|
|
195
|
+
| `--target=v6.2.1` | 目标 Node.js 版本（默认 `process.version`） |
|
|
196
|
+
| `--silly`, `--loglevel=silly` | 输出全部进度日志 |
|
|
197
|
+
| `--verbose`, `--loglevel=verbose` | 输出大部分进度日志 |
|
|
198
|
+
| `--silent`, `--loglevel=silent` | 不输出任何日志 |
|
|
199
|
+
| `debug`, `--debug` | 生成 Debug 构建（默认 Release） |
|
|
200
|
+
| `--release`, `--no-debug` | 生成 Release 构建 |
|
|
201
|
+
| `-C $dir`, `--directory=$dir` | 在指定目录运行命令 |
|
|
202
|
+
| `--make=$make` | 覆盖 `make` 命令（如 `gmake`） |
|
|
203
|
+
| `--thin=yes` | 启用 thin 静态库 |
|
|
204
|
+
| `--arch=$arch` | 目标架构（如 `ia32`） |
|
|
205
|
+
| `--tarball=$path` | 从本地 tarball 获取头文件 |
|
|
206
|
+
| `--devdir=$path` | SDK 下载目录（默认为系统缓存目录） |
|
|
207
|
+
| `--ensure` | 已存在的头文件不重装 |
|
|
208
|
+
| `--dist-url=$url` | 从自定义 URL 下载头文件 tarball |
|
|
209
|
+
| `--proxy=$url` | 下载时使用 HTTP(S) 代理 |
|
|
210
|
+
| `--noproxy=$urls` | 下载时忽略代理的 URL 列表 |
|
|
211
|
+
| `--cafile=$cafile` | 覆盖默认 CA 链（用于下载 tarball） |
|
|
212
|
+
| `--nodedir=$path` | 指定 Node 源码路径 |
|
|
213
|
+
| `--python=$path` | 指定 Python 二进制路径 |
|
|
214
|
+
| `--msvs_version=$version` | 指定 Visual Studio 版本（仅 Windows） |
|
|
215
|
+
| `--solution=$solution` | 指定 Visual Studio Solution 版本（仅 Windows） |
|
|
216
|
+
| `--force-process-config` | 强制用运行时的 `process.config` 生成 `config.gypi` |
|
|
217
|
+
|
|
218
|
+
## 配置
|
|
219
|
+
|
|
220
|
+
### 环境变量
|
|
221
|
+
|
|
222
|
+
上表中的所有命令选项，都可以用 `npm_config_OPTION_NAME` 形式的**环境变量**来设置（选项名中的 `-` 替换为 `_`）。
|
|
223
|
+
|
|
224
|
+
例如，把 `devdir` 设为 `/tmp/.gyp`：
|
|
225
|
+
|
|
226
|
+
Unix：
|
|
227
|
+
```bash
|
|
228
|
+
export npm_config_devdir=/tmp/.gyp
|
|
229
|
+
```
|
|
230
|
+
|
|
231
|
+
Windows：
|
|
232
|
+
```console
|
|
233
|
+
set npm_config_devdir=c:\temp\.gyp
|
|
234
|
+
```
|
|
235
|
+
|
|
236
|
+
### npm 配置（npm v9 之前）
|
|
237
|
+
|
|
238
|
+
用 `OPTION_NAME` 形式：
|
|
239
|
+
|
|
240
|
+
```bash
|
|
241
|
+
npm config set [--global] devdir /tmp/.gyp
|
|
242
|
+
```
|
|
243
|
+
|
|
244
|
+
**注意**：通过 `npm config` 设置的配置，只在本包 **由 npm 调用时**生效，直接运行 `nodejs-mobile-gyp` 不生效。
|
|
245
|
+
|
|
246
|
+
## 上游参考
|
|
247
|
+
|
|
248
|
+
本包是 `node-gyp` 的 fork。上游完整文档（含更多高级用法、`binding.gyp` 语法、跨平台细节）请见：
|
|
249
|
+
|
|
250
|
+
- [nodejs/node-gyp README](https://github.com/nodejs/node-gyp#readme)
|
|
251
|
+
- [gyp 用户文档](https://gyp.gsrc.io/docs/UserDocumentation.md)
|
|
252
|
+
- [gyp 输入格式参考](https://gyp.gsrc.io/docs/InputFormatReference.md)
|
|
253
|
+
|
|
254
|
+
## 许可
|
|
255
|
+
|
|
256
|
+
ISC
|