IT技术互动交流平台

Jenkins+Xcode+Fir.im自动构建项目 并打包ipa上传(MAC)

来源:IT165收集  发布日期:2016-07-20 22:43:10

一、简述
jenkins是一个广泛用于持续构建的可视化web工具,持续构建即各种项目的”自动化”编译、打包、分发部署。jenkins可以很好的支持各种语言(比如:java, c#, php等)的项目构建,也完全兼容ant、maven、gradle等多种第三方构建工具,同时跟svn、git能无缝集成,也支持直接与知名源代码托管网站,比如github、bitbucket直接集成。

二、Jenkins的安装
1、Jenkins本身是用java语言开发的,所以安装Jenkins之前,要保证你的电脑有jdk,如果没有,请到如下链接下载:http://rj.baidu.com/soft/detail/25851.html?ald,另外建议git、ant、maven、gradle、groovy等工具也一并安装好,方便与这些构建工具集成。

2、进入Jenkins的官网 https://jenkins.io/index.html,然后下载并安装Jenkins。此处有两种安装方法,使用命令行安装和使用jenkins.pkg安装,建议使用后一种,步骤如下:
(1)如下图,点击 Download Jenkins
这里写图片描述

(2)然后选择 LTS Release->2.7.1.war->Mac OS X
这里写图片描述

(3)下载完成后,得到 jenkins-2.7.1.pkg 文件,点击直接安装即可,安装过程中,一路continue,到下图时,取消 start at boot as“jenkins”,一般不需要自启动。
这里写图片描述

(4)安装完成后,会直接跳转到如下界面,如果没有跳转或者跳转失败,可通过执行如下命令 ” open /Applications/Jenkins/jenkins.war ” 进入到该界面:
这里写图片描述

(5)观察图中的路径,然后打开你的终端,执行如下命令(注意:该命令仅在安装Jenkins的过程中执行才有效;安装成功后,再在终端中执行是无效的):
这里写图片描述

(6)然后将我们得到的password输入到“Administrator password“中,即可进入如下界面,接着安装一些建议的插件,安装过程中,有的插件可能会安装失败,可以跳过,之后需要对应的插件时,再重新安装即可,具体后面会讲到:
这里写图片描述

(7)插件安装完成后,可能会卡在如下界面,不会自动跳转,刷新下界面即可:
这里写图片描述

(8)在刷新后的界面中注册,输入用户名和密码,如下:
这里写图片描述

(9)注册成功后,点击”Start using Jenkins”
这里写图片描述

三、Jenkins的使用
1、安装成功后,会进入到如下界面:
这里写图片描述

2、由于安装过程中,有些插件可能会安装失败,通过如下方式检查所需的插件是否安装成功。
(1)通过“系统管理->管理插件->已安装“,检查如下所需的插件是否安装成功:
<1> Xcode integration
<2> GIT plugin
<3> Post-Build Script Plug-in
<4> GitHub plugin
<5> Email Extension Plugin
特别提醒:本人的项目是使用Git托管在OSChina上的,所以具体需要什么插件要具体考虑,建议最好对照上述步骤(7)中的插件安装结果来检查。

(2)如果有对应的插件没有安装成功,可通过“系统管理->管理插件->可选插件“来安装。安装插件的过程中,如下:
这里写图片描述

可以看到,插件已经安装成功。但是,打开“系统管理->管理插件->已安装“时,没有找到刚刚安装的插件,这是可以通过重启Jenkins,并重新安装来解决,直到最终我们安装的插件出现在“系统管理->管理插件->已安装“中。
提示:重启Jenkins的方法为:localhost:8080/restart

3、Jenkins的使用
(1)点击新建,创建一个项目
这里写图片描述

(2)输入项目名称,并选择构建一个自由风格的软件项目,点击下方的OK。
这里写图片描述

(3)General 中建议写上一些项目描述,其余的不用操作
这里写图片描述

(4)源码管理,配置如下:
我的项目是使用Git托管在OSChina上的,具体情况具体对待,配置如下:
<1> 选择Git
这里写图片描述

<2> 首先将托管在OSChina上的项目的URL这里写图片描述取出,并粘贴在图中位置
这里写图片描述

<3> 通过 “Credentials->Add->Jenkins”来添加OSChina的用户名和密码。
这里写图片描述

<4> 输入对应的用户名和密码后,并在Credentials中选择该帐号,其余选项不用操作。
这里写图片描述

(5)构建触发器,有多个选项,具体选择要看你的需求,举例说明:
<1> Build periodically:周期进行项目构建,它不关心源码是否发生变化。

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

<3> 我们接下来用Build periodically来演示,如下图,其中的日程表设置为 ” 10 12 * * * “,即每天中午的12点10分,都会自动构建一次:
这里写图片描述

提示:日程表中所填格式的含义,可以点击右侧的?来查看,其中有很详细的解释。

(6)构建环境,可直接跳过,不用设置。

(7)构建,设置如下:
1)General build settings
<1> 增加构建步骤,选择 Xcode。
这里写图片描述

