Google Scanner for A11y 是什么?
Google Scanner for A11y,简称 GSCX,是一个开发者助手。作为一个 Objective-C 库,它位于 iOS 应用的进程中,扫描检测到的问题,以便在开发者甚至编写测试之前捕捉它们。扫描器内置了对检测无障碍问题的检查,并支持扩展的插件框架,以添加您自己的检查。
开始使用
要将扫描器安装到您的应用中,创建您应用的复制并添加 GSCXScanner
库作为依赖项。
启动这个新的应用目标,您将注意到应用的顶部有一个“执行扫描”按钮。点击它并扫描器将扫描您的应用并报告是否有问题发现。
警告 您必须不要直接将此依赖项添加到应用目标中,而只将其添加到其复制中,以确保您的应用不会安装带有无障碍扫描器的应用到生产环境中。
还需要一个额外的步骤,即将 GTXiLib
提供给扫描器框架进行链接。如果您以前已将静态框架添加到您的应用中,此过程将非常熟悉。
安装步骤概述(Cocoapods)
您可以使用 GSCXScanner
pod 向您的应用程序添加无障碍扫描程序。例如
target 'FooBarTarget' do
use_frameworks!
# Pods for FooBarTarget
# ...
pod 'GSCXScanner'
end
安装步骤概述(手动)
- 下载
GSCXScanner
- 下载
GTXiLib
- 将
GSCXScanner.framework
添加到您的应用 - 启动您的应用以扫描其UI。
GSCXScanner
仓库
1. 下载 下载 GSCXScanner
仓库并解压缩。
GTXiLib
仓库
2. 下载 下载 GTXiLib
,解压缩并将其放在与 GSCXScanner 相同的父目录中。例如,目录结构可能如下所示
foo_root_dir/
GSCXScanner/
GTXiLib/
...
GSCXScanner.framework
添加到您的应用程序中
3. 将 将 GSCXScanner.xcodeproj
作为依赖项添加到您的应用程序中:打开您应用程序的 Xcode 项目,将 GSCXScanner
Xcode 项目文件拖放到项目导航器中,或者选择 文件 > 添加文件
并选择 GSCXScanner.xcodeproj
。始终选择“添加文件夹引用”以防止 Xcode 复制项目。
在您的应用程序的 构建阶段
下,在 目标依赖项
和 链接库
下都添加 GSCXScanner.framework
。
请注意,GSCXScanner
依赖于 GTXiLib
,而 GTXiLib
依赖于 Protobuf。如果您手动将 GSCXScanner.xcodeproj
添加到项目中,请按照 Protobuf-C++ 中的步骤构建和安装 proto 库。不要忘记将正确的标志添加到您的 Xcode 项目设置中。如果您使用 Cocoapods 构建,则此步骤是不必要的。GTXiLib CocoaPod 为您包含了 Protobuf-C++
。
4. 启动您的应用程序以扫描其 UI
启动您的应用程序,GSCXScanner UI 将叠加在应用程序的 UI 上。正常使用应用程序,并在您想要扫描应用程序 UI 以检查无障碍问题的地方,只需按下屏幕左下角的 扫描
按钮。
插件
扫描器是可扩展的,要自定义扫描器,请使用 GSCXScannerLib
替代默认的扫描器框架,以避免在您的应用程序上自动安装它,然后使用 GSCXInstaller
类中的 API 进行自定义。
讨论
请加入我们的ios-accessibility Google 群组,一起讨论无障碍适配方面的问题,并关注 Scanner 的所有更新。
注意:这不是一个官方的 Google 产品。