2.2 スマートコンパイルモード-アセンブリの参照

なぜアセンブリを参照するのですか

アセンブリの参照には実装が含まれておらず、具体的な実装の違いによる予期しない動作は発生しません。非常に包括的です。

前提条件

1. DotNetCore.Compile.Environment環境パッケージをインポートしてください。このパッケージは、コンパイル時にアセンブリの参照をrefsフォルダに出力します。
2. DotNetCore.Natasha.CSharp.Compiler.Domainコアバージョンのコンパイルドメインパッケージをインポートしてください。
3. スマートコンパイルのためのプレヒートメソッドを使用します。
4. スマートコンパイル。

プレヒートの例

通常のプレヒート

1. ジェネリックなプレヒートメソッドでコンパイルドメインクリエーターのシングルトンを自動的に作成します。
2. falseパラメータを渡すことでランタイムアセンブリを無効にし、Natashaはアセンブリの参照を選択します。
3. 最初のパラメータは、メモリアセンブリからUsing Codeを抽出するかどうかを指定します。falseに設定すると、アセンブリの参照からUsingを抽出します。
4. 2番目のパラメータは、メモリアセンブリからメタデータを抽出するかどうかを指定します。falseに設定すると、アセンブリの参照からメタデータを抽出します。

//コンパイルドメインを登録してプレヒートメソッドを使用
NatashaManagement.Preheating<NatashaDomainCreator>(false, false);

Usingキャッシュのプレヒート

最初の生成時にUsing CodeをキャッシュファイルNatasha.Namespace.cacheに書き込み、後続の再起動ではファイルから自動的に読み込みます。

//コンパイルドメインを登録してプレヒートメソッドを使用
NatashaManagement.Preheating<NatashaDomainCreator>(false, false，true);

分離プレヒート

//コンパイルドメインを登録
NatashaManagement.RegistDomainCreator<NatashaDomainCreator>();
//プレヒートメソッド
NatashaManagement.Preheating(false, false);

フィルタープレヒート

//Dapperのメジャーバージョンが12より大きいアセンブリが存在する場合、キャッシュに入れないでください。
//除外メソッドを渡す
NatashaManagement.Preheating<NatashaDomainCreator>((asmName, name) => {
    if (asmName.Name != null)
    {
        if (asmName.Name.Contains("Dapper") && asmName.Version!.Major > 12)
        {
            return true;
        }
    }
    return false;
},false, false，true);

環境が複雑すぎて予期しない事態に遭遇した可能性がありますので、コードを簡素化して例外が再現可能かどうかを確認し、Natashaへ問題を報告してください。

スマートコンパイル

プレヒート後は、以下のコードを参照してください。

AssemblyCSharpBuilder builder = new();
var myAssembly = builder
    .UseRandomDomain()
    .UseSmartMode() //启用智能模式
    .Add("public class A{ }")
    .GetAssembly();

智能模式将合并 共享域与当前域的 元数据以及 Using, 并启用语义检查. 智能模式的 API 逻辑为：

.WithCombineReferences(item => item.UseAllReferences())
.WithCombineUsingCode(UsingLoadBehavior.WithAll)
.WithReleaseCompile()
.WithSemanticCheck();

可以参考[元数据管理与微调] 对 元数据 的合并行为进行微调。 可以参考[微调Using覆盖] 对 UsingCode 的合并行为进行微调。

其他案例

批量排除程序集

NatashaInitializer.Preheating((asmName, name) => {
    if (name != null)
    {
        if (name.Contains("System"))
        {
            if (
            name.Contains("Net") ||
            name.Contains("Xml") ||
            name.Contains("IO") ||
            name.Contains("Reflection") ||
            name.Contains("Threading") ||
            name.Contains("Security") ||
            name.Contains("Diagnostics") ||
            name.Contains("Data") ||
            name.Contains("Resources.") ||
            name.Contains("Drawing") ||
            name.Contains("Text") ||
            name.Contains("Globalization") ||
            name.Contains("Service") ||
            name.Contains("Web") ||
            name.Contains("Window") ||
            name.Contains("ComponentModel")
            )
            {
                //排除
                return true;
            }
            return false;
        }
        if (name.Contains("Natasha"))
        {
            //加载
            return false;
        }
        if (name.Contains("ConsoleApp3"))
        {
            //加载
            return false;
        }
    }
    return true;
}，false, false);

根据版本排除程序集

该示例使用 AssemblyName 进行判断程序集名称及版本, 以下代码排除了 dapper 主版本号为 12 的程序集引用文件;

NatashaInitializer.Preheating((asmName, name) => {
    if (asmName.Name != null)
    {
        if (asmName.Name.Contains("Dapper") && asmName.Version!.Major > 12)
        {
            return true;
        }
    }
    return false;
});

减少程序集引用文件的加载,可以有效的控制内存涨幅.