怎样使用Xcode的Targets来管理开发版本和生产版本的构建

原文:How to Use Xcode Targets to Manage Development and Production Builds
作者:EugeneTrapeznikov

想象一下,你已经完成了应用程序的开发和测试,现在准备提交正式版本。问题是,一些web服务的url指向了测试服务器,同时API密钥被配置用于测试环境。在提交app给苹果审核前,你需要修改所有这些API密钥和URL以适应生产版本。这听起来还好,对吧?但是相较于在开发环境和生产环境之间来回修改相关数值,有没有更好的方法来处理开发和生产版本的构建?这正是接下来Eugene要和你讨论的。

  • 进入Eugene的教程

对于初学者来说,有些人可能会奇怪,在App开发过程中,为什么需要使用两个单独的数据库和环境。原因是当你继续构建新的功能特性或继续开发你的应用,你希望区分开现有的公开版本和生产版本。

标准的软件开发实践是在不同的开发环境下开发不同版本的软件,像我们案例中讲到的开发iphone应用。应用程序的开发版本通常使用一个不同于生产环境的数据库(或如分析的其他系统)。这就是为什么我们应该为不同的环境中使用单独的服务器和数据库。开发人员在测试期间通常都使用虚拟图像或虚拟数据。在测试环境中,使用诸如 “test comment”, “argharghargh” 和 “one more test comment”之类的测试数据并不少见。显然,你不希望你的真实用户看到这样的消息。如果你的应用程序使用了一个分析系统的情况下,你甚至会在测试阶段发送成千上万的事件。同样的,你不会把测试数据和生产数据放在同一个数据库中。这就是为什么总是推荐区分开发和生产环境。

在使用两个独立的环境时,你的应用程序需要有一个办法找出它应该连接到的环境。一种常用的方法是在你的主应用代理里定义一个全局变量,它会将您的应用程序初始化为开发或生产模式。

enum environmentType {
    case development, production
}
let environment:environmentType = .production
switch environment {
case .development:
    // set web service URL to development
    // set API keys to development
    print("It's for development")
case .production:
    // set web service URL to production
    // set API keys to production
    print("It's for production")
}

这种方法需要你每次切换环境时改变全局变量。虽然这种方法也许快捷,方便,但是它有一些重要的限制。首先,因为我们在开发和生产两个环境中使用一个Bundle ID,你不能在一台设备上安装应用的两个版本。当你需要要测试开发版本的应用程序时,同时仍在该设备上使用生产版本的应用,这就变的不方便了。此外,这种方法很有可能将应用的开发版本上传到应用商店。如果你忘记了改变这个全局变量,你将会上传错误的应用给你的用户。我记得有一次在提交应用程序到应用商店之前我忘记改变全局变量,用户下载的是应用的开发版本,这是可怕的。

在这篇文章中,我将展示一个更好的方法来区分开发和生产构建。具体而言,我们将在Xcode中创建一个开发的target。这种方法法适用于新的和现有的大型项目,所以你可以用一个现有的应用程序对照本教程。

通过应用这种方法,应用的开发和生产版本将使用相同的基础代码,但可以有不同的图标,bundle ID 和指向不同的数据库。发布和提交过程将会非常简单。最重要的是,你的测试人员和经理可以在同一设备上安装两个版本的应用程序,所以他们完全知道他们在体验哪个版本。

  • 如何创建一个新的Target

所以你如何在Xcode中创建一个开发的target?我使用示例项目“todo”引导您一步一步完成整个过程。您也可以使用自己的项目并按照步骤:

  1. 在项目的导航面板进入项目设置。在Targets区域下,右键单击现有目标并选择 Duplicate 复制现有的目标。
    640-0.jpeg
  2. Xcode会询问你新的target是否是为iPad开发。对于本教程,我们只是选择“Duplicate Only”。
    640-1.jpeg

    提示:如果您的项目支持通用设备,Xcode不会提示上述消息。
  3. 现在我们有一个名为todo copy的新的target和build scheme。重命名并使之更容易理解。
  • 在Targets列表中选择新的target。按Enter键编辑文本,添加一个更合适的名字。我更倾向于“todo Dev”。你可以自由选择任何你喜欢的名字。
  • 接下来,找到“Manage Schemes…”,选择您在步骤1中创建的shceme,并按“输入”,使scheme的名称和新的target的名称相同(这是你为新的target所选择的名字)


    640-2.jpeg
  1. 步骤4是可选的,但强烈推荐。如果你想简单地区分开发和生产版本构建,你应该为每个版本使用单独的icon和启动页。这将使测试人员更清晰地知道正在使用哪个app,防止上传开发版本。
    跳到 Assets.xcassets 添加一个新的图标。右击图标 > App Icons & Launch Images> New iOS App Icon. 新图标重命名为AppIcon-Dev同时添加自己的图片。

    640-3.jpeg

  2. 现在回到项目设置,选择您的开发target,并改变Bundle Identifier。你可以简单地将“Dev”追加到原来的ID上。如果执行了步骤4,请确保更改应用app icon,设置为在上一步中创建的。


    640-4.jpeg
  3. Xcode会自动为你的target添加plist文件(如todo copy-Info.plist)。你可以在项目的根文件夹找到它。将它从“copy”重命名为“Dev”,并将它放在原始的plist文件下。这里你将更容易管理文件。

  4. 现在打开你开发targetBuild Settings,滚动到Packaging,并将值改为开发的plist文件(todo Dev.plist)。

    640-5.jpeg

  5. 最后,我们会为生产和开发target配置预处理宏/编译器标识。之后我们就可以使用该标识在我们的代码来检测应用程序正在运行的版本。
    对于Objective-C的项目,去到Build SettingsApple LLVM 7.0 - Preprocessing。拓展Preprocessor Macros在Rebug和Release区域添加一个变量。对于开发target(即todo Dev),将该值设置为DEVELOPMENT = 1。另一个,将值设为DEVELOPMENT=0来表示生产版本。

    640-6.jpeg

    640-7.jpeg

    对于swift的项目,编译器不再支持预处理指令。作为替代,它使用编译时的属性和build配置。选中开发target,添加一个标识表示开发版本。找到Build Setting往下滚动到Swift Compiler - Custom Flags部分。将值设为-DDEVELOPMENT表示这个target作为开发版本。
    640-8.jpeg

