前言:
最近在研究swift发现很久没有更新文章了,看着时差那么久没有更新有点急躁了,但又不知道要分享内容好一点又实用的文章,最近写项目上线的次数比较频繁,上线时对于Xcode的配置也是诸多操作,问题是,一些web服务的url指向了测试服务器,同时API密钥被配置用于测试环境。在提交app给苹果审核前,你需要修改所有这些API密钥和URL以适应生产版本,相较于在开发环境和生产环境之间来回修改相关数值,对于这种繁琐的操作和弊端想着要优化了,所以这两天就去研究了一下Targets管理项目。
对于iOS开发的老鸟来说这已经不是事儿了,但对于初学者来说很多人就会觉得奇怪,为什么需要使用两个单独的数据库和环境。原因是当你继续构建新的功能特性或继续开发你的应用,你希望区分开现有的公开版本和生产版本和预发布版本。
区分版本的方法一:
因为公司的开发团队的严谨把数据库的接口区分为公开环境、预发布环境、测试环境,那么就必须把项目使用三个独立的环境区分开来。我之前使用的一个办法就是定义一个全局的变量,它会将应用程序初始化为公开版本、测试版本、预发布版本。
Objective-C:
在PCH文件中定义成宏(这里就不教大家怎么新建配置PCH了)
要哪个环境就打开注释,关闭另外两个注释
#define LocalEnvironment //测试环境
//#define ReleaseEnvironment //预发布环境
//#define OfficialEnvironment //公开环境
#ifdef LocalEnvironment
#define APIURL @"http://www.test.myapi.net" //APIURL 为后台接口
#endif
#ifdef ReleaseEnvironment
#define APIURL @"http://www.release.myapi.net"
#endif
#ifdef OfficialEnvironment
#define APIURL @"http://www.myapi.net"
#endif
Swift3.0后:
新建一个 Swift File 文件,定义成全局常量
enum environmentType {
case local, release, official //测试环境,预发布环境,公开环境
}
//给测试人员的时候切换他们想要的环境,上线的时候切换official环境
let environment: environmentType = .official
let APIURL: String = "" //APIURL 为后台接口
switch environment {
case .local:
APIURL = "http://www.test.myapi.net"
case .release:
APIURL = "http://www.release.myapi.net"
case .official:
APIURL = "http://www.myapi.net"
}
弊端:这种方法需要你每次切换环境时改变全局变量。虽然这种方法也许快捷,方便,但是它有一些重要的限制。首先,因为我们在开发和生产两个环境中使用一个Bundle ID,你不能在一台设备上安装应用的两个版本。当你需要要测试开发版本的应用程序时,同时仍在该设备上使用生产版本的应用,这就变的不方便了。此外,这种方法很有可能将应用的开发版本上传到应用商店。如果你忘记了改变这个全局变量,你将会上传错误的应用给你的用户。
区分版本的方法二:
创建新的Target,我将使用一个事例项目引导学者们一步步探讨整个过程(通用Objective-C、Swift)
1.首先新建一个项目取名Happy,可以看到只有一个TARGETS,我们把这个target作为公开版本。
2.配置测试版本和预发布版本。
3.选择 Duplicate Only,需要新建两个因为需要再新建两个版本
4.现在打开你开发target的“Build Settings”,滚动到“Packaging”,并将值改为开发的plist文件。注意:这三个targets对应的代码相同,但Plist和设置是不同的
5.可选操作:但强烈推荐。如果你想简单地区分公开版本和预发布版本构建,你应该为每个版本使用单独的icon和启动页。这将使测试人员更清晰地知道正在使用哪个app,防止上传开发版本。
跳到 `Assets.xcassets` 添加一个新的图标。右击图标 > App Icons & Launch Images > New iOS App Icon. 新图标重命名为“AppIcon-Release”同时添加自己的图片。
现在回到项目设置,选择您的开发target,并改变Bundle Identifier。你可以简单地将“Release”追加到原来的ID上。如果执行了上一步骤,请确保更改应用app icon,设置为在上一步中创建的。(PS:改变Bundle Identifier的话需要重新去官网弄好区分这个Bundle Identifier的测试证书)
6.最后,我们会为生产和开发target配置预处理宏/编译器标识。之后我们就可以使用该标识在我们的代码来检测应用程序正在运行的版本。
Objective-C
去到`Build Settings`下`Apple LLVM 7.0 - Preprocessing`。拓展`Preprocessor Macros`在Rebug和Release区域添加一个变量。对于公开版本target(即Happy),将该值设置为`DEVELOPMENT=2`。对于预发布版本target(即Happy Release),将该值设置为`DEVELOPMENT=1`。对于测试版本target(即Happy Test),将该值设置为`DEVELOPMENT=0`。
Swift
编译器不再支持预处理指令。作为替代,它使用编译时的属性和build配置。选中开发target,添加一个标识表示开发版本。找到`Build Setting`往下滚动到`Swift Compiler - Custom Flags`部分。将值设为`-DTEST`表示这个target作为测试版本。将值设为`-DRELEASE`表示这个target作为预发布版本。将值设为`-DOFFICIAL`表示这个target作为公开版本。
使用Target和宏
根据已配置的宏DEV_VERSION,我们可以在代码中利用它动态地编译项目。下面是一个简单的例子:
Objective-C: 在PCH文件中
#if DEVELOPMENT==0
#define LocalEnvironment //测试
#elif DEVELOPMENT==1
#define ReleaseEnvironment //预发布
#elif DEVELOPMENT==2
#define OfficialEnvironment //公开
#endif
#ifdef LocalEnvironment
#define APIURL @"http://www.test.myapi.net" //APIURL 为后台接口
#endif
#ifdef ReleaseEnvironment
#define APIURL @"http://www.release.myapi.net"
#endif
#ifdef OfficialEnvironment
#define APIURL @"http://www.myapi.net"
#endif
Objective-C中你可以使用`#if`检查`DEVELOPMENT`的环境,并相应的设置URLs/ API密钥。
Swift: 在新建的Swift File文件中,声明成全局常量
#if TEST //测试
let SERVER_URL = "http://www.test.myapi.net"
#elseif RELEASE //预发布
let SERVER_URL = "http://www.release.myapi.net"
#else //公开
let SERVER_URL = "http://www.myapi.net"
#endif
像这样
Swift中你仍然可以使用`#if`判定build的参数动态编译。然而,除了使用`#define`定义基本常量,在swift中我们也可以用`let`定义一个全局常量。
验证:
最后,管理多个target的一些注意事项:
1.当你添加新的文件到项目中,不要忘记选择两个target,以保持你的代码同步在这三个版本。
2.如果你使用的CocoaPods,不要忘了添加新的target到你的Podfile中。
Build setting搜索user header search paths添加 ${SRCROOT}(表示当前目录) 防止Import的时候出现错误
多Target控制项目的版本操作已经完成,喜欢的朋友动动手指喜欢一下,发现有错误希望能和大家沟通提点一下,谢谢大家继续支持。