target和scheme、.xcarchive和.ipa的详细解析

前言

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和target

• 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，结果如下

image.png

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对以前的工程进行编译、打包，加深理解。

如果再有必要，搭建自动化构建的环境，应该不是难题。

bash脚本语言

workspace、project、target和scheme的官方介绍