京东多端全流程交易解决方案阿波罗平台iOS单元测试实践

发表于 3年以前  | 总阅读数:2430 次

单元测试

什么是单元测试?

单元测试,是针对一小段代码或方法,检验被测代码一个小的、明确的功能是否正确 ,证明某段代码的行为和开发者期望一致的行为。简单来说,是针对单个程序、函数、过程进行正确性检验的工作的白盒测试。单元测试应该遵循F.I.R.S.T原则:

快速(Fast):测试应该能快速运行。

独立(Independent)测试应该相互独立,不能有依赖。

可重复(Repeatable)测试应当可在任何环境重复通过。包括无网络的环境。

自足验证(Self-Validating)测试应该有布尔值输出。

及时(Timely)测试应及时编写。单元测试应该恰好在使其通过的代码之前编写。

前端是否需要进行单元测试?

一个成熟的软件开发人员非常清楚测试的重要性。当我们需要开发一个新功能、新需求时,我们通过单元测试来验证一段代码中是否运行的正常,传入极端边界值是否会出现问题,单元测试还能使第一次阅读代码的开发人员更好的理解这段代码的含义。

经过良好的的单元测试过的代码总会给开发人员带来勇气。当我们需要重新修改需求、甚至重构代码时,因为有了良好的单元测试,即使你搞砸了,你也会很快通过运行不通过的单元测试发现问题。

所以单元测试,前端和后端都很重要,现在和以后都很重要。

单元测试现在还存在哪些问题?

开发成本增加。TDD原则要求我们在开发代码前先编写单元测试,按照这条规则,我们编写的单元测试将覆盖所有业务代码。测试的代码量足以匹敌需求代码量,编写单元测试所需要花费的时间将和开发需求的时间相同甚至远超开发时间,这无疑增加了开发人员的开发成本。

无法验证单元测试的有效性。基于控制唯一变量的原则,如果要验证单元测试的有效性,我们需要找到两个强大的团队来执行重要的开发任务,并且在规模、结构、工具、技能水平和工作实践——在除测试之外的所有方面的表现都大致相同。然后,还需要在一个比较长的周期内研究他们的生产力和质量差异。无疑还没有团队能够这样去做,所以我们无法使用有效的数据来说明单元测试的有效性,只能凭借以往开发者的经验积累来进行单元测试。

接入单元测试方案,我们要如何选择? 在阿波罗早期调研时,公司内部还没有太多的方案可供选择。所以我们主要是使用手动导入XCodeCoverage和OCMock库再接入Bamboo的方案。

现在iBiu最新版本已经支持了单元测试,内部也是使用XCodeCoverage库来生成覆盖率。

那么就先针对这两个平台对现有的单测支持能力做一个对比:

Bamboo的定时触发

方案选择建议:

  1. 如果你现在已经接入了iBiu,但是现在不是太着急生成视图的单测覆盖率报告,可以先使用Xcode的自带单测覆盖率查看,等iBiu与Bamboo数据打通后直接通过iBiu接入。(两个团队已经在紧急建设中)
  2. 如果部门需要统一在Bamboo中统计单侧覆盖率,那么可以直接使用手动接入Bamboo方式,除了第一次配置略麻烦,后面直接在Bamboo定时运行还是很方便。
  3. 如果你的工程没有接入iBiu,或者还不想接入Bamboo,但是想要生成更加详细的单测覆盖率,可以只接入XCodeCoverage和OCMock,生成本地单测详细报告。

iBiu接入和Bamboo中生成单测覆盖率报告都是使用XCodeCoverage,下文会详细介绍这个库的使用方法。

单元测试覆盖率

无论在iBiu、还是Bamboo,我们关注的有效数据都是单元测试覆盖率。

如何使用Xcode生成覆盖率数据?

无论是哪种方式接入,单测覆盖率最终的数据来源都是通过Xcode生成。

步骤如下:

  1. 在工程中新增单测的Target:

  2. 开启覆盖率需要覆盖的范围,选择你需要测试target,一般是我们的组件源码所在的target;

  3. 修改目标target的Settings

4 . 写好单测代码,运行command+U后,就可以看到生成的单测覆盖率

5 . 点开详细内容,可看到具体哪些代码被覆盖,其中红色代表没有被覆盖,绿色代码已经被覆盖。 Xcode生成的单测覆盖率报告

