关于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

2. 区别两个属性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