xcodebuild自动打包学习日记

本着务实求真、增加技能点的前提下(~想偷懒)，学习了了下xcodebuild自动打包方面。在这个做个小总结，方便自己及你我他。

工具介绍

xcodebuild builds one or more targets contained in an Xcode project, or builds a scheme contained in an Xcode workspace
xcodebuild就是用来构建产品的命令行工具，其用法可以归结为3个部分：

可构建的对象
构建行为
一些其他辅助命令

可以构建的对象有：(默认情况下会运行project下的第一个targect)

workspace：必须和“-scheme”一起使用，构建该workspace下的一个scheme。
project：当根目录下有多个Project的时候，必须使用“-project”指定project
target：构建某个Target
scheme：和“-workspace”一起使用，指定构建的scheme。

构建行为有：

xcodebuild clean:清除build目录下的
xcodebuild build: 构建
xcodebuild test: 测试某个scheme，必须和"-scheme"一起使用
xcodebuild archive:打包，必须和“-scheme”一起使用
xcodebuild -exportArchive:包导出

辅助命令有:

man xcodebuild:查看手册
xcodebuild -version:查看版本号
xcodebuild -help:查看帮助
xcodebuild -showsdks:查看已安装SDK列表
...

打包测试

打包过程中主要使用了一下三个命令:

xcodebuild clean 清理工程
xcodebuild archive 编译打包文件
xcodebuild -exportArchive 导出IPA包

需要两个文件build.sh和ExportOptions.plist

截屏2020-07-08 下午3.40.21.png

build.sh

#!bin/sh

echo "开始工程清理"
# ${workspace} 工程中,.xcworkspace的文件名字
# ${scheme} 当前要编译运行的scheme
# configuration ${Debug或者Release} 当前是要以Debug运行还是以Release运行
# -quiet 忽略警告提示打印
# -UseNewBuildSystem=NO 是否使用新的build系统
xcodebuild clean -workspace "YourProjectWorkspace.xcworkspace" -scheme "Yourscheme" -configuration Release -UseNewBuildSystem=NO
echo "工程清理完成"

echo "开始工程打包"
#${workspace} 工程中,.xcworkspace的文件名字
#${scheme} 当前要编译运行的scheme
#configuration ${Debug或者Release} 当前是要以Debug运行还是以Release运行
#-archive_path 导出.xcarchive文件的存放路径
#CODE_SIGN_IDENTITY 证书文件名
#PROVISIONING_PROFILE 运行文件UUID
xcodebuild archive -workspace "YourProjectWorkspace.xcworkspace" -scheme "Yourscheme" -configuration Release -archivePath "~/Desktop/autoPack/SetUpConfig"
echo "工程打包完成"

echo "开始导出IPA包"
#xcodebuild -exportArchive -archivePath archive文件的地址.xcarchive
#                          -exportPath 导出的ipa文件夹地址
#                          -exportOptionsPlist exprotOptionsPlist.plist（前面路径会自动补全）
#                          CODE_SIGN_IDENTITY=证书
#                          PROVISIONING_PROFILE=描述文件UUID
xcodebuild -exportArchive -archivePath "~/Desktop/autoPack/SetUpConfig.xcarchive" -exportPath "~/Desktop/autoPack/SetUpConfig.ipa" -exportOptionsPlist "ExportOptions.plist"

scheme可以使用xcodebuild -list命令查看
CODE_SIGN_IDENTITY和PROVISIONING_PROFILE 如果不需要指定可以不用写，它会根据你xcode中的配置去自动匹配

ExportOptions.plist

这个在使用xcode打包后会生成，建议使用xcodebuild自动打包前先使用xcode打一个包，保证项目代码和各项配置没有问题。

截屏2020-07-08 下午3.57.09.png

执行命令

打开终端,cd到工程目录,输入 sh ./build.sh

遇到的问题

** ARCHIVE SUCCEEDED **

工程打包完成
开始导出IPA包
2020-05-09 11:33:57.289 xcodebuild[20203:817143] [MT] IDEDistribution: -[IDEDistributionLogging _createLoggingBundleAtPath:]: Created bundle at path '/var/folders/_6/t0xhscld37g6mb17jt4cv2sw0000gn/T/SetUpConfiguartion_2020-05-09_11-33-57.287.xcdistributionlogs'.
error: exportArchive: The data couldn’t be read because it isn’t in the correct format.

Error Domain=NSCocoaErrorDomain Code=3840 "No value." UserInfo={NSDebugDescription=No value., NSFilePath=/var/folders/_6/t0xhscld37g6mb17jt4cv2sw0000gn/T/ipatool-json-filepath-~~~EygMH8}

** EXPORT FAILED **

按照提示，前往错误日志文件地址，找到错误日志文件

/var/folders/_6/t0xhscld37g6mb17jt4cv2sw0000gn/T/SetUpConfiguartion_2020-05-09_11-33-57.287.xcdistributionlogs

在错误日志中看到

/System/Library/Frameworks/Ruby.framework/Versions/2.6/usr/lib/ruby/2.6.0/rubygems/core_ext/kernel_require.rb:54:in `require': cannot load such file -- sqlite3 (LoadError)

终端执行 gem list | grep sqlite3 如果没有输出信息说明少了sqlite3 这个文件。
执行 gem install sqlite3 --platform=ruby 安装，如果是已安装则继续执行 rvm use system --default

我看网上很多文章都说如果出现这个问题是因为xcode上的Enable BitCode问题，设置为No即可。这时可以使用xcode打包并导出测试一下，如果xcode打包并导出都没有问题，则不是Enable BitCode问题
关于Enable BitCode，可以看看这位大神的文章:关于bitcode, 知道这些就够了

参考
# iOS系统提供开发环境下命令行编译工具：xcodebuild

iOS 自动化打包（xcodebuild）