首页手记 iOS自动化编译打包

iOS自动化编译打包

标签：

iOS 自动化测试移动测试

作为一名客户端开发人员，每次给测试打包都是一件很痛苦的事情，因为有时候随便改点一些小Bug，测试要回归测试，一天之内可能会不断的打包n个版本，如果让开发人员每次都手动打包，不仅是浪费了开发者的时间，同时也浪费了测试组的时间。所以此时自动化打包是显得多么的重要，节省了开发者和测试组的大量时间。有了自动化打包工具，开发人员只需要将修改的代码提交到远程仓库即可，剩下的事就交给自动化打包工具吧。在一切都OK后需要打包上传到iTunes Connect上，此时只需要修改一个.plist配置文件就可以。给测试组的宝宝们教一下如何把ipa文件上传到iTunes Connect，并发布，以后这些小事就可以交给他们做了。O(∩_∩)O哈哈哈~

基本命令

主要有以下2种方法：

xcrun: 把*.app打包成ipa。
xcodebuild: 生成Archive、导出ipa。

由于之前在网上查到资料，对比了两者的区别，有人说是第一种命令，xcrun有点out了，不太适合现在的打包了，本人也没有去真正测试是否到底好用，所以在此只介绍第二种命令xcodebuild的使用，这也是我目前正在用的。在我们的项目中有2个shell脚本，一个是用来打包测试版的，一个是用来打发布到App Store版的，不用的环境运行不同的脚本。

xcodebuild 的基本使用

xcodebuild命令打包主要有2个步骤，搞清楚这两个步骤，其他的就是个性化的东西了（比如：打包前修改一些配置文件，生成的ipa的命名等都可以放在脚本里去做）。
第一步：编译打包成Archive 就如在Xcode操作「Product -> Archive」
xcodebuild archive -workspace XXX.xcworkspace -scheme XXX -configuration Release -archivePath ${ARCHIVE_PATH} CONFIGURATION_BUILD_DIR=${CONFIGURATION_BUILD_PATH}
参数说明：

-workspace：指定工作空间文件XXX.xcworkspace
-scheme：指定构建工程名称
-configuration：[Debug/Release]可选项，选择Debug或者Release构建
-archivePath：保存生成.xcarchive包路径
CONFIGURATION_BUILD_DIR：build时的文件路径（主要包含.a文件、XXX.app文件和XXX.app.dSYM文件）如果不需要用到XXX.app.dSYM文件中的二进制文件（有些第三方崩溃统计需要用到此文件），可以不加此项。

第二步：用生成的XXX.xcarchive文件导出为XXX.ipa文件
xcodebuild -exportArchive -archivePath ${ARCHIVE_PATH} -exportOptionsPlist ${EXPORT_OPTIONS_PLIST_PATH} -exportPath ${EXPORT_DIR}
参数说明：

-archivePath：第一步中生成XXX.xcarchive文件的路径
-exportOptionsPlist：导出过程中需要的配置文件路径（我是放在工程文件夹中的）
-exportPath：导出ipa保存目录

exportOptionsPlist文件参数如下图：
上传App Store版本

测试组使用版本

以上两步是最核心的两步，理解了各个参数的用意，就明白是怎么回事了。xcodebuild还有其他用法，可以通过命令xcodebuild -usage查看相关说明。

具体使用

下面是我用的打包脚本，是用于打包发布到App Store版的，需要用到打包测试版的话，自己动手修改一下，也当做学习了。其中很多用到了变量名，可能看起来会有点费劲，自己看的时候捋一捋吧。

# !/bin/bash
# 时间字符串格式化输出 eg:2016-11-14 22:40
# date_value=` date "+%Y-%m-%d %H:%M"`
# 执行 ./build-redlips_appStore.sh release 打包
PROJECT="XXX"
WORKSPACE_FILE=${PROJECT}.xcworkspace
TARGET="XXX"
BUILD_CONFIGURATION="Debug"
if [ "$1" = "release" ]; then
BUILD_CONFIGURATION="Release"
fi

