- iOS应用程序使用Xcode进行编译,打包的时候会接触到
workspace
,project
,target
与scheme
这四个概念,下面我们来详细介绍这四个概念;
Project
-
Project
是基本工程,其包含了所有的代码文件,.a或.framework静态库文件,资源文件,以及与编译相关基础设置; -
Project
可以单独存在,也可以被包含在Workspace
中; - 一个
Project
可以包含一个或者多个Target
,在Project
中设置的编译选项Build Setting
,可作用于所有的Target
,每一个Target
自己也单独设置自己特殊的编译配置,如下所示:
Target
-
Target
是编译的目标,其会继承Project
的编译设置,并可重新设置自己的编译配置,上面已经有所阐述,编译的配置主要是Build Setting
与Build Phases
- 一个
Target
经过编译之后就只会生成一个对应的Product
; - 一个
Project
可包含多个Target
,Target
之间可以相互依赖,如果这两个target在同一个workspace
中,Xcode就能识别这个依赖,这种依赖关系我们称之为隐式依赖(implicit dependency)
- 不同的target,经过编译生成的
Product
类型也不同,常见的Product
类型有.app
,.a
,.framework
都隶属于Mach-O文件
,生成的Product
类型与Target
的编译配置有关,在Build Setting -> Mach-O Type
中进行设置,举例如下:
Worksapce
-
Worksapce
顾名思义是工作空间,是Xcode的一种文件,可管理Project
和其他文件,便于我们使用它; -
Worksapce
可以包含多个Project
,如下所示:
-
Worksapce
中的Project
都共享一个编译目录,我们称之为workspace build directory
,那么每个Project
之间的文件都是可以相互引用的,如果当前Worksapce
中的Project
都引用了同一个Library
时,不需要给每个Project
都拷贝一份; -
Worksapce
中的每个Project
依然是独立的,不会影响到其他Project
;
Scheme
Scheme
也可看成编译的配置文件,我们可以指定build(编译),Run(运行),Test(测试),Profile(性能分析),analyze(语法分析),archive(打包)的配置选项,Scheme
是针对Target
的,一个Target
可以设置多个不同的Scheme
-
Xcode默认的
Scheme
只有一个与Project
同名;
Xcode为
Scheme
默认生成的配置选项Configuration
有Debug
与Release
两种,我们也可自定义新增Configuration
,下面会有涉及到;我们可以自定义新的
Scheme
,如下所示:
- 上述四种之前的关系可用下图进行描述:
Xcode多环境配置
第一种方式:单scheme + 多configurations
-
新建一个项目命名为
ShellTest
,并支持Cocoapods,然后配置info -> Configurations
,添加新的环境配置,如下所示:
其中
Debug
与Release
是Xcode默认的,Dev_Debug
与Dev_Release
是自定义新增的;-
这里配置完成后,由于使用了Cocoapods,要执行一次
pod install
,pods会自动去配置相关的环境,如下所示:
-
现在有四种
Configurations
,如下所示:
配置预编译宏,以此可用来设置不同scheme下的域名;
- 配置App的名称
- 配置App的BundleID
- 配置AppIcon
- 依次选择四种scheme,运行工程,最后会得到四个不同配置的App,如下所示:
第二种方式:多scheme + 多configurations
- 上述第一种方式
单scheme + 多configurations
,每次运行都需要重新设置scheme的configurations选项,比较麻烦,下面建立所个scheme,然后让设置每个scheme的configurations选项,在运行工程时,只要切换scheme即可;
- 其他的配置与方式一相同;
第三种方式:多target
- 选中target -> YYTest 然后右击选择
Duplicate
,会创建一个新的target;
- 可更改新的target的名称,plist文件名称,以及对应的scheme名称为
YYTestBeta
- 由于
YYTestBeta
这个target是全新的,所有的配置都是全新的一份,我们可以单独设置自己的配置选项;
第四种方式:xcconfig文件的使用
- 通过常见
. xcconfig
文件来实现多环境的配置,注意每一个Configurations
对应一个. xcconfig
文件; - 在新建工程
SFTest
中创建三个. xcconfig
文件,分别为CommonConfig.xcconfig
,DebugConfig.xcconfig
,ReleaseConfig.xcconfig
,其中CommonConfig.xcconfig
是公用的,可在DebugConfig.xcconfig
,ReleaseConfig.xcconfig
文件中以#include
的形式导入;
- 然后在
Project -> info -> configurations
中去设置.xcconfig文件,如下所示:
- 最后在工程中使用.xcconfig文件中自定义的key-value选项,如下所示:
工程运行之后,我们App的名称就变成了
畅游
;通过终端命令行,我们可以查看
Build Settings
,如下:cd到工程目录,然后执行
xcodebuild -list
Information about project "SFTest":
Targets:
SFTest
Build Configurations:
Debug
Release
If no build configuration is specified and -scheme is not passed then "Release" is used.
Schemes:
SFTest
终端打印所有编译配置Build Settings,执行
xcodebuild -showBuildSettings
将目标scheme
SFTest
的编译配置输出成SFTestOut.xcconfig
文件, 终端执行xcodebuild -scheme "SFTest" -showBuildSettings >> SFTestOut.xcconfig
将target ->
SFTest
的编译配置输出成.txt文件,终端执行xcodebuild -project SFTest.xcodeproj -target SFTest -configuration Debug -showBuildSettings > xcodebuild_showBuildSettings.txt
- 现在工程中引入
Cocoapods
进行第三方库的管理,执行pod init
与pod install
终端出现警告,运行出现报错,如下所示:
- cocoapods 也是使用
xcconfig
来管理配置,可以看工程中 Pods 下面的 Targets Support Files 文件夹; - 引入了 pod 的项目,默认的 Configurations 为 pod 的 xcconfig;
- 为了不影响 pod 的使用,需要在
DebugConfig.xcconfig
,ReleaseConfig.xcconfig
中分别引入以下代码,如下:
- 再次运行,运行成功!
常见的环境变量
-
$(TARGET_NAME)
:目标工程名称 -
$(BUILD_PRODUCTS_DIR)
:编译生成Product的路径 -
$(SRCROOT)
:工程文件路径,例如SFTest.xcodeproj
-
$(CURRENT_PROJECT_VERSION)
:当前工程的版本号