点击方法后面的箭头会跳转到对应的代码中

当每一次运行单测后,都应该快速的点开浏览所有重要的代码块,查看被覆盖和没被覆盖的部分。往往有些你觉得单元测试已经被覆盖到的部分,其实并没有覆盖到。

一般来说,单测覆盖率不会达到100%。阿波罗前端本次接入单测只考虑业务逻辑的代码部分,UI单测并不在本次的规划当中,所以我们的单测覆盖率对比服务端相对会更低一些。

如何得到更加详细的单测覆盖率报告?

XcodeCoverage提供了一种简单的方法来生成Xcode项目的Objective-C代码覆盖率报告。生成的报告包括HTML和XML。覆盖数据不会包括苹果sdk,并且XcodeCoverage现在还不支持Swift。

  1. 安装XcodeCoverage
  • 如果工程是使用iBiu,那么在Podfile文件平级的文件夹中,新增一个Podfile.custom文件,然后使用iBiu进行安装。

文件内容:

  • 如果工程没有使用iBiu,那就使用CocoaPods正常安装,在Podfile文件中增加pod 'XcodeCoverage',然后pod install。

另外还需要在终端安装两个工具:

gem install xcpretty:

gem install ocunit2junit

xcpretty用于对xcodebuild的输出进行格式化。并包含输出report功能。

ocunit2junit用来将 OCUnit 的输出转换成 JUnit 风格的报告

2 . 配置XcodeCoverage

在你的主工程中加一个Run Script,运行一个脚本文件-

${PODS_ROOT}/XcodeCoverage/exportenv.sh

3 . exportenv.sh脚本打开一下要运行的脚本,文件就在Pod/XcodeCoverage/下

主要作用是新生成了一个env.sh文件,并写入了BUILT_PRODUCTS_DIR、CURRENT_ARCHOBJECT_FILE_DIR_normal、OBJROOT、OBJROOT等参数。

然后我们先command+b或者command+u一下,运行这个脚本去生成env.sh。

4 . env.sh脚本 打开生成的env.sh脚本看一下

env.sh脚本中有几个参数需要我们关注:

  • OBJECT_FILE_DIR_normal,这个值默认生成的是我们主工程的地址,但是现在我们要测试的是包含业务代码的target,所以这个值需要修改为目标target的地址。

我们真正的代码其实在工程中是相当于一个pod,所以这个值需要改成Pod所在的位置/Users/xxxx /Library/Developer/Xcode/DerivedData/xxxCartModule-gtprkfazpqerpsczqxftrlwkzauw/Build/Intermediates.noindex/Pods.build/Debug-iphonesimulator/xxxCartModule.build/Objects-normal。主要修改是标红的两个位置。

  • SRCROOT,可以看到默认生成的值是指向Example文件夹的,也就是我们一般写调用、验证组件的等的测试代码的地方,而我们实际的需要被单测的代码都在classes文件中,所以这个值需要改成:/xxxCartModule/xxxCartModule/Classes。

需要注意,因为env.sh是由于run exportenv脚本每次动态生成,就会导致每次build或者跑单测都会生成一次,都需要改一次上述的两个值。如果觉得比较麻烦可以写一个脚本进行修改。

修改完成后我们cd到Pods/XcodeCoverage文件夹,执行getcov脚本。/getcov -s,运行后,浏览器会自动打开生成的单测覆盖率详细报告。

5 . 覆盖率报告

生成的报告包含总代码行、已覆盖的代码行、代码覆盖率、总方法数、已覆盖的方法数、方法覆盖率,可以点击每一个类查看覆盖的代码和没有覆盖的代码。如果想要将单测报告生成到指定文件夹,可以执行

./getcov -o 你的文件夹

生成的单测报告

文件中的详细代码覆盖情况

6 . 覆盖率报告生成原理 Xcode编译后会为每个可执行文件生成对应的 .gcno 文件;之后在代码中调用覆盖率分发函数,会生成对应的 .gcda 文件。其中,.gcno 包含了代码计数器和源码的映射关系, .gcda 记录了每段代码具体的执行次数。覆盖率解析工具都需要结合这两个文件给出最后的检测报表。

这就是为什么我们需要修改env.sh中的文件路径,因为需要让XcodeCoverage去扫描正确的gcda 文件。

刚刚在终端运行生成单测覆盖率时的输出记录可以验证以上内容。

