【译】iOS Xcode部署配置

1445851427334659.jpg

本文由 CocoaChina译者 @张小刚哟 翻译，作者： Nicholas Solter原文： Xcode Deployment Configurations for iOS
几乎所有移动应用，包括我正在编写的一款iOS应用 Emmerge 都需要与服务器交互。从第一次向团队成员演示应用开始，我们就开始找一种更快构建不同环境产品的方法。一开始我们只需要修改不同环境下的服务器地址，但在经过几天来回的在配置文件中切换本地和远程服务器地址后，我对这种重复工作烦透了，于是到Google查找解决方法。在搜索一段时间后，我却没用找到如何在Xcode中为每一种构建环境分别设置配置的方法，于是在经过大量搜索stack overflow和博客后，我总结了一种相当简洁有效的方法，在这里分享给需要的人。
我们何时需要考虑不同的部署环境
任何需要与后端服务器通信的APP（最简单的APP除外）至少需要一个可配置的服务器URL。又或者你的应用使用了第三方平台登录，如Facbook、Google或者类似的系统，并且在每种构建环境下又需要不同的第三方平台，那么就需要为不同构建环境设置不同的平台App IDs。又或者你的应用需要收集分析数据，那么你可能就需要配置不同的 mixpanel ID。
具体设置方法
下面简单的例子中，我们需要创建Development和Release两种环境，最终我们要为每种环境创建自己的配置文件(Setting.plist)，并且在应用运行时只加载相应环境的配置文件。
你可以下载 Demo程序 跟着步骤操作一遍。
1.创建Development和Release构建环境
在Project Navigator下，选择项目名，然后在下拉菜单中选择Project（注意不是Target），然后选中Info标签栏。

1445850557506270.png

在"Configurations"下点击 "+" ，然后选择 "Duplicate 'Release' Configuration"，然后重命名为"Production"。

1445850576226303.png

然后重复上面操作，复制"Debug"配置，重命名为"Development"。
接着，删除默认的Debug和Release配置。

1445850636774747.png

(注意：如果你使用了CocoaPods，请看下面CocoaPods注意项。)
2.为两种构建环境分别创建配置文件"Settings-Development.plist" 和 "Settings-Production.plist"。

1445850668734460.png

1445850672655103.png

3.现在你可以向配置文件中添加任意的配置项，但要确保两个配置文件中的配置项的key相同。

1445850740940695.png

4.打开Project Navigator，选中项目名，然后在下拉菜单中选中Target（注意不是Project）。

1445850758321504.png

在Build Phases区域，在Copy Bundle Resources区域中移除Target对两个配置文件的引用。

1445850814734789.png

1445850820165629.png

5.添加一个Run Script Build Phase，选择Editor -> Add Build Phase -> Add Run Script Build Phase。

1445850848883771.png

6.拷贝下面脚本到新创建的Run Script

if
 [ “${CONFIGURATION}” == “Development” ]; then
cp -r “${PROJECT_DIR}/Settings-Development.plist” “${BUILT_PRODUCTS_DIR}/${PRODUCT_NAME}.app/Settings.plist”
elif [ “${CONFIGURATION}” == “Production” ]; then
p -r “${PROJECT_DIR}/Settings-Production.plist” “${BUILT_PRODUCTS_DIR}/${PRODUCT_NAME}.app/Settings.plist”
fi

7.下面我们就可以在程序运行时读取配置文件中的内容：

var serverUrl: String = ""
if let filePath = NSBundle.mainBundle().pathForResource("Settings", ofType: "plist" ) {
 let contentsOfFile = NSDictionary(contentsOfFile: filePath) serverUrl = contentsOfFile?.objectForKey(  "ServerUrl" ) as! String
 } 
  else
 {
// no settings!
 }

8.接下来设置应用构建时的配置环境，点击菜单栏中的Product -> Scheme -> Edit Scheme，选中左侧Action列表栏中的"Run"，然后在右侧选择Development或Production配置

1445850922344670.png

[图片上传中。。。（13）]
9.同样，你需要为其他的Action，如Test，Profile，Analyze和Archive选择构建配置。比如，你对Production进行运行/测试时，请确保在将其打包上传至TestFlight前，把"Archive"Action的构建配置设为"Production"!
CocoaPods注意事项：
如果在添加新的Devlopment和Production配置之前，你已经在项目中使用了CocoaPods，那么就可能会遇到错误，比如，“[!] CocoaPods did not set the base configuration of your project because your project already has a custom config set. In order for CocoaPods integration to work at all, please either set the base configurations of the target … in your build configuration”，或者与pods相关的链接器错误。
要解决这些问题，你需要到Project setting区域的info栏（和步骤1相同位置）,将所有新增配置的"Based on Configuration File" 设置为 "None"，然后运行"pod install"，强制pod工具为新创建的配置重新生成配置文件。同样如果后面你又添加了新的配置，你需要重复上面操作。

1445850978302581.png

接下来
通过这个框架，你可以在项目配置文件中添加任何配置项，并在程序运行时读取它们。当然，如果你的应用需要多种演示测试环境，你可以根据需要创建更多构建环境。同样你也可以在一个构建环境中添加多个项目配置文件，但要记住要为每种构建环境创建单独的配置文件，另外你需要在Build Phases脚本中将这些配置文件在构建时拷贝到程序包中（参考步骤6）。
反馈
我非常乐意收到相关的任何建议，尤其是可以简化这个过程或者有其他思路的建议。