百度360必应搜狗淘宝本站头条
头像打包下载acmecadconverter_8.52绿色版mysql 昨天的日期个人网站源码word文档批量处理大师破解版
当前位置：网站首页 > 技术教程 > 正文

NetBeauty2:让你的.NET项目输出目录更清爽

csdh11 2025-03-24 15:21 9 浏览

在.NET项目开发中，随着项目复杂性的增加，依赖的dll文件也会逐渐增多。这往往导致输出目录混乱，不便于管理和部署。而NetBeauty2开源项目正是为了解决这一问题而生，它能够帮助开发者在独立发布.NET项目时，将.NET运行时和依赖的dll文件移动到指定的目录，从而让输出目录更加干净、清爽。

1. NetBeauty2简介

NetBeauty2是一个开源的.NET依赖库整理工具，它的主要作用是在.NET项目独立发布时，对输出目录进行整理和优化。通过NetBeauty2，开发者可以轻松地将.NET运行时和依赖的dll文件移动到指定的目录，使得项目的输出目录更加清晰、易于管理。

项目仓库地址：
https://github.com/nulastudio/NetBeauty2[1]

下图为优化后输出目录（.NET运行时及引用依赖库移到libraries目录，目录名可配置）：

下图为极限优化后输出目录（查看 `--hiddens`[2] 选项使用）

再来对比下未使用前输出目录（震撼吧！.NET运行时及相关依赖库全放在了根输出目录，.NET Framework可以配置privatePath，.NET Core可没那么方便）：

2. 支持情况


NetBeauty 2[3]NetCoreBeauty[4]
支持框架.Net Framework .Net Core 3.0+.Net Core 2.0+
支持部署模式Framework-dependent deployment (FDD) Self-contained deployment (SCD) Framework-dependent executables (FDE)Self-contained deployment (SCD)
支持操作系统Allwin-x64 win-x86 win-arm64(.NET 6+) linux-x64 linux-arm linux-arm64 osx-x64 osx-arm64(.NET 6+)
Need Patched HostFXRNo Yes(if use patch)Yes
Minimum Structure~20 Files ~8 Files(if use patch)~8 Files
How It Works`STARTUP_HOOKS`[5] `AssemblyLoadContext.Resolving`[6] `AssemblyLoadContext.ResolvingUnmanagedDll`[7] + `patched libhostfxr`[8](if use patch) `additionalProbingPaths`[9](if use patch)`patched libhostfxr`[10] `additionalProbingPaths`[11]
Shared RuntimeYesPossible If Using patched libhostfxr Alone

3. 如何使用？

3.1. 准备工作

在你的.NET Core工程（需要发布的主工程）添加Nuget包：

dotnet add package nulastudio.NetBeauty

打开工程文件编辑（.csproj）:

<Project Sdk="Microsoft.NET.Sdk">

<PropertyGroup>
<OutputType>Exe</OutputType>
<TargetFramework>netcoreapp3.0</TargetFramework>
</PropertyGroup>

<PropertyGroup>
<BeautySharedRuntimeMode>False</BeautySharedRuntimeMode>

<BeautyLibsDir Condition="$(BeautySharedRuntimeMode) == 'True'">../libraries</BeautyLibsDir>
<BeautyLibsDir Condition="$(BeautySharedRuntimeMode) != 'True'">./libraries</BeautyLibsDir>





<DisableBeauty>False</DisableBeauty>

<BeautyOnPublishOnly>False</BeautyOnPublishOnly>

<BeautyNoRuntimeInfo>False</BeautyNoRuntimeInfo>

<BeautyEnableDebugging>False</BeautyEnableDebugging>



<BeautyUsePatch>True</BeautyUsePatch>










<BeautyLogLevel>Info</BeautyLogLevel>



</PropertyGroup>

<ItemGroup>
<PackageReference Include="nulastudio.NetBeauty" Version="2.1.4.4" />
</ItemGroup>

</Project>

运行 dotnet build 或者 dotnet publish, 优化输出操作会自动完成。

3.2. 如果应用已经发布？

如果你的应用程序已经发布，可以这样使用（站长没试过，这可以做为发布后补偿措施）：

Usage:
nbeauty2 [--loglevel=(Error|Detail|Info)] [--srmode] [--enabledebug] [--usepatch] [--hiddens=hiddenFiles] [--noruntimeinfo] [--roll-forward=] [--apphostentry=] [--apphostdir=]  [ []]

例如：

ncbeauty2 --usepatch --loglevel Detail --hiddens "hostfxr;hostpolicy;*.deps.json;*.runtimeconfig*.json" /path/to/publishDir libraries "dll1.dll;lib*;..."

3.3. 配置为.NET Core全局工具

dotnet tool install --global nulastudio.nbeauty

安装后在程序发布时会自动应用。

4. 各种项目使用示例

克隆仓库（
https://github.com/nulastudio/NetBeauty2[12]），里面有各种模版项目使用示例：

