iOS自动化编译打包
作为一名客户端开发人员,每次给测试打包都是一件很痛苦的事情,因为有时候随便改点一些小Bug,测试要回归测试,一天之内可能会不断的打包n个版本,如果让开发人员每次都手动打包,不仅是浪费了开发者的时间,同时也浪费了测试组的时间。所以此时自动化打包是显得多么的重要,节省了开发者和测试组的大量时间。有了自动化打包工具,开发人员只需要将修改的代码提交到远程仓库即可,剩下的事就交给自动化打包工具吧。在一切都OK后需要打包上传到iTunes Connect上,此时只需要修改一个.plist配置文件就可以。给测试组的宝宝们教一下如何把ipa文件上传到iTunes Connect,并发布,以后这些小事就可以交给他们做了。O(∩_∩)O哈哈哈~
coverImage.jpg
基本命令
主要有以下2种方法:
-
xcrun
: 把*.app打包成ipa。 -
xcodebuild
: 生成Archive、导出ipa。
由于之前在网上查到资料,对比了两者的区别,有人说是第一种命令,
xcrun
有点out了,不太适合现在的打包了,本人也没有去真正测试是否到底好用,所以在此只介绍第二种命令xcodebuild
的使用,这也是我目前正在用的。在我们的项目中有2个shell脚本,一个是用来打包测试版的,一个是用来打发布到App Store版的,不用的环境运行不同的脚本。
xcedebuild 的基本使用
xcedebuild
命令打包主要有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."
以上就是我打包用到的脚本,至于打包测试版的,我就不展示了,伙伴们可以自己动手写一个,就当练习了,毕竟自己动手丰衣足食嘛,哈哈....