Project Icon

bflat

生成小型独立原生的C#可执行文件编译器

bflat是一款创新C#编译器,结合Roslyn和NativeAOT技术,支持最新C#特性。它生成小巧、独立的原生可执行文件,无需.NET运行时。支持Linux、Windows和UEFI等多平台,提供两种标准库选择。bflat简化C#开发流程,带来类似Go语言的工具链体验,为开发者提供高效灵活的编程方案。

bflat

https://flattened.net

C#就是你所熟知的样子,但采用了受Go启发的工具链,可以直接生成小巧、独立且原生的可执行文件。

$ echo 'System.Console.WriteLine("Hello World");' > hello.cs
$ bflat build hello.cs
$ ./hello
Hello World
$ bflat build hello.cs --os:windows
$ file ./hello.exe
hello.exe: PE32+ executable (console) x86-64, for MS Windows

🎻 bflat究竟是什么

bflat是Roslyn(生成.NET可执行文件的"官方"C#编译器)和NativeAOT(前身为CoreRT,基于CoreCLR的.NET预先编译器)的结合体。借此,你可以使用最新的C#特性,同时享受高性能的CoreCLR垃圾回收和原生代码生成器(RyuJIT)。

bflat将这两个组件合并成一个单一的预先编译跨平台编译器和C#运行时。

bflat目前可以针对以下平台:

  • 基于glibc的x64/arm64 Linux(x64上2.17或更高版本(约CentOS 7),或arm64上2.27或更高版本(约Ubuntu 18.04))
  • 基于bionic的arm64 Linux(Android API级别21)
  • x64/arm64 Windows(Windows 7或更高版本)
  • x64/arm64 UEFI(仅使用--stdlib:zero

对musl-based Linux的支持正在开发中。

bflat可以生成原生可执行文件,或者可以通过FFI从其他语言调用的原生共享库。

🥁 如何获取bflat

查看本仓库的Releases标签并下载与你的主机系统匹配的编译器。这些都是跨平台编译器,可以针对任何支持的操作系统/架构。

将压缩包解压到一个方便的位置,并将根目录添加到你的PATH中。这样就设置完成了。查看samples目录获取一些示例。

在Windows上,你也可以通过winget获取:winget install bflat

二进制发布版本使用MIT许可证。

🎷 我没看到dotnet、MSBuild或NuGet

这正是重点所在。bflat之于dotnet,就像VS Code之于VS。

🎙 源代码在哪里

源代码分布在本仓库和bflattened/runtime中。bflattened/runtime仓库是dotnet/runtime仓库的定期更新分支,包含无法上游的bflat特定更改。bflattened/runtime仓库生成本仓库所使用的编译器和运行时二进制文件。

📚 两个标准库

bflat带有两个标准库。第一个(称为DotNet)是默认的,来自dotnet/runtime仓库分支。它包含你熟悉和喜爱的.NET所有内容。第二个(称为Zero)是一个最小的标准库,除了基本类型外几乎没有其他内容。它的源代码位于本仓库中。使用--stdlib:zero参数可以在两者之间切换。

📻 如何及时了解bflat的最新动态?

Twitter上关注我。

🎺 优化输出大小

默认情况下,bflat生成的可执行文件大小在1 MB到2 MB之间,即使是最简单的应用程序也是如此。这有多个原因:

  • bflat包含所有已编译方法的堆栈跟踪数据,以便打印美观的异常堆栈跟踪
  • 即使是最简单的应用程序也可能调用反射(例如获取OutOfMemoryException类的名称)、全球化等
  • 方法体在16字节边界对齐,以优化CPU缓存行利用率
  • (不适用于Windows)可执行文件中包含DWARF调试信息

选择"更大"的默认值是为了友好和方便。要获得更接近低级编程语言的体验,请在bflat build命令中指定--no-reflection--no-stacktrace-data--no-globalization--no-exception-messages参数。

最好举个例子。以下程序:

using System.Diagnostics;
using static System.Console;

WriteLine($"NullReferenceException message is: {new NullReferenceException().Message}");
WriteLine($"The runtime type of int is named: {typeof(int)}");
WriteLine($"Type of boxed integer is{(123.GetType() == typeof(int) ? "" : " not")} equal to typeof(int)");
WriteLine($"Type of boxed integer is{(123.GetType() == typeof(byte) ? "" : " not")} equal to typeof(byte)");
WriteLine($"Upper case of 'Вторник' is '{"Вторник".ToUpper()}'");
WriteLine($"Current stack frame is {new StackTrace().GetFrame(0)}");

默认情况下会打印:

NullReferenceException message is: Object reference not set to an instance of an object.
The runtime type of int is named: System.Int32
Type of boxed integer is equal to typeof(int)
Type of boxed integer is not equal to typeof(byte)
Upper case of 'Вторник' is 'ВТОРНИК'
Current stack frame is <Program>$.<Main>$(String[]) + 0x154 at offset 340 in file:line:column <filename unknown>:0:0

但使用上述所有参数时会打印:

NullReferenceException message is: Arg_NullReferenceException
The runtime type of int is named: EETypeRva:0x00048BD0
Type of boxed integer is equal to typeof(int)
Type of boxed integer is not equal to typeof(byte)
Upper case of 'Вторник' is 'Вторник'
Current stack frame is ms!<BaseAddress>+0xb82d4 at offset 340 in file:line:column <filename unknown>:0:0

启用所有选项后,可以轻松地将有用的程序控制在1 MB以下。在撰写本文时,上述程序在Windows上的大小为708 kB。生成的可执行文件与其他可执行文件一样。你可以添加-Os --no-pie --separate-symbols以获得更多节省,并使用UPX等工具进行进一步压缩(可达到约300 kB范围)。

如果你的目标是类Unix系统,可能需要传递--separate-symbols以将调试信息放入单独的文件中(调试信息很大!)。在Windows上不需要这样做,因为平台惯例是将调试信息放在单独的PDB文件中。

🎸 预处理器定义

除了命令行提供的预处理器定义外,bflat还定义了几个其他符号:BFLAT(始终定义),DEBUG(未优化时定义),WINDOWS/LINUX/UEFI(当相应操作系统为目标时),X64/ARM64(当针对相应架构时)。

🎹 调试bflat应用程序

用bflat编译的应用程序的调试方式与其他原生代码相同。在你喜欢的调试器(Linux上的gdb或lldb,Windows上的Visual Studio或WinDbg)下启动生成的可执行文件,你就能设置断点、单步执行并查看局部变量。

☝ 示例

仓库的samples目录中有带README的示例。克隆仓库并自己尝试这些示例吧!

项目侧边栏1项目侧边栏2
推荐项目
Project Cover

豆包MarsCode

豆包 MarsCode 是一款革命性的编程助手,通过AI技术提供代码补全、单测生成、代码解释和智能问答等功能,支持100+编程语言,与主流编辑器无缝集成,显著提升开发效率和代码质量。

Project Cover

AI写歌

Suno AI是一个革命性的AI音乐创作平台,能在短短30秒内帮助用户创作出一首完整的歌曲。无论是寻找创作灵感还是需要快速制作音乐,Suno AI都是音乐爱好者和专业人士的理想选择。

Project Cover

有言AI

有言平台提供一站式AIGC视频创作解决方案,通过智能技术简化视频制作流程。无论是企业宣传还是个人分享,有言都能帮助用户快速、轻松地制作出专业级别的视频内容。

Project Cover

Kimi

Kimi AI助手提供多语言对话支持,能够阅读和理解用户上传的文件内容,解析网页信息,并结合搜索结果为用户提供详尽的答案。无论是日常咨询还是专业问题,Kimi都能以友好、专业的方式提供帮助。

Project Cover

阿里绘蛙

绘蛙是阿里巴巴集团推出的革命性AI电商营销平台。利用尖端人工智能技术,为商家提供一键生成商品图和营销文案的服务,显著提升内容创作效率和营销效果。适用于淘宝、天猫等电商平台,让商品第一时间被种草。

Project Cover

吐司

探索Tensor.Art平台的独特AI模型,免费访问各种图像生成与AI训练工具,从Stable Diffusion等基础模型开始,轻松实现创新图像生成。体验前沿的AI技术,推动个人和企业的创新发展。

Project Cover

SubCat字幕猫

SubCat字幕猫APP是一款创新的视频播放器,它将改变您观看视频的方式!SubCat结合了先进的人工智能技术,为您提供即时视频字幕翻译,无论是本地视频还是网络流媒体,让您轻松享受各种语言的内容。

Project Cover

美间AI

美间AI创意设计平台,利用前沿AI技术,为设计师和营销人员提供一站式设计解决方案。从智能海报到3D效果图,再到文案生成,美间让创意设计更简单、更高效。

Project Cover

AIWritePaper论文写作

AIWritePaper论文写作是一站式AI论文写作辅助工具,简化了选题、文献检索至论文撰写的整个过程。通过简单设定,平台可快速生成高质量论文大纲和全文,配合图表、参考文献等一应俱全,同时提供开题报告和答辩PPT等增值服务,保障数据安全,有效提升写作效率和论文质量。

投诉举报邮箱: service@vectorlightyear.com
@2024 懂AI·鲁ICP备2024100362号-6·鲁公网安备37021002001498号