#新建3个文件夹路径（我是都放在桌面），用来保存打包时相关的文件
CONFIGURATION_BUILD_DIR=~/Desktop/build_configuration
ARCHIVE_DIR=~/Desktop/build_archive
EXPORT_DIR=~/Desktop/build_ipa
# LOG_PATH=~/Desktop/build_log
# LOG_PATH是一个文档路径，只是用来记录命令的输出，因为都打在终端会很多，另外也方便后面分析。后面的命令也是如此。这里面带的选项可以根据需要参考xcodebuild -help的信息。
# clean
# 清理构建目录  就如在Xcode操作「Product -> Clean」。
xcodebuild clean -configuration ${BUILD_CONFIGURATION} -alltargets
# 移除之前的目录并创建新的文件夹（可以不执行此操作）
rm -rf ${CONFIGURATION_BUILD_DIR}
rm -rf ${ARCHIVE_DIR}
rm -rf ${EXPORT_DIR}
mkdir ${CONFIGURATION_BUILD_DIR}
mkdir ${ARCHIVE_DIR}
mkdir ${EXPORT_DIR}
# 编译打包成Archive  就如在Xcode操作「Product -> Archive」
CONFIGURATION_BUILD_PATH=${CONFIGURATION_BUILD_DIR}/${BUILD_CONFIGURATION}-iphoneos
# archivePath="~/Desktop/build_archive/${TARGET}.xcarchive"
ARCHIVE_PATH=${ARCHIVE_DIR}/${TARGET}.xcarchive
# CODE_SIGN_IDENTITY="$codeSignIdentity" PROVISIONING_PROFILE="$provisioningProfile"
xcodebuild archive -workspace ${WORKSPACE_FILE} -scheme ${TARGET} -configuration ${BUILD_CONFIGURATION} -archivePath ${ARCHIVE_PATH} CONFIGURATION_BUILD_DIR=${CONFIGURATION_BUILD_PATH}
# 将Archive导出 (注意路径加""号和不加""的写法)
# exportOptionsPlist="/Users/apple/Desktop/XXX/XXX/Src/Common/AppStoreExportOptions.plist"
# 取出当前目录的路径进行拼接（每人的项目文件名可能不一样）
BASE_PATH=${PWD}
EXPORT_OPTIONS_PLIST_PATH=${BASE_PATH}/XXX/Src/Common/AppStoreExportOptions.plist
xcodebuild -exportArchive -archivePath ${ARCHIVE_PATH} -exportOptionsPlist ${EXPORT_OPTIONS_PLIST_PATH} -exportPath ${EXPORT_DIR}

****************************** 分割线 ******************************

#下面是获取上传到第三方统计崩溃日志的文件，如果没有用到可以到此结束
# 复制（or压缩） CONFIGURATION_BUILD_PATH 目录下的 XXX.app.dSYM 文件（其实是个文件夹）到 EXPORT_DIR 目录下
DSYM_PATH=${CONFIGURATION_BUILD_PATH}/${TARGET}.app.dSYM
DSYM_ZIP_PATH=${EXPORT_DIR}/${TARGET}.app.dSYM.zip
DSYM_COPY_PATH=${EXPORT_DIR}
# zip -r 目标路径  源文件路径
zip -r ${DSYM_ZIP_PATH} ${DSYM_PATH}
# cp -r 源文件路径 目标路径
cp -r ${DSYM_PATH} ${DSYM_COPY_PATH}
# 复制 XXX.app.dSYM 包里的 XXX 文件 上传到听云
TARGET_PATH=${DSYM_COPY_PATH}/${TARGET}.app.dSYM/Contents/Resources/DWARF/${TARGET}
cp ${TARGET_PATH} ${EXPORT_DIR}

温馨提醒

打包前记得把你的证书和签名设置正确，否则打包必定失败。
如果添加了iOS10的通知特性（PushNotificationService），记得在工程中TARGETS下选择PushNotificationService，Build Settings栏目下，Enable Bitcode属性设置为NO。否则打包成功在上传到iTunes Connect时，会出现如下错误：

ERROR ITMS-90635: “Invalid Mach-O Format. The Mach-O in bundle “XXX.app/PlugIns/XXXPushNotificationService.appex” isn’t consistent with the Mach-O in the main bundle. The main bundle Mach-O contains armv7(machine code) and arm64(machine code), while the nested bundle Mach-O contains armv7(bitcode) and arm64(bitcode). Verify that all of the targets for a platform have a consistent value for the ENABLE_BITCODE build setting.”

以上就是我打包用到的脚本，至于打包测试版的，我就不展示了，伙伴们可以自己动手写一个，就当练习了，毕竟自己动手丰衣足食嘛，哈哈…