本文来告诉大家 msbuild Roslyn 的行为,本文非新手友好

常用参数

项目文件中的已知属性(知道了这些,就不会随便在 csproj 中写死常量啦) - walterlv

项目文件中的已知 NuGet 属性(使用这些属性,创建 NuGet 包就可以不需要 nuspec 文件啦) - walterlv

常用判断

msbuild 项目文件常用判断条件

行为属性

CopyLocalLockFileAssemblies

拷贝引用项到输出。默认行为下,对于 DLL 项目来说不拷贝引用项到输出,对于 Exe 或 WinExe 项目来说默认是会拷贝引用项到输出

如果想要让 DLL 项目也将引用项拷贝到输出,则可以配置 CopyLocalLockFileAssemblies 为 true 的值,如以下代码

  <PropertyGroup>
    <!-- 拷贝输出项,用于给 MauiWpfAdapt 项目引用 -->
    <CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies>
  </PropertyGroup>

多框架相关

调用次数

如有 Target 设置 AfterTargets="Build" 将在多框架下被分别调用,每个框架都会调用一次,最后还会再调用一次表示总的构建。调用次数等于框架数量加一

如在框架为 <TargetFrameworks>net45;netcoreapp3.1;net6.0</TargetFrameworks> 那将会分别在 net45 netcoreapp3.1 net6.0 调用一次,以及最终构建完成调用一次

多框架的 IntermediateOutputPath 属性值

默认是使用 IntermediateOutputPath 表示 obj 下的缓存文件夹,可以用来输出构建相关的缓存文件,在多框架下,默认是加上框架的路径,如 obj\Debug\net45\obj\Debug\net5.0\ 文件夹

随着调用的次数,各个框架构建的时候,将会带上框架的路径。在最终构建,也就是总的框架构建,调用时的值是不带上具体的框架的,如 obj\Debug\ 文件夹

测试逻辑如下

  <Target Name="GallikufawhaGebalule" AfterTargets="Build">
    <Warning Text="IntermediateOutputPath: $(IntermediateOutputPath)" />
  </Target>

在多框架 <TargetFrameworks>net45;net5.0</TargetFrameworks> 下,以上代码输出如下

1>C:\lindexi\Code\Foo.csproj(17,3): warning : IntermediateOutputPath: obj\Debug\net45\
1>已完成生成项目“Foo.csproj”的操作。
1>C:\lindexi\Code\Foo.csproj(17,3): warning : IntermediateOutputPath: obj\Debug\net5.0\
1>已完成生成项目“Foo.csproj”的操作。
1>C:\lindexi\Code\Foo.csproj(17,3): warning : IntermediateOutputPath: obj\Debug\

NuGet 相关

配置属性大全

dotnet 打包 NuGet 的配置属性大全整理

动态加入打包到 NuGet 包的文件时机

可在 _GetPackageFiles 这个 Target 前执行,在此执行加入 Nuget 打包文件才是有效,在这个时机之后将会无效,如以下代码

  <ItemGroup>
    <None Include="build\package.targets" Pack="True" PackagePath="\build\$(PackageId).targets" />
  </ItemGroup>

  <Target Name="FooIncludeAllDependencies" BeforeTargets="_GetPackageFiles">
    <ItemGroup>
      <None Include="..\Foo\Foo.dll" Pack="True" PackagePath="analyzers\dotnet\cs" />
    </ItemGroup>
  </Target>

以上代码的两个加入打包的文件都会成功都被加入打包。更多请参阅 Roslyn 打包自定义的文件到 NuGet 包

多框架的 BuildMultiTargeting 和 Build 文件夹下的 Target 调用次数

在 Build 文件夹下的 Target 将会在各个框架分别执行。放在 BuildMultiTargeting 的 Target 将只会执行一次,详细请看 Roslyn 在多开发框架让 msbuild 的 Target 仅运行一次

可以同时存在 BuildMultiTargeting 和 Build 文件夹,里面的内容相互不干涉,除非有设置调用关系和引用

独立框架的 Target 定义属性给多框架使用

在 Build 文件夹下的 Target 将会在各个框架分别独立执行,而 BuildMultiTargeting 只会执行一次。如果在 Build 文件夹下定义属性,如下面代码

  <Target Name="BuildSourceNuGet" AfterTargets="Build">
    <PropertyGroup>
      <IntermediateOutputPathCombine>$(IntermediateOutputPathCombine);$(IntermediateOutputPath)</IntermediateOutputPathCombine>
    </PropertyGroup>

    <Warning Text="build once"/>
  </Target>

预期是各个框架在 IntermediateOutputPathCombine 属性上定义各自的 IntermediateOutputPath 路径。然而在 BuildMultiTargeting 下拿到的依然是空值

  <Target Name="BuildSourceNuGetMultiTargeting" AfterTargets="Build">
    <Warning Text="MultiTargetingBuild: $(IntermediateOutputPathCombine)"/>
  </Target>

因此不能在 BuildMultiTargeting 上使用到各个 Build 文件夹下的 Target 收集的属性内容


本文会经常更新,请阅读原文: https://blog.lindexi.com/post/msbuild-Roslyn-%E8%A1%8C%E4%B8%BA%E8%AF%A6%E8%A7%A3.html ,以避免陈旧错误知识的误导,同时有更好的阅读体验。

如果你想持续阅读我的最新博客,请点击 RSS 订阅,推荐使用RSS Stalker订阅博客,或者收藏我的博客导航

知识共享许可协议 本作品采用 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议 进行许可。欢迎转载、使用、重新发布,但务必保留文章署名林德熙(包含链接: https://blog.lindexi.com ),不得用于商业目的,基于本文修改后的作品务必以相同的许可发布。如有任何疑问,请 与我联系

微软最具价值专家


无盈利,不卖课,做纯粹的技术博客

以下是广告时间

推荐关注 Edi.Wang 的公众号

欢迎进入 Eleven 老师组建的 .NET 社区

以上广告全是友情推广,无盈利