2、iOS强化 --- Xcode 多环境的配置

这里我们会介绍三种,在充分了解前两种的基础上,建议大家在开发中灵活使用第三种方法。当然,大家在熟练的情况也可以根据实际情况自己组合使用

在讲解多环境配置之前我们先来认识一下,我们在Xcode常见的一些名词,都代表什么意思?

  • Project:包含了项目所有的代码,资源文件,所有信息。
  • Target:对指定代码和资源文件的具体构建方式。
  • Scheme:对指定Target的环境配置。
    首先我们来看一个熟悉的东西:
    image.png

    相信大家都会通多上面修改Configuration的方式来切换DebugRelease的开发环境。但是仅仅是这样并不能满足我们日常的开发需求,下面我们来介绍三种Xcode的多环境配置,希望可以在日常的开发中给大家带来方便,增加效率。

方法一:通过增加Target

我们知道,Target是对指定代码和资源文件的具体构建方式。那么理论上我们知道复制一份Target出来,然后在不同的Target下,设置不同的参数配置不就可以了吗!
下面我们来配置一下:
1、首先我们针对对应的Target,制作一个副本

image.png

2、制作完成之后,我们会发现工程里面多了一个Target和一个Info.plist文件,同时也会多一个Scheme
image.png

image.png

3、我们可以通过修改Bundle IndentifierInfo.plistScheme名称来进行区分

image.png

image.png

⚠️ 注意,修改外Info.plist文件名之后,一定要在对应的Build Settings里面修改Info.plist路径

image.png

  • 我们接着讲一下,Target中预定义宏的的设置
    我们再testDebug中设置自定义的
    image.png

    使用如下:
if (TEST_DEBUG) {
        NSLog(@"Debug");
    } else {
        NSLog(@"Release");
    }

注意 ⚠️ :此时TEST_DEBUG我们并不能在test中使用,因为我们只在testDebug设置了;那么当我们切换到test环境中的时候,就会报错:(这里要注意,对个Target操作的只有一套代码)

image.png

这时候我们只需要在test环境下也设置同样名字的就可以了,对应的值设置成不同的,就可以在代码里面区分不同的环境,执行不同的指令了。

  • Swift环境中设置Other Swift Flags,混编情况下也是一样。
    我们在上面工程的基础上看下混编要怎么设置(注意,视情况做出调整):
    这里要注意,在添加一定要在前面加一个-D
    image.png

方法二:添加Scheme

image.png

然后我们可以对不同的Scheme配置不同的configuration来进行环境区分。如下:
image-debug.png

image-release.png

这样我们就可以通过切换不同的Scheme来切换不同的开发环境。

  • 举个例子,不同的Scheme对应不同的AppIcon:
    首先我们要在Assets.xcassets再添加一个AppIcon

    image.png

    接着我们可以在targetBuild Settings里面设置不同的configuration对应不同的AppIcon
    image.png

  • 我们还可以针对不同Scheme设置不同的App Name
    TargetBuild Settings里面添加自定义的字段,如下:

    image.png

    假设我们现在就将字段名定义为BUNDLEDISPLAY_NAME,然后Debug模式下就叫DebugRelease模式下就叫Release
    接着我们要在Info.plist文件中替换Bundle name:
    image.png

    效果如下:
    debug.png

release.png

缺点:此时同样的,我们还是需要在Target里面修改很多东西,这样的还难免会遗漏一些东西,改起来也不是特别的方便。

方法三:利用xcconfig文件,结合自定义的Scheme来配置多环境开发

  • 首先我们来了解一下什么是xcconfig文件,我们在使用cocopod的时候,会自动什么podxcconfig文件,如下:
    image.png

    其实这个xcconfig文件类似于plist文件,就是一个Key-Value的集合,其对应的就是Target中的设置:
    image.png
  • 既然cocopod可以定义自己的xcconfig文件,那么我们也可以定义自己的xcconfig文件,这样做的好处是,将需要修改的环境变量集中到一个文件里面,这样便于管理。
    下面我们自定义自己的xcconfig文件:
    image.png
  • ⚠️ 注意:xcconfig文件的命名规则是:<文件夹名称-APP名称.对应的configuration>如下:
    image.png
  • 然后我们在PROJECT-Info-Configurations里面,将不同的configuration设置对应的xcconfig文件:
    image.png
  • xcconfig文件其实就是一个Key-Value文件,对应的就是Target的设置。下面我们来测试一下:
    1、首先我们在TargetBuild Settings里面设置自己的字段:
    image.png

    2、接着我们给工程加一个test1_DebugScheme,对应的就是Debug模式;原来的test1对应Release模式:
    image.png

    3、根据上面讲的,将不同的configuration设置对应的xcconfig文件,在xcconfig文件中我们这样写:
    Debug文件:APP_CONFIG = APP_Debug_Replace
    Release文件:APP_CONFIG = APP_Release_Replace
    4、我们在Info.plist文件中添加一个刚刚设置的字段:
    image.png

    5、打印我们自定义的字段:
