百度360必应搜狗淘宝本站头条
当前位置:网站首页 > 技术教程 > 正文

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

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

在.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


相关推荐

NUS邵林团队发布DexSinGrasp基于强化学习实现物体分离与抓取统一

本文的作者均来自新加坡国立大学LinSLab。本文的共同第一作者为新加坡国立大学实习生许立昕和博士生刘子轩,主要研究方向为机器人学习和灵巧操纵,其余作者分别为硕士生桂哲玮、实习生郭京翔、江泽宇以及...

「PLC进阶」如何通过编写SCL语言程序实现物料分拣?

01、前言SCL作为IEC61131-3编程语言的一种,由于其高级语言的特性,特别适合复杂运算、复杂数学函数应用的场合。本文以FactoryIO软件中的物料分拣案例作为硬件基础,介绍如何通过SCL来实...

zk源码—5.请求的处理过程一(http1.1请求方法)

大纲1.服务器的请求处理链...

自己动手从0开始实现一个分布式 RPC 框架

前言为什么要自己写一个RPC框架,我觉得从个人成长上说,如果一个程序员能清楚的了解RPC框架所具备的要素,掌握RPC框架中涉及的服务注册发现、负载均衡、序列化协议、RPC通信协议、Socket通信、异...

MLSys’25 | 极低内存消耗:用SGD的内存成本实现AdamW的优化性能

AIxiv专栏是机器之心发布学术、技术内容的栏目。过去数年,机器之心AIxiv专栏接收报道了2000多篇内容,覆盖全球各大高校与企业的顶级实验室,有效促进了学术交流与传播。如果您有优秀的工作想要分享,...

线程池误用导致系统假死(线程池会自动销毁吗)

背景介绍在项目中,为了提高系统性能使用了RxJava实现异步方案,其中异步线程池是自建的。但是当QPS稍微增大之后却发现系统假死、无响应和返回,调用方出现大量超时现象。但是通过监控发现,系统线程数正常...

大型乘用车工厂布局规划(六大乘用车基地)

乘用车工厂的布局规划直接影响生产效率、物流成本、安全性和未来扩展能力。合理的布局应确保生产流程顺畅、物流高效、资源优化,并符合现代化智能制造和绿色工厂的要求。以下是详细的工厂布局规划要点:1.工厂布...

西门子 S7-200 SMART PLC 连接Factory IO的方法

有很多同学不清楚如何西门子200smart如何连接FactoryIO,本教程为您提供了如何使用西门子S7-200SMARTPLC连接FactoryIO的说明。设置PC和PLC之间的...

西门子博图高级仿真软件的应用(西门子博途软件仿真)

1.博图高级仿真软件(S7-PLCSIMAdvancedV2.0)S7-PLCSIMAdvancedV2.0包含大量仿真功能,通过创建虚拟控制器对S7-1500和ET200SP控制器进行仿真...

PLC编程必踩的6大坑——请对号入座,评论区见

一、缺乏整体规划:面条式代码问题实例:某快递分拣线项目初期未做流程图设计,工程师直接开始编写传送带控制程序。后期增加质检模块时发现I/O地址冲突,电机启停逻辑与传感器信号出现3处死循环,导致项目延期2...

统信UOS无需开发者模式安装软件包
统信UOS无需开发者模式安装软件包

原文链接:统信UOS无需开发者模式安装软件包...

2025-05-05 14:55 csdh11

100个Java工具类之76:数据指纹DigestUtils

为了提高数据安全性,保证数据的完整性和真实性,DigestUtils应运而生。正确恰当地使用DigestUtils的加密算法,可以实现数据的脱敏,防止数据泄露或篡改。...

麒麟KYLINIOS软件仓库搭建02-软件仓库添加新的软件包

#秋日生活打卡季#原文链接:...

Java常用工具类技术文档(java中工具类的作用)

一、概述Java工具类(UtilityClasses)是封装了通用功能的静态方法集合,能够简化代码、提高开发效率。本文整理Java原生及常用第三方库(如ApacheCommons、GoogleG...

软路由的用法(自动追剧配置)(软路由教学)

本内容来源于@什么值得买APP,观点仅代表作者本人|作者:值友98958248861环境和需求...