Jenkins+git+蒲公英 (自动打包及部署)
Contents
1、Jenkins的安装与启动
- 方式一:直接下载安装包
https://jenkins.io/index.html
安装完成后在 Terminal 中输入,即可打开 Jenkins。1
open /Applications/Jenkins/jenkins.war
方式二:使用homebrew
安装 homebrew(如果已经安装,跳过此步)
1
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
安装 Jenkins
1
2
3
4brew install jenkins
```
3.启动 Jenkinsjenkins
1
2
3
4
5
6
7
## 2、访问Jenkins
- 当Jenkins启动后,浏览器中输入 http://localhost:8080/
- 使用安装包安装会自动弹出了浏览器打开
- 如果端口冲突那么请修改端口defaults write /Library/Preferences/org.jenkins-ci httpPort xxxx
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20![](http://upload-images.jianshu.io/upload_images/590107-2e947f45037f0381.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
- 请前往图中红字所示地址
![受保护-请修改文件访问权限](http://upload-images.jianshu.io/upload_images/590107-c40bddef94c4f86d.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
- 修改文件访问权限后,进入该文件夹中,将`initialAdminPassword`中的密码拷贝到输入框,点击`continue`
- 下载插件
![选择左边-安装建议的插件](http://upload-images.jianshu.io/upload_images/590107-dcb0e7074609d615.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
- 插件安装中。。。
![插件安装中](http://upload-images.jianshu.io/upload_images/590107-cff5482499c94487.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
- 插件安装完毕,创建账户->`Save and Finish`
![创建管理员账户](http://upload-images.jianshu.io/upload_images/590107-cf6aea14195ed426.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
- 账户创建成功
## 3、Jenkins插件安装
- 依次安装以下Jenkins插件GitLab
Xcode integration
Keychains and Provisioning Profiles Management1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
- 插件安装步骤
![进入插件管理页面](http://upload-images.jianshu.io/upload_images/590107-434038a2912b1fa9.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
![搜索并安装插件](http://upload-images.jianshu.io/upload_images/590107-c2f49af7c047b3ee.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
## 4、创建Jenkins任务
- 回到Jenkins首页,点击`新建`
![创建Jenkins任务](http://upload-images.jianshu.io/upload_images/590107-efe92edfb9f37717.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
## 5、配置刚刚创建好的Jenkins任务
#### 5.1、设置源码管理(这里我们使用的是git)
![配置Git远程仓库](http://upload-images.jianshu.io/upload_images/590107-91b8e142ec059222.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
- 设置Gredentials
![进入Gredentials页面](http://upload-images.jianshu.io/upload_images/590107-314317f40aa835a7.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
![创建](http://upload-images.jianshu.io/upload_images/590107-3b68540b0ceaf7d6.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
![配置](http://upload-images.jianshu.io/upload_images/590107-c1fafb236668c622.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
- 如果不清楚上如中的`Key`, 应该填什么,请看下面
1、前往文件夹~/.ssh/id_rsa
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
622、用文本编辑器打开`id_rsa`, 拷贝里面的内容到上图中`Key`的输入框,如下图
![~/.ssh/id_rsa](http://upload-images.jianshu.io/upload_images/590107-535a453b70136339.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
- 配置好Credential, 点击ok,再次回到项目的`源码管理`,选择Gredentials为我们刚刚创建的,如图
![选择Gredentials](http://upload-images.jianshu.io/upload_images/590107-765a020e8d0863a7.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
#### 5.2、设置构建触发器(可以触发构建操作的配置)
![非必填,不配置的话需要手动点击构建](http://upload-images.jianshu.io/upload_images/590107-42d1da1fdc261a8a.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
#### 5.3、设置构建环境,这里我们选择`Keychains and Code Signing Identities`
- 勾选`Keychains and Code Signing Identities`
- 配置`Keychain`和` Provisioning Profiles`
- 保存后进入`Keychains and Provisioning Profiles Management`页面,如果没有该选项,请参考上述`第三步:Jenkins插件`安装来安装`Keychains and Provisioning Profiles Management`插件
![进入`Keychains and Provisioning Profiles Management`页面](http://upload-images.jianshu.io/upload_images/590107-a67676aed151ce9a.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
-
![配置`Keychain`和` Provisioning Profiles`](http://upload-images.jianshu.io/upload_images/590107-458c88c5b7258a60.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
![上图中的的`Code Sining Identities`来源(钥匙串中)](http://upload-images.jianshu.io/upload_images/590107-46823912e5866f36.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
- 注意:保存后,在`/Users/Shared/Jenkins`文件夹下如图:
![需要出现`Keychains`和`MobileDevice`文件夹](http://upload-images.jianshu.io/upload_images/590107-32c0a3562d782b64.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
如果未出现:
1、直接将`/Users/‘你的用户名’/Library/Keychains`文件夹拷贝到`/Users/Shared/Jenkins`文件夹下;
2、直接将`/Users/‘你的用户名’/Library/MobileDevice`文件夹拷贝到`/Users/Shared/Jenkins`文件夹下;
- 注意:这里配置的证书是将来用来打包项目用的证书,必须与你将要打包的Xcode项目中的配置一致!!!
- 注意:这里配置的证书是将来用来打包项目用的证书,必须与你将要打包的Xcode项目中的配置一致!!!
- 注意:这里配置的证书是将来用来打包项目用的证书,必须与你将要打包的Xcode项目中的配置一致!!!
- 需要手动配置Xcode项目的profile文件,不要使用`Auto........`,这里不再说明如何手动配置Xcode项目的profile文件
至此,我们完成如下图的构建环境配置(如下图)
![构建环境配置](http://upload-images.jianshu.io/upload_images/590107-1935ff0937c69a92.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
#### 5.4、设置构建操作(这里我们选择`Xcode`)
- 点击增加构建步骤, 选择Xcode
- 如果没有Xcode选项,请参考上述`第三步:Jenkins插件`安装来安装`Xcode integration`插件
![增加构建步骤-Xcode](http://upload-images.jianshu.io/upload_images/590107-1d7cd44873448e41.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
- 配置Xcode构建步骤
- 配置`General build settings`
![General build settings](http://upload-images.jianshu.io/upload_images/590107-29ee273591301013.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
- 配置`Code signing & OS X keychain options`
![Code signing & OS X keychain options](http://upload-images.jianshu.io/upload_images/590107-c63c0e36bfc45576.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
- 配置`Advanced Xcode build options`
![Advanced Xcode build options](http://upload-images.jianshu.io/upload_images/590107-e594f8bee6a79572.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
> 此时我们所有的打包操作已经完毕,如果你仅仅是打包用,到此你可以点击保存,点击`立即构建`,进行构建操作了
![立即构建](http://upload-images.jianshu.io/upload_images/590107-062b0ae9fb30fcc8.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
既然已经做到这一步(自动打包),我们还可以配置一些构建操作,将打包后的IPA文件上传到蒲公英,便于测试!配置如下:
- 1、在蒲公英网站上创建用户,获取到`userKey`和`apiKey`
- 2、在Jenkins上再次配置下我们之前配置好的项目,在之前添加的`Xcode`构建步骤下,新增一个`Execute shell`构建步骤,如图:
![Execute shell](http://upload-images.jianshu.io/upload_images/590107-232d94822576574b.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
- 3、在`command`中填写如下命令:#蒲公英上的User Key
uKey=”xxxxxxxxxxxxxxxxxxxxxxxx”
#蒲公英上的API Key
apiKey=”xxxxxxxxxxxxxxxxxxxxxxxx”
#要上传的ipa文件路径
IPA_PATH=”我们打包后的IPA文件地址”
#执行上传至蒲公英的命令,这句不需要修改
curl -F “file=@${IPA_PATH}” -F “uKey=${uKey}” -F “_api_key=${apiKey}” https://www.pgyer.com/apiv1/app/upload
```
- 配置完毕,点击保存,我们再次构建我们的项目,如果不出意外,我们看到的是这样的标志
说明我们的项目构建成功,并成功发布到蒲公英,快去蒲公英上看看吧~~
6、常见报错及解决办法
1、This project contains no schemes
解决办法:
注意点:
- 这里我们不能去Jenkins项目目录下修改Xcode项目的shared勾选,我们应该在本地的开发源码上修改,然后提交到git远程仓库,再次构建!!!
- 由于gitignor文件,我们有可能没有注意的情况下,并没有将shared勾选这个设置提交到远程仓库,导致再次侯建依旧失败!