IOS自动化打包平台

前提：IOS打包平台需要有一个IOS系统的电脑，Mac、一体机都可以。
咱们的打包平台，用的工具有Jenkins、Fastlane、GitLab、蒲公英。
一、工具说明：
先介绍着四个工具的作用：
1、GitLab主要用于存放开发代码，可以通过WebHooks功能和Jenkins配合实现代码提交后自动触发Jenkins的Job。
2、Fastlane主要用于打包IOS包的，当然你可以选择用xcodebuild命令来打包，但是相对麻烦。
3、Jenkins主要是用来做持续集成的，咱们的Jenkins是安装在Linux上的，但是我们需要一个IOS系统的机器作为子节点用来打包IOS的App。
4、下面是关于蒲公英的介绍：
蒲公英是一个提供专业的手机应用内测服务，您只需将需要内测的应用上传至蒲公英，生成二维码，内测用户通过在手机上扫描二维码，即可将内测应用安装至手机等设备中进行测试提供专业的手机应用内测服务，您只需将需要内测的应用上传至蒲公英，生成二维码，内测用户通过在手机上扫描二维码，即可将内测应用安装至手机等设备中进行测试。

二、准备代码
1、我们通过git来clone开发代码，IOS代码的地址为：git@gitlab.aobei.com:ios_dev/ABKUser.git
我们的命令为：git clone git@gitlab.aobei.com:ios_dev/ABKUser.git
克隆成功后，如下图所示：

2、进入刚才clone的文件夹中： cd ABKUser
3、切换git分支到dev分支：git checkout dev
4、执行当前文件夹的pull脚本，该脚本会重新同步代码并把该工程依赖的其他工程也会拉取下来：./pull ，执行成功后如下图：

命令执行过程中可能会打开xcode。
至此，我们的代码准备完毕。
三、Fastlane的安装以及使用
1、首先确保安装课最新版本的Xcode命令行工具。
xcode-select --install
如下图所示证明安装成功：

2、安装Fastlane，在这里我们选择通过Homebrew方式安装。请注意安装Fastlane需要翻墙。
brew cask install fastlane
3、安装成功后在你的代码的根目录下执行如下命令：
fastlane init
4、在执行过程中需要我们输入一些信息，如图处，我们输入2 继续即可。

1、2、3、4含义如下：
1：屏幕截屏。
2：打包TestFlight版本。
3：打包AppStore版本。
4：手动设置打包配置。

5、此处需要输入我们的Apple ID，然后点击回车继续。

 XXXXX@icloud.com

6、后面还有一个地方需要输入Apple ID的密码，我这里已经输入过了所以不提示了。
7、如下图直接点击回车继续：

8、如下图图示我们没有问题：

9、init执行完成后，我们可以看到在项目的根目录下回生成一个fastlane的文件夹，如图：

10、进入fastlane文件夹中查看，会有几个文件，如图：

11、其中Fastfile这个文件是我们打包的主要配置文件，我们需要修改一下，如图：

然后在build_app的前面加上如下两行：

get_certificates
get_provisioning_profile(adhoc:true)

修改后，如图：

12、然后我们回到项目根目录下，执行 fastlane beta 命令，如图：

13、出现如下界面，证明成功，如图：

14、这时我们进入项目的根目录下，查看会发现多了一个.ipa文件，如图：

至此说明我们的fastlane 已经没有问题并且可以使用了。

三、打好的包上传至蒲公英，
1、首先先注册蒲公英，蒲公英官网：https://www.pgyer.com/ ，大家需要自行注册，大家可以根据实际情况选择注册个人或者企业，注册完成后需要大家进行认证，只有认证通过才可以上传app，在这里就不再说了。
2、认证完成后大家可以查看自己的api_key和user_key，在账户设置中点击API信息，如图：

3、回到mac中项目根目录下，安装蒲公英的 Fastlane 插件。运行如下命令：
sudo bundle exec fastlane add_plugin pgyer
如图：

4、出现如下情况，点击y，然后继续：

5、安装过程中可以需要输入用户密码，安装成功后如图：

6、回到我们的项目根目录中，找到我们的Fastfile文件，继续修改我们的Fastfile文件，让我们打好的包上传至蒲公英上。在build_app的后面添加如下代码：
pgyer(api_key: “蒲公英上你的api_key”, user_key: “蒲公英上你自己的user_key”)
修改后，如图：

7、修稿完成后运行 fastlane beat ，成功后如图：

8、登录蒲公英查看我们是否上传成功，在我的应用中找到我们上传的应用，证明长传成功，如图：

9、只有添加了内测设备的手机才可以下载我们的app，因此我们需要添加内测设备，才可以下载，如何添加内测设备，请参考蒲公英文档：https://www.pgyer.com/doc/view/add_udid_to_app
10、添加好内测设备后，我们需要重新执行 fastlane beta 命令，重新发布到蒲公英，发布成功后我们可以在应用界面看到内测设备，我们点击打开，我们可以在UUIDS中找到我们的UUID，那我们就可以用这个手机扫描下载二维码进行下载了，如图：

11、注意：大家可以看到我们上传的应用是内测版，也直邮内测版本才可以让我们下载，如果大家上传的是app-store版则不能下载。

至此，我们的应用已经可以上传至蒲公英上并可以让我们下载了，我们接下来进行最后一步和jenkins的集成。

四、和jenkins的集成。

1、jenkins的安装以及配置，我们这里就不说了，网上很多资料，大家可以自己去查找。
2、然后我们需要在jenkins上把我们这mac设置成Jenkins的子节点，大家请自行完成。
3、我们在jenkins 上新建一个自由风格的job。
4、然后进入配置页面，找到限制项目的运行节点，选择我们刚才配置的子节点，如图：

5、构建处选择执行shell，写入如下脚本，如图：
cd /Users/XXXXXX/git_project/XXXXXX
git checkout dev
git checkout .
./pull
fastlane beta

6、保存配置后，点击立即构建按钮，打包成功后如图：

常见问题：
1、fastlane beta 在执行过程中，如果出现签名问题，请查看xcode软件中是否绑定了apple id 账号，如果没有绑定请登录自己的账号。
2、在使用fastlane打包上传到蒲公英时，可能会出现找不到pyger插件的情况。
解决：查看输入的日志，发现在加载插件的时候加载失败，查看Gemfile文件，查看文件内容，是否如下：

若不一样，请修改后，再次尝试运行，fastlane beta ，提示插件加载成功，并能发布到蒲公英上去。
3、ios，如何打debug包，需要在Fastfile中进行配置，build_app中加入 configuration: “Debug” ，如图所示：