转载

【译】iOS Xcode部署配置

【译】iOS Xcode部署配置

本文由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标签栏。

【译】iOS Xcode部署配置

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

【译】iOS Xcode部署配置

然后重复上面操作,复制"Debug"配置,重命名为"Development"。

接着,删除默认的Debug和Release配置。

【译】iOS Xcode部署配置

(注意:如果你使用了CocoaPods,请看下面CocoaPods注意项。)

2.为两种构建环境分别创建配置文件"Settings-Development.plist" 和 "Settings-Production.plist"。

【译】iOS Xcode部署配置

【译】iOS Xcode部署配置

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

【译】iOS Xcode部署配置

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

【译】iOS Xcode部署配置

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

【译】iOS Xcode部署配置

【译】iOS Xcode部署配置

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

【译】iOS Xcode部署配置

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  cp -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配置

【译】iOS Xcode部署配置

【译】iOS Xcode部署配置

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工具为新创建的配置重新生成配置文件。同样如果后面你又添加了新的配置,你需要重复上面操作。

【译】iOS Xcode部署配置

接下来

通过这个框架,你可以在项目配置文件中添加任何配置项,并在程序运行时读取它们。当然,如果你的应用需要多种演示测试环境,你可以根据需要创建更多构建环境。同样你也可以在一个构建环境中添加多个项目配置文件,但要记住要为每种构建环境创建单独的配置文件,另外你需要在Build Phases脚本中将这些配置文件在构建时拷贝到程序包中(参考步骤6)。

反馈

我非常乐意收到相关的任何建议,尤其是可以简化这个过程或者有其他思路的建议。

正文到此结束
Loading...