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
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, 知道这些就够了