关于iOS自动化测试方案(Appium + Cucumber)及其环境搭建 - (3)配置页面标签元素

简介

  通过前面的两个章节的介绍,相信你已经了解了移动端的UI自动化测试,并且已经搭建好了相关的环境。在这里我想再讲一点的是,我的案例是搭建的Ruby环境,但其实只要你搭建好了Appium你可以用使用官方支持的任一语言进行脚本编写,甚至可以不用Cucumber也能够通过指定app文件的路径去进行自动化测试。我个人是推荐于用Cucumber的方式,除了可以用自然语言编写测试场景,Cucumber对jenkins的集成会更好。
  先思考一个问题,测试的App怎么通过你写的测试脚本去自动的点击页面上的哪个位置,哪个控件呢,你的脚本如何获取到你想要点击的控件呢?答案是,我们自己去给我们的App的页面元素添加标签。接下来我会描述下iOS端怎么对App添加元素标签。

对比安卓:
iOS 不像 Android 那样可以在 xml 文件中自动生成唯一的 id 作为标签,需要我们手动为控件添加可访问性(Accessibility)。
首先得知道的是,生成的标签需要符合的必要条件:

  1. 页面内唯一:页面内不同视图标签不重复。
  2. 运行时恒定:每次运行应用中此页面时视图的标签始终恒定,无需修改测试脚本。

为了满足标签的必要条件,可以选择其在某个类中的属性名称作为标签,因为同一个类中是不可能有两个相同名称的属性的,并且属性名称都是固定在代码里的,也就是恒定不变的。在此总结下标签的策略流程:

  1. 如果变量是某个类的属性,则可满足标签条件。因为代码没有改动,则标签也不会变化。即使代码有变动,也肯定是因为业务逻辑变更导致了界面上的变化,那么测试脚本肯定也是要改的,所以无需多虑此种情况。
  2. 如果是临时创建的局部变量,同一页面中很有可能有相同名字的局部变量。而且 Objective-C Runtime 无法获取局部变量名称,所以针对此种情况尽量采用其他来源的内容作为标签。
  3. 获取代码中局部变量的变量名,并与其对象绑定起来。(绑定是指将标签赋给accessibilityIdentifier 之类的属性)

请仔细的思考上述3条结论,详细的阐述和实现原理请参考下面的参考链接:
为 UIAutomation 添加自动化测试标签的探索

内容

  接下去的描述我默认你的工程集成了TBUIAutoTest。对于这个第三方添加标签的方式我基本是比较认同的,但是在使用上面有几个地方需要我们注意。
1.自定义代码添加
  标准的UIKit controls和views都是自动无障碍的,所以只需要确保它们默认提供的无障碍信息是否准确。如果写了一个自定义的view为用户提供信息,或者一个可以自定义的可以交互的控件,那么你就需要自己实现它的无障碍配置。这就是我们常见的情况了,这种情况又可以分为以下两种:

  • an individual view:这个view里面不包含任何子元素

  • a container view:这个view里面包含其他子元素,并且这些子元素都需要做无障碍配置

    1.1 当你为你的控制器添加的自定义view的时候,默认是无法获取该view的元素标签,需要手动给该view的isAccessibilityElement属性赋值为Yes。

    // 这个view为某个自定义视图的实例
    // 方式一:直接给属性赋值
    view.isAccessibilityElement = YES
    // 方式二:实现UIAccessibilityProtocol协议中的方法
    - (BOOL)isAccessibilityElement {
        return YES;
    }
    

    1.2 还有就是当你有一个视图容器,里面包含了很多的其他元素,而这些元素提供了某些信息或者可以进行交互,也就是说这些子元素需要配置成accessible,而你的视图容器不需要配置成accessible。在此种情况下,你的视图容器就需要实现UIAccessibilityContainer协议,该协议中的方法会将这些需要配置成accessible的子元素放在一个数组中。最简单的一种实现如下:

#pragma mark - UIAccessibilityContainer

#ifdef AUTO_TEST_ENV
-(BOOL)isAccessibilityElement
{
    return NO;
}

- (NSInteger)accessibilityElementCount
{
    return [[self subviews] count];
}

- (id)accessibilityElementAtIndex:(NSInteger)index
{
    return [[self subviews] objectAtIndex:index];
}

- (NSInteger)indexOfAccessibilityElement:(id)element
{
    return [[self subviews] indexOfObject:element];
}
#endif

2.扩展

  1. 这里的AUTO_TEST_ENV可以通过preprocessor macros或者pch进行设置

