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

最新推荐文章于 2024-08-15 13:54:22 发布
最新推荐文章于 2024-08-15 13:54:22 发布
阅读量103 收藏 1
点赞数
文章标签： .net
原文链接：https://mp.weixin.qq.com/s?__biz=MzAwNTMxMzg1MA==&mid=2654099079&idx=8&sn=88676277f4876844bd4b4faf277bfd89&chksm=8127a9813a747fea76d5539e3f6537e3aaad08e3e04a9a5bb06468b4f4dbb9e286561f8de617&scene=126&sessionid=0
版权

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

unsetunset1. NetBeauty2简介unsetunset

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

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

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

321f623c02b4bba855f63be9e53483f3.png

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

bf99da54912cfbb825e4d622c265ec76.png

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

6822348af87c54cf341059e55873c1b6.png

unsetunset2. 支持情况unsetunset


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

unsetunset3. 如何使用？unsetunset

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>
    <!-- beauty into sub-directory, default is libs, quote with "" if contains space  -->
    <BeautyLibsDir Condition="$(BeautySharedRuntimeMode) == 'True'">../libraries</BeautyLibsDir>
    <BeautyLibsDir Condition="$(BeautySharedRuntimeMode) != 'True'">./libraries</BeautyLibsDir>
    <!-- dlls that you don't want to be moved or can not be moved -->
    <!-- <BeautyExcludes>dll1.dll;lib*;...</BeautyExcludes> -->
    <!-- dlls that end users never needed, so hide them -->
    <!-- <BeautyHiddens>hostfxr;hostpolicy;*.deps.json;*.runtimeconfig*.json</BeautyHiddens> -->
    <!-- set to True if you want to disable -->
    <DisableBeauty>False</DisableBeauty>
    <!-- set to False if you want to beauty on build -->
    <BeautyOnPublishOnly>False</BeautyOnPublishOnly>
    <!-- DO NOT TOUCH THIS OPTION -->
    <BeautyNoRuntimeInfo>False</BeautyNoRuntimeInfo>
    <!-- set to True if you want to allow 3rd debuggers(like dnSpy) debugs the app -->
    <BeautyEnableDebugging>False</BeautyEnableDebugging>
    <!-- the patch can reduce the file count -->
    <!-- set to False if you want to disable -->
    <!-- SCD Mode Feature Only -->
    <BeautyUsePatch>True</BeautyUsePatch>
    <!-- App Entry Dll = BeautyDir + BeautyAppHostDir + BeautyAppHostEntry -->
    <!-- see https://github.com/nulastudio/NetBeauty2#customize-apphost for more details -->
    <!-- relative path based on AppHostDir -->
    <!-- .NET Core Non Single-File Only -->
    <!-- <BeautyAppHostEntry>bin/MyApp.dll</BeautyAppHostEntry> -->
    <!-- relative path based on BeautyDir -->
    <!-- .NET Core Non Single-File Only -->
    <!-- <BeautyAppHostDir>..</BeautyAppHostDir> -->
    <!-- <BeautyAfterTasks></BeautyAfterTasks> -->
    <!-- valid values: Error|Detail|Info -->
    <BeautyLogLevel>Info</BeautyLogLevel>
    <!-- set to a repo mirror if you have troble in connecting github -->
    <!-- <BeautyGitCDN>https://gitee.com/liesauer/HostFXRPatcher</BeautyGitCDN> -->
    <!-- <BeautyGitTree>master</BeautyGitTree> -->
  </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=<rollForward>] [--apphostentry=<appHostEntry>] [--apphostdir=<appHostDir>] <beautyDir> [<libsDir> [<excludes>]]

例如：

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

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

unsetunset4. 各种项目使用示例unsetunset

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

127d18066a9589cc43d69126247e4aa1.jpeg
测试工程名说明
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]

unsetunset5. 总结unsetunset

林德熙大佬分享过类似的包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

