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

栏目: 编程工具 · 发布时间: 5年前

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

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 文件,主要是这段代码(省略了大量内容,留下了看起来有点儿关系的部分):

<!-- 已删减大量内容,全部内容请自己阅读源码。 -->
<PackTask PackItem="$(PackProjectInputFile)"
          PackageFiles="@(_PackageFiles)"
          PackageFilesToExclude="@(_PackageFilesToExclude)"
          PackageTypes="$(PackageType)"
          IsTool="$(IsTool)"
          IncludeBuildOutput="$(IncludeBuildOutput)"/>
</Target>

PackageTypesIsTool 是我放来灌水的,这两个属性决定了我们打出来的包的类型(是否是工具类型)。看起来像的是 PackageFilesPackageFilesToExclude 属性,不过这两个属性用到了私有的属性 @(_PackageFiles)@(_PackageFilesToExclude)

所以接下来需要搜索到底是那里在为 @(_PackageFiles)@(_PackageFilesToExclude) 赋值。搜索 <_PackageFiles 可以找到赋值的地方就在 NuGet.Build.Tasks.Pack.targets 文件中:

<!-- 已删减大量内容,全部内容请自己阅读源码。 -->
<Target Name="_GetPackageFiles" Condition="$(IncludeContentInPack) == 'true'">
  <ItemGroup>
    <_PackageFilesToExclude Include="@(Content)" Condition="'%(Content.Pack)' == 'false'"/>
  </ItemGroup>
  <!-- Include PackageFiles and Content of the project being packed -->
  <ItemGroup>
    <_PackageFiles Include="@(Content)" Condition=" %(Content.Pack) != 'false' ">
      <BuildAction Condition = "'%(Content.BuildAction)' == ''">Content</BuildAction>
    </_PackageFiles>
    <_PackageFiles Include="@(Compile)" Condition=" %(Compile.Pack) == 'true' ">
      <BuildAction Condition = "'%(Compile.BuildAction)' == ''">Compile</BuildAction>
    </_PackageFiles>
    <_PackageFiles Include="@(None)" Condition=" %(None.Pack) == 'true' ">
      <BuildAction Condition = "'%(None.BuildAction)' == ''">None</BuildAction>
    </_PackageFiles>
    <!-- 已删减大量内容,全部内容请自己阅读源码。 -->
  </ItemGroup>
</Target>

这是一个私有 Target ,所以答案已经呼之欲出了。

答案

我们写一个 Target ,将 _GetPackageFiles 设为我们的前置 Target。然后,我们就可以把输出目录中除了 NuGet 自然而然会帮我们打入 NuGet 包中的所有文件都加入到 NuGet 包中的对应目录下。

具体来说,是将下面的 Target 添加到项目文件的末尾。

<Target Name="IncludeAllDependencies" BeforeTargets="_GetPackageFiles">
  <ItemGroup>
    <None Include="$(OutputPath)*.*" Exclude="$(OutputPath)$(AssemblyName).exe;$(OutputPath)$(AssemblyName).pdb" Pack="True" PackagePath="tools\net47" />
  </ItemGroup>
</Target>

本文会经常更新,请阅读原文: https://walterlv.github.io/post/include-dependencies-into-nuget-tool-package.html ,以避免陈旧错误知识的误导,同时有更好的阅读体验。

在制作跨平台的 NuGet 工具包时,如何将工具(exe/dll)的所有依赖一并放入包中 本作品采用 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议 进行许可。欢迎转载、使用、重新发布,但务必保留文章署名 吕毅 (包含链接: https://walterlv.github.io ),不得用于商业目的,基于本文修改后的作品务必以相同的许可发布。如有任何疑问,请 与我联系


以上所述就是小编给大家介绍的《在制作跨平台的 NuGet 工具包时,如何将工具(exe/dll)的所有依赖一并放入包中》,希望对大家有所帮助,如果大家有任何疑问请给我留言,小编会及时回复大家的。在此也非常感谢大家对 码农网 的支持!

查看所有标签

猜你喜欢:

本站部分资源来源于网络,本站转载出于传递更多信息之目的,版权归原作者或者来源机构所有,如转载稿涉及版权问题,请联系我们

高性能网站建设指南(第二版)

高性能网站建设指南(第二版)

Steve Souders / 刘彦博 / 电子工业出版社 / 2015-5 / 55.00元

《高性能网站建设指南:前端工程师技能精髓》结合Web 2.0以来Web开发领域的最新形势和特点,介绍了网站性能问题的现状、产生的原因,以及改善或解决性能问题的原则、技术技巧和最佳实践。重点关注网页的行为特征,阐释优化Ajax、CSS、JavaScript、Flash和图片处理等要素的技术,全面涵盖浏览器端性能问题的方方面面。在《高性能网站建设指南:前端工程师技能精髓》中,作者给出了14条具体的优化......一起来看看 《高性能网站建设指南(第二版)》 这本书的介绍吧!

SHA 加密
SHA 加密

SHA 加密工具

RGB HSV 转换
RGB HSV 转换

RGB HSV 互转工具

HSV CMYK 转换工具
HSV CMYK 转换工具

HSV CMYK互换工具