preprocessor macros设置:选中TargetTest,点击Build Settings选择Preprocessor Macros给TargetTest增加一个对应的宏TARGETTEST

  1. 区别两个属性accessibilityLabel和accessibilityIdentifier。
    你想要真的区分这两个属性,你应该了解什么是Accessibility:
    在Apple的定义中,我们可以理解为:无障碍使用。所谓“无障碍使用”,是对于“有障碍人士来说”,比方说让一位有眼疾的用户可以“无障碍”使用iPhone上的APP。
    iOS的设备天生就具备这一特性,打开“设置 -> 通用 -> 辅助功能”,就可以看见Apple提供的一系列的Accessibility功能,这里可以说几个比较常见的:
    • VoiceOver:VoiceOver是苹果创新的屏幕阅读技术,用户通过触摸屏幕,随后APP返回语
    • 音信息,从而引导用户操作
    • 缩放(Zoom):顾名思义,缩放屏幕上的元素
    • 显示调节——反转颜色(White on Black):反转显示屏上的颜色

在UI自动化测试这个地方我们用到了VoiceOver,也就是旁白技术。辅助功能找到旁白然后点击打开即可。你去感受后再通过代码的设置我相信你会对这两个属性有一个更加深刻的认识。

Apple为实现VoiceOver,为iOS设计出了一套API,通过它,开发者们就可以让自己的APP实现VoiceOver的功能。这一套API主要包括以下几个部分:

  1. UIAccessibility(Informal Protocol):实现UIAccessibility协议的对象报告其可访问性状态(即是否可访问),并提供有关其自身的描述性信息。 默认情况下,标准的UIKit控件和视图实现了UIAccessibility协议。
  2. UIAccessibilityContainer(Informal Protocol):该协议一般用于UIView的子类,可以让它所包含的一些子UI作为单独的元素被访问到。当一个视图所包含的子对象并不是UIView的子类,而又需要被访问到的时候,这个协议就非常有用。
  3. UIAccessibilityElement(Class):这个类默认实现了UIAccessibility协议,可以为一个不能被自动访问到的对象(例如非UIView的子类)创建一个该类的实例,从而让它可以被访问到。

UIAccessibility是iOS的Accessibility最核心的一套API,它实际上是一个非正式协议,里面提供了一系列的方法来提供UI的辅助信息。举个例子,在开启了VoiceOver的情况下,在用户触摸到某个UI的时候,APP就会将这些方法提供的关于此UI的辅助信息转化成语音念出来。
这里有必要说一下什么是非正式协议:

非正式协议实际上是基于NSObject的一个分类,它的子类们都隐式地遵守了该协议。在非正式协议中声明的方法,可以选择实现与否。这就很清楚了,在还没有引入“optional protocol methods”之前,非正式协议就是一种替代方案。

下面再贴出UIAccessibility API中的常用属性:

  1. cessibilityLabel:一个简短的本地化的词或短语,简洁地描述了控件或视图,但不能识别元素的类型。 例如“添加”或“播放”
  2. accessibilityHint:一个简短的本地化短语,用于描述作用于元素上的操作所得到的结果。 例如“添加标题”或“查看购物车”
  3. accessibilityTraits:一个或多个单独特征的组合,每个特征描述元素的某一个方面,包括状态、行为或用法。这些都定义成了UIAccessibilityTrait的某一个常量。
  4. accessibilityFrame:屏幕中某元素的坐标和大小
  5. accessibilityValue:某UI元素的当前值,并且这个值无法由label表示出来。例如,某个slider的标签可能是“速度”,但其当前值可能为“50%”

相信到这个地方应该对两个属性accessibilityLabel和accessibilityIdentifier有了清楚的认识。

accessibilityLabel: 设置后当你打开VoiceOver功能,点击控件就会读出你设置的值,accessibilityIdentifier: 为你的控件添加唯一id,UI自动化测试可以使用该属性获取元素

结论:
对于iOS配置页面元素,我们采用集成TBUIAutoTest,但是对于那种绘制上去的 UI,但非使用原生 UI 控件的场景,就需要自己创建 UIAccessibilityElement 对象,并手动设置标签。

参考链接:
iOS 自动化测试标签生成工具接入指南
带你认识——iOS Accessibility

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

推荐阅读更多精彩内容

  • Swift1> Swift和OC的区别1.1> Swift没有地址/指针的概念1.2> 泛型1.3> 类型严谨 对...
    cosWriter阅读 11,036评论 1 32
  • 介绍 1.开启voiceOver 设置->通用->辅助功能->VoiceOver 在voiceOver模式中 a....
    linatan阅读 5,942评论 0 8
  • 官方文档链接:https://developer.android.google.cn/training/testi...
    lanceJin阅读 951评论 0 0
  • 日更第十一天,说实话每天“绞尽脑汁”。今天想起朱伟那句话“少一点功利主义的追求,多一点不为什么的坚持”每天的重复似...
    门前门前一棵葡萄树阅读 352评论 0 2
  • 星期六 天气晴 心情多云 早上大概八点醒的 但是不想起床 今天就要开始考计算机二级了 舍友们都起床了 我不好意思再...
    高同学说阅读 85评论 0 1