API Host NativePackages

NativePackages

AuroraScript 随附扩展包的目录。

命名空间：AuroraScript.Core。类型：static class。

返回 .NET 宿主 API 参考

概述

随附的扩展包是显式能力。EngineOptions.Default 不启用任何扩展包。仅选择应用所需的文件系统或网络访问，然后在脚本代码中导入已启用的裸路径。

using AuroraScript.Core;

var options = EngineOptions.Default.WithPackages(packages =>
{
    packages.Add(NativePackages.FileSystem);
    packages.Add(NativePackages.HttpClient);
});

属性

FileSystem

static NativePackageDefinition FileSystem

启用 fs 导入及 fs 中记录的 API。

import fs from "fs";

HttpClient

static NativePackageDefinition HttpClient

启用 http 导入及其在 http 中记录的同步与回调 API。

import http from "http";

解析与隔离

• 已启用的裸路径在配置的项目源解析器之前解析。
• 相对导入（如 ./fs 和 ../http）仍使用项目源。
• 扩展包源是依赖项，不会由无参 BuildAsync() 枚举为项目入口。
• 模块对象在引擎和脚本域之间隔离。
• 在一个 EngineOptions 实例上选择模块不会全局启用它。

两个模块都授予语言运行时之外的访问权限。应将其视为应用能力，而非无害的工具库；不要为不受信任的脚本启用它们，除非有适当的进程或操作系统沙箱。