现在,您已经创建并配置了开发target,下一步呢?

  • 使用Target和宏

根据已配置的宏DEV_VERSION,我们可以在代码中利用它动态地编译项目。下面是一个简单的例子:

Objective-C:

#if DEVELOPMENT
#define SERVER_URL @"http://dev.server.com/api/"
#define API_TOKEN @"DI2023409jf90ew"
#else
#define SERVER_URL @"http://prod.server.com/api/"
#define API_TOKEN @"71a629j0f090232"
#endif

Objective-C中你可以使用#if检查DEVELOPMENT的环境,并相应的设置URLs/ API密钥。

Swift:

#if DEVELOPMENT
let SERVER_URL = "http://dev.server.com/api/"
let API_TOKEN = "DI2023409jf90ew"
#else
let SERVER_URL = "http://prod.server.com/api/"
let API_TOKEN = "71a629j0f090232"
#endif```

Swift中你仍然可以使用`#if`判定build的参数动态编译。然而,除了使用`#define`定义基本常量,在swift中我们也可以用`let`定义一个全局常量。
*提示:通常,你会把上面的代码放在app delegate中。但这最终是取决于你在哪里初始化应用程序设置。*

现在,当您选择“todo Dev”scheme运行项目,你创建开发版本会自动将服务器的配置设置为开发环境。现在,您可以上传开发版本到TestFlight 或 HockeyApp供测试人员和管理人员来测试。
接着如果你需要创建一个生产版本,您可以简单地选择"todo"scheme。不需要更改代码。

**管理多个target的一些注意事项**

1. 当你添加新的文件到项目中,不要忘记选择两个target,以保持你的代码同步在两个版本。
![640-9.jpeg](http://upload-images.jianshu.io/upload_images/1748817-48ad8b9cfd0d7908.jpeg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
2. 如果你使用的CocoaPods,不要忘了添加新的target到你的podfile中。您可以使用`link_with`指定多个target。您可以进一步细节请查阅的 CocoaPods 文档。你的podfile看起来是这样的:
![640-10.jpeg](http://upload-images.jianshu.io/upload_images/1748817-d6fdd9ee9a720c44.jpeg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
3. 如果你使用持续集成系统,如 Travis CI 或Jenkins,别忘了配置两个target的build和deliver。
[.](https://mp.weixin.qq.com/s?__biz=MjM5OTM0MzIwMQ==&mid=2652546114&idx=1&sn=67e479d82e0d0a662b05082fe74f731b&scene=0&key=77421cf58af4a653c8399f6b45841a85c270e9c5a3a27be12bf54eb8e0f4ef3abd3fd0774f444128ce7a65dc65673883&ascene=7&uin=NTk5NjY4MDAw&devicetype=iPhone+OS9.3.2&version=16031510&nettype=WIFI&fontScale=100&pass_ticket=RvqmZR25hWgBcY4bjjgmBhNXNIEICVVC%2FJ1rHW3D8AiLKzaNJKaKDqdSrCnfUcML)
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 158,560评论 4 361
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,104评论 1 291
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,297评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,869评论 0 204
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,275评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,563评论 1 216
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,833评论 2 312
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,543评论 0 197
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,245评论 1 241
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,512评论 2 244
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,011评论 1 258
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,359评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,006评论 3 235
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,062评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,825评论 0 194
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,590评论 2 273
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,501评论 2 268

推荐阅读更多精彩内容