这些天做了一个基于 VSTS 的 Xamarin.Android的持续集成,这里分享下
Build Agent 环境需求
DotNetFramework
msbuild
visualstudio
AndroidSDK
JDK
Xamarin.Android
Build的部分分为以下步骤:
1. 还原NuGet包
a. 这步之所以存在,原因为我使用了Xamarin.Android进行编译,而没有直接对解决方案使用MSBUILD进行编译,所以需要单独还原一下NuGet包
b. 解决方案路径填写 **\*.sln 即可
2. 替换版本号
a. Xamarin.Android的版本号与AndroidManifest.xml中的versionName与versionCode有关,我在这里使用Powershell将版本号替换成了新的
b. 此脚本传递参数为当前源代码路径,$(Build.SourcesDirectory)
c. 脚本代码:
param( [string]$path ) if([String]::IsNullOrEmpty($path)){ $path= $($MyInvocation.MyCommand.Definition.Replace("build\changeVersion.ps1" ,"")) } write $path $pattern='android:versionName="[^"]+"' $version=[String]::Format('android:versionName="{0}.{1}"',[DateTime]::Now.Year-2013,[DateTime]::Now.ToString("M.d.H")) $filePath = [System.IO.Path]::Combine($path,"source\AndroidAppProject\Properties") write $filePath ls $filePath *.xml | %{sc -Path $_.FullName -Value $($(gc $_.FullName) -replace $pattern,$version) }
3. 编译Android程序
a. 使用TSTS自带的Xamarin.Android进行编译
b. 输出目录我设定在了$(Agent.BuildDirectory)\bin\$(BuildConfiguration)
c. 配置使用用户入队时的配置$(BuildConfiguration)
4. 获取编译Andorid的AndroidManifest数据,例如 packagename/label/versionName等
a. 这个是我自己写的一个VSTS扩展,用于获取一些应用的基本信息,并存储在对应的变量中,以备后续步骤使用(生成ReleaseNote时)
5. 对编译好的Android apk进行签名
a. 使用 VSTS自带的Android签名 功能进行签名
b. 需要勾选 为APK签名,并填入Keystore密码、Keystore别名,密钥密码
c. Jarsigner 参数: -verbose -sigalg MD5withRSA -digestalg SHA1
d. 勾选Zipalign
6. 删除多余的文件
a. 因为编译时 DLL 也会被复制过来,所以需要删除下多余的文件,只留APK
7. 生成 ReleaseNotes
a. 使用的是 rfennell 的生成ReleaseNote的VSTS扩展 https://github.com/rfennell/vNextBuild/tree/master/Extensions/GenerateReleaseNotes
b. 我这里将 ReleaseNotes,生成了一个 MarkDown :ReleaseNotes.md,以备发布时使用
8. 生成预发布脚本
a. 我提前写了一个预发布Powershell脚本用于将APK发布到Bugly,主要是调用 CURL,这里就不详述了
这样,就可以进行 手动或自动集成的操作
小技巧:
关于敏感数据,一些敏感数据,比如签名时的密码、其实可以在 生成定义 的 变量 中进行定义,并设置为加密变量 ,这样在传输或编辑时,都将无法查看此变量
引用:
Vsts build 中可以使用的变量:
https://www.visualstudio.com/zh-cn/docs/build/define/variables
Bugly api文档
https://bugly.qq.com/docs/user-guide/api-beta/?v=20160824161206
获取 Xamarin.Android AndroidManifest 信息
https://github.com/chsword/zou-vsts-tasks