自动化打包 Mac JenKins + Xcode + 蒲公英 + Testflight

其实这篇博客很早就写好了（其实是某次离职的交接文档的一部分）最近笔者想重新做回程序员就发上来吧还是比较详细的

需求：每次开发完毕进入测试的时候，每次修改完bug 或者测试想回归测试的时候都要频繁的打包给测试，在开发期间打包又卡又浪费时间。

解决后：在每次修改完bug 后会自动打包上传还会邮件通知测试邮件内容里面有我们 git push 的信息方便同事查看是修复了那个bug

要求：一台闲置的Mac（服务端没有Mac的服务器呜呜呜不然这个可以放在服务器上跑） gitlab Swift

第一步先安装JenKins
JenKins （Jenkins是开源CI&CD软件领导者，提供超过1000个插件来支持构建、部署、自动化，满足任何项目的需要。）
jenkins就是一个任务自动化的工具也就是你可以写一份文档来让他一步一步执行。接下来的操作都是如何配置文档，所以没什么技术难度，闲暇时间做就好了，后端同学肯定熟悉这个

brew install jenkins 安装
jenkins 启动
http://localhost:8080/ 访问jenkins

Jenkins安装完是用浏览器直接打开 http://localhost:8080，那么应该是如下的显示界面

image.png

获取密码：打开终端输入
把显示的密码复制粘贴至管理员密码中，进入自定义jenkins界面

image.png

我们选择安装推荐的插件

image.png

安装插件完成后新建管理员用户：

image.png

实例配置这里不做修改直接保存

image.png

接下里是安装必要的插件，推荐的插件不够

系统管理 - > 插件管理 - >可选插件 - > 过滤 - >选择插件 -> 直接安装
Xcode integration 必须的这个是配置Xcode 编译项的Keychains and Provisioning Profiles Management 证书管理Email Ext Recipients Column Plugin 邮件
CocoaPods Jenkins Integration
GitLab
GitLab Authentication

配置Keychains and Provisioning Profiles Management

cd ~/Library/Keychains

macOS10.12以及以后的系统里面没有login.keychain文件，只有login.keychain-db,可以复制出来删除-db，也可以创建一个快捷方式名字叫做login.keychain，upload就好了。（上传keychain，路径用自己改名后的那个）

image.png

然后添加Provisioning Profiles，上传方法和上传login.keychain一样，去选择Provisioning Profiles文件，然后upload，然后结果
Provisioning Profiles Directory Path
的是固定格式的/Users/用户名/Library/MobileDevice/Provisioning\ Profiles/
注有时候这个地方文件夹会没有权限

系统设置配置

image.png

Default Subject 【构建通知】: $PROJECT_NAME - Build # $BUILD_NUMBER - $BUILD_STATUS!

Default Content

<!DOCTYPE html>  
<html>  
<head>  
<meta charset="UTF-8">  
<title>${ENV, var="JOB_NAME"}-第${BUILD_NUMBER}次构建日志</title>  
</head>  
  
<body leftmargin="8" marginwidth="0" topmargin="8" marginheight="4"  
    offset="0">  
    <table width="95%" cellpadding="0" cellspacing="0"  style="font-size: 11pt; font-family: Tahoma, Arial, Helvetica, sans-serif">  
        <tr>  
            <td>各位同事，大家好，以下为${PROJECT_NAME }项目构建信息</td>  
        </tr>  
        <tr>  
            <td><br />  
            <b><font color="#0B610B">构建信息</font></b>  
            <hr size="2" width="100%" align="center" /></td>  
        </tr>  
        <tr>  
            <td>  
                <ul>  
                    <li>项目名称 ： ${PROJECT_NAME}</li>  
                    <li>构建编号 ： 第${BUILD_NUMBER}次构建</li>  
                    <li>触发原因： ${CHANGES}</li>  
                    <li>构建状态： ${BUILD_STATUS}</li>  
                    <li>构建日志： <a href="${BUILD_URL}console">${BUILD_URL}console</a></li>  
                    <li>构建  Url ： <a href="${BUILD_URL}">${BUILD_URL}</a></li>  
                    <li>工作目录 ： <a href="${PROJECT_URL}ws">${PROJECT_URL}ws</a></li>  
                    <li>项目  Url ： <a href="${PROJECT_URL}">${PROJECT_URL}</a></li>  
                </ul>  
            </td>  
        </tr>  
    </table>  
</body>  
</html>

开始配置任务

然后创建一个任务，自由风格的任务笔者这边因为需要上传蒲公英和 testTestflight 所以创建了两个任务

image.png

可以选择保留版本时间和个数这里其实选丢弃旧的构建

Source Code Management

image.png

这里填上git 地址分支
Build Triggers

image.png

触发构建的方式
其实轮询就行检查到有新的改动才会打包

image.png

build

image.png

这里可以任意勾选执行步骤例如其实因为个推 bug 和修改build 号的需求且需要pod install 就选了先执行 shell 脚本（这个脚本需要按照自己项目来写）


pod install --verbose --no-repo-update

buildMainPlist="/Users/xiexing/.jenkins/workspace/app/MarkDaily/Info.plist"
buildServicePlist="/Users/xiexing/.jenkins/workspace/app/NotificationService/Info.plist"
buildNumber=$(date +"%m%d%H%M")

/usr/libexec/PlistBuddy -c "Set :CFBundleVersion $buildNumber" "$buildMainPlist"
/usr/libexec/PlistBuddy -c "Set :CFBundleVersion $buildNumber" "$buildServicePlist"

选择 Xcode 插件

image.png

接下来就是xcode 的配置自行选择就可

image.png

Configuration ：Release

Xcode Schema ：File

image.png

注 $workspace 这里是因为那个蒲公英插件（他不能识别文件夹）才这样写

Testflight 的就可以写

image.png

这一项记得勾选

image.png

Build就完成设置了

接下里就到上传了

image.png

蒲公英可以查看

https://www.pgyer.com/doc/view/jenkins_ios 配置

image.png

Testflight 选择shell 脚本上传
最后添加一个shell 脚本就行

ALTOOLPATH=/Applications/Xcode.app/Contents/Applications/Application\ Loader.app/Contents/Frameworks/ITunesSoftwareService.framework/Versions/A/Support/altool

IPAPATH="/Users/xiexing/.jenkins/workspace/APP-TESTFLIGHT/build/XXXX.ipa"

APPID="XXXX"

APPPASSWORD="XXX"

"${ALTOOLPATH}" --validate-app -f "${IPAPATH}" -u "${APPID}" -p "${APPPASSWORD}" --output-format xml


"${ALTOOLPATH}" --upload-app -f "${IPAPATH}" -u "${APPID}" -p "${APPPASSWORD}" --output-format xml

最后一步发送邮件

image.png

这里其实 就是采用 我们在设置 上 填好的
Project Recipient List：$DEFAULT_RECIPIENTS $DEFAULT_REPLYTO
Project Reply-To List：$DEFAULT_REPLYTO $DEFAULT_RECIPIENTS
Content Type：Html
Default Subject：$DEFAULT_SUBJECT Testflight
Default Content ：$DEFAULT_CONTENT

最后点击保存
两个任务只有build 和上传不一样其他统一
可以先手动构建一下看看成不成功
这个真的是傻瓜教程每一步都有了，快动手试一试吧