iOS架构之路11 -- project，target，workspace与scheme的区别与联系

• iOS应用程序使用Xcode进行编译，打包的时候会接触到workspace，project，target与scheme这四个概念，下面我们来详细介绍这四个概念；

Project

• Project是基本工程，其包含了所有的代码文件，.a或.framework静态库文件，资源文件，以及与编译相关基础设置；
• Project可以单独存在，也可以被包含在Workspace中；
• 一个Project可以包含一个或者多个Target，在Project中设置的编译选项Build Setting，可作用于所有的Target，每一个Target自己也单独设置自己特殊的编译配置，如下所示：
  
  image.png

image.png

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中进行设置，举例如下：
  
  image.png

image.png

image.png

Worksapce

• Worksapce顾名思义是工作空间，是Xcode的一种文件，可管理Project和其他文件，便于我们使用它；
• Worksapce可以包含多个Project，如下所示：
  
  image.png
• 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同名；
  

  image.png

• Xcode为Scheme默认生成的配置选项Configuration有Debug与Release两种，我们也可自定义新增Configuration，下面会有涉及到；

• 我们可以自定义新的Scheme，如下所示：

Snip20210922_30.png

Snip20210922_31.png

image.png

image.png

• 上述四种之前的关系可用下图进行描述：

image.png

Xcode多环境配置

第一种方式：单scheme + 多configurations

• 新建一个项目命名为ShellTest，并支持Cocoapods，然后配置info -> Configurations，添加新的环境配置，如下所示：
  

  Snip20210918_10.png

• 其中Debug与Release是Xcode默认的，Dev_Debug与Dev_Release是自定义新增的；

• 这里配置完成后，由于使用了Cocoapods，要执行一次pod install，pods会自动去配置相关的环境，如下所示：
  

  Snip20210918_11.png

• 现在有四种Configurations，如下所示：
  

  image.png

• 配置预编译宏，以此可用来设置不同scheme下的域名；

Snip20210918_12.png

image.png

• 配置App的名称

image.png

Snip20210922_19.png

image.png

• 配置App的BundleID

image.png

• 配置AppIcon

image.png

image.png

image.png

• 依次选择四种scheme，运行工程，最后会得到四个不同配置的App，如下所示：

image.png

第二种方式：多scheme + 多configurations

• 上述第一种方式 单scheme + 多configurations，每次运行都需要重新设置scheme的configurations选项，比较麻烦，下面建立所个scheme，然后让设置每个scheme的configurations选项，在运行工程时，只要切换scheme即可；
  
  image.png
• 其他的配置与方式一相同；

第三种方式：多target

• 选中target -> YYTest 然后右击选择Duplicate，会创建一个新的target；
  
  image.png
• 可更改新的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的形式导入；

Snip20210923_41.png

image.png

• 然后在Project -> info -> configurations中去设置.xcconfig文件，如下所示：

Snip20210923_42.png

• 最后在工程中使用.xcconfig文件中自定义的key-value选项，如下所示：

Snip20210923_44.png

• 工程运行之后，我们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

• 将目标schemeSFTest的编译配置输出成SFTestOut.xcconfig文件， 终端执行xcodebuild -scheme "SFTest" -showBuildSettings >> SFTestOut.xcconfig

• 将target -> SFTest的编译配置输出成.txt文件，终端执行xcodebuild -project SFTest.xcodeproj -target SFTest -configuration Debug -showBuildSettings > xcodebuild_showBuildSettings.txt

image.png

• 现在工程中引入Cocoapods进行第三方库的管理，执行pod init与pod install 终端出现警告，运行出现报错，如下所示：

Snip20210923_45.png

Snip20210923_46.png

• cocoapods 也是使用 xcconfig来管理配置，可以看工程中 Pods 下面的 Targets Support Files 文件夹；
• 引入了 pod 的项目，默认的 Configurations 为 pod 的 xcconfig；
• 为了不影响 pod 的使用，需要在DebugConfig.xcconfig，ReleaseConfig.xcconfig中分别引入以下代码，如下：

Snip20210923_49.png

• 再次运行，运行成功！

常见的环境变量

• $(TARGET_NAME)：目标工程名称
• $(BUILD_PRODUCTS_DIR)：编译生成Product的路径
• $(SRCROOT)：工程文件路径，例如SFTest.xcodeproj
• $(CURRENT_PROJECT_VERSION)：当前工程的版本号