NSString *path = [NSBundle.mainBundle pathForResource:@"Info" ofType:@"plist"];
NSDictionary *infoDic = [[NSDictionary alloc] initWithContentsOfFile:path];
NSLog(@"%@",infoDic[@"APP_CONFIG"]);

/*运行test1*/
输出结果:APP_Release_Replace
/*运行test1_Debug*/
输出结果:APP_Debug_Replace

讲到这里,大家可能会觉得第三种方法中,单独添加一个test1_Debug完全就是多余,可以通过运行的时候切换test1configuration也能实现上面的效果。
这里请大家考虑一下,实际的开发中,你面对的可能不只是Debug & Release环境,可能有本地测试服正式服等等。因此个人建议,用不同的Scheme区分开,是比较高效的处理方式。

这里给大家推荐一个网站,可以查到Target的各个字段对应的缩写:Xcode Build Settings

  • 下面我们介绍一下最后一个知识点:xcconfig文件冲突
  • 冲突 1:

实际开发中,我们会使用Cocopods来管理我们的第三方库,Cocopods也会给我们生成一些xcconfig文件(这里注意⚠️ :每次podCocopods都会从新生成xcconfig文件,所以不要在Cocopods生成的xcconfig文件中做修改)

那么这个时候,就有一个问题,我们针对configuration到底要选哪一个xcconfig文件呢?
答案当然是我们自定义的xcconfig

这样有衍生出另一问题,那么pod生成的xcconfig我们该怎么处理,如果不添加,则pod install就会出问题,如果是之前pod好的工程,那么pod中针对Target的一些设置又该怎么办?
其实很简单,我们只需要在自定义xcconfig文件中引入pod生成的xcconfig文件就可以了,如下:

#include "Pods/Target Support Files/Pods-test1/Pods-test1.debug.xcconfig"
  • 冲突 2:

解决了上面的问题,我们来看另一问题,严格将问题2也是一个衍生问题。

如果自定义xcconfigpod生成的xcconfig文件,对同一个字段进行了修改,那Xcode会用哪个文件中的配置呢?
答案是:自定义xcconfig,其实大家想一下就明白了,自定义的 引用 pod生成的,然后Xcode再引用自定义的

那么像这种问题我们该怎么解决呢?
这里我们先给出答案:使用$(inherited),可以理解为继承。

下面我们看一下具体的使用场景:
首先我们在自定义的xcconfig文件中添加

OTHER_LDFLAGS = -framework "SDWebImage"

同时我们也podAFNetworking
此时我们会发现,在TargetBuild Settings-Other Link Flags路面只有SDWebImage,如下:

image.png

这也就意味着,我们引入的第三方库的链接是失败的。
这时候,我们就可以在等号加上-framework "SDWebImage"

OTHER_LDFLAGS = $(inherited) -framework "SDWebImage"

这里跟大家分享一下:问题 2 的解决办法,其实就在pod自己生成的xcconfig里面,如果有兴趣可以先不自定义xcconfig,使用pod引入一个三方库,看看pod自动生成的xcconfig是怎么写的,然后对应的Target里面的设置又有了哪些变化。

Tips:
大家在配置自己的xcconfig文件的时候有几个小技巧跟大家讲一下:

  • 1、在Build Settings里面自定义了URL字段,在xcconfig如何配置//的问题
    如果我们直接在xcconfig文件中写上对应的URL会是被识别为注释符号
    我们可以先定义一个/的变量:
A = /
HOST_URL = ${A}/192.168.1.1

其中${A}$(A) 是等价的。

  • 2、比如说我们现在要配置 OTHER_LDFLAGS,按照上面讲的我们是这样写的:
OTHER_LDFLAGS =  -framework "SDWebImage"

其实我们还可以添加附加条件,比如:指定特定的开发环境机型架构等等,如下:

OTHER_LDFLAGS[config=Debug][sdk=iphonesimulator*][arch=x86_64] =  -framework "SDWebImage"

此时OTHER_LDFLAGS引入SDWebImage只会在Debug模式下,运行模拟器并且对应的执行架构为x86_64的时候,才会执行。

优先级(由高到低):

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

推荐阅读更多精彩内容

  • 由于项目中我们可能存在多个环境的配置 如debug 和release 为了更方便的管理我们需要做多环境配置。那么下...
    猿人阅读 777评论 0 2
  • [toc] 前言 创建一个项目在xcode中有以下三项,在平时开发不是很大型的项目,很少会注意这些问题。 Xcod...
    清风烈酒2157阅读 1,730评论 1 4
  • Xcode多环境配置一共有3种形式: Target Scheme xcconfig Project:包含了项目所有...
    HotPotCat阅读 2,228评论 1 3
  • App多环境配置探索 简介 App开发为什么需要使用多环境呢?原因很简单,就是为了 App 或 App 新功能 在...
    evanxlh阅读 313评论 0 0
  • 在Xcode开发中通常会针对Debug/Release使用不同的服务器地址,最简单的方式那肯定是直接在代码中进行修...
    崔希羽阅读 438评论 0 0