如何在ADO中创建仅含JSON文件的NuGet包并让引用项目获取文件

1. 修正NuGet包的文件打包配置（package.nuspec） #

确保JSON文件被正确打包到contentFiles目录（适配SDK风格项目），同时包含构建目标文件：

<?xml version="1.0"?>
<package xmlns="http://schemas.microsoft.com/packaging/2013/05/nuspec.xsd">
  <metadata>
    <id>YourConfigPackage</id>
    <version>1.0.0</version>
    <contentFiles>
      <!-- 标记JSON文件为Content，复制到输出目录 -->
      <files include="any/any/Configs/**/*.json" buildAction="Content" copyToOutput="true" />
    </contentFiles>
  </metadata>
  <files>
    <!-- 通用配置文件打包路径 -->
    <file src="Configs/Common/*.json" target="contentFiles/any/any/Configs/Common" />
    <!-- 环境专属配置文件打包路径 -->
    <file src="Configs/Env/*.json" target="contentFiles/any/any/Configs/Env" />
    <!-- 构建目标文件打包到build目录 -->
    <file src="bla.targets" target="build" />
  </files>
</package>

2. 完善构建目标文件（bla.targets） #

通过MSBuild目标强制将NuGet包中的JSON文件复制到引用项目的指定路径，并纳入构建：

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <!-- 定义NuGet包中的JSON文件集合 -->
  <ItemGroup>
    <ConfigJsonFiles Include="$(MSBuildThisFileDirectory)..\contentFiles\any\any\Configs\**\*.json" />
  </ItemGroup>

  <!-- 在构建前执行文件复制 -->
  <Target Name="CopyConfigFilesToProject" BeforeTargets="BeforeBuild">
    <!-- 复制到项目根目录下的Configs文件夹（可按需修改路径） -->
    <Copy
      SourceFiles="@(ConfigJsonFiles)"
      DestinationFiles="$(ProjectDir)Configs\%(RecursiveDir)%(Filename)%(Extension)"
      SkipUnchangedFiles="true"
      OverwriteReadOnlyFiles="true"
    />

    <!-- 将复制后的文件标记为项目Content，确保纳入构建和输出 -->
    <ItemGroup>
      <Content Include="$(ProjectDir)Configs\%(RecursiveDir)%(Filename)%(Extension)" />
    </ItemGroup>
  </Target>
</Project>

3. 验证与重建步骤 #

• 重新打包并推送NuGet包到私有源
• 在引用项目中卸载旧包，重新安装新包
• 执行清理解决方案→重建解决方案操作

此时引用项目的指定路径（如./Configs）下会出现JSON配置文件，且这些文件会被标记为Content类型，自动参与构建并复制到输出目录。

额外注意事项 #

• 若使用非SDK风格项目，可将contentFiles替换为content目录（旧版NuGet复制逻辑），但contentFiles更适配现代项目结构
• 如需区分环境配置，可在.targets中通过Condition结合环境变量/项目属性实现按需复制

内容的提问来源于stack exchange，提问作者Ed Williams