Github自动打包并推送Nuget版本

时间:2022-05-15 08:51:24

如何将自己的类库,自动打包并自动发布到Nuget?

1. 项目csproject属性修改

新建一个项目GitToNugetPackageTest

Github自动打包并推送Nuget版本

不用添加任何类,我们修改csproject属性。

替换为以下模板内容后,并修改以下节点值:

  • TargetFrameworks 依赖的框架版本,比如net452;netcoreapp3.1,多个版本以分号隔开Version
  • Version 版本号,每次需要升级Nuget版本时,可以修改这个提交一下就行了。
  • RespositoryUrl、PackageProjectUrl替换成自己的项目地址和仓库地址
 <Project Sdk="Microsoft.NET.Sdk.WindowsDesktop">
<PropertyGroup>
<TargetFrameworks>net45</TargetFrameworks>
<GeneratePackageOnBuild>true</GeneratePackageOnBuild>
<Version>1.0.0</Version>
<Authors>Kybs0</Authors>
<UseWpf>True</UseWpf>
<UseWindowsForms>true</UseWindowsForms>
<RepositoryUrl>https://github.com/Kybs0/GitToNugetPackageTest.git</RepositoryUrl>
<PackageProjectUrl>https://github.com/Kybs0/GitToNugetPackageTest</PackageProjectUrl>
<PackageIconUrl></PackageIconUrl>
<RepositoryType>git</RepositoryType>
<Description>测试:Git自动打包,并推到Nuget源。</Description>
<LangVersion>latest</LangVersion>
</PropertyGroup>
<ItemGroup>
<None Remove="GitToNugetPackageTest.csproj.DotSettings" />
</ItemGroup>
<ItemGroup>
<PackageReference Include="System.ValueTuple" Version="4.5.0" />
</ItemGroup>
</Project>

2. 生成并上传Nuget包

在第1步的基础上,鼠标右击项目,点击打包

Github自动打包并推送Nuget版本

在Debug下可以查看到本地生成的nuget源包

Github自动打包并推送Nuget版本

将此源包上传至https://www.nuget.org/packages/manage/upload

上传成功后,在头像弹框内点击API KEYS,然后生成一个新的API KEY(关联上GitToNugetPackageTest)

Github自动打包并推送Nuget版本Github自动打包并推送Nuget版本

生成成功后,在API Keys列表找到新的Key,点击复制(复制以后保存在你的记事本里,第4步需要)。

注:注意保留API KEY!刷新页面就没有了,除非点击重新生成,但是重新生成的Key就是另一个Key值了。

所以为了减少麻烦,建议一个项目用一个API KEY。

3.新建Action,添加打包流程

在github上新建个repository,并将项目推送上去:https://github.com/Kybs0/GitToNugetPackageTest

然后在Action下新建一个workflow

Github自动打包并推送Nuget版本

选.NetCore模板,然后修改为以下内容:

 name: CI

 on:
push:
branches: [ master ]
pull_request:
branches: [ master ] jobs:
build:
runs-on: windows-latest # Steps represent a sequence of tasks that will be executed as part of the job
steps:
# 1.Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it
- uses: actions/checkout@v2
# 2.runtime environment
- name: Setup .NET Core
uses: actions/setup-dotnet@v1
with:
dotnet-version: 3.1.100
# 3.build
- name: Build with dotnet
run: dotnet build --configuration Release
# 4.Install Nuget
- name: Install Nuget
run: |
$sourceNugetExe = "https://dist.nuget.org/win-x86-commandline/latest/nuget.exe"
$targetNugetExe = "nuget.exe"
Invoke-WebRequest $sourceNugetExe -OutFile $targetNugetExe
# 5. Push package
- name: Push generated package to GitHub registry
run: |
.\nuget push .\GitToNugetPackageTest\bin\Release\*.nupkg -Source https://api.nuget.org/v3/index.json -SkipDuplicate -ApiKey ${{ secrets.NugetKey }} -NoSymbols

以上对master分支打包,并推送到Nuget。

需要修改的是第5步,如果workflow的yml格式文件是在解决方案下的,需要添加“.\GitToNugetPackageTest\bin\Release\*.nupkg”相对路径,改个名称就好。

4. GitHub关联相应的Nuget源地址

在github项目所在的设置-Secrets页面,添加第二步从nuget生成的API Key。

Github自动打包并推送Nuget版本

添加后,尝试修改csproject中的版本号为1.0.1,然后等待github打包,打包完成后,nuget包的版本就更新成1.0.1了:https://www.nuget.org/packages/GitToNugetPackageTest/

Github自动打包并推送Nuget版本

VS搜索nuget包:

Github自动打包并推送Nuget版本

以上适合小白浏览的经验步骤~

详细的打包原理及进阶,可以看俩个MVP大佬同事的博客

dotnet 配合 GitHub 的 Action 做自动推 Tag 时打包 NuGet 包

从零开始制作 NuGet 源代码包(全面支持 .NET Core / .NET Framework / WPF 项目)