设置 Nuget 本地源、在线私有源、自动构建打包

设置 Nuget 本地源、在线私有源、自动构建打包

• 本文演示如果在项目中生成 Nuget 包，并添加 Nuget 本地源，不用发布到 Nuget 服务器。再附带使用在线私有源的简单方法，以及提交代码自动拉取构建
• 本文用项目NewLifeX/X打包为 Nuget 包，项目NewLife.Cube测试

打包 nuget 包

• 项目右键属性-打包即可，执行之后会生成并打包，生成的 NuGet 包属性可以在项目属性面板的打包一项设置，设置版本号、包描述、作者信息等

• 注意，打包操作相当于生成，也就是说生成过但是没打包，此时打包并不会生成新的 Nuget 包，需要全部删除输出目录，重新打包

  

• 得到 nuget 包

  

设置 Nuget 源

• 打包之后需要设置一下 Nuget 源，让工具知道还原的时候用哪个源
• 项目右键属性-管理 Nuget 程序包-打开右边设置图标进入设置。从截图可以看到，如果是设置好包源的情况，两个包都提示可以升级，并且是刚刚生成的新版本，箭头旁边的下拉框对应的就是刚刚的包地址，即本地路径
  
  
• 添加本地目录作为 Nuget 源，直接填本机目录。依次打开选项中的 Nuget 包管理器-程序包源-绿色的加号-底下填名称-点击三个点按钮选择本地路径-更新-确定
  
  
• 经过以上设置，Nuget 包管理界面右边的下拉框就会出现刚刚设置的包源，选择刚刚设置的那个，在浏览选项卡就能看到只有这两个包

团队共享设置

• 上面设置的路径是某台电脑上的，另一台电脑对应地址又可能不一样，那么如何使用同一个设置，并且不用每个人都添加一次 Nuget 源呢？答案就是Nuget.config以及相对地址
• 首先是Nuget.config，在 VS 打开项目的时候，会自动加载里面的设置，自动添加源，只在本项目有效，并不是全局的。然后包地址设置为相对地址，相对于解决方案所在目录，两个项目均处于同一目录即可。本文的两个项目输出目录均为解决方案所在目录的上一目录
  
  
• 在解决方案目录新建文件Nuget.config，填写以下内容
  
  

<?xml version="1.0" encoding="utf-8"?>
<configuration>
 <packageSources>
  <add key="本地X组件" value="../Bin" />
 </packageSources>
</configuration>

• 可以看到，相对目录被识别为正确的地址，这样就可以达到所有人共用此设置的目的，Nuget.config的源排第一位，还原时优先从本地源查找还原
  
  

在线私有源

• Nuget 官方提供了NuGet.Server，可自行搭建自己的 Nuget 服务器，
• 这里使用BaGet，使用 Docker 快速搭建一个 Nuget 服务器
• 以 ubuntu 服务器为例，在当前目录新建baget.env文件，填写如下内容，注意 ApiKey，push 包的时候会用到

ApiKey=NUGET-SERVER-API-KEY
Storage__Type=FileSystem
Storage__Path=/var/baget/packages
Database__Type=Sqlite
Database__ConnectionString=Data Source=/var/baget/baget.db
Search__Type=Database

• 然后运行容器docker run --rm --name nuget-server -p 5555:80 --env-file baget.env -v "$(pwd)/baget-data:/var/baget" loicsharma/baget:latest
• 一切 ok 后就可以推送 Nuget 包了，dotnet nuget push -s http://localhost:5555/v3/index.json -k NUGET-SERVER-API-KEY newtonsoft.json.11.0.2.nupkg，注意推送地址以及 ApiKey，包名的话，一般懒得打可以用*.nupkg

在线自动构建 Nuget 包并发布-myget

• 使用myget，可以设置自动拉取源码，自动构建 Nuget 包，并且可以 push 到 nuget.org，所以可以用 myget 来测试
• 新建 feed
  
  
• 设置构建服务。如果点击之后没啥反应，没有弹窗或者只有黑色的遮罩，这可能是浏览器不兼容，换个浏览器（这里就是谷歌浏览器有问题，其它比如火狐没事。当然也可以打开控制台复制那个弹窗地址手动打开）
  
  
• 注意第一个设置，勾选之后，自动注册 web hook 每次提交触发构建服务
  
  
• 点击 build 开始第一次构建，点击 edit 可进行更多设置，设置包含源码、生成版本号的规则等
  
  
• 如果构建成功，点击一个包，即可看到安装方法，包源为https://www.myget.org/F/{你的feed名}/api/v3/index.json

总结

• 本文记录了这些 Nuget 包打包发布步骤，帮助还不知道这些方法但又想尝试的同学
• 方法多样，总有适合自己的，最适合团队的才是最好的。