API Host NativePackagesBuilder

NativePackagesBuilder

EngineOptions.WithPackages 使用的可变构建器。

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

返回 .NET 宿主 API 参考

概述

构建器从源 EngineOptions 中已有的定义开始。调用仅修改临时构建器；WithPackages 返回新的不可变选项快照。

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

构造函数

NativePackagesBuilder(IReadOnlyList<NativePackageDefinition> definitions)

从现有定义列表初始化构建器。列表不能为 null，不能包含 null，也不能包含重复的模块名称或导入路径。

常规宿主配置使用 EngineOptions.WithPackages，它会自动创建此构建器。

方法

Add

NativePackagesBuilder Add(NativePackageDefinition definition)
NativePackagesBuilder Add(Type nativeType)
NativePackagesBuilder Add<T>() where T : ScriptObject

添加一个定义并返回同一构建器以支持链式调用。definition 不能为 null。Add(Type) / Add<T>() 要求类型是带 [NativeType] 与 [NativePackage] 的 sealed 顶层 ScriptObject，并暴露生成的 RegisterPackage。重复的 Name、ModulePath 或 TypeName 会抛出 InvalidOperationException。

Clear

NativePackagesBuilder Clear()

移除所有定义并返回同一构建器。

var withoutNativeCapabilities = existing.WithPackages(packages =>
    packages.Clear());