郭斯基扫描器 4.0.2

GSCXScanner 4.0.2

Cooper KnaakSid J 维护。



  • 作者:
  • j-sid

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

安装步骤概述(手动)

  1. 下载 GSCXScanner
  2. 下载 GTXiLib
  3. GSCXScanner.framework 添加到您的应用
  4. 启动您的应用以扫描其UI。

1. 下载 GSCXScanner 仓库

下载 GSCXScanner 仓库并解压缩。

2. 下载 GTXiLib 仓库

下载 GTXiLib,解压缩并将其放在与 GSCXScanner 相同的父目录中。例如,目录结构可能如下所示

foo_root_dir/
    GSCXScanner/
    GTXiLib/
    ...

3. 将 GSCXScanner.framework 添加到您的应用程序中

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 产品。