@flun/nodejs-mobile-gyp 1.0.1

package/lib/node-gyp.js

@@ -0,0 +1,201 @@
+import path from 'path'
+import nopt from 'nopt'
+import * as log from './log.js'
+import childProcess from 'child_process'
+import { EventEmitter } from 'events'
+import { readFileSync } from 'fs'
+import { fileURLToPath } from 'url'
+
+import { build } from './build.js'
+import { clean } from './clean.js'
+import { configure } from './configure.js'
+import { rebuild } from './rebuild.js'
+import { install } from './install.js'
+import { list } from './list.js'
+import { remove } from './remove.js'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+
+// 命令名到实现函数的静态映射（ESM 不支持动态 require）
+const commandModules = {
+  build,
+  clean,
+  configure,
+  rebuild,
+  install,
+  list,
+  remove
+}
+const commands = Object.keys(commandModules)
+
+/**
+ * node-gyp 主类：解析参数、分发命令、生成 usage
+ */
+class Gyp extends EventEmitter {
+  /**
+   * 导出 package.json 内容
+   */
+  package = JSON.parse(readFileSync(path.resolve(__dirname, '../package.json'), 'utf8'))
+
+  /**
+   * nopt 配置定义
+   */
+  configDefs = {
+    help: Boolean, // 各处
+    arch: String, // 'configure'
+    cafile: String, // 'install'
+    debug: Boolean, // 'build'
+    directory: String, // bin
+    make: String, // 'build'
+    'msvs-version': String, // 'configure'
+    ensure: Boolean, // 'install'
+    solution: String, // 'build'（仅 Windows）
+    proxy: String, // 'install'
+    noproxy: String, // 'install'
+    devdir: String, // 各处
+    nodedir: String, // 'configure'
+    loglevel: String, // 各处
+    python: String, // 'configure'
+    'dist-url': String, // 'install'
+    tarball: String, // 'install'
+    jobs: String, // 'build'
+    thin: String, // 'configure'
+    'force-process-config': Boolean // 'configure'
+  }
+
+  /**
+   * nopt 简写
+   */
+  shorthands = {
+    release: '--no-debug',
+    C: '--directory',
+    debug: '--debug',
+    j: '--jobs',
+    silly: '--loglevel=silly',
+    verbose: '--loglevel=verbose',
+    silent: '--loglevel=silent'
+  }
+
+  /**
+   * 暴露命令别名供 bin 文件使用
+   */
+  aliases = {
+    ls: 'list',
+    rm: 'remove'
+  }
+
+  constructor (...args) {
+    super(...args)
+
+    this.devDir = ''
+
+    this.commands = commands.reduce((acc, command) => {
+      acc[command] = (argv) => commandModules[command](this, argv)
+      return acc
+    }, {})
+
+    Object.defineProperty(this, 'version', {
+      enumerable: true,
+      get: function () { return this.package.version }
+    })
+  }
+
+  /**
+   * 解析传入的 argv 数组，设置 'opts'、'argv' 和 'command' 属性
+   */
+  parseArgv (argv) {
+    this.opts = nopt(this.configDefs, this.shorthands, argv)
+    this.argv = this.opts.argv.remain.slice()
+
+    const commands = this.todo = []
+
+    // 创建一份把别名映射后的 argv 副本
+    argv = this.argv.map((arg) => {
+    // 是别名吗？
+      if (arg in this.aliases) {
+        arg = this.aliases[arg]
+      }
+      return arg
+    })
+
+    // 把映射后的参数处理成 "command" 对象（name 和 args 属性）
+    argv.slice().forEach((arg) => {
+      if (arg in this.commands) {
+        const args = argv.splice(0, argv.indexOf(arg))
+        argv.shift()
+        if (commands.length > 0) {
+          commands[commands.length - 1].args = args
+        }
+        commands.push({ name: arg, args: [] })
+      }
+    })
+    if (commands.length > 0) {
+      commands[commands.length - 1].args = argv.splice(0)
+    }
+
+    // 支持从 npm 继承配置环境变量
+    const npmConfigPrefix = 'npm_config_'
+    Object.keys(process.env).forEach((name) => {
+      if (name.indexOf(npmConfigPrefix) !== 0) {
+        return
+      }
+      const val = process.env[name]
+      if (name === npmConfigPrefix + 'loglevel') {
+        log.logger.level = val
+      } else {
+      // 把用户定义的选项加入配置
+        name = name.substring(npmConfigPrefix.length)
+        // gyp@741b7f1 遇到零长度选项会死循环，确保过滤掉
+        if (name) {
+        // 把 force_process_config 这类名字转成 force-process-config
+          if (name.includes('_')) {
+            name = name.replace(/_/g, '-')
+          }
+          this.opts[name] = val
+        }
+      }
+    })
+
+    if (this.opts.loglevel) {
+      log.logger.level = this.opts.loglevel
+    }
+    log.resume()
+  }
+
+  /**
+   * 启动子进程并发出 'spawn' 事件
+   */
+  spawn (command, args, opts) {
+    if (!opts) {
+      opts = {}
+    }
+    if (!opts.silent && !opts.stdio) {
+      opts.stdio = [0, 1, 2]
+    }
+    const cp = childProcess.spawn(command, args, opts)
+    log.info('spawn', command)
+    log.info('spawn args', args)
+    return cp
+  }
+
+  /**
+   * 返回 node-gyp 的用法说明
+   */
+  usage () {
+    return [
+      '',
+      '  Usage: node-gyp <command> [options]',
+      '',
+      '  where <command> is one of:',
+      commands.map((c) => '    - ' + c + ' - ' + commandModules[c].usage).join('\n'),
+      '',
+      'node-gyp@' + this.version + '  ' + path.resolve(__dirname, '..'),
+      'node@' + process.versions.node
+    ].join('\n')
+  }
+}
+
+const createGyp = () => new Gyp()
+
+export default createGyp
+export { Gyp }

