For AI agents: the complete documentation index is available at /next/zh/llms.txt, the full documentation bundle is available at /next/zh/llms-full.txt, and this page is available as Markdown at /next/zh/lynxtron/api/@lynx-js/lynxtron-rebuild/index.md.
  • 简体中文
  • @lynx-js/lynxtron-rebuild

    @lynx-js/lynxtron-rebuild 用于将 npm Node.js 原生模块重新编译到 Lynxtron runtime ABI。它对应 Electron 生态中的 @electron/rebuild,但目标 runtime 是 Lynxtron。

    安装

    npm install -D @lynx-js/lynxtron-rebuild

    用法

    npx @lynx-js/lynxtron-rebuild

    通常在安装或更新原生模块后执行。工具可能复用兼容的预编译产物,因此成功退出不一定表示重新编译了二进制。请检查日志和实际加载的 .node 路径,并在目标 Lynxtron runtime 和打包后的应用中调用模块验证。

    适用场景

    场景是否需要
    纯 JavaScript npm 包不需要 rebuild
    依赖 Node.js/V8 ABI 的原生模块二进制与 Lynxtron 不匹配时,使用 @lynx-js/lynxtron-rebuild
    有兼容预编译产物的 Node-API 模块可以复用;需验证操作系统、架构、Node-API 版本、原生依赖及 Lynxtron 实际加载
    从 Electron 项目迁移过来的原生模块Electron ABI 专用二进制需替换为 Lynxtron 构建;兼容的 Node-API 产物可以复用
    Lynx 原生能力库通常通过 npm run build:lynxtron 构建,不依赖 lynxtron-rebuild

    更多说明见 Node.js 原生模块。

    除非另有说明,本项目采用知识共享署名 4.0 国际许可协议进行许可,代码示例采用 Apache License 2.0 许可协议进行许可。