iOS开发当中优雅的管理多个环境下的差异化设置

问题陈述

在开发当中我们常常会遇到的一点需求,对于不同的发布需求,需要切换不同的开发环境

例如:

  • 对于开发或内部测试构建 - iOS应用商店之外的开发发行版
    Host - devapi.project-name.com
    API Key - development_key
  • 客户端测试构建 - iOS应用商店外的企业发行版
    Host - stgapi.project-name.com
    API Key - enterprise_key
  • 为生产构建 - App Store 中的分发
    Host - api.project-name.com
    API key - app_store_key

最简单的,我们可以使用 DEBUG 管理两种设置

#if DEBUG
    #define API_BASE_URL @"http://devapi.project-name.com/api/v1"
    #define API_KEY @"development_key"
#else
    #define API_BASE_URL @"http://stgapi.project-name.com/api/v1"
    #define API_KEY @"enterprise_key"
#endif

于是我们会遇到这样的问题问题

企业发行版(客户端测试)和iOS APP Store 分发(生产)切换时每次均需要修改代码。

  • For Enterprise distribution

  • #if DEBUG
        //debug setting
    #else
        //enterprise setting
        #define API_BASE_URL @"http://stgapi.project-name.com/api/v1"
        #define API_KEY @"enterprise_key"
    #endif
    
  • For App Store distribution

  • #if DEBUG
        //debug setting
    #else
        //app store setting
        #define API_BASE_URL @"http://api.project-name.com/api/v1"
        #define API_KEY @"app_store_key"
    #endif
    

那么可不可以实现下面这样的方法呢

#ifdef DEVELOPMENT
    #define API_BASE_URL @"http://devapi.project-name.com/api/v1"
    #define API_KEY @"development_key"
#elif ENTERPRISE
    #define API_BASE_URL @"http://stgapi.project-name.com/api/v1"
    #define API_KEY @"enterprise_key"
#elif APP_STORE
    #define API_BASE_URL @"http://api.project-name.com/api/v1"
    #define API_KEY @"app_store_key"
#endif

于是我们需要解决这个问题

如何在不创建不同 target的情况下用不同名称创建三个构建?

  • ProductName - 用于 App Store
  • ProductName-Dev - 用户内部开发构建
  • ProductName-Stg - 用户客户端测试(企业)构建

解决方案

创建个人配置

在项目设置(非target)中,创建以下配置:

  • Debug_Dev

  • Debug_Staging

  • Debug_Prod

  • Release_Dev

  • Release_Staging

  • Release_Prod

create_config

注意,如果使用Cocoapods,则需要将配置设置回none,删除项目中Pods文件夹的内容,然后重新运行 pod install

接下来为每个环境创建方案

创建以下内容(复制原始的),代替MyApp方案 :

Create_Scheme
  • MyApp_Dev (Development)

  • MyApp_Stg (Staging)

  • MyApp (Production)

在每个方案中,在适当的地方使用关联的 Debug_* and Release_* 配置。

Assosiation_Env

最终看起来像这样

Created_Scheme

然后让我们添加预处理器宏来标识环境

添加一个额外的预处理器宏,以确定要构建的环境。

在项目构建设置中, 点击 + 号,添加一个名字像 MYAPP_ENVIRONMENT 的用户自定义构建(User-Defined)设置. 然后, 在每一个不同的环境组中添加不同的预处理宏,例如 DEVELOPMENT=1, STAGING=1 and PRODUCTION=1.

然后,在预处理器宏中(而且是在项目project级别,而不是目标targets级别)使用 $(MYAPP_ENVIRONMENT) 添加这个新的MYAPP_ENVIRONMENT设置。

最终看起来如下图

这样,就可以像下面这样确定开发环境的切换:

#ifdef DEVELOPMENT
    NSString * const MyAppAPIBaseURL = @"https://api-dev.myapp.com/";
#elif STAGING
    NSString * const MyAppAPIBaseURL = @"https://api-staging.myapp.com/";
#elif PRODUCTION
    NSString * const MyAppAPIBaseURL = @"https://api.myapp.com/";
#endif

还可以创建不同的用户定义的构建设置来做不同的事情,比如更改应用程序的显示名称。

可以通过创建一个名为 MYAPP_DISPLAY_NAME 的新设置 (与创建用于标识环境的预处理器宏相同),为每个配置设置正确的名称,然后在 info.plist 中设置正确的名称:$(MYAPP_DISPLAY_NAME)

希望这篇文章对你有帮助,如果有什么问题欢迎评论区留言讨论

完整项目 -

https://github.com/vineetchoudhary/BuildManagement
引用来源

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,324评论 5 476
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,303评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,192评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,555评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,569评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,566评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,927评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,583评论 0 257
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,827评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,590评论 2 320
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,669评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,365评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,941评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,928评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,159评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,880评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,399评论 2 342

推荐阅读更多精彩内容