Jenkins一键发布「apk&ipa」 到Bugly

背景

一大早刚到公司没多久,测试妹妹小韩跑过来:“老王,麻烦给我发一份xxx项目的最新安装包呗?”

老王:“啥,昨天不是发你一个了吗?”

小韩:“我要回归下昨天已解决的bug,所以~”

于是,老王蹭蹭蹭打开IDE,N分钟后一个安装包通过QQ扔给了小韩。五分钟后,小韩又跑过来了

小韩:“昨天你关闭的xxx bug好像没解决吧,我操作给你看下~”

老王放下手中的山东煎饼,盯着小韩的操作看了一遍。

老王:“不科学哇,我昨天肯定解决了,你装的是我刚发给你的吗?”

小韩:“肯定是啊,我刚卸载了重新按装的。。。”

老王:“难道是接口出问题了?你等下,我调试下。。。”

老王:“fuck,我用的正式环境的接口。。。稍等下,我一会儿再给你一个。”

N分钟之后,测试小韩终于告诉老王昨天的那个bug没问题了~

然后,小韩又跑去找iOS开发小李去了。。。此处省略500字~

反思

上面这个小故事,相信在不少公司都会存在。在测试阶段,测试人员在不断测试和回归的过程中,会和开发人员沟通,期间可能会发布N个安装包。

一般情况下,都是开发直接打包,然后发给测试人员。测试人员此时处于一个被动地位,只能被动的接受开发给的安装包,然后去做相关测试。

另外,打包对于开发来讲,可能觉得没啥技术含量的事情,夹杂着情绪去做事情迟早也会出纰漏。

Jenkins

Jenkins是一个持续集成工具,它可以在设定的某个时间点(或者代码有更新等情况)自动去构建安装包,同时可以将安装包上传到第三方平台,比如:Bugly蒲公英,这样测试人员可以通过微信、QQ扫一扫直接安装(Bugly的链接可以直接在微信内打开,这是我选择它的原因)。

当然,如果你需要,也可以将构建的结果(成功、失败),通过Email发送给相关人员,以便及时发现问题。

那么下面我们讲解如何使用Jenkins构建Android和iOS安装包,并自动上传Bugly平台吧~

软件环境

  1. Mac OS X EI Capitan
  2. Jenkins 2.19.3
  3. Tomcat
  4. AndroidStudio & Gradle等Android开发环境
  5. Xcode & 企业证书

Jenkins安装

打开Jenkins官网,选择“Download Jenkins”

Jenkins

选择左侧的“LTS Release”相对稳定的版本,我们看到Jenkins提供了很多平台的支持。

我是Mac环境,一般很多人都会去选择Mac OS X,直接选择这个可以省去Tomcat的安装。但经过我反复的实践,选择安装包安装的话,会生成一个Jenkins用户,后续的工作空间会在这个用户下,我遇到了各种文件夹权限问题,如果你去授予了读写权限,又会遇到Jenkins打不开的问题了~

所以,后来我直接放弃了,虽然网上有各种办法,可能他们的版本比较旧。最后,受到高人指点,我直接下载了.war文件,知道的朋友应该明白,这个文件是直接放在Tomcat下webapps下,然后你就可以使用了,它的权限就是当前用户,所以就不存在问题了~

所以下载好.war文件之后,我们就开始安装Tomcat吧。

Tomcat安装
下载地址:http://tomcat.apache.org/download-70.cgi

Tomcat安装

选择zip压缩文件,下载完成后解压缩到你的目录,我放在/Users/hiphonezhu/Desktop/D/software/apache-tomcat-8.5.8

然后,把上面一步下载好的Jenkins.war放到apache-tomcat-8.5.8/webapps目录下。

运行Jenkins

命令行进入Tomcat安装目录bin文件夹下,执行如下命令:

$ cd /Users/hiphonezhu/Desktop/D/software/apache-tomcat-8.5.8/bin
$ startup.sh
运行Jenkins

打开浏览器,输入http://localhost:8080/, 看到这个页面表示Tomcat启动成功了

Manager Apps

点击“Manager Apps”,会提示输入用户名和密码,Tomcat默认是没有用户名和密码的,那怎么办呢?

我们点击取消,会出现这个页面:

401登录提示