7 . 可能遇到的报错问题在生成覆盖率报告的日志中,我们还会发现有类似这样的输出:

像我的工程输出这个报错是因为在代码中使用了外部类的一个方法。

一般我们工程中会引用到许多JD内部库,除了上面的运行错误日志外,还会导致无法生成最后的单测报告文件:

解决办法是:需要让XcodeCoverage在扫描文件的时候忽略掉JD库,在Classes下新增一个.xcodecoverageignore文件,文件内容中写要忽略的库就可以了。

${SRCROOT}/报错的库 /*

8 . 关于getcov的其他用法

  • --show or -s: Show HTML report.
  • --xml or -x: Generate Cobertura XML. 生成覆盖率XML
  • -o output\_dir: Specify output directory. 将结果输出到一个文件夹
  • -i info\_file: Specify name of generated lcov info file. 指定生成的lcov信息文件的名称
  • -v: Enable verbose output.
  • -h or --help: Show usage.

当通过以上步骤本地工程可以正常生成覆盖率报告文件时,接入Bamboo就变得非常容易。

开发单元测试

开发测试代码和开发需求代码一样重要。测试必须跟随业务代码的修改而修改,它不是一次性的产物,也需要开发人员进行维护。

哪些代码需要写单元测试?

下面表格列举出一个工程中主要部分和是否需要单元测试,供大家参考:

写单元测试应该在代码开发之前,且应该自下向上进行,从最基础的开始写

如何写一个单元测试?

单元测试开发主要是基于以下三个要素:

Given:配置测试的初始状态,比如造一些数据、mock一些对象等,这里我们可能需要OCMock这个库的辅助。

When:对要测试的目标执行代码,调用你要测试的方法

Then:对测试结果进行断言(成功 or 失败),对于结果做一个预判,并且通过编译来判断你的预判是否正确。

关于单元测试开发规范,我们的建议是:

一个单测类只测一个代码类。一个单测类中只测试这个类的相关方法,不要把所有的单测方法都写在一个测试类中。这样看上去拥挤不堪,既不美观又不好维护。并且注意命名规则,可以是被测试的类名+Test。

一个单测方法只测一个方法的一种情况。我们不要想写一个超长的测试方法,在同一个方法里测试完这个又测试那个,就像下面这种,需要拆分成两个单测方法。当然一个方法中可以针对一种情况写多条断言。 ×不要这样写↑

如何测试代码中的私有方法/私有属性?

如果你需要测试定义在.m中的一个方法或者一个属性。可以在单测的target中,创建一个Category,将私有的方法和属性开放到.h中。并且可以将Category的.m文件删除,它并没有什么用。

单元测试中如何mock数据?

写单元测试的大部分时候我们都需要mock数据举个例子,业务代码如下,单元测试需要验证是否走到了if里:

业务代码

方式1:模拟一份假数据当做入参

方式2:你当然可以不关心假数据是什么,只关注这个方法中的逻辑。那就使用OCMock直接存根一份对象。

具体选择哪种方式可以根据被测试的方法自行判断:如果入参是一个对象,那么选择OCMock;如果入参是一个基础数据,造假数据比较麻烦可以选择OCMock,假数据结构不麻烦的话可以直接mock假数据。

单元测试如何做断言?

需要特别关注断言失败的单测,这可能证明你对你的代码有某些误判。

苹果提供了断言XCTAssert等方法,具体如下:

从以上表格中可以看到苹果提供的基本是对变量的判断。

当我们需要校验的是最后是否跳转到另一个方法时,就需要使用OCMock的OCMVerify方法。

如下图举例: 业务代码

单测代码

最后让我们聊一聊OCMock

OCMock实际是利用runtime原理,通过消息转发方式来实现的。感兴趣的同学可打开源代码看一看。

OCMock提供了下面这些方法:

OCMock在使用上有以下几点需要注意:

  1. OCMock生成的对象是id类型,在使用mock对象的时候,调用属性名和方法名都不会自动带出,所以调用的方法名需要自己写出来。
  2. 在一个指定类上,只能有一个mock对象 *不要这样写↑

3 . 在使用断言方法判断一个方法时,如果方法有入参,可以使用[OCMArg any]当做入参,该方法可以返回一个id类型的参数,这样无需纠结入参的值,需要注意int、float等类型不可以使用。如果在断言方法时代码明明走到了单测依旧报错,可以校验下方法中的传参是否相同。

4 . 使用OCMock时,最好在每次使用完后手动调用stopMocking,养成用完即释放的好习惯

以上就是OCMock经常使用的方法,建议在使用时看看官方文档《OCMock》关于OCMock的实际用法还可以参考《OCMockTests》。

本文由哈喽比特于3年以前收录,如有侵权请联系我们。
文章来源:https://mp.weixin.qq.com/s/i0ABSwl-YhGnuWdbsITo4g

 相关推荐

刘强东夫妇:“移民美国”传言被驳斥

京东创始人刘强东和其妻子章泽天最近成为了互联网舆论关注的焦点。有关他们“移民美国”和在美国购买豪宅的传言在互联网上广泛传播。然而,京东官方通过微博发言人发布的消息澄清了这些传言,称这些言论纯属虚假信息和蓄意捏造。

发布于:1年以前  |  808次阅读  |  详细内容 »

博主曝三大运营商,将集体采购百万台华为Mate60系列

日前,据博主“@超能数码君老周”爆料,国内三大运营商中国移动、中国电信和中国联通预计将集体采购百万台规模的华为Mate60系列手机。

发布于:1年以前  |  770次阅读  |  详细内容 »

ASML CEO警告:出口管制不是可行做法,不要“逼迫中国大陆创新”

据报道,荷兰半导体设备公司ASML正看到美国对华遏制政策的负面影响。阿斯麦(ASML)CEO彼得·温宁克在一档电视节目中分享了他对中国大陆问题以及该公司面临的出口管制和保护主义的看法。彼得曾在多个场合表达了他对出口管制以及中荷经济关系的担忧。

发布于:1年以前  |  756次阅读  |  详细内容 »

抖音中长视频App青桃更名抖音精选,字节再发力对抗B站

今年早些时候,抖音悄然上线了一款名为“青桃”的 App,Slogan 为“看见你的热爱”,根据应用介绍可知,“青桃”是一个属于年轻人的兴趣知识视频平台,由抖音官方出品的中长视频关联版本,整体风格有些类似B站。

发布于:1年以前  |  648次阅读  |  详细内容 »

威马CDO:中国每百户家庭仅17户有车

日前,威马汽车首席数据官梅松林转发了一份“世界各国地区拥车率排行榜”,同时,他发文表示:中国汽车普及率低于非洲国家尼日利亚,每百户家庭仅17户有车。意大利世界排名第一,每十户中九户有车。

发布于:1年以前  |  589次阅读  |  详细内容 »

研究发现维生素 C 等抗氧化剂会刺激癌症生长和转移

近日,一项新的研究发现,维生素 C 和 E 等抗氧化剂会激活一种机制,刺激癌症肿瘤中新血管的生长,帮助它们生长和扩散。

发布于:1年以前  |  449次阅读  |  详细内容 »

苹果据称正引入3D打印技术,用以生产智能手表的钢质底盘

据媒体援引消息人士报道,苹果公司正在测试使用3D打印技术来生产其智能手表的钢质底盘。消息传出后,3D系统一度大涨超10%,不过截至周三收盘,该股涨幅回落至2%以内。

发布于:1年以前  |  446次阅读  |  详细内容 »

千万级抖音网红秀才账号被封禁

9月2日,坐拥千万粉丝的网红主播“秀才”账号被封禁,在社交媒体平台上引发热议。平台相关负责人表示,“秀才”账号违反平台相关规定,已封禁。据知情人士透露,秀才近期被举报存在违法行为,这可能是他被封禁的部分原因。据悉,“秀才”年龄39岁,是安徽省亳州市蒙城县人,抖音网红,粉丝数量超1200万。他曾被称为“中老年...

发布于:1年以前  |  445次阅读  |  详细内容 »

亚马逊股东起诉公司和贝索斯,称其在购买卫星发射服务时忽视了 SpaceX

9月3日消息,亚马逊的一些股东,包括持有该公司股票的一家养老基金,日前对亚马逊、其创始人贝索斯和其董事会提起诉讼,指控他们在为 Project Kuiper 卫星星座项目购买发射服务时“违反了信义义务”。

发布于:1年以前  |  444次阅读  |  详细内容 »

苹果上线AppsbyApple网站,以推广自家应用程序

据消息,为推广自家应用,苹果现推出了一个名为“Apps by Apple”的网站,展示了苹果为旗下产品(如 iPhone、iPad、Apple Watch、Mac 和 Apple TV)开发的各种应用程序。

发布于:1年以前  |  442次阅读  |  详细内容 »

特斯拉美国降价引发投资者不满:“这是短期麻醉剂”

特斯拉本周在美国大幅下调Model S和X售价,引发了该公司一些最坚定支持者的不满。知名特斯拉多头、未来基金(Future Fund)管理合伙人加里·布莱克发帖称,降价是一种“短期麻醉剂”,会让潜在客户等待进一步降价。

发布于:1年以前  |  441次阅读  |  详细内容 »

光刻机巨头阿斯麦:拿到许可,继续对华出口

据外媒9月2日报道,荷兰半导体设备制造商阿斯麦称,尽管荷兰政府颁布的半导体设备出口管制新规9月正式生效,但该公司已获得在2023年底以前向中国运送受限制芯片制造机器的许可。

发布于:1年以前  |  437次阅读  |  详细内容 »

马斯克与库克首次隔空合作:为苹果提供卫星服务

近日,根据美国证券交易委员会的文件显示,苹果卫星服务提供商 Globalstar 近期向马斯克旗下的 SpaceX 支付 6400 万美元(约 4.65 亿元人民币)。用于在 2023-2025 年期间,发射卫星,进一步扩展苹果 iPhone 系列的 SOS 卫星服务。

发布于:1年以前  |  430次阅读  |  详细内容 »

𝕏(推特)调整隐私政策,可拿用户发布的信息训练 AI 模型

据报道,马斯克旗下社交平台𝕏(推特)日前调整了隐私政策,允许 𝕏 使用用户发布的信息来训练其人工智能(AI)模型。新的隐私政策将于 9 月 29 日生效。新政策规定,𝕏可能会使用所收集到的平台信息和公开可用的信息,来帮助训练 𝕏 的机器学习或人工智能模型。

发布于:1年以前  |  428次阅读  |  详细内容 »

荣耀CEO谈华为手机回归:替老同事们高兴,对行业也是好事

9月2日,荣耀CEO赵明在采访中谈及华为手机回归时表示,替老同事们高兴,觉得手机行业,由于华为的回归,让竞争充满了更多的可能性和更多的魅力,对行业来说也是件好事。

发布于:1年以前  |  423次阅读  |  详细内容 »

AI操控无人机能力超越人类冠军

《自然》30日发表的一篇论文报道了一个名为Swift的人工智能(AI)系统,该系统驾驶无人机的能力可在真实世界中一对一冠军赛里战胜人类对手。

发布于:1年以前  |  423次阅读  |  详细内容 »

AI生成的蘑菇科普书存在可致命错误

近日,非营利组织纽约真菌学会(NYMS)发出警告,表示亚马逊为代表的电商平台上,充斥着各种AI生成的蘑菇觅食科普书籍,其中存在诸多错误。

发布于:1年以前  |  420次阅读  |  详细内容 »

社交媒体平台𝕏计划收集用户生物识别数据与工作教育经历

社交媒体平台𝕏(原推特)新隐私政策提到:“在您同意的情况下,我们可能出于安全、安保和身份识别目的收集和使用您的生物识别信息。”

发布于:1年以前  |  411次阅读  |  详细内容 »

国产扫地机器人热销欧洲,国产割草机器人抢占欧洲草坪

2023年德国柏林消费电子展上,各大企业都带来了最新的理念和产品,而高端化、本土化的中国产品正在不断吸引欧洲等国际市场的目光。

发布于:1年以前  |  406次阅读  |  详细内容 »

罗永浩吐槽iPhone15和14不会有区别,除了序列号变了

罗永浩日前在直播中吐槽苹果即将推出的 iPhone 新品,具体内容为:“以我对我‘子公司’的了解,我认为 iPhone 15 跟 iPhone 14 不会有什么区别的,除了序(列)号变了,这个‘不要脸’的东西,这个‘臭厨子’。

发布于:1年以前  |  398次阅读  |  详细内容 »
 相关文章
快速配置 Sign In with Apple 5年以前  |  7734次阅读
使用 GPUImage 实现一个简单相机 5年以前  |  6021次阅读
APP适配iOS11 5年以前  |  5789次阅读
 目录