API Host EngineOptions

EngineOptions

不可变引擎配置根对象

Immutable engine configuration root

.NET Host API 目录

.NET Host API Directory

概述

Overview

EngineOptions 是不可变 record。始终从 Default 开始并调用 With... 方法；每个回调只修改相应 Builder，然后返回新配置，不会修改原配置。

EngineOptions is an immutable record. Start from Default and call With...; each callback modifies only its builder and returns new options without changing the original.

Default

Returns

默认根配置。

Default root configuration.

var options = EngineOptions.Default;

Runtime / Compiler / Optimization / Output

Returns

已冻结的子配置。

Immutable child configuration.

用途

读取最终配置；修改时使用对应 With... 方法。

Read final settings; use matching With... method to modify them.

var options = EngineOptions.Default;
var mode = options.Compiler.Mode;
var hotReload = options.Runtime.EnableHotReload;

WithCompiler(configure)

Parameters:

• configure
  接收 CompilerOptionsBuilder 的回调。

  Callback receiving CompilerOptionsBuilder.

Returns

新 EngineOptions。

New EngineOptions.

var options = EngineOptions.Default.WithCompiler(builder =>
    builder.Mode = CompilationMode.Dynamic);

WithRuntime(configure)

Parameters:

• configure
  接收 RuntimeOptionsBuilder 的回调。

  Callback receiving RuntimeOptionsBuilder.

Returns

新 EngineOptions。

New EngineOptions.

var options = EngineOptions.Default.WithRuntime(builder =>
    builder.HotReload = false);

WithOptimization(configure)

Parameters:

• configure
  接收 OptimizationOptionsBuilder 的回调。

  Callback receiving OptimizationOptionsBuilder.

Returns

新 EngineOptions。

New EngineOptions.

var options = EngineOptions.Default.WithOptimization(builder =>
    builder.AutoModuleDirectCall = true);

WithOutput(configure)

Parameters:

• configure
  接收 OutputOptionsBuilder 的回调。

  Callback receiving OutputOptionsBuilder.

Returns

新 EngineOptions。

New EngineOptions.

var options = EngineOptions.Default.WithOutput(builder =>
    builder.AssemblyFile = "generated/AuroraScripts.dll");