ctx.native.node 允许扩展在 Studio 和打包后的玩家项目中使用 Node.js 内置模块,适合读写本地文件、处理路径或调用其他宿主级能力。
v1.9.2 新增
加载内置模块
使用require() 同步加载模块:
import():
node: 前缀的显式内置模块,例如 node:fs、node:path、node:os 和 node:crypto。
第三方依赖
ctx.native.node 不能加载 npm 包:
dist bundle。不要依赖用户电脑上全局安装的包,也不要在运行时执行安装命令。
能力范围
| 扩展来源 | 是否可用 |
|---|---|
| 本地扩展 | 默认开放 |
| 项目发行物 | 默认开放,预览与打包后的玩家项目沿用同一规则 |
| 工坊扩展 | 账号需要取得 Node 原生扩展发布资格,且每个版本都要重新审核 |
ctx.native.node。即使选择闭源,也会附带一份仅供运营审核、不会公开给用户的源码包。权限由审核结果派生,不需要在 extension.json 中手动添加。
没有权限时,调用会抛出明确错误;扩展应捕获错误并提供不依赖原生能力的降级路径。