dotNET跨平台
关注
  • 0
    点赞
  • 踩
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
NetCoreBeauty:将.NET Core应用程序运行时组件和依赖项移动到子目录中，使其美观
05-15
NetCoreBeauty :backhand_index_pointing_down: :backhand_index_pointing_down: :backhand_index_pointing_down:中国大陆用户自愿要看 :backhand_index_pointing_right: :backhand_index_pointing_right: :backhand_index_pointing_right: :backhand_index_pointing_left: :backhand_index_pointing_left: :backhand_index_pointing_left: 它是什么？ NetCoreBeauty将.NET Core应用程序运行时组件和依赖项移动到一个子目录中，以使其美观。 美容之后 甚至更少！ 请参见选项 美容前 为什么和为什么不？ 为什么不单？ 首先，显然，您不能在.Net Core 2.x使用它。 其次，单文件应用程序发布会将所有内容提取到一个临时目录中，然后从该位置运行它。 因此，如果您使用Assembl
使用 NetCoreBeauty 优化 .NET CORE 独立部署目录结构
dotNET跨平台
02-15 595
在将一个 .NET CORE \ .NET 5.0 \ .NET 6.0 程序进行独立部署发布时，会在发布目录产生很多系统类库，导致目录非常不简洁。这给寻找入口程序造成了困难，特别是路遥工...
【无标题】
m0_54681721的博客
12-07 112
[dev] servera [test] serverb [balancers] serverb [prod] serverc serverd [webservers:childrend] ~ ~ :wq [defaults] #some basic default values. inventory /home/student/ansible/inventory #library =/usr/share/my modules/ #module utils = /usr/share/my module ut
如何更精准地设置 C# / .NET Core 项目的输出路径？（包括添加和删除各种前后缀）
kuangben2000的博客
04-28 1860
如何更精准地设置 C# / .NET Core 项目的输出路径？（包括添加和删除各种前后缀） https://blog.csdn.net/WPwalter/article/details/88384117 我们都知道可以通过在 Visual Studio 中设置输出路径（OutputPath）来更改项目输出文件所在的位置。对于 .NET Core 所使用的新 csproj 格式来说，你可能会发...
Nito.AsyncEx：async/await的.Net辅助库。
成长的足迹
08-12 319
Nito.AsyncEx是一个功能强大且灵活的开源项目，它提供了一系列工具和扩展方法，使得开发者可以更加轻松地编写和管理异步任务。
EmguCV学习笔记 VB.Net 第1章 EmguCV
UruseiBest 的技术专栏
08-15 818
EmguCV是一个基于OpenCV的开源免费的跨平台计算机视觉库，它是一个开源、免费的计算机视觉库。EmguCV提供了C#和VB.NET等语言的接口，方便.Net开发者使用，它向C#和VB.NET开发者提供了OpenCV库的大部分功能，包括图像和视频处理、特征提取、目标检测、机器学习等。而且EmguCV提供了简单易用的API接口，可以快速上手进行图像和视频处理任务。
.net6 swagger 修改路由名称的过滤器 去除掉后缀的Service
qq_61596453的博客
08-12 241
在program.cs中注册。
.net6 JWT权限验证
qq_61596453的博客
08-12 231
自定义认证中间件也需要在program.cs中注册。如需所有接口日志，可以写自定义认证中间件。首先写一个JWT token生成方法。在program.cs中注册接口类。同样需要注册 因为要获取上下文。通过token获取当前用户。写一个自定义权限验证类。控制器中可以直接只用。
Spire.PDF for .NET【文档操作】演示：检测 PDF 文件是否为 Portfolio
励志做最业余的专业博主，控件产品可以私我~
08-13 1003
PDF 包可以组合多种文件类型，例如 Word、Excel、PDF 和图像文件，与将文件合并为单个 PDF 文件相比，PDF 包保留了文件的单独标识，您可以轻松地打开、阅读、编辑和格式化 PDF 包中的每个文件，而不受其他文件的干扰。
EmguCV学习笔记 VB.Net 2.2 Matrix类
UruseiBest 的技术专栏
08-15 648
Matrix类是EmguCV中的一个矩阵类，它可以用来存储和处理矩阵数据，可以处理任意维度的矩阵。与Mat类相比，Matrix类提供了更多的矩阵运算方法，如矩阵加减、乘法、逆矩阵等，也更加灵活，而且底层实现也更加高效。例如，当均值为0，标准差为1时，生成的随机矩阵的像素值符合标准正态分布。当均值为0，标准差为0.5时，生成的随机矩阵的像素值分布更加集中，更接近于均值。该控件位于【工具箱】|【Emgu.CV】下面。SetRandNormal方法只能生成正态分布的随机矩阵，不能生成其他分布的随机矩阵。
.Net 填坑 接口、父类、子类同名方法的调用
kylinok的博客
08-12 401
方法调用，要看调用方法的方式，实例方法与虚方法。实例方法，直接按变量类型，去找到对应的方法直接调用实例虚方法，找到变量实际的存储类型，去一层层找到有无复写的虚方法注意：new与override关键字的区别，特别是new关键字，可以当做是独立的属于类型自身的方法。
.net实战(VB):连接网页数据
nianfen的博客
08-12 427
此处是实现登录并获取返回的数据(主要是为了获取令牌，后续的数据获取都要在传参的同时传入令牌)4.登录进去以后，在相应的控件中继续传参，我这个实例中控件的id是name2，传入aa1字符串。5.Debug.WriteLine(response)输出的数据如下，将这一串数据赋值给JObject变量，获取child(子项)，这里面我们主要获取data子项。补充一句，传参的网址和我们手动登录的网址是不一样的，要获取常规网站的传参网址，请私信博主。3.对返回的数据进行处理，获取token(令牌)
超市管理系统，基于javaweb.zip
08-15
项目工程资源经过严格测试可直接运行成功且功能正常的情况才上传，可轻松copy复刻，拿到资料包后可轻松复现出一样的项目，本人系统开发经验充足（全栈开发），有任何使用问题欢迎随时与我联系，我会及时为您解惑，提供帮助 【资源内容】：项目具体内容可查看/点击本页面下方的*资源详情*，包含完整源码+工程文件+说明（若有）等。【若无积分，此资源可私信获取】 【本人专注IT领域】：有任何使用问题欢迎随时与我联系，我会及时解答，第一时间为您提供帮助 【附带帮助】：若还需要相关开发工具、学习资料等，我会提供帮助，提供资料，鼓励学习进步 【适合场景】：相关项目设计中，皆可应用在项目开发、毕业设计、课程设计、期末/期中/大作业、工程实训、大创等学科竞赛比赛、初期项目立项、学习/练手等方面中 可借鉴此优质项目实现复刻，也可基于此项目来扩展开发出更多功能 #注 1. 本资源仅用于开源学习和技术交流。不可商用等，一切后果由使用者承担 2. 部分字体及插图等来自网络，若是侵权请联系删除，本人不对所涉及的版权问题或内容负法律责任。收取的费用仅用于收集和整理资料耗费时间的酬劳
vue3面试题2023,84页，几十道vue面试题，准备vue的面试，这么一份文件就够了
08-15
vue3面试题2023： Vue 的优缺点  优点 1.创建单页面应用的轻量级Web应用框架 2.简单易用 3.双向数据绑定 4.组件化的思想 5.虚拟DOM 6.数据驱动视图 缺点 不支持IE8
【雷达跟踪】基于matlab雷达目标生成与跟踪【含Matlab源码 7220期】.zip
08-15
CSDN海神之光上传的代码均可运行，亲测可用，直接替换数据即可，适合小白； 1、代码压缩包内容 主函数：main.m； 调用函数：其他m文件；无需运行 运行结果效果图； 2、代码运行版本 Matlab 2019b；若运行有误，根据提示修改；若不会，私信博主； 3、运行操作步骤 步骤一：将所有文件放到Matlab的当前文件夹中； 步骤二：双击打开main.m文件； 步骤三：点击运行，等程序运行完得到结果； 4、仿真咨询 如需其他服务，可私信博主或扫描博客文章底部QQ名片； 4.1 博客或资源的完整代码提供 4.2 期刊或参考文献复现 4.3 Matlab程序定制 4.4 科研合作 功率谱估计： 故障诊断分析： 雷达通信：雷达LFM、MIMO、成像、定位、干扰、检测、信号分析、脉冲压缩 滤波估计：SOC估计 目标定位：WSN定位、滤波跟踪、目标定位 生物电信号：肌电信号EMG、脑电信号EEG、心电信号ECG 通信系统：DOA估计、编码译码、变分模态分解、管道泄漏、滤波器、数字信号处理+传输+分析+去噪（CEEMDAN）、数字信号调制、误码率、信号估计、DTMF、信号检测识别融合、LEACH协议、信号检测、水声通信
CTR2024中国广告主营销趋势调查报告.pdf
最新发布
08-15
【CTR】2024中国广告主营销趋势调查报告.pdf【CTR】2024中国广告主营销趋势调查报告.pdf【CTR】2024中国广告主营销趋势调查报告.pdf【CTR】2024中国广告主营销趋势调查报告.pdf【CTR】2024中国广告主营销趋势调查报告.pdf【CTR】2024中国广告主营销趋势调查报告.pdf【CTR】2024中国广告主营销趋势调查报告.pdf【CTR】2024中国广告主营销趋势调查报告.pdf【CTR】2024中国广告主营销趋势调查报告.pdf【CTR】2024中国广告主营销趋势调查报告.pdf【CTR】2024中国广告主营销趋势调查报告.pdf【CTR】2024中国广告主营销趋势调查报告.pdf【CTR】2024中国广告主营销趋势调查报告.pdf【CTR】2024中国广告主营销趋势调查报告.pdf【CTR】2024中国广告主营销趋势调查报告.pdf【CTR】2024中国广告主营销趋势调查报告.pdf【CTR】2024中国广告主营销趋势调查报告.pdf【CTR】2024中国广告主营销趋势调查报告.pdf【CTR】2024中国广告主营销趋势调查报告.pdf【CTR】2
毕业答辩PPT模板，共24页
08-15
毕业答辩PPT模板，共24页
PHPStudy-BackDoor-EXP PHPstudy后门利用脚本 (5).zip
08-15
php面试题
AuToGraFS-2.0.1b0-py2.py3-none-any.whl.zip
08-15
AuToGraFS-2.0.1b0-py2.py3-none-any.whl.zip
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值