本文由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标签栏。
在"Configurations"下点击 "+" ,然后选择 "Duplicate 'Release' Configuration",然后重命名为"Production"。
然后重复上面操作,复制"Debug"配置,重命名为"Development"。
接着,删除默认的Debug和Release配置。
(注意:如果你使用了CocoaPods,请看下面CocoaPods注意项。)
2.为两种构建环境分别创建配置文件"Settings-Development.plist" 和 "Settings-Production.plist"。
3.现在你可以向配置文件中添加任意的配置项,但要确保两个配置文件中的配置项的key相同。
4.打开Project Navigator,选中项目名,然后在下拉菜单中选中Target(注意不是Project)。
在Build Phases区域,在Copy Bundle Resources区域中移除Target对两个配置文件的引用。
5.添加一个Run Script Build Phase,选择Editor -> Add Build Phase -> Add Run Script Build Phase。
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配置
[图片上传中。。。(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工具为新创建的配置重新生成配置文件。同样如果后面你又添加了新的配置,你需要重复上面操作。
接下来
通过这个框架,你可以在项目配置文件中添加任何配置项,并在程序运行时读取它们。当然,如果你的应用需要多种演示测试环境,你可以根据需要创建更多构建环境。同样你也可以在一个构建环境中添加多个项目配置文件,但要记住要为每种构建环境创建单独的配置文件,另外你需要在Build Phases脚本中将这些配置文件在构建时拷贝到程序包中(参考步骤6)。
反馈
我非常乐意收到相关的任何建议,尤其是可以简化这个过程或者有其他思路的建议。