个人博客 - 刘佳华

NuGet 包管理

发表于 分类于

创建 NuGet 包以及搭建离线服务

简介

NuGet 是 .NET 的包管理器，由于微软服务器做的十分到位，不像其他语言的包管理器 maven、pip、npm 等还要搬梯子或是映射国内镜像源，所以我一直不理解在公司内搭建 NuGet 服务的需求，但是最近有一些库需要给多个项目使用，确实使用包管理的方式要比每个项目集成代码或者拷贝 DLL 好得多，但是有些库适合提交到微软的包管理仓库，有些不适合。

NuGet 服务器

简介

BaGet 是一个轻量级 NuGet 服务器，开源 GitHub

部署

项目为跨平台应用，根据自己的习惯部署即可。
我直接使用代码编译运行，部署后访问地址为：http://localhost:50557

上传

创建好 NuGet 包后使用命令上传 .nupkg 即可，IP 端口根据实际部署地址为准

1
nuget push -Source http://localhost:50557/v3/index.json package.nupkg

项目安装

  1. 项目中右键点击管理 NuGet 程序包
  2. 在右上角程序包源中配置新增一个包源 http://localhost:50557/v3/index.json
  3. 正常使用安装 NuGet 程序包

创建 NuGet 程序包

简介

NuGetPackageExplorer 是一个使用 GUI 创建、更新和部署 NuGet 包的工具，推荐使用 Microsoft Store 安装。

创建 NuGet 项目

创建较为简单，不多介绍了，配置好名称版本库信息，库添加到 lib 下对应的版本中。

遇到的问题

NuGet 中包含的文件无法拷贝到项目生成目录

参考 Create a package using the nuget.exe CLI 所有内容复制到项目根目录的文件，放到 content 下，但是实际测试并没有拷贝到项目根目录下，参考其他博客文章，几种方式都没有起效果。

  1. 使用 NuGetPackageExplorer 编辑 Files 标签无法保存，不清楚是什么原因导致的。
  2. 二进制文件放到 contentFiles\ 目录下，然后使用 contentFiles 标签配置，但是安装 NuGet 包时报错只能拷贝文本文件。
  3. 使用 init.sp1 脚本执行拷贝，测试安装后脚本并没有执行。

所以目前我只能手动在安装 NuGet 包后手动添加配置或把文件手动把文件拷贝到项目根目录，编辑项目配置文件。
例如： NuGet 包名为 Test，版本号为 1.0.0，要拷贝的文件包含在 content\lib 下，拷贝到项目生成目录 \lib。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
<ItemGroup>
    <PackageReference Include="Test" Version="1.0.0" />
</ItemGroup>
<!--需要添加的配置-->
<ItemGroup>
    <!-- Content 项表示需要作为内容文件包含到项目中的文件或文件集合。 -->
    <!-- Include 属性指定了要包含的文件或文件集合的路径模式，这里使用 NuGet 包根目录和特定子目录的通配符来匹配所有文件。 -->
    <Content Include="$(NuGetPackageRoot)\Test\1.0.0\content\lib\**">
        <!-- LinkBase 属性定义了在项目内部如何引用这些文件的基础路径，它决定了文件在项目中显示的位置，通常用于将文件组织到特定的目录结构中。 -->
        <LinkBase>lib</LinkBase>
        <!-- CopyToOutputDirectory 属性决定了文件在构建过程中是否应该被复制到输出目录，以及复制的行为。 -->
        <!-- "Always" 表示无论构建成功或失败，文件都会被复制到输出目录。 -->
        <!-- "PreserveNewest" 仅当文件比输出目录中的文件新时才复制。 -->
        <!-- "Never" 不复制文件。 -->
        <CopyToOutputDirectory>Always</CopyToOutputDirectory>
        <!-- Visible 属性决定了这些文件是否应该在解决方案资源管理器中可见。 -->
        <!-- "false" 表示这些文件在解决方案资源管理器中是不可见的。 -->
        <!-- "true" 则表示文件在解决方案资源管理器中是可见的。 -->
        <Visible>false</Visible>
        <!-- LinkBaseTargetFramework 属性通常用于多目标框架项目，以指定目标框架的链接基础。 -->
        <!-- 在这里为空，表示没有指定特定的目标框架链接基础。 -->
        <!-- 如果设置了该属性，它将影响文件在不同目标框架下的链接路径。 -->
        <LinkBaseTargetFramework></LinkBaseTargetFramework>
        <!-- LinkBaseSpecificVersion 属性用于控制是否使用特定版本的链接基础。 -->
        <!-- "false" 表示不使用特定版本的链接基础，这通常意味着链接路径不会包含版本号信息。 -->
        <!-- "true" 则链接路径可能会包含文件来源的版本号信息，以区分不同版本的文件。 -->
        <LinkBaseSpecificVersion>false</LinkBaseSpecificVersion>
    </Content>
</ItemGroup>