AOT 的使用以及 .NET 与 Go 互相调用
SDK:.NET 7 SDK、Desktop development with C++ workload。
IDE:Visual Studio 2022
Desktop development with C++ workload是一个工具集,里面包含 C++ 开发工具,需要在Visual Studio Installer中安装,如下图红框中所示。
创建一个控制台项目
首先创建一个 .NET 7 控制台项目,名称为CsharpAot。
打开项目之后,基本代码如图所示:
我们使用下面的代码做测试:
public class Program { static void Main() { Console.WriteLine("C# Aot!"); Console.ReadKey(); } }体验 AOT 编译
这一步,可以参考官方网站的更多说明:
本地 AOT 部署概述 - .NET | Microsoft Learn
为了能够让项目发布时使用 AOT 模式,需要在项目文件中加上<PublishAot>true</PublishAot>选项。
然后使用 Visual Studio 发布项目。
发布项目的配置文件设置,需要按照下图进行配置。
AOT 跟
生成单个文件两个选项不能同时使用,因为 AOT 本身就是单个文件。
配置完成后,点击发布,然后打开Release目录,会看到如图所示的文件。
.exe是独立的可执行文件,不需要再依赖.NET Runtime环境,这个程序可以放到其他没有安装 .NET 环境的机器中运行。
然后删除以下三个文件:
CsharpAot.exp CsharpAot.lib CsharpAot.pdb光用
.exe即可运行,其他是调试符号等文件,不是必需的。
剩下CsharpAot.exe文件后,启动这个程序:
C# 调用库函数
这一部分的代码示例,是从笔者的一个开源项目中抽取出来的,这个项目封装了一些获取系统资源的接口,以及快速接入 Prometheus 监控。
不过很久没有更新了,最近没啥动力更新,读者可以点击这里了解一下这个项目:
CZGL.SystemInfo/src/CZGL.SystemInfo/Memory at net6.0 · whuanle/CZGL.SystemInfo · GitHub
因为后续代码需要,所以现在请开启 “允许不安全代码”。
本小节的示例是通过使用kernel32.dll去调用 Windows 的内核 API(Win32 API),调用GlobalMemoryStatusEx函数检索有关系统当前使用物理内存和虚拟内存的信息。
使用到的 Win32 函数可参考:GlobalMemoryStatusEx 函数 (sysinfoapi.h) - Win32 apps | Microsoft Learn
关于 .NET 调用动态链接库的方式,在 .NET 7 之前,通过这样调用:
[DllImport("Kernel32.dll", CharSet = CharSet.Auto, SetLastError = true)] [return: MarshalAs(UnmanagedType.Bool)] internal static extern Boolean GlobalMemoryStatusEx(ref MemoryStatusExE lpBuffer);在 .NET 7 中,出现了新的操作方式[LibraryImport]。
文档是这样介绍的:
Indicates that a source generator should create a function for marshalling arguments instead of relying on the runtime to generate an equivalent marshalling function at run time. 指示源生成器应创建用于编组参数的函数,而不是依赖运行库在运行时生成等效的编组函数。简单来说,就是我们要使用 AOT 写代码,然后代码中引用到别的动态链接库时,需要使用[LibraryImport]引入这些函数。
笔者没有在 AOT 下测试过
[DllImport],读者感兴趣可以试试。
新建两个结构体MEMORYSTATUS.cs、MemoryStatusExE.cs。
MEMORYSTATUS.cs:
public struct MEMORYSTATUS { internal UInt32 dwLength; internal UInt32 dwMemoryLoad; internal UInt32 dwTotalPhys; internal UInt32 dwAvailPhys; internal UInt32 dwTotalPageFile; internal UInt32 dwAvailPageFile; internal UInt32 dwTotalVirtual; internal UInt32 dwAvailVirtual; }MemoryStatusExE.cs:
public struct MemoryStatusExE { /// <summary> /// 结构的大小,以字节为单位,必须在调用 GlobalMemoryStatusEx 之前设置此成员,可以用 Init 方法提前处理 /// </summary> /// <remarks>应当使用本对象提供的 Init ,而不是使用构造函数!</remarks> internal UInt32 dwLength; /// <summary> /// 一个介于 0 和 100 之间的数字,用于指定正在使用的物理内存的大致百分比(0 表示没有内存使用,100 表示内存已满)。 /// </summary> internal UInt32 dwMemoryLoad; /// <summary> /// 实际物理内存量,以字节为单位 /// </summary> internal UInt64 ullTotalPhys; /// <summary> /// 当前可用的物理内存量,以字节为单位。这是可以立即重用而无需先将其内容写入磁盘的物理内存量。它是备用列表、空闲列表和零列表的大小之和 /// </summary> internal UInt64 ullAvailPhys; /// <summary> /// 系统或当前进程的当前已提交内存限制,以字节为单位,以较小者为准。要获得系统范围的承诺内存限制,请调用GetPerformanceInfo /// </summary> internal UInt64 ullTotalPageFile; /// <summary> /// 当前进程可以提交的最大内存量,以字节为单位。该值等于或小于系统范围的可用提交值。要计算整个系统的可承诺值,调用GetPerformanceInfo核减价值CommitTotal从价值CommitLimit /// </summary> internal UInt64 ullAvailPageFile; /// <summary> /// 调用进程的虚拟地址空间的用户模式部分的大小,以字节为单位。该值取决于进程类型、处理器类型和操作系统的配置。例如,对于 x86 处理器上的大多数 32 位进程,此值约为 2 GB,对于在启用4 GB 调整的系统上运行的具有大地址感知能力的 32 位进程约为 3 GB 。 /// </summary> internal UInt64 ullTotalVirtual; /// <summary> /// 当前在调用进程的虚拟地址空间的用户模式部分中未保留和未提交的内存量,以字节为单位 /// </summary> internal UInt64 ullAvailVirtual; /// <summary> /// 预订的。该值始终为 0 /// </summary> internal UInt64 ullAvailExtendedVirtual; internal void Refresh() { dwLength = checked((UInt32)Marshal.SizeOf(typeof(MemoryStatusExE))); } }定义引用库函数的入口:
public static partial class Native { /// <summary> /// 检索有关系统当前使用物理和虚拟内存的信息 /// </summary> /// <param name="lpBuffer"></param> /// <returns></returns> [LibraryImport("Kernel32.dll", SetLastError = true)] [return: MarshalAs(UnmanagedType.Bool)] internal static partial Boolean GlobalMemoryStatusEx(ref MemoryStatusExE lpBuffer); }然后调用Kernel32.dll中的函数:
public class Program { static void Main() { var result = GetValue(); Console.WriteLine($"当前实际可用内存量:{result.ullAvailPhys / 1000 / 1000}MB"); Console.ReadKey(); } /// <exception cref="Win32Exception"></exception> public static MemoryStatusExE GetValue() { var memoryStatusEx = new MemoryStatusExE(); // 重新初始化结构的大小 memoryStatusEx.Refresh(); // 刷新值 if (!Native.GlobalMemoryStatusEx(ref memoryStatusEx)) throw new Win32Exception("无法获得内存信息"); return memoryStatusEx; } }使用 AOT 发布项目,执行CsharpAot.exe文件。
减少体积
在前面两个例子中可以看到CsharpAot.exe文件大约在 3MB 左右,但是这个文件还是太大了,那么我们如何进一步减少 AOT 文件的大小呢?
读者可以从这里了解如何裁剪程序:https://learn.microsoft.com/zh-cn/dotnet/core/deploying/trimming/trim-self-contained
需要注意的是,裁剪是没有那么简单的,里面配置繁多,有一些选项不能同时使用,每个选项又能带来什么样的效果,这些选项可能会让开发者用得很迷茫。
经过笔者的大量测试,笔者选用了以下一些配置,能够达到很好的裁剪效果,供读者测试。
首先,引入一个库:
<ItemGroup> <PackageReference Include="Microsoft.DotNet.ILCompiler" Version="7.0.0-*" /> </ItemGroup>接着,在项目文件中加入以下选项:
<!--AOT 相关--> <PublishAot>true</PublishAot> <TrimMode>full</TrimMode> <RunAOTCompilation>True</RunAOTCompilation> <PublishTrimmed>true</PublishTrimmed> <TrimmerRemoveSymbols>true</TrimmerRemoveSymbols> <PublishReadyToRunEmitSymbols>false</PublishReadyToRunEmitSymbols> <DebuggerSupport>false</DebuggerSupport> <EnableUnsafeUTF7Encoding>true</EnableUnsafeUTF7Encoding> <InvariantGlobalization>true</InvariantGlobalization> <HttpActivityPropagationSupport>false</HttpActivityPropagationSupport> <MetadataUpdaterSupport>true</MetadataUpdaterSupport> <UseSystemResourceKeys>true</UseSystemResourceKeys> <IlcDisableReflection >true</IlcDisableReflection>最后,发布项目。
吃惊!生成的可执行文件只有 1MB 了,而且还可以正常执行。
笔者注:虽然现在看起来 AOT 的文件很小了,但是如果使用到HttpClient、System.Text.Json等库,哪怕只用到了一两个函数,最终包含这些库以及这些库使用到的依赖,生成的 AOT 文件会大得惊人。
所以,如果项目中使用到其他 nuget 包的时候,别想着生成的 AOT 能小多少!
C# 导出函数
这一步可以从时总的博客中学习更多:跨语言调用C#代码的新方式-DllExport - InCerry - 博客园
PS:时总真的太强了。
在 C 语言中,导出一个函数的格式可以这样:
// MyCFuncs.h #ifdef __cplusplus extern "C" { // only need to export C interface if // used by C++ source code #endif __declspec( dllimport ) void MyCFunc(); __declspec( dllimport ) void AnotherCFunc(); #ifdef __cplusplus } #endif当代码编译之后,我们就可以通过引用生成的库文件,调用MyCFunc、AnotherCFunc两个方法。
如果不导出的话,别的程序是无法调用库文件里面的函数。
因为 .NET 7 的 AOT 做了很多改进,因此,.NET 程序也可以导出函数了。
新建一个项目,名字就叫CsharpExport吧,我们接下来就在这里项目中编写我们的动态链接库。
添加一个CsharpExport.cs文件,内容如下:
using System.Runtime.InteropServices; namespace CsharpExport { public class Export { [UnmanagedCallersOnly(EntryPoint = "Add")] public static int Add(int a, int b) { return a + b; } } }然后在.csproj文件中,加上PublishAot选项。
然后通过以下命令发布项目,生成链接库:
dotnet publish -p:NativeLib=Shared -r win-x64 -c Release看起来还是比较大,为了继续裁剪体积,我们可以在CsharpExport.csproj中加入以下配置,以便生成更小的可执行文件。
<!--AOT 相关--> <PublishAot>true</PublishAot> <TrimMode>full</TrimMode> <RunAOTCompilation>True</RunAOTCompilation> <PublishTrimmed>true</PublishTrimmed> <TrimmerRemoveSymbols>true</TrimmerRemoveSymbols> <PublishReadyToRunEmitSymbols>false</PublishReadyToRunEmitSymbols> <DebuggerSupport>false</DebuggerSupport> <EnableUnsafeUTF7Encoding>true</EnableUnsafeUTF7Encoding> <InvariantGlobalization>true</InvariantGlobalization> <HttpActivityPropagationSupport>false</HttpActivityPropagationSupport> <MetadataUpdaterSupport>true</MetadataUpdaterSupport> <UseSystemResourceKeys>true</UseSystemResourceKeys> <IlcDisableReflection >true</IlcDisableReflection>C# 调用 C# 生成的 AOT
在本小节中,将使用CsharpAot项目调用CsharpExport生成的动态链接库。
把CsharpExport.dll复制到CsharpAot项目中,并配置始终复制。
在CsharpAot的Native中加上:
[LibraryImport("CsharpExport.dll", SetLastError = true)] [return: MarshalAs(UnmanagedType.I4)] internal static partial Int32 Add(Int32 a, Int32 b);