前言
workspace、project、target、scheme
,这些基本概念非常容易混淆,特别是经常使用Xcode编译和打包的开发者,往往会忽视这些基础知识。
最近开始用xcodebuild
,Xcode的可视化操作带来的便利就是对命令行的生疏,特写一篇文章来回顾下。
workspace、project、target和scheme
了解这四个基本概念,有利于理解用命令行编译的参数设置。
- project是基本工程,包含了所有的代码文件和资源文件、以及基本的编译相关设置。project可以单独存在,也可以被包含在workspace。
- workspace是project的管理文件,一个workspace可以包含多个project,同个workspace内的project之间可以引用。
- target是编译目标,target会继承project的基本设置,并重新设置target相关的编译信息(主要是Build Settings 和 Build Phases)。
一个target对应一个product,一个工程里可以有多个target。target之间可以存在依赖,如果targetA依赖targetB,那么编译targetA的时候会先编译targetB。多个target只能有一个处于active状态,由Xcode的scheme决定。
如下图,圆圈所在就是编译目标,有两个target,分别是产生product和测试相关,其中的LearnAnimationTests
就是依赖LearnAnimation
。
- scheme是编译任务,配置了
Build、Run、Test、Profile、Analyze、Archive
相关的信息(见下图),同时可以指定运行的目标(如图中是iPhone 7 Plus)
我们可以定义多个scheme,但是只能使用一个。
.app .xcarchive 和 .ipa的区别
这三个文件都是Xcode直接产出的运行相关文件,通过指令同样可以生成这三个文件。
-
.xcarchive 是通过Xcode打包或者 xcodebuild archive打包出来的文件,里面包括了.app文件、dSYM符号文件等;
-
.ipa 是一个zip压缩包,主要有Payload文件夹,里面有.app文件,Symbols是符号文件;
-
.app 程序运行包,其中包括二进制的可执行文件以及运行所需要的资源以及plist,还有就是签名文件和privisioning file;
命令行编译
xcodebuild是命令行构建工具,接下来尝试用xcodebuild产生上面所说的.app、.xcarchive 和 .ipa文件。(苹果文档,通过在命令行输入man xcodebuild同样可以看到)
1、产生.app文件
如果工程设置的Mach-O Type设置是Executable,编译产生的就会是.app文件。
例如,我们使用Debug
的configuration
设置来编译Live
的target
,命令是xcodebuild -target Live -configuration Debug
,结果如下:
类似,如果使用
Release
也可以产生.app文件,命令是:xcodebuild -target Live -configuration Release
,结果如下2、产生.xcarchive文件
xcodebuild的archive
动作(action)可以产生.xcarchive文件,下面是一个普通的archive
指令:
xcodebuild archive -project "LearnAnimation.xcodeproj" -scheme "LearnAnimation" -configuration Release -archivePath archive/learn.xcarchive
3、产生.ipa文件
xcodebuild的-exportArchive
参数可以用来打包.ipa文件,下面是一个普通的打包指令:
xcodebuild -exportArchive -archivePath archive/learn.xcarchive -exportPath App -exportProvisioningProfile "provisioning file name"
扩展内容
1、命令行修改plist参数
PlistBuddy支持修改plist,下面是一个修改指令:
/usr/libexec/PlistBuddy -c "Set :TestVersion ${TestVersion}" ${infoplist_path}
${infoplist_path} 替换为自己的plist的路径。
PlistBuddy简单使用,简书上也有详细介绍的文章。
2、编译project工程和xcworkspace工程的区别
xcodebuild编译project,可添加-project projectName
参数,也可以不添加
xcodebuild编译xcworkspace,需要添加-workspace workspaceName
参数
如果对于缺省的参数,xcodebuild会优先使用xcode工程内的设置,再使用默认值。
3、xcodebuild编译报错library not found
ld: library not found for -lAFNetworking
clang: error: linker command failed with exit code 1 (use -v to see invocation)
报错是链接时AFNetworking找不到,检查工程设置中是否有引入AFNetworking;如果工程设置正常,那么检查AFNetworking是否为pod方式引入,如果是则xcodebuild的目标需要是xcworkspace
。
4、蒲公英上传ipa指令
打包出来的ipa配合下面的上传指令,可以把ipa包直接发到蒲公英上。
curl -F "file=@Live.ipa" -F "uKey=key12345" -F "_api_key=key54321" http://www.pgyer.com/apiv1/app/upload
总结
在真机的代码覆盖率测试的背景驱动下,我强行对Xcode基础知识进行一遍回顾,同时也要复习bash脚本语言,然后用xcodebuild对以前的工程进行编译、打包,加深理解。
如果再有必要,搭建自动化构建的环境,应该不是难题。