【资料图】

DotNetCore.Natasha.CSharp v5.2.2.1

• 使用 NMS Template 接管 CI 的部分功能.
• 取消 SourceLink.GitHub 的继承性.
• 优化几处内存占用问题.
• 增加隐式 using 配置文件以支持隐式 using 引用. 当项目开启 enable时,自动生效.
• 增加初始化 PE 信息判断, 跳过无效 DLL 文件.
• 整改 AssemblyCSharpBuilder, 修改几处 API:
  • 增加 GetAvailableCompilation, 开发者使用此API可以进行单独编译信息整合以及语义语法修剪,其结果为 Compilation 属性, 为下一步编译程序集做准备.
  • 增加 ClearCompilationCache 移除当前 编译单元的编译信息, 运行 GetAvailableCompilation/GetAssembly 将重新构建编译信息.
  • 增加 WithRandomAssenblyName 将当前编译单元的程序集名更改为 GUID 随机名.
  • 增加 ClearScript 清除当前编译单元储存的所有C#脚本代码.
  • 增加 Clear 清除脚本代码,清除编译信息,清除程序集名.
• 增加一个节省性能开销的 API.
  • AnalysisIgnoreAccessibility(), 调用此方法,语义检测将检测元数据的访问级别,可能增加性能开销.
  • NotAnalysisIgnoreAccessibility(), 调用此方法,语义检测将忽视检测元数据的访问级别,降低开销(编译单元默认使用的是低开销方案), 安全编程请选择此项.
• 编译单元增加两个方便操作的 API.
  • AddWithFullUsing(script): 增加脚本时,默认覆盖全域的 Using 引用.
  • AddWithDefaultUsing(script): 增加脚本时,默认覆盖主域的 Using 引用.
• 新增 Type 的扩展 API:
  • GetDelegateFromType , 参考 GetDelegateFromShortName 的用法.
• [破坏性更改]下列 API, 从 AssemblyCSharpBuilder 的扩展方法 更改为 Assembly 类型的扩展方法:
  • GetTypeFromShortName / GetTypeFromFullName,
  • GetMethodFromShortName / GetMethodFromFullName
  • GetDelegateFromShortName / GetDelegateFromFullName

使用迁移: builder.GetDelegateFromShortName() 更改为 builder.GetAssembly().GetDelegateFromShortName();builder.GetAssembly() 仍然不可多次编译, 请及时缓存结果.

DotNetCore.Natasha.Domain v5.2.0.1

• 取消 SourceLink.GitHub 的继承性.
• 增加 全局 using 配置文件以支持全局 using 引用.

变更一览

internal class Program    {        static void Main(string[] args)        {            //准备工作            NatashaManagement.Preheating();            AssemblyCSharpBuilder builder = new();            builder.Domain = DomainManagement.Random();            //填充一个            builder.AddWithDefaultUsing("public class A { }");            //此 API 可以在不用编译的情况下获取到已经格式化好的语法树.            //注: GetAssembly 方法中已包括此方法, 但不会重复运行.            builder.GetAvailableCompilation();            var assemblyA = builder.GetAssembly();            ShowAssemblyInfo(assemblyA);            ShowSyntaxTree(builder.Compilation!);            //清除编译信息,使 builder 可以重新组合 编译信息.            builder.ClearCompilationCache();            //重置程序集名,以免编译时产生冲突.            builder.WithRandomAssenblyName();            //向 builder 中追加类型 B.            builder.AddWithDefaultUsing("public static class B{ public static void Show(){ Console.WriteLine(\"HelloWorld!\"); } }");                        var assemblyAB = builder.GetAssembly();            ShowAssemblyInfo(assemblyAB);            ShowSyntaxTree(builder.Compilation!);            //反射方法并生成委托            var action = assemblyAB.GetDelegateFromShortName("B", "Show");            Console.WriteLine("运行方法:");            action();            //action.DisposeDomain();            //Console.WriteLine(DomainManagement.IsDeleted(builder.Domain!.Name!));            Console.ReadKey();            static void ShowAssemblyInfo(Assembly assembly)            {                Console.WriteLine("此程序集名字:"+assembly.FullName);                Console.WriteLine("此程序集是否为动态程序集:" + (assembly.IsDynamic ? "是" : "否"));                Console.WriteLine("编译后的程序集中类的数量:" + assembly.GetTypes().Length);                Console.WriteLine("程序集中的类分别是:" + string.Join(",", assembly.GetTypes().Select(item => item.Name)));                           }            static void ShowSyntaxTree(Compilation compilation)            {                Console.WriteLine("---------------------------");                foreach (var item in compilation.SyntaxTrees)                {                    Console.WriteLine("脚本代码:");                    Console.WriteLine(item.ToString());                }                Console.WriteLine("---------------------------");            }        }    }

结果如下:

此程序集名字:9a7962dc0b004c2481d615c5e044c6df, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null此程序集是否为动态程序集:否编译后的程序集中类的数量:3程序集中的类分别是:EmbeddedAttribute,RefSafetyRulesAttribute,A-----------脚本代码-----------public class A{}-----------------------------此程序集名字:a17ce8ef9c164e558facf13425b279c6, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null此程序集是否为动态程序集:否编译后的程序集中类的数量:4程序集中的类分别是:EmbeddedAttribute,RefSafetyRulesAttribute,A,B-----------脚本代码-----------public class A{}using System;public static class B{    public static void Show()    {        Console.WriteLine("HelloWorld!");    }}-----------------------------运行方法:HelloWorld!

关键词：