如何针对不同配置/平台组合引用对应NuGet包？——SAP Business One SDK多版本多架构场景解决方案问询

一、修复当前条件PackageReference的显示问题 #

你现在遇到的VS显示所有8个包的问题，本质是Visual Studio的IntelliSense会加载所有PackageReference元素，不管ItemGroup的Condition是否满足——Condition只在构建阶段生效，编辑器阶段不会自动过滤。要解决这个问题，可以从两个方向调整：

1. 简化配置并精准过滤引用 #

先在项目文件的<PropertyGroup>中提取配置中的版本、数据库信息，减少重复代码：

<PropertyGroup>
  <!-- 从Configuration名称中拆分B1版本，比如B1v93SQL → v93 -->
  <B1Version>$([System.String]::Copy('$(Configuration)').Substring(3,3))</B1Version>
  <!-- 从Configuration名称中拆分数据库类型，比如B1v93SQL → SQL -->
  <B1Database>$([System.String]::Copy('$(Configuration)').Substring(6))</B1Database>
</PropertyGroup>

然后用单个ItemGroup通过属性拼接包名，同时给PackageReference加上条件判断：

<ItemGroup>
  <PackageReference 
    Include="OchALCommon.$(B1Version)$(B1Database)$(Platform)" 
    Version="1.0.*"
    Condition=" '$(Configuration)' Contains 'B1v' " />
</ItemGroup>

这种写法会让VS只识别当前活动配置/平台对应的包，不会显示全部8个条目。

2. 保留原结构但隐藏冗余引用 #

如果想沿用原来的多ItemGroup写法，给每个PackageReference加上PrivateAssets="All"，这样VS的解决方案资源管理器只会显示符合当前条件的引用：

<ItemGroup Condition=" '$(Configuration)|$(Platform)' == 'B1v93SQL|x64' ">
  <PackageReference Include="OchALCommon.v93SQLx64" Version="1.0.*" PrivateAssets="All" />
</ItemGroup>

二、最优方案：合并为单个NuGet包自动适配 #

你的理想目标（单个包支持所有8种组合）完全可行，核心是利用NuGet的MSBuild Targets注入和架构/配置感知能力实现自动适配，步骤如下：

1. 组织NuGet包目录结构 #

创建一个包项目，按版本、数据库、架构分层存放程序集：

OchALCommon/
├── build/
│   └── OchALCommon.targets  <!-- 自动适配的核心逻辑 -->
├── lib/
│   └── net48/  <!-- 假设类库基于.NET Framework 4.8，对应SAP B1 SDK环境 -->
│       ├── v93/
│       │   ├── SQL/
│       │   │   ├── x86/OchALCommon.dll
│       │   │   └── x64/OchALCommon.dll
│       │   └── HANA/
│       │       ├── x86/OchALCommon.dll
│       │       └── x64/OchALCommon.dll
│       └── v10/
│           ├── SQL/
│           │   ├── x86/OchALCommon.dll
│           │   └── x64/OchALCommon.dll
│           └── HANA/
│               ├── x86/OchALCommon.dll
│               └── x64/OchALCommon.dll
└── OchALCommon.nuspec

2. 编写Nuspec包描述文件 #

定义包元数据并指定要包含的文件：

<?xml version="1.0"?>
<package xmlns="http://schemas.microsoft.com/packaging/2013/05/nuspec.xsd">
  <metadata>
    <id>OchALCommon</id>
    <version>1.0.0</version>
    <title>OchALCommon for SAP Business One</title>
    <authors>Your Team</authors>
    <description>Multi-version, multi-architecture class library for SAP Business One SDK</description>
    <frameworks>
      <framework targetFramework=".NETFramework4.8" />
    </frameworks>
  </metadata>
  <files>
    <!-- 包含所有环境的程序集 -->
    <file src="lib/net48/**/*.dll" target="lib/net48" />
    <!-- 注入自动适配的Targets文件 -->
    <file src="build/OchALCommon.targets" target="build/net48" />
  </files>
</package>

3. 编写自动适配的Targets文件 #

这个文件会根据引用项目的配置和平台，自动加载对应的程序集：

<?xml version="1.0" encoding="utf-8"?>
<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <PropertyGroup>
    <!-- 从引用项目的Configuration中提取关键信息 -->
    <B1Version>$([System.String]::Copy('$(Configuration)').Substring(3,3))</B1Version>
    <B1Database>$([System.String]::Copy('$(Configuration)').Substring(6))</B1Database>
  </PropertyGroup>

  <ItemGroup>
    <!-- 根据当前配置自动引用对应程序集 -->
    <Reference Include="OchALCommon">
      <HintPath>$(MSBuildThisFileDirectory)..\lib\net48\$(B1Version)\$(B1Database)\$(Platform)\OchALCommon.dll</HintPath>
      <Private>True</Private>
    </Reference>
  </ItemGroup>
</Project>

4. 打包与使用 #

• 执行nuget pack OchALCommon.nuspec生成单个NuGet包。
• 引用项目只需添加一行配置：

<PackageReference Include="OchALCommon" Version="1.0.*" />

当引用项目切换到B1v93SQL|x64、B1v10HANA|x86等任意配置时，Targets会自动加载对应环境的程序集，完全无需手动切换包。

三、关于Directory.Build.targets不生效的问题 #

你之前遇到的修改后无响应的问题，大多是VS缓存导致的，可按以下步骤解决：

• 清理项目的obj和bin文件夹。
• 关闭VS，删除项目根目录的隐藏.vs文件夹。
• 重新打开项目，右键点击项目选择Reload Project。

内容的提问来源于stack exchange，提问作者Mark Rabjohn