<2> 在下图的Target中,保证该Target和Xcode项目工程中的Target同名。
这里写图片描述

Xcode项目工程中的Target如下图:
这里写图片描述

<3> 点击图中右下角的Settings
这里写图片描述

<4> 建议勾选Clean before build?,并将Configuration设为Release。
这里写图片描述

<5> 勾选Pack application and build .ipa?,同时为即将输出的ipa文件命名并指定输出路径,如下图:
这里写图片描述

2)Code signing & OS X keychain options
我在OSChina上托管的项目,已经在Xcode中就配置好了证书,所以只需要执行如下步骤:勾选 Unlock Keychain?,并输入对应的Keychain path 和 Keychain password 即可。
这里写图片描述

提示:怎样获得Keychain path 和 Keychain password ?
解决方案:回到Jenkins首页,系统管理->系统设置->
Xcode Builder,其中Keychain path会自动生成,Keychain Name 和 Keychain password 填写即可。
这里写图片描述

3)Advanced Xcode build options
此处有个注意点,即你的项目中使用CocoaPods和没有使用CocoaPods的配置是不同的。
<1> 假如你的项目中使用了CocoaPods,如下图配置,至于每一项是什么含义,点击后面的?,已经解释的很清楚了,不再赘述:
这里写图片描述

<2> 假如你的项目中没有使用CocoaPods,应配置如下:
这里写图片描述

4)Versioning 跳过即可。

(8)构建后操作
小提示:点击各个选项最后的?时,都会有相应选项的详细说明。
1)构建后,上传到fir.im
由于构建后,要上传到http://fir.im/apps,而且上传有两种常用方法,建议使用第一种。

第一种方法:使用插件fir-plugin-0629.hpi,直接点击下载即可。配置如下:
<1> 回到Jenkins首页,系统管理->管理插件->高级,通过下图将你下载的插件上传:
这里写图片描述

<2> 上传之后,在 “可选插件” 中找到它,然后安装。

<3> 安装成功后,如下图,选择 “增加构建后操作步骤”,选择 “Upload to fir.im”。
这里写图片描述

<4> 在Upload to fir.im 中,输入你的fir.im Token。
这里写图片描述

提示:fir.im Token 的获得方式:首先注册一个 fir.im 帐号,然后如下图,找到你的 fir.im Token。
这里写图片描述

如下图,即 fir.im Token,可重新生成。
这里写图片描述

<5> 其余选项略过。

第二种方法:使用命令行的形式配置并上传,简述如下:
<1> 选择 “增加构建后操作步骤”

<2> 选择 “Execute a set of scripts”

<3> 选择 “Add build step”

<4> 选择 “Execute shell”

<5> 在下图中输入:fir p${WORKSPACE}/build/TestJenkins.ipa -T#API Token#
这里写图片描述

提示1:其中${WORKSPACE}/build/为 .ipa 的输出路径,#API Token#为fir.im的API Token。

提示2:在使用该命令前请先确认安装fir-cli,安装命令如下:
sudo gem install fir-cli –no-ri –no-rdoc
上面的命令来自 fir.im 的工具 fir-cli,这是他们的官方使用说明:官方工具 fir-cli 使用说明。