它提示我们在conf/tomcat-users.xml文件中可以配置用户,打开文件,在最后加入用户:

conf/tomcat-users.xml

重新启动Tomcat:

$ cd /Users/hiphonezhu/Desktop/D/software/apache-tomcat-8.5.8/bin
$ shutdown.sh
$ startup.sh

再次点击“Manager Apps”,输入用户名和密码,进入Tomcat管理界面:

Tomcat管理界面

如果你刚刚下载了Jenkins.war并放到了apache-tomcat-8.5.8/webapps目录下,此时会看到/jenkins这个应用,如上图红色区域,点击我们就打开Jenkins了。

安装Jenkins插件

初次打开Jenkins会提示你输入密码,按照提示找到文件并打开,然后填入密码即可,这里不贴图了。

然后会提示你安装插件,我们首先选择推荐安装推荐的插件。经过漫长的等待,我们终于进去Jenkins管理界面了

Jenkins管理界面

选择“Manager Jenkins”,进入设置界面

Manage Plugins

选择“Manage Plugins”进入插件管理界面

Install Plugins

我们额外需要安装的插件有:

  1. Git
  2. Gradle
  3. Xcode

因为我的代码托管在自建的gitblit上,所以源码管理工具选择了Git。如果你的代码放在Github上,还需安装GitHub插件。

当然,如果你使用SVN,那么还需安装SVN相关插件,这里不做更多介绍。

新增构建项目(通用)

回到Jenkins主页,点击“New Item”

New Item

输入项目名称,点击“OK”,进入配置界面

Source Code Management

选择“Source Code Management”,设置Git的地址ssh://zhuhfxxxxxxxxx,选择认证方式“Credentials”,点击“Add”

Credentials

我们选择“SSH Username with private key”认证方式,“Username”随意填写,只是Jenkins的存储的用户而已。

“Private Key”就是“SSH Key”,首先你要在本地生成一对“私钥”和“公钥”,然后把公钥填到你的源码管理库里面去,这里的key填写的是私钥,不熟悉的朋友可以参考这篇文章:http://jingyan.baidu.com/article/a65957f4f0acc624e67f9bc1.html

设置成功后,选择你刚刚填写的用户,如果认证成功,则没有提示,如果失败下图红色区域会出现红色错误提示(写本篇文章的时候,尝试填写错误的居然不提示了,我发誓一开始我输错了确实提示了~):

认证失败

设置构建条件

Paste_Image.png

经常用到的是以下两个:

Build periodically:周期进行项目构建(它不care源码是否发生变化)。

Poll SCM:定时检查源码变更(根据SCM软件的版本号),如果有更新就checkout最新code下来,然后执行构建动作。

参数配置参考:
http://blog.csdn.net/xueyingqi/article/details/53216506
http://blog.csdn.net/yezicjj/article/details/52763700

通用的设置介绍完了,下面我们介绍Android和iOS不同的构建参数设置。

Android构建

Build

Build选择“Add build step”,因为Android使用Gradle打包的,所以我们选择“Invoke Gradle script”。

Gradle

正常情况下,只需要设置Tasks的参数。

Tasks的参数其实就是./gradlew xxx后面的参数,比如我们填写的assembleDebug,最终执行的命令就是:

$ ./gradlew assembleDebug

表示最终打包出来的是Debug版本,这个和你在AndroidStudio中使用命令行打包是一个道理,我们可以使用

$ ./gradlew tasks

来查看你的项目可以执行的任务

tasks

如果你的项目在命令行使用

$ ./gradlew assembleDebug
$ ./gradlew assembleRelease

或者其他命令(多个productFlavors)可以正常打包,那么Jenkins也是可以正常打包的。

这里需要说明的是,如果你需要打Release包,那么你的app/build.gradle文件中需要有签名的配置:

signing config

配置完成后,点击“Save”按钮,回到你新建的项目。主动构建,点击“Build Now”

Build Now

在“Build History”中:

  1. 正在构建的会显示当前构建的进度;
  2. 如果最后显示蓝色的表示构建成功;
  3. 红色表示构建失败;
  4. 灰色表示构建被终止,可能是用户主动点击了“x”号。

选择某一次构建记录,点击“Console Output”,可以查看构建的过程

Build Detail

