iOS+Jenkins+git+蒲公英 (iOS自动打包）

1、Jenkins的安装与启动

• 方式一：直接下载安装包
  https://jenkins.io/index.html
  安装完成后在 Terminal 中输入，即可打开 Jenkins。

open /Applications/Jenkins/jenkins.war

• 方式二：使用homebrew

  1. 安装 homebrew（如果已经安装，跳过此步）

  ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
  

  2. 安装 Jenkins

  brew install jenkins     
  

  3.启动 Jenkins

  jenkins
  

2、访问Jenkins

• 当Jenkins启动后，浏览器中输入 http://localhost:8080/

• 使用安装包安装会自动弹出了浏览器打开

• 如果端口冲突那么请修改端口

defaults write /Library/Preferences/org.jenkins-ci httpPort xxxx

• 请前往图中红字所示地址

  
  受保护-请修改文件访问权限

• 修改文件访问权限后，进入该文件夹中，将initialAdminPassword中的密码拷贝到输入框，点击continue

• 下载插件

  
  选择左边-安装建议的插件

• 插件安装中。。。

  
  插件安装中

• 插件安装完毕，创建账户->Save and Finish
  

  创建管理员账户

• 账户创建成功

3、Jenkins插件安装

• 依次安装以下Jenkins插件

GitLab
Xcode integration
Keychains and Provisioning Profiles Management

• 插件安装步骤

  
  进入插件管理页面
  搜索并安装插件

4、创建Jenkins任务

• 回到Jenkins首页，点击新建
  创建Jenkins任务

5、配置刚刚创建好的Jenkins任务

5.1、设置源码管理（这里我们使用的是git）

配置Git远程仓库

• 设置Gredentials

  
  进入Gredentials页面
  创建
  配置

• 如果不清楚上如中的Key, 应该填什么，请看下面
  1、前往文件夹

 ~/.ssh/id_rsa

2、用文本编辑器打开id_rsa, 拷贝里面的内容到上图中Key的输入框，如下图

~/.ssh/id_rsa

• 配置好Credential, 点击ok，再次回到项目的源码管理,选择Gredentials为我们刚刚创建的，如图
  选择Gredentials

5.2、设置构建触发器（可以触发构建操作的配置）

非必填，不配置的话需要手动点击构建

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`页面

配置`Keychain`和` Provisioning Profiles`
上图中的的`Code Sining Identities`来源(钥匙串中)

• 注意：保存后，在/Users/Shared/Jenkins文件夹下如图：
  

  需要出现`Keychains`和`MobileDevice`文件夹
  如果未出现：
  1、直接将/Users/‘你的用户名’/Library/Keychains文件夹拷贝到/Users/Shared/Jenkins文件夹下；
  2、直接将/Users/‘你的用户名’/Library/MobileDevice文件夹拷贝到/Users/Shared/Jenkins文件夹下；

• 注意：这里配置的证书是将来用来打包项目用的证书，必须与你将要打包的Xcode项目中的配置一致！！！

• 注意：这里配置的证书是将来用来打包项目用的证书，必须与你将要打包的Xcode项目中的配置一致！！！

• 注意：这里配置的证书是将来用来打包项目用的证书，必须与你将要打包的Xcode项目中的配置一致！！！

• 需要手动配置Xcode项目的profile文件，不要使用Auto........,这里不再说明如何手动配置Xcode项目的profile文件
  至此，我们完成如下图的构建环境配置（如下图）
  

  构建环境配置

5.4、设置构建操作（这里我们选择Xcode）

• 点击增加构建步骤， 选择Xcode

• 如果没有Xcode选项，请参考上述第三步：Jenkins插件安装来安装Xcode integration插件
  

  增加构建步骤-Xcode

• 配置Xcode构建步骤

  • 配置General build settings
    

    General build settings

  • 配置Code signing & OS X keychain options
    

    Code signing & OS X keychain options

  • 配置Advanced Xcode build options
    

    Advanced Xcode build options

此时我们所有的打包操作已经完毕，如果你仅仅是打包用，到此你可以点击保存，点击立即构建，进行构建操作了

立即构建

既然已经做到这一步（自动打包），我们还可以配置一些构建操作，将打包后的IPA文件上传到蒲公英，便于测试！配置如下：

• 1、在蒲公英网站上创建用户，获取到userKey和apiKey
• 2、在Jenkins上再次配置下我们之前配置好的项目，在之前添加的Xcode构建步骤下，新增一个Execute shell构建步骤，如图：
  Execute shell
• 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

This project contains no schemes

• 解决办法：

  
  勾选shared

• 注意点：

  • 这里我们不能去Jenkins项目目录下修改Xcode项目的shared勾选，我们应该在本地的开发源码上修改，然后提交到git远程仓库，再次构建！！！

  • 由于gitignor文件，我们有可能没有注意的情况下，并没有将shared勾选这个设置提交到远程仓库，导致再次侯建依旧失败！