测试工程名说明
WPFTestWPF项目(Winform类似），默认.NET 5
WebAppTestRazorPages项目，默认.NET 6
NetFxTest.NET Framework WPF项目（.NET 4.x，Winform类似）
ChromelyTest引用了Chromely的.NET项目
AvaloniaTestAvalonia UI项目，默认.NET 5

小知识1

Chromely NuGet包是一个用于创建跨平台桌面应用的库，它提供了一个基于Chromium的浏览器控件。通过Chromely，开发者可以使用Web技术（如HTML、CSS和JavaScript）来构建桌面应用的用户界面，同时保留对本地系统资源的访问。

Chromely NuGet包提供了一套完整的API和工具，使得开发者可以轻松地将Web应用程序转换为桌面应用程序，而无需进行大量的代码重写或修改。它还支持各种插件和扩展，以便开发者可以根据需要添加额外的功能或定制现有的功能。

此外，Chromely还支持多种编程语言和框架，如C#、.NET Core、ASP.NET Core等，这使得开发者可以选择他们最熟悉的技术栈来构建应用程序。

小知识2

Avalonia UI是一个跨平台的.NET UI框架，它允许开发者使用XAML和C#语言创建可在多个平台上运行的应用程序，包括Windows、Linux、macOS、iOS、Android以及WebAssembly。Avalonia UI旨在帮助开发者构建漂亮、现代的图形用户界面(GUI)。它兼容所有支持.NET Standard 2.0的平台，使开发者能够从单个代码库创建适用于多个操作系统的原生应用程序。通过使用Avalonia UI，开发者可以充分利用.NET生态系统的强大功能，同时实现跨平台兼容性，降低开发成本并提高开发效率。

推荐开源控件库：irihitech/Semi.Avalonia[13]，irihitech/Ursa.Avalonia[14]

5. 总结

林德熙大佬分享过类似的包NuGet Gallery |
dotnetCampus.PublishFolderCleaner 3.11.1[15]，但该库说明只在Windows发布支持，大家可以对比使用，原文链接：PublishFolderCleaner 让你的 dotnet 应用发布文件夹更加整洁 - lindexi - 博客园 (cnblogs.com)[16]，再次给出本文介绍库NetBeauty2开源地址：

项目仓库地址：
https://github.com/nulastudio/NetBeauty2[17]

参考：

  • nulastudio/NetBeauty2: Move a .NET Framework/.NET Core app runtime components and dependencies into a sub-directory and make it beauty. (github.com)[18]

  • 路遥工具箱 .NET 6.0 独立部署时优化目录结构-码农很忙 (coderbusy.com)[19]

  • PublishFolderCleaner 让你的 dotnet 应用发布文件夹更加整洁 - lindexi - 博客园 (cnblogs.com)[20]

参考资料
[1]

https://github.com/nulastudio/NetBeauty2: https://github.com/nulastudio/NetBeauty2

[2]

--hiddens: https://github.com/nulastudio/NetBeauty2#use-the-binary-application-if-your-project-has-already-been-published

[3]

NetBeauty 2: https://github.com/nulastudio/NetBeauty2

[4]

NetCoreBeauty: https://github.com/nulastudio/NetBeauty2/tree/v1

[5]

STARTUP_HOOKS: https://github.com/dotnet/runtime/blob/main/docs/design/features/host-startup-hook.md

[6]

AssemblyLoadContext.Resolving: https://docs.microsoft.com/en-us/dotnet/api/system.runtime.loader.assemblyloadcontext.resolving?view=netcore-3.0

[7]

AssemblyLoadContext.ResolvingUnmanagedDll: https://docs.microsoft.com/en-us/dotnet/api/system.runtime.loader.assemblyloadcontext.resolvingunmanageddll?view=netcore-3.0

[8]

patched libhostfxr: https://github.com/nulastudio/HostFXRPatcher

[9]

additionalProbingPaths: https://github.com/dotnet/toolset/blob/master/Documentation/specs/runtime-configuration-file.md#runtimeoptions-section-runtimeconfigjson

[10]

patched libhostfxr: https://github.com/nulastudio/HostFXRPatcher

[11]

additionalProbingPaths: https://github.com/dotnet/toolset/blob/master/Documentation/specs/runtime-configuration-file.md#runtimeoptions-section-runtimeconfigjson

[12]

https://github.com/nulastudio/NetBeauty2: https://github.com/nulastudio/NetBeauty2

[13]

irihitech/Semi.Avalonia: https://github.com/irihitech/Semi.Avalonia

[14]

irihitech/Ursa.Avalonia: https://github.com/irihitech/Ursa.Avalonia

[15]

NuGet Gallery | dotnetCampus.PublishFolderCleaner 3.11.1: https://www.nuget.org/packages/dotnetCampus.PublishFolderCleaner

[16]

PublishFolderCleaner 让你的 dotnet 应用发布文件夹更加整洁 - lindexi - 博客园 (cnblogs.com):
https://www.cnblogs.com/lindexi/p/15423277.html

[17]

https://github.com/nulastudio/NetBeauty2: https://github.com/nulastudio/NetBeauty2

[18]

nulastudio/NetBeauty2: Move a .NET Framework/.NET Core app runtime components and dependencies into a sub-directory and make it beauty. (github.com): https://github.com/nulastudio/NetBeauty2

[19]

路遥工具箱 .NET 6.0 独立部署时优化目录结构-码农很忙 (coderbusy.com):
https://www.coderbusy.com/archives/2301.html

[20]

PublishFolderCleaner 让你的 dotnet 应用发布文件夹更加整洁 - lindexi - 博客园 (cnblogs.com):
https://www.cnblogs.com/lindexi/p/15423277.html


相关推荐

探索Java项目中日志系统最佳实践:从入门到精通

探索Java项目中日志系统最佳实践：从入门到精通在现代软件开发中，日志系统如同一位默默无闻却至关重要的管家，它记录了程序运行中的各种事件，为我们排查问题、监控性能和优化系统提供了宝贵的依据。在Java...

用了这么多年的java日志框架，你真的弄懂了吗?

在项目开发过程中，有一个必不可少的环节就是记录日志，相信只要是个程序员都用过，可是咱们自问下，用了这么多年的日志框架，你确定自己真弄懂了日志框架的来龙去脉嘛？下面笔者就详细聊聊java中常用日志框架的...

物理老师教你学Java语言(中篇)（物理专业学编程）

第四章物质的基本结构——类与对象...

一文搞定!Spring Boot3 定时任务操作全攻略

各位互联网大厂的后端开发小伙伴们，在使用SpringBoot3开发项目时，你是否遇到过定时任务实现的难题呢？比如任务调度时间不准确，代码报错却找不到方向，是不是特别头疼？如今，随着互联网业务规模...

你还不懂java的日志系统吗 ?（java的日志类）

一、背景在java的开发中，使用最多也绕不过去的一个话题就是日志，在程序中除了业务代码外，使用最多的就是打印日志。经常听到的这样一句话就是“打个日志调试下”，没错在日常的开发、调试过程中打印日志是常干...

谈谈枚举的新用法--java（java枚举的作用与好处）

问题的由来前段时间改游戏buff功能，干了一件愚蠢的事情，那就是把枚举和运算集合在一起，然后运行一段时间后buff就出现各种问题，我当时懵逼了！事情是这样的，做过游戏的都知道，buff，需要分类型，且...

你还不懂java的日志系统吗（javaw 日志）

一、背景在java的开发中，使用最多也绕不过去的一个话题就是日志，在程序中除了业务代码外，使用最多的就是打印日志。经常听到的这样一句话就是“打个日志调试下”，没错在日常的开发、调试过程中打印日志是常干...

Java 8之后的那些新特性(三):Java System Logger

去年12月份log4j日志框架的一个漏洞，给Java整个行业造成了非常大的影响。这个事情也顺带把log4j这个日志框架推到了争议的最前线。在Java领域，log4j可能相对比较流行。而在log4j之外...

Java开发中的日志管理:让程序“开口说话”

Java开发中的日志管理：让程序“开口说话”日志是程序员的朋友，也是程序的“嘴巴”。它能让程序在运行过程中“开口说话”，告诉我们它的状态、行为以及遇到的问题。在Java开发中，良好的日志管理不仅能帮助...

吊打面试官(十二)--Java语言中ArrayList类一文全掌握

导读...

OS X 效率启动器 Alfred 详解与使用技巧

问：为什么要在Mac上使用效率启动器类应用？答：在非特殊专业用户的环境下，（每天）用户一般可以在系统中进行上百次操作，可以是点击，也可以是拖拽，但这些只是过程，而我们的真正目的是想获得结果，也就是...

Java中 高级的异常处理（java中异常处理的两种方式）

介绍异常处理是软件开发的一个关键方面，尤其是在Java中，这种语言以其稳健性和平台独立性而闻名。正确的异常处理不仅可以防止应用程序崩溃，还有助于调试并向用户提供有意义的反馈。...

【性能调优】全方位教你定位慢SQL，方法介绍下!

1.使用数据库自带工具...

全面了解mysql锁机制(InnoDB)与问题排查

MySQL/InnoDB的加锁，一直是一个常见的话题。例如，数据库如果有高并发请求，如何保证数据完整性？产生死锁问题如何排查并解决？下面是不同锁等级的区别表级锁：开销小，加锁快；不会出现死锁；锁定粒度...

看懂这篇文章，你就懂了数据库死锁产生的场景和解决方法

一、什么是死锁加锁（Locking）是数据库在并发访问时保证数据一致性和完整性的主要机制。任何事务都需要获得相应对象上的锁才能访问数据，读取数据的事务通常只需要获得读锁（共享锁），修改数据的事务需要获...

一周热门
最近发表
标签列表