(此文章同时发表在本人微信公众号“dotNET每日精华文章”,欢迎右边二维码来关注。)
题记:这是一个简单的入门向导,涉及到GitHub、AppVeyor和Nuget.org。
最近在开发钉钉相关东西,遂简单包装了一个钉钉SDK并开源(https://github.com/keyroads/DingtalkSDK),这就涉及到如何进行持续集成并自动发布Nuget包的问题。之前一直都是使用TFS或者VSTS来做CI,既然是一个托管在GitHub中的开源项目,就从大家常用的持续集成平台(AppVeyor和Travis CI)中选一个(我选用的AppVeyor,因为它对.NET项目做了很多便捷的支持)。同时这是一个函数库,所以也需要自动发布到Nuget.org(当然MyGet中也可以),供有需要的人引用。
下面是具体步骤(流水账):
1,托管代码到GitHub中(废话),建议设master为主分支。
2,到https://ci.appveyor.com/signup 注册用户,选择“FREE”计划,登录可以选用GitHub帐号,这样方便更好的集成。
3,在AppVeyor的项目页面https://ci.appveyor.com/projects,新建项目,选择GitHub,选择列出的某个资源库(Repository)。注:如果之前就是用GitHub帐号登录AppVeyor的话这里就会列出你在GitHub上的项目(如果需要选择你某个组织的项目,那么授权的时候记得也对组织授权),如果没有用GitHub帐号登录,那么这里应该有个和GitHub帐号集成的过程。
4,在步骤3中选择“NEW”后,AppVeyor使用了一些默认的参数把项目马上建立好了。这个时候,理论上是可以正常进行CI了。不过很多时候,我们还是需要进行一些个性化的配置。AppVeyor的配置,可以基于YML格式文件来配置(在Repository的根目录放置appveyor.yml,AppVeyor就可以自动读取,当然也可以设定appveyor.yml文件的路径和文件名),也可以基于用户界面来配置。两者并存,文件方式默认优先用户界面方式,不过用户界面方式中有选项(General > Ignore appveyor.yml)可以忽略文件方式。
5,我自己的个性化配置如下:
5.1,同一个Repository我新建了两个CI项目,一个用于持续集成(每次提交和PR都会构建,命名为Build),一个用于“持续交付”(推送tag的时候,构建的同时把Nuget包部署到Nuget.org,命名为Publish)。
5.2,先说Build项目的配置。在General部分:我勾选了“Pull Requests do not increment build number”避免build编号不会被尚未接受的pr所打乱;“Branches to build”选择“Only branches specified below”输入“master”代表只对master分支的改变起作用;勾选“Do not build tags”因为tag由Publish项目来处理;勾选“Fetch repository as zip archive”以便项目代码多历史长的时候可以加快代码获取速度;勾选“Ignore appveyor.yml”。在Build部分:“Configuration”输入“Release”;“Before build script”选择CMD并输入“dotnet restore”和“nuget restore”两行,有dotnet是因为我的DingtalkSDK中有.NET Core的版本。
5.3,Publish项目的配置是基于Build项目的,不过改变或加入了如下配置。General部分:不勾选“Do not build tags”而勾选“Build tags only”以便推送tag的时候(即需要发布一个版本的时候)才触发CI;启用“AssemblyInfo patching”让发布的Nuget包的版本可以产生变化。Build部分:勾选“Package NuGet projects”让AppVeyor自动给你生成Nuget包(下面会更详细的解释)。Artifacts部分:添加一个artifact,在“PATH TO ARTIFACT”输入“temp_path\*.nupkg”,在“DEPLOYMENT NAME”输入“Nuget Packages”,“TYPE”选择“Auto”。在Deployment部分:添加一个deployment,“Deployment provider”选择“NuGet”,输入从Nuget.org获得的API-KEY到“API key”中,“Artifact(s)”输入“/.*\.nupkg/”。
6,上面提到Publish这个CI项目是会自动发布Nuget包到Nuget.org的。在AppVeyor的帮助下,这个过程其实是非常简单的。
6.1,下载Nuget.exe(https://dist.nuget.org/win-x86-commandline/latest/nuget.exe)。
6.2,进入到需要打包为Nuget的项目文件夹中,运行“nuget spec”来为当前项目生成一个打包描述nuspec文件。根据自己的需要编辑生成nuspec文件,比如添加依赖等。具体可以参考(https://docs.nuget.org/ndocs/schema/nuspec)。
6.3,把nuspec文件包含到源代码(注意在项目根目录,即和csproj文件在一起),并提交到GitHub中。这是让AppVeyor的“Package NuGet projects”选项起作用的关键步骤。通过启用这个选择,AppVeyor会自动给这个项目构建出Nuget包,并放到“temp_path”目录中,所以需要把这个Nuget包添加到构建输出artifact中。
6.4,到Nuget.org网站中,注册帐号(可以直接使用微软帐户来登录)。然后就可以在(https://www.nuget.org/account)获取到API KEY(在AppVeyor的部署配置中需要)。
7,最后就是把构建状态显示到GitHub中的项目首页。这个也很简单,在AppVeyor中的每个项目配置里都有一个Badges部分,把“Sample markdown code”复制到README.md中就搞定了。
至此,一个.NET开源函数库项目自动构建和部署就此配置完成。当然,由于目前DingtalkSDK对.NET Core还没有真正支持,所以并未考虑.NET Core的Nuget打包的配置。