使用Configurations + Scheme + User-defined setting管理你的项目环境

切换项目环境是日常操作之一,如何做到优雅而自动化一直是一个问题,以我们项目为例,以往的方式是通过宏定义的方式,切换时手动切换变量,然后这种做法既不优雅又容易因为手动的原因出现一些问题,比如线上debug(手动狗头)这种操作。当然还有其他的一些方案比如多Tagrget + 宏定义,这种做法的问题是添加文件时需要包含进多个target,不然就会报错,除了资源文件一些代码文件比如Catagory如果没有添加编译期不能发现但到运行时就会Crash。本文介绍一种方式,使用多Configurations + Scheme+User-defined setting来配置和管理项目环境。

先来介绍一下这几个部分

Configurations

image.png

如图,选择Project工程,会看到在Info栏有一个Configurations字段,默认情况下,项目会生成两种配置DebugRelease,开发时运行代码使用 Debug 配置,打包一般使用 Release配置,基于这两种配置我们可以做到的是基于当前环境(debug还是release)来设置baseUrl,比如这样

    var baseURL: URL {
        if Debug {
            return testURL
        } else {
            return productionURL
        }
    }

然而我们的日常开发中可能会操作的情况有这么四种

  • 开发时debug配置,测试环境
  • 开发时debug配置,正式环境
  • 测试分发Release配置,测试环境
  • AppStore/测试分发Release,正式环境

很显然仅仅是Debug和Release这两种环境配置已经满足不了我们的需求,我们需要做的就是新增这两种环境配置。

image.png

如图,新增了ProductionDebugInhouseRelease分别对应开发时正式环境和分发时测试环境。这样我们的项目就有了四种对应的环境配置,基于这些环境配置,我们只需要让我们的操作(Run/Archive)基于不同环境,然后不同的环境内返回不同的baseURL就可以了。那么如何来自做呢。

Scheme

首先我们项目默认只有一个Scheme,相应的Run和Archive操作也默认对应了Debug和Release环境,如下图所示。


image.png

我们新增两种环境后,首先想到的就是新增一个Scheme配置,然后将新增的Scheme的Run和Archive操作对应到我们新增的两种环境即可。如下图所示,我们新增了一个Scheme,然后修改了其Run/Archive操作到对应的ProductionDebug和InhouseRelease环境。这样我们就可以通过两个Scheme来进行四种环境的操作了。

image.png

User-defined setting

第一步解决了,那么如何配置不同环境的URL呢?

一种比较简单的方式是通过环境代码判断

    var baseURL: URL {
        var urlString = "baseURL"
        
        #if DEBUG
        urlString = "debug url string"
        #elseif ProductionDebug
        urlString = "production debug url string"
        #elseif InhouseRelease
        urlString = "release url string"
        #else
        urlString = "release url string"
        #endif
        
        return URL(string: urlString)!
    }

一种更好的方式是通过User-defined setting将URL的配置写入其中。选中当前Target,在Build Settings栏点击+号,选择 Add-user-defined setting。

屏幕快照 2019-04-24 上午11.45.22.png

image.png

如图所示,我们新增了一个名为BASE_URL的字段,然后在不同的环境下配置了相应的URL,如何使用到这个BASE_URL呢,方法是在infoPlist中新增一个字段

image.png

如图,新增一个API_BASE_URL字段,其value引用了Build Settings中的BASE_URL字段。这样在不同环境下就可以引用到相应的URL。
最后在用的地方加载infoPlist中的这个字段就可以了(这里使用了单例+懒加载是为了只加载一次,因为baseURL会频繁调用)。

struct EnvironmentManager {
    static var share = KYXEnvironmentManager()
    
    lazy var baseURL: URL = {
        let urlString = Bundle.main.infoDictionary?["API_BASE_URL"] as? String ?? ""
        return URL(string: urlString)!
    }()
}

最后,当你要切换时只需要选择相应的Scheme来操作就可以了。
当然更好的一种方式是结合fastlane,可以让整个过程更加自动化,具体的下篇来聊
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念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