package/lib/process-release.js

@@ -0,0 +1,144 @@
+/* eslint-disable n/no-deprecated-api */
+
+import semver from 'semver'
+import url from 'url'
+import path from 'path'
+import * as log from './log.js'
+
+// 开始发布 -headers.tar.gz 的版本
+const headersTarballRange = '>= 3.0.0 || ~0.12.10 || ~0.10.42'
+const bitsre = /\/win-(x86|x64|arm64)\//
+const bitsreV3 = /\/win-(x86|ia32|x64)\// // io.js v3.x.x 里用的是 "ia32"，本应是 "x86"
+
+/**
+ * 归一化路径：统一分隔符为 /
+ */
+const normalizePath = (p) => path.normalize(p).replace(/\\/g, '/')
+
+/**
+ * 根据名称、基础 URL、架构、主版本号解析 lib 下载地址
+ */
+const resolveLibUrl = (name, defaultUrl, arch, versionMajor) => {
+  const base = url.resolve(defaultUrl, './')
+  const hasLibUrl = bitsre.test(defaultUrl) || (versionMajor === 3 && bitsreV3.test(defaultUrl))
+
+  if (!hasLibUrl) {
+    // 假设传入的是 baseUrl
+    if (versionMajor >= 1) {
+      return url.resolve(base, 'win-' + arch + '/' + name + '.lib')
+    }
+    // io.js@1.0.0 之前，32 位 node.lib 在根目录，64 位在 /x64/
+    return url.resolve(base, (arch === 'x86' ? '' : arch + '/') + name + '.lib')
+  }
+
+  // 否则传入的已经是 .lib 地址，只需保证架构正确
+  return defaultUrl.replace(versionMajor === 3 ? bitsreV3 : bitsre, '/win-' + arch + '/')
+}
+
+/**
+ * 负责确定下载 URL、本地目录和文件名。
+ * 输入来自命令行开关（--target、--dist-url）、process.version 和 process.release。
+ */
+const processRelease = (argv, gyp, defaultVersion, defaultRelease) => {
+  let version = (semver.valid(argv[0]) && argv[0]) || gyp.opts.target || defaultVersion
+  const versionSemver = semver.parse(version)
+  let overrideDistUrl = gyp.opts['dist-url'] || gyp.opts.disturl
+  let isNamedForLegacyIojs
+  let name
+  let distBaseUrl
+  let baseUrl
+  let libUrl32
+  let libUrl64
+  let libUrlArm64
+  let tarballUrl
+  let canGetHeaders
+
+  if (!versionSemver) {
+    // 不是合法 semver，只能原样返回 version
+    return { version }
+  }
+  // 把 version 拍平为字符串
+  version = versionSemver.version
+
+  // defaultVersion 来自 process.version，应当是合法 semver
+  const isDefaultVersion = version === semver.parse(defaultVersion).version
+
+  // 用了 --target=x.y.z 就不能用 process.release
+  if (!isDefaultVersion) {
+    defaultRelease = null
+  }
+
+  if (defaultRelease) {
+    // v3 起有 process.release
+    name = defaultRelease.name.replace(/io\.js/, 'iojs') // 去掉 '.' 以便目录命名
+  } else {
+    // 老版本 Node 或自定义 --target
+    // semver.satisfies() 不支持预发布标签，因此直接判断主版本
+    isNamedForLegacyIojs = versionSemver.major >= 1 && versionSemver.major < 4
+    // isNamedForLegacyIojs 是为了支持 Electron < 4（特别是 Electron 3）
+    // 早期逻辑用它保证 iojs 版本下载 "iojs"，Node 版本下载 "node"。
+    // 但该逻辑过宽，导致 electron@3 的发布物命名为 "iojs" 才能让 node-gyp 正常工作。
+    // Electron@3 EOL 之后（2019 年底）应移除这个 hack。
+    name = isNamedForLegacyIojs ? 'iojs' : 'node'
+  }
+
+  // 检查 nvm.sh 标准镜像环境变量
+  if (!overrideDistUrl && process.env.NODEJS_ORG_MIRROR) {
+    overrideDistUrl = process.env.NODEJS_ORG_MIRROR
+  }
+
+  if (overrideDistUrl) {
+    log.verbose('download', 'using dist-url', overrideDistUrl)
+  }
+
+  if (overrideDistUrl) {
+    distBaseUrl = overrideDistUrl.replace(/\/+$/, '')
+  } else {
+    distBaseUrl = 'https://nodejs.org/dist'
+  }
+  distBaseUrl += '/v' + version + '/'
+
+  // 新式：基于 process.release，大部分数据已有
+  if (defaultRelease && defaultRelease.headersUrl && !overrideDistUrl) {
+    baseUrl = url.resolve(defaultRelease.headersUrl, './')
+    libUrl32 = resolveLibUrl(name, defaultRelease.libUrl || baseUrl || distBaseUrl, 'x86', versionSemver.major)
+    libUrl64 = resolveLibUrl(name, defaultRelease.libUrl || baseUrl || distBaseUrl, 'x64', versionSemver.major)
+    libUrlArm64 = resolveLibUrl(name, defaultRelease.libUrl || baseUrl || distBaseUrl, 'arm64', versionSemver.major)
+    tarballUrl = defaultRelease.headersUrl
+  } else {
+    // 没有 process.release 的老版本，需要做很多假设；
+    // 另外 --target=x.y.z 时也无法使用当前 process.release
+    baseUrl = distBaseUrl
+    libUrl32 = resolveLibUrl(name, baseUrl, 'x86', versionSemver.major)
+    libUrl64 = resolveLibUrl(name, baseUrl, 'x64', versionSemver.major)
+    libUrlArm64 = resolveLibUrl(name, baseUrl, 'arm64', versionSemver.major)
+
+    // 大胆假设：任何版本号 >3.0.0 的版本，其 dist 目录都有 *-headers.tar.gz
+    canGetHeaders = semver.satisfies(versionSemver, headersTarballRange)
+    tarballUrl = url.resolve(baseUrl, name + '-v' + version + (canGetHeaders ? '-headers' : '') + '.tar.gz')
+  }
+
+  return {
+    version,
+    semver: versionSemver,
+    name,
+    baseUrl,
+    tarballUrl,
+    shasumsUrl: url.resolve(baseUrl, 'SHASUMS256.txt'),
+    versionDir: (name !== 'node' ? name + '-' : '') + version,
+    ia32: {
+      libUrl: libUrl32,
+      libPath: normalizePath(path.relative(url.parse(baseUrl).path, url.parse(libUrl32).path))
+    },
+    x64: {
+      libUrl: libUrl64,
+      libPath: normalizePath(path.relative(url.parse(baseUrl).path, url.parse(libUrl64).path))
+    },
+    arm64: {
+      libUrl: libUrlArm64,
+      libPath: normalizePath(path.relative(url.parse(baseUrl).path, url.parse(libUrlArm64).path))
+    }
+  }
+}
+
+export { processRelease }

