在制作跨平台的 NuGet 工具包时,如何将工具(exe/dll)的所有依赖一并放入包中

本文详细介绍了在制作跨平台NuGet工具包时如何将工具(如exe/dll)及其所有依赖项一同打包进nupkg文件。针对默认情况下NuGet不包含依赖的问题,作者通过研究Microsoft.NET.Sdk源码,发现并提供了解决方案,即创建自定义Target,设置正确的属性以确保所有必需的依赖都被正确地包含在NuGet包中。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

NuGet 提供了工具类型的包支持,生成一个基于 .NET Core 的 dll 或者基于 .NET Framework 的 exe 之后,你几乎可以对项目做任何事情。但是,默认情况下,NuGet 不会将这些工具的依赖一起打包进入 NuGet 包 nupkg 文件内,这就使得功能比较复杂的跨平台 NuGet 工具包几乎是无法正常工作的。

本文将介绍将这些依赖加入 NuGet 包中的方法,使得复杂的工具能够正常使用。


问题

你可能是在 创建一个基于命令行工具的跨平台 NuGet 工具包 的时候遇到依赖问题的,也可能是自己做到另外什么工具遇到的。

典型的例子,我正在做一个基于 Roslyn 的 NuGet 工具包。于是整个 Roslyn 的大量 dll 都是我的依赖。但默认情况下,打出来的包并不包含 Roslyn 相关的 dll。

探索

官方关于 NuGet 的文档 并没有提及任何关于额外添加依赖文件的方法,擅长 NuGet 的大神 Nate McMaster 虽然有一篇关于加入 NuGet 依赖的博客 MSBuild tasks with dependencies,但依然没有很简单地解决。

尝试找一个实际将这些依赖 Include 进来,但是不知道什么时机合适。太早了依赖文件还没有生成,太晚了 NuGet 包中即将打的文件早已确认,Include 了也没用。

于是,我去阅读了 Microsoft.NET.Sdk 的源码,找到了并没有公开的内部方法来解决这个问题。关于阅读 Microsoft.NET.Sdk 源码的方式,可以参考 解读 Microsoft.NET.Sdk 的源码,你能定制各种奇怪而富有创意的编译过程Reading the Source Code of Microsoft.NET.Sdk, Writing the Creative Extension of Compiling

NuGet 打包的核心在 NuGet.Build.Tasks.Pack.targets 文件,主要是这段代码(省略了大量内容,留下了看起来有点儿关系的部分):</

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值