发布构建时如何从Artifact Feed引用类库替代项目引用

核心思路 #

把类库封装为可分发的包（如NuGet包），通过CI流程自动构建并推送到内部Artifact Feed，同时将UI、API主项目的项目引用替换为该Feed的包引用，CD阶段直接拉取包完成发布。

1. 配置类库项目生成可发布包 #

以.NET类库为例，在项目文件（.csproj）中添加包相关配置，确保构建时自动生成可推送的包：

<PropertyGroup>
  <!-- 包标识与版本，版本号绑定CI构建号实现自动递增 -->
  <PackageId>YourTeam.YourLibrary</PackageId>
  <Version>1.0.0-ci.$(BuildNumber)</Version>
  <Authors>YourTeam</Authors>
  <Description>业务通用类库</Description>
  <!-- 开启构建时自动生成nupkg包 -->
  <GeneratePackageOnBuild>true</GeneratePackageOnBuild>
  <!-- 按需添加符号文件，方便调试 -->
  <IncludeSymbols>true</IncludeSymbols>
</PropertyGroup>

2. 改造CI流程推送类库到Artifact Feed #

在CI构建流水线中新增以下步骤：

• 先构建整个解决方案，确保类库生成对应的.nupkg包文件
• 使用包管理工具推送包到内部Artifact Feed，以dotnet命令为例：

dotnet nuget push "**/*.nupkg" --source "你的Artifact Feed地址" --api-key "你的Feed授权密钥" --skip-duplicate

• 注意：添加--skip-duplicate避免重复推送相同版本包；版本号绑定CI构建号，确保每次构建的包版本唯一。

3. 替换主项目的依赖方式 #

• 移除UI、API项目中对类库的项目引用，改为添加来自Artifact Feed的包引用：

<!-- 删除原项目引用 -->
<!-- <ProjectReference Include="..\YourLibrary\YourLibrary.csproj" /> -->

<!-- 添加包引用，可使用通配符匹配最新CI版本，或指定固定版本 -->
<PackageReference Include="YourTeam.YourLibrary" Version="1.0.0-ci.*" />

• 在主项目的NuGet.Config中添加内部Artifact Feed源，确保构建时能拉取到包：

<packageSources>
  <add key="内部类库Feed" value="你的Artifact Feed地址" />
  <add key="nuget.org" value="https://api.nuget.org/v3/index.json" />
</packageSources>

4. 调整CD流程完成主项目发布 #

CD阶段无需再构建类库，只需执行以下操作：

• 确保CD环境的NuGet配置已包含内部Feed源，拉取对应版本的类库包
• 直接构建并发布UI、API主项目到目标服务器，此时主项目依赖将从Artifact Feed获取，而非本地项目引用
• 若需指定特定版本类库，可通过环境变量传递版本号，动态替换主项目中的包版本配置

关键注意事项 #

• 版本管理：采用语义化版本+CI构建号的格式（如1.0.0-ci.123），确保每次CI包版本唯一，CD阶段可精准拉取对应版本
• 本地开发兼容：本地调试时，可通过dotnet pack --output将类库包推送到本地NuGet源，既保留本地调试能力，又与CI/CD流程一致
• 权限控制：确保CI服务账号拥有Artifact Feed的推送权限，CD构建账号拥有拉取权限

内容的提问来源于stack exchange，提问作者the.herbert