package/lib/rebuild.js

@@ -0,0 +1,14 @@
+/**
+ * 依次执行 clean、configure、build
+ */
+const rebuild = async (gyp, argv) => {
+  gyp.todo.push(
+    { name: 'clean', args: [] }
+    , { name: 'configure', args: argv }
+    , { name: 'build', args: [] }
+  )
+}
+
+rebuild.usage = 'Runs "clean", "configure" and "build" all at once'
+
+export { rebuild }

package/lib/remove.js

@@ -0,0 +1,47 @@
+import gracefulFs from 'graceful-fs'
+import path from 'path'
+import * as log from './log.js'
+import semver from 'semver'
+
+const fs = gracefulFs.promises
+
+/**
+ * 删除指定版本的 Node 开发文件
+ */
+const remove = async (gyp, argv) => {
+  const devDir = gyp.devDir
+  log.verbose('remove', 'using node-gyp dir:', devDir)
+
+  // 获取用户指定的版本号
+  let version = argv[0] || gyp.opts.target
+  log.verbose('remove', 'removing target version:', version)
+
+  if (!version) {
+    throw new Error('You must specify a version number to remove. Ex: "' + process.version + '"')
+  }
+
+  const versionSemver = semver.parse(version)
+  if (versionSemver) {
+    // 把版本数组拍平为字符串
+    version = versionSemver.version
+  }
+
+  const versionPath = path.resolve(gyp.devDir, version)
+  log.verbose('remove', 'removing development files for version:', version)
+
+  // 先检查是否安装过
+  try {
+    await fs.stat(versionPath)
+  } catch (err) {
+    if (err.code === 'ENOENT') {
+      return 'version was already uninstalled: ' + version
+    }
+    throw err
+  }
+
+  await fs.rm(versionPath, { recursive: true, force: true })
+}
+
+remove.usage = 'Removes the node development files for the specified version'
+
+export { remove }

