简单的iOS多环境切换配置技巧-京东云开发者社区

在客户端开发过程中，我们经常会需要在不同的开发环境下，需要设置不同的参数、使用不同的代码逻辑。例如：在Debug模式下，我们需要输出log，而在Release模式下所有的log输出应该被关闭。我们通常是通过使用项目中默认的Debug和Release模式来做相应的区分的。

Xcode在创建项目时默认创建Debug和Release两种Build Configuration。但有时候这两种Build Configuration可能无法完全满足我们的需求。例如，有时可能还需要一种ADHoc模式来实现通过企业证书来发布企业版APP给测试同学来进行测试或者进行UAT。

本文就通过在一个Flutter和iOS混合项目中新增一个ADHoc模式，来实现在一个工程的Target中可以同时支持企业版本的APP和APP Store版本的APP的开发和自动化打包。

#### 整个流程如下图所示：

![](//img1.jcloudcs.com/developer.jdcloud.com/15e207be-a5ef-4ee2-9379-a56e1d532a9620210223134746.png)

#### 1. 创建新的Build Configuration

在Xcode的Project的Configurations选项中，可以看到默认的两种Build Configuration：Debug和Release。点击下面的“+”按钮，就可以新建一个Build Configuration。

![](//img1.jcloudcs.com/developer.jdcloud.com/7593260f-3662-41f5-b8a1-e586b2c8c48420210223135715.png)

点击Duplicate “Release” Configuration可以新建一个编译配置，其中的设置和已有的Release模式的设置完全一样。将新建的编译模式命名为“ADHoc_Release”，同样可以新建一个编译模式为“ADHoc_Debug”。

![](//img1.jcloudcs.com/developer.jdcloud.com/d5d48d10-f032-48b3-aafa-fe69ec1e61c720210223135739.png)

#### 2. 修改Build Configuration

新建的Build Configuration的目的是为了区分通过APPStore证书还是通过企业证书来开发和打包，同时由于我们的APP需要支持Push推送，所以Build Configuration需要修改的内容主要有：

a.Bundle ID（修改Xcode配置）
b.APP的名称（修改Info.plist）
c.Push SDK的初始化参数(修改工程代码)
d.证书（修改Xcode配置）。

##### a.修改BuildSetting的Bundle ID
在Target的Build Settings中的Product Bundle Identifer中，可以根据Build Configuration分别设置不同的编译配置的Bundle ID。

![](//img1.jcloudcs.com/developer.jdcloud.com/d45d902e-cb4f-4962-93a0-b4ceffa6109420210223135802.png)

##### b.修改APP的名称
**-新增自定义参数**

由于APP的名称是在Info.plist中的Bundle display name被设置的，而为了让Info.plist中的设置可以根据不同的Build Configuration设置不同的名称，首先需要在Build Setting中新建一个用户自定义的参数BUNDLE_DISPLAY_NAME，并根据不同的Build Configuration，设置不同的名称。

首先新建一个User-Defined Setting：
![](//img1.jcloudcs.com/developer.jdcloud.com/19271e97-7d53-429c-8c74-8b6f23e16c8c20210223140100.png)

修改设置的名称和内容：

![](//img1.jcloudcs.com/developer.jdcloud.com/445a00bb-742a-4355-ad99-9eb386bc971c20210223140134.png)

**-修改Info.plist**

在Info.plist中，设置Bundle display name的值为刚才自定义的参数BUNDLE_DISPLAY_NAME。

![](//img1.jcloudcs.com/developer.jdcloud.com/804e220f-f128-47d4-b08b-bf4b31a12e7d20210223140211.png)

##### c.修改Push SDK的初始化参数
因为企业版APP和APP Store版APP的Bundle ID不同，因此需要在Push SDK的初始化时，设置不同的appid和appSecret。

**-增加宏定义**

首先，在Project的Apple Clang-Processing中，设置预编译的宏定义。在ADHoc_Debug中添加宏定义ADHOC_DEBUG，在 ADHoc_Release中添加宏定义ADHOC_RELEASE。

![](//img1.jcloudcs.com/developer.jdcloud.com/64dafc43-672d-45c6-ad16-9d64fab6b69720210223140309.png)

**-修改代码**

修改完以后，就可以在代码中直接使用我们新加的宏定义，在代码中修改Push SDK的初始化逻辑。

![](//img1.jcloudcs.com/developer.jdcloud.com/59cb2bcd-89d0-4f7c-84b6-637746ff14cb20210223140343.png)

##### d.证书

在Signing&Capabilities中，需要根据不同的编译配置，设置不同的证书和配置文件。其中ADHoc需要配置企业证书，而其他的需要配置的是APP Store证书。

![](//img1.jcloudcs.com/developer.jdcloud.com/f17ff9f7-c866-4f02-b0f1-bb99b6c5870b20210223140424.png)

##### 使用Cocoapods注意事项
如果是使用Cocoapods来管理整个项目的话，一定不要忘记在修改完成后执行pod install命令，执行完后，我们就可以在工程中发现多了adhoc_debug.xcconfig和adhoc_release.xcconfig这两个文件存储着我们刚才所做的各种修改。

##### 在Flutter项目中的注意事项
之所以把新建的两个build Setting命名为ADHoc_Debug和ADHoc_Release是因为，在Flutter的编译脚本xcode_backend.sh中有如下代码：

![](//img1.jcloudcs.com/developer.jdcloud.com/9f47ef50-2665-4f02-bdb3-4d3e87a01b7b20210223140502.png)

也就是说，我们可以在编译配置中，设置FLUTTER_BUILD_MODE这个宏定义，并设置为release、profile或者debug，Flutter就能根据此来编译成对应的SDK。

如果没有设置，Flutter就会根据我们的build configuration的名称来选择Flutter SDK的编译模式。因此，我们只需要在build configuration中包含debug、profile或者release这几个字段中的一个，Flutter就能根据此来编译成对应的SDK。否则Flutter就无法决定到底使用哪一种编译模式来进行编译，而导致编译失败。

#### 3.自动化打包
在阿凡达平台提供的持续集成CI中，也支持设置不同的build configuration。只需要在构建类型中输入我们自己定义的build configuration的名称，打包平台就会自动根据当前选择的build configuration来进行自动打包和持续集成。

![](//img1.jcloudcs.com/developer.jdcloud.com/fc9f4772-9e62-4895-80d6-3c09e9c09b6320210223140545.png)

#### 总结
在Xcode中可以通过设置不同的build configuration来实现多环境的切换，而build configuration可以设置的内容很多，既可以设置不同的各种Xcode 的编译选项，也可以设置Info.plist中的内容，当然也可以通过配置宏定义，在代码中实现根据不同配置，运行不同的代码代码逻辑。使用好build configuration可以节省我们很多的工作量。

当然如果build configuration无法完全满足需求，也可以通过设置不同的Target来实现根据不同的配置打包不同的app。

------------
###### 自猿其说Tech-JDL京东物流技术发展部
###### 作者：用户产品部 郝宏伟