成功情况,最后你会看到“BUILD SUCCESSFUL”字样
Build Successful

最终apk的输出目录,和我们用AS开发一致,在app/build/outputs/apk文件夹中:

Apk

Android的构建,我们暂且到此,自动上传至Bugly平台因为Android和iOS基本是类似的,所以会在文章最后统一讲解。

下面我们来看下iOS的构建步骤吧~

iOS构建

Xcode

Build选择“Add build step”,选择“Xcode”

General build settings

这里有一点需要说明,因为会影响到下面的配置。

以前我们在使用第三方库的时候,一般都是手动下载到本地,然后加入到项目中。

现在很多项目都是用CocoaPods来管理第三方库,这个和Android的Gradle非常类似,可以方便的安装和升级使用第三方库。

不使用CocoaPods,你的项目文件是xxx.xcodeproj,使用之后我们要通过xxx.xcworkspace来打开项目,这个非常重要,直接影响了我们接下来的配置。

如果你没使用CocoaPods,那么Target这一项,需要填写你项目的Target,也就是下图红色区域的文字:

Target

如果你使用了CocoaPods,那么这一项请留空,我们会在后面的scheme中填写。

记住:target和project一起使用,scheme和workspace配套使用,更多信息请查看workspace, project, target, scheme 解析

我们继续,点击“General build settings”中的“Settings...”按钮,展开更多选项:


General build settings-Settings...
  1. 我们将“Clean before build?”打钩,build之前清理一下,总归保险一点,有时候清理下,问题就没了~
  2. Configuration有两个值,“Debug”和“Release”,这个和Xcode “Edit Scheme”中的“Build Configuration”的值一致:
Edit Scheme
Build Configuration

Debug和Release最多的用途,还是用于测试环境和正式环境不同的配置,比如常用的接口API的地址:

API

它与发布AppStore或者第三方平台内测,没有太多直接的关系。

ipa命令规则:

Pack

“Pack application and build .ipa?”,选择打钩,表示需要生成ipa文件。

  1. .ipa filename pattern,ipa文件的命名规则,如果不填写默认规则是:target-version-build,例如xxx-1.0.0-2.ipa。

你可以使用 ${VERSION} 、${BUILD_DATE} (yyyy.MM.dd)等系统的值来组合最终的名称,也可以像红色区域一样,写一个固定的名称。

注意:这里不需要填写.ipa后缀,Jenkins会自动帮我们加上的。
  1. Output directory,建议不清楚的不要填写,它表示ipa输出目录,是一个相对路径,相对于CONFIGURATION_BUILD_DIR这个默认的Build目录或者你修改之后的Build目录;
  2. Manifest Plist URL,打ipa包的时候可以直接生成plist文件,它的plist的url填写成你的服务的地址,这个地址加上文件名就组成了可下载ipa包的https服务地址url。这个plist url中jenkins会自动后面加上ipa文件名。

如果你用的自己的HTTPS服务器,来提供Ad Hoc或者In-House类型的ipa包发布,那么这里可以填写你的服务器地址(现在要权威机构颁发的证书才能使用,自建的https无法访问)。

因为我们使用bugly作为分发平台,所以这里就不配置了,有兴趣的自行搜索下~

Code signing & OS X Keychain options


Code signing
  1. Change bundle ID?,用于动态修改bundle ID,你需要指定新的bundle ID和plist文件的路径。一般情况不用修改,有时候测试包和正式包需要共存,这里可以修改下;
  2. Code Signing Identity,用于签名的证书名称,如果开发或者发布证书不是你创建的,让创建者导出p12和mobileprovision文件给你,安装p12之后,打开钥匙串,把证书的名字复制填入即可


    Paste_Image.png

    这里涉及到iOS签名证书的制作和生成,不是本文讨论的重点,不懂的同学可以参考文章最后的链接。

  3. Sign IPA at build time,表示对编译的时候对IPA包签名,不打勾的话执行xcrun命令的时候,不会加上--sign 参数,这据说是Xcode的一个bug~
  4. Embedded Profile,这个是填写mobileprovision描述文件的完整路径。

Code Signing Identity和Embedded Profile这两个空都可以不填,这样会使用Xcode中的配置,如下图:

Code Signing Identity & Embedded Profile

Unlock Keychain


Unlock Keychain?