package/lib/util.js

@@ -0,0 +1,83 @@
+import cp from 'child_process'
+import path from 'path'
+import gracefulFs from 'graceful-fs'
+import * as log from './log.js'
+
+const { openSync, closeSync } = gracefulFs
+
+/**
+ * 执行外部命令并返回 [err, stdout, stderr]
+ */
+const execFile = async (...args) => new Promise((resolve) => {
+  const child = cp.execFile(...args, (...a) => resolve(a))
+  child.stdin.end()
+})
+
+/**
+ * 读取 Windows 注册表指定键的值
+ */
+const regGetValue = async (key, value, addOpts) => {
+  const outReValue = value.replace(/\W/g, '.')
+  const outRe = new RegExp(`^\\s+${outReValue}\\s+REG_\\w+\\s+(\\S.*)$`, 'im')
+  const reg = path.join(process.env.SystemRoot, 'System32', 'reg.exe')
+  const regArgs = ['query', key, '/v', value].concat(addOpts)
+
+  log.silly('reg', 'running', reg, regArgs)
+  const [err, stdout, stderr] = await execFile(reg, regArgs, { encoding: 'utf8' })
+
+  log.silly('reg', 'reg.exe stdout = %j', stdout)
+  if (err || stderr.trim() !== '') {
+    log.silly('reg', 'reg.exe err = %j', err && (err.stack || err))
+    log.silly('reg', 'reg.exe stderr = %j', stderr)
+    if (err) {
+      throw err
+    }
+    throw new Error(stderr)
+  }
+
+  const result = outRe.exec(stdout)
+  if (!result) {
+    log.silly('reg', 'error parsing stdout')
+    throw new Error('Could not parse output of reg.exe')
+  }
+
+  log.silly('reg', 'found: %j', result[1])
+  return result[1]
+}
+
+/**
+ * 依次搜索多个注册表键，返回第一个可读的值
+ */
+const regSearchKeys = async (keys, value, addOpts) => {
+  for (const key of keys) {
+    try {
+      return await regGetValue(key, value, addOpts)
+    } catch {
+      continue
+    }
+  }
+}
+
+/**
+ * 返回候选列表中第一个当前用户可读的文件或目录，都不存在则返回 undefined
+ */
+const findAccessibleSync = (logprefix, dir, candidates) => {
+  for (let next = 0; next < candidates.length; next++) {
+    const candidate = path.resolve(dir, candidates[next])
+    let fd
+    try {
+      fd = openSync(candidate, 'r')
+    } catch (e) {
+      // 该候选文件不存在或不可读，继续检查下一个
+      log.silly(logprefix, 'Could not open %s: %s', candidate, e.message)
+      continue
+    }
+    closeSync(fd)
+    log.silly(logprefix, 'Found readable %s', candidate)
+    return candidate
+  }
+
+  return undefined
+}
+
+export { execFile, regGetValue, regSearchKeys, findAccessibleSync }

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@flun/nodejs-mobile-gyp",
+  "description": "Node.js for Mobile Apps native addon build tool (flun fork)",
+  "keywords": [
+    "nodejs-mobile",
+    "native",
+    "addon",
+    "module",
+    "c",
+    "c++",
+    "bindings",
+    "gyp"
+  ],
+  "version": "1.0.1",
+  "installVersion": 11,
+  "author": "flun <open@flun.top>",
+  "bin": "./bin/node-gyp.js",
+  "main": "./lib/node-gyp.js",
+  "files": [
+    "bin/",
+    "gyp/gyp",
+    "gyp/gyp.bat",
+    "gyp/gyp_main.py",
+    "gyp/LICENSE",
+    "gyp/pylib/gyp/",
+    "gyp/pylib/packaging/",
+    "gyp/data/",
+    "!gyp/pylib/gyp/__pycache__/",
+    "!gyp/pylib/gyp/generator/__pycache__/",
+    "!gyp/pylib/gyp/**/*_test.py",
+    "!gyp/pylib/packaging/__pycache__/",
+    "lib/",
+    "src/",
+    "addon.gypi",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "env-paths": "^4.0.0",
+    "exponential-backoff": "^3.1.3",
+    "glob": "^13.0.6",
+    "graceful-fs": "^4.2.11",
+    "make-fetch-happen": "^16.0.1",
+    "nopt": "^10.0.1",
+    "proc-log": "^7.0.0",
+    "semver": "^7.8.5",
+    "tar": "^7.5.22",
+    "which": "^7.0.0"
+  },
+  "allowScripts": {
+    "node": true
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "homepage": "https://github.com/OpenFlun/nodejs-mobile-gyp",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/OpenFlun/nodejs-mobile-gyp.git"
+  },
+  "gitee": "https://gitee.com/OpenFlun/nodejs-mobile-gyp.git",
+  "bugs": {
+    "url": "https://github.com/OpenFlun/nodejs-mobile-gyp/issues"
+  },
+  "license": "ISC",
+  "type": "module",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}

package/src/win_delay_load_hook.cc

@@ -0,0 +1,39 @@
+/*
+ * When this file is linked to a DLL, it sets up a delay-load hook that
+ * intervenes when the DLL is trying to load the host executable
+ * dynamically. Instead of trying to locate the .exe file it'll just
+ * return a handle to the process image.
+ *
+ * This allows compiled addons to work when the host executable is renamed.
+ */
+
+#ifdef _MSC_VER
+
+#pragma managed(push, off)
+
+#ifndef WIN32_LEAN_AND_MEAN
+#define WIN32_LEAN_AND_MEAN
+#endif
+
+#include <windows.h>
+
+#include <delayimp.h>
+#include <string.h>
+
+static FARPROC WINAPI load_exe_hook(unsigned int event, DelayLoadInfo* info) {
+  HMODULE m;
+  if (event != dliNotePreLoadLibrary)
+    return NULL;
+
+  if (_stricmp(info->szDll, HOST_BINARY) != 0)
+    return NULL;
+
+  m = GetModuleHandle(NULL);
+  return (FARPROC) m;
+}
+
+decltype(__pfnDliNotifyHook2) __pfnDliNotifyHook2 = load_exe_hook;
+
+#pragma managed(pop)
+
+#endif