绑定在teamcity中的Nuget软件包不安装文档文件-Java 学习之路

所以基本上我通过运行“pack”目标的.proj文件在TeamCity中构建nuget包：

<MSBuild 
    Projects="$(MSBuildProjectDirectory)\PROJNAME.csproj"
    Targets="Rebuild;pack"
    Properties="Configuration=$(Configuration);Version=$(BUILD_NUMBER)" />

使用以下工件输出：

PROJNAME\bin\Release\PROJNAME.%build.number%.nupkg

这很适合基本消耗nuget包，但是我无法使文档xml文件工作 .

我查看了输出nupkg，我看到文档xml实际上已捆绑并包含在包中，但问题是当我最终在我的消费项目中恢复nuget包时，dll会按预期复制，但是文档才不是 .

doc included in nuget package

我想知道这是否是因为TC生成的.nuspec文件，如果我可能需要放弃teamcities nuspec并创建我自己的，但是我希望避免这个，因为它的工作方式很好，并处理版本控制等 .

有什么简单的方法可以在包恢复时包含文档xml吗？

1 回答

0
最后我发现它归结为3件事，是：
- 确保将项目配置设置为生成文档 .
- 通过手动添加代码，例如：
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|AnyCPU'"><DocumentationFile>bin\$(Configuration)\netstandard2.0\Project.documentation.xml</DocumentationFile> </PropertyGroup> <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|AnyCPU'"> <DocumentationFile>bin\$(Configuration)\netstandard2.0\Project.documentation.xml</DocumentationFile> </PropertyGroup>
- 或者通过Visual Studio Project属性菜单，如果您通过VS执行此操作，还要确保对所有配置执行此操作（如下图中的A所示）：
- 将EnableDocumentationFile添加到.csproj文件中，例如：
<PropertyGroup> <TargetFramework>netstandard2.0</TargetFramework> <RootNamespace>project</RootNamespace> <Configurations>Debug;Release</Configurations> <EnableDocumentationFile>true</EnableDocumentationFile> </PropertyGroup>
- 并且最重要的是让您的项目知道（再次在您的.csproj中）它应该复制文档文件，如果您希望它与包dll显示在同一级别，请使用PackageFlatten：
<ItemGroup> <None Remove="bin\$(Configuration)\netstandard2.0\Project.documentation.xml" /> </ItemGroup> <ItemGroup> <Content Include="bin\$(Configuration)\netstandard2.0\Project.documentation.xml"> <Pack>true</Pack> <PackageCopyToOutput>true</PackageCopyToOutput> <PackageFlatten>true</PackageFlatten> </Content> </ItemGroup>
回复于 2024-04-29T15:29:23+08:00

绑定在teamcity中的Nuget软件包不安装文档文件

1 回答

相关问题