2)构建后,自动发送邮件提醒
<1> Jenkins 自带一个邮件的通知的功能,但是自带的邮件通知功能,有点简单,不能自定义信息,所以我们安装邮件插件Email Extension Plugin。

<2> 首先确保在 “系统管理->插件管理->已安装 “中,已经安装了Email Extension Plugin,如果没有,请安装。

<3> 通过 “系统管理->系统设置->Extended E-mail Notification” 配置邮件服务器,此处以163邮箱为例,具体配置如下图,并指定 “Default Content Type”:
这里写图片描述

<4> 点击上图中的 “高级”,可以进一步设置,如下图,即指定一个可用的163邮箱,用来发送邮件,输入正确的邮箱和密码”:
这里写图片描述

同时指定 ” Default Recipients” 和 “Default Content”,具体如下图,其中 “Default Content” 可根据实际需求来调整。
这里写图片描述

<5> 在 “系统管理->系统设置->Jenkins Location” 中,将上述163邮箱作为 “系统管理员邮件地址”。
这里写图片描述

提示:邮箱(以163邮箱为例),一般都是禁止第三方邮件客户端来使用163邮箱来发邮件的,可以通过以下方式解决:
首先,进入163邮箱,找到设置;

然后,如下图,选择 “POP3/SMTP/IMAP”
这里写图片描述

最后,如下图,勾选 “Z喎"http://www.it165.net/pro/pkqt/" target="_blank" class="keylink">QT1AzL1NNVFC3/s7xJnJkcXVvOyC6zSAmbGRxdW87SU1BUC9TTVRQt/7O8SZyZHF1bzujrLKizai5/bbM0MXR6daktcS3vcq9o6zKtc/WyrnTw8rayKjC67XHwry12sj9t73Tyrz+v827p7bLoaOjqLTLtKa499bW08rP5LXEyejWw7K70ru2qM/gzayjrLWrtPPNrNCh0uyjqTxiciAvPgo8aW1nIGFsdD0="这里写图片描述" src="http://www.it165.net/uploadfile/files/2016/0720/201607202047171005.png" title="" />

<6> 回到项目中的 “构建后操作”处,继续进行设置,如下图:
这里写图片描述qqOs1NnV67bU0NTJ6NbDoaM8L3A+CjxwPiZsdDs3Jmd0OyDI57n7z+u78bXDyuSz9mxvZ6Osv8nNqLn9z8LNvNbQtcQgJmxkcXVvO0F0dGFjaCBCdWlsZCBMb2cmcmRxdW87IMC0yejWw6GjPGJyIC8+CjxpbWcgYWx0PQ=="这里写图片描述" src="http://www.it165.net/uploadfile/files/2016/0720/201607202047171010.png" title="" />

<8> 点击上图中的 “Advanced Settings”,来进一步设置触发方式。如下图,我选择了当构建成功和失败时,都发送邮件通知指定对象。
这里写图片描述

<9> 在各种具体的触发方式中,同样可以做一些具体设置。例如,想在不同的触发方式下,发送邮件给不同的人,那么就可以通过该功能实现。
例如,在触发成功的情况下,通知下面三人,可如下设置:
这里写图片描述

在触发失败的情况下,仅通知特定一人,可如下设置:
这里写图片描述

(9)上述步骤都完成后,点击 “Apply”->保存。
这里写图片描述

(10)当你在(5)中设置的触发时间点到了时,就会自动构建项目,并打包ipa上传。

(11)上传后,可登录http://fir.im/apps去查看,如果上传成功,显示如下,可打开预览查看具体的更新时间:
这里写图片描述

(12)也可打开设定的邮箱,去验证是否有收到邮件,一般邮件内容如下,可点击其中的 ” ipa下载地址” 去下载该APP:
这里写图片描述

Tag标签: 项目  
  • 专题推荐

About IT165 - 广告服务 - 隐私声明 - 版权申明 - 免责条款 - 网站地图 - 网友投稿 - 联系方式
本站内容来自于互联网,仅供用于网络技术学习,学习中请遵循相关法律法规