IPA签名的时候,需要你的Mac电脑当前登录的用户授予权限。保守起见,建议打钩;并在“Keychain password”中,输入Mac电脑当前用户登录的密码。(测试下来,使用war包方式,此项不勾选也是ok的~)

Advanced Xcode build options


Advanced Xcode build options
  1. Xcode Schema File,如果你使用workspace而不是project此项必填,与target类似,填写你需要构建的schema;
  2. Xcode Workspace File,.xcworkspace文件的路径,$WORKSPACE表示的是当前项目的路径,"/"后面就是.xcworkspace后缀的文件名,注意:这里不需要填写后缀;
  3. Build output directory,
    系统默认的Build目录是CONFIGURATION_BUILD_DIR,我们上文提到的ipa包的输出目录,其实就是相对于这个目录的路径;建议填写,比如我们填写的$WORKSPACE/jenkins-build,上文ipa的“Output directory”填写ipa,那么最终编译输出的文件和ipa包的目录结构如下:
build & ipa

点击“Save”,保存我们的配置,我们来尝试构建一下。

选择某一次构建记录,点击“Console Output”,查看构建的过程:

Console Output

红色区域可以看到,ipa成功打包出来了,路径和我们上面一张图的目录结构一致。

至此,iOS的配置也结束了。下面我们重点讲解下,如何上传「apk&ipa」到第三方分发平台Bugly~

上传Bugly

  1. 打开Bugly官网,注册完成后,新建一个项目:
    Bugly

    填写完基本信息后,选择平台,然后保存。

注意:Android和iOS不能用同一个产品,否则下文执行上传命令,即使参数正确,也会提示“文件上传成功,但版本创建失败!”

  1. 选择第一步创建的产品,打开“产品设置”页面:


    产品设置

    我们要使用App ID 和 App Key这两个参数。

  2. 打开之前在Jenkins创建的项目,选择“Configure”来修改配置项:
    选择Build,“Add build step”新增一个脚本“Execute shell”


    Execute shell

    输入脚本


    Shell

    具体如下:
    cd $WORKSPACE/jenkins-build/ipa
    curl —-insecure -F "file=@xxx.ipa" -F "app_id=xxx" -F "pid=2" -F "title=xxx" -F "description=xxx" https://api.bugly.qq.com/beta/apiv1/exp?app_key=xxx
    

    cd $WORKSPACE/jenkins-build/ipa,表示进入ipa输出文件夹;
    curl xxx,curl是一个命令,百度百科解释如下:

curl是利用URL语法在命令行方式下工作的开源文件传输工具。它被广泛应用在Unix、多种Linux发行版中,并且有DOSWin32、Win64下的移植版本。

具体的参数的解释:

curl

更多参数可以参考:Bugly官方文档

  1. 上传成功之后,我们再次打开“Console Output”查看构建日志:


    Paste_Image.png

    可以看到已经成功上传到Bugly了,


    内测分发

    点击“下载”安装包,或者打开“预览”界面,通过微信、QQ扫一扫来安装
    扫一扫

相信,写到这里,测试妹子小韩一定很开心的笑了,以后不需要再去找“隔壁老王”了。。。

也许你跟着本文的步骤,还是会出现各种问题,你的环境或者配置错误都可能是引起的原因。有问题的同学可以先搜索下,一般都能找到解决办法,如果还是不能解决,可以给我留言~

参考文章:

Jenkins:
http://www.tuicool.com/articles/7Z3aYna
http://blog.csdn.net/wyb199026/article/details/52225345
http://blog.csdn.net/youtk21ai/article/details/48719807

iOS打包:
http://www.cnblogs.com/zengshuilin/p/5771401.html
http://www.cnblogs.com/tangyuanby2/p/5848230.html
http://www.cnblogs.com/wangbinios/p/5709386.html
http://blog.csdn.net/he_jiabin/article/details/49275191

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 158,847评论 4 362
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,208评论 1 292
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,587评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,942评论 0 205
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,332评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,587评论 1 218
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,853评论 2 312
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,568评论 0 198
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,273评论 1 242
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,542评论 2 246
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,033评论 1 260
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,373评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,031评论 3 236
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,073评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,830评论 0 195
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,628评论 2 274
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,537评论 2 269

推荐阅读更多精彩内容