Evinced SDK for iOS applications
弃用通知
Evinced UIKit SDK 已弃用，并将很快被移除。请参阅我们全新的移动无障碍工具这里。
概述
Evinced iOS 解决方案包括两个部分
iOS SDK
这是一个简单的开源 SDK，可以从应用中提取相关 UI 信息并将其安全地发送到桌面客户端进行分析。您需要使用您应用的开发版本构建此 SDK。
桌面应用程序
该应用程序从SDK接收原始数据，分析应用程序的可达性合规性，检测问题并建议解决方案。
导入Evinced iOS SDK
先决条件
- 当前版本支持以下内容：
- 适用于iOS 12.0及以上版本的部署目标
- 使用Cocoapods作为导入机制 - 将支持其他框架。
- 基于Native UIKit的iOS应用程序 - 将很快支持基于Native swift UI、React native和混合应用程序。
如何集成
1 - 为使用Evinced运行应用程序设置单独的构建目标。2 - 安装Evinced pod。3 - 在您的应用程序中添加调用Evinced SDK的代码。4 - 选择测试目标并构建应用程序。
步骤 1
为使用Evinced运行您的应用程序设置单独的构建目标。
- 在不同的名称下克隆现有的应用程序目标（为了避免冲突，请不要使用“Evinced”作为目标名称）。
继续
在“构建设置”的“其他 Swift 标志”中添加 -D EVINCEDTEST 以标记测试目标。对于 Objective C 应用，在“预处理器宏”中使用 EVINCEDTEST=1。
可选
如果你想在桌面应用中使用 QR 码配对，并且你的测试应用不使用摄像头，则执行此步骤。
确保你的测试目标使用不同的 Info.plist 文件。通过 Xcode 或直接编辑 Info.plist 源代码，将“Privacy - Camera Usage Description”键添加到测试目标的 Info.plist 文件中，如下添加到 <dict> … </dict> 块中：
<key>NSCameraUsageDescription</key>
<string>Allow pairing via QR code</string>
步骤 2
安装 Evinced pod。
- 在你的 Podfile 的目标名称下添加以下内容
pod 'EvincedSDKiOS'你的 Podfile 应该看起来像这样
use_frameworks!
platform :ios, '13.0'
target '<your target name>' do
pod 'EvincedSDKiOS'
end- 在项目目录中运行
pod install；
步骤 3
在应用中添加代码以调用 Evinced SDK。
- 在
AppDelegate.swift中添加以下导入语句。注意 - 即使你的应用程序使用 SceneDelegate UIKit 生命周期，你也应该继续使用 AppDelegate 类以启动 Evinced。
#if EVINCEDTEST
import EvincedSDKiOS
#endif- 对于 Objective C，将以下内容添加到
AppDelegate.m
#ifdef EVINCEDTEST
@import EvincedSDKiOS;
#endif- 启动 Evinced 引擎
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
// Other code if needed...
#if EVINCEDTEST
EvincedEngine.start()
#endif
return true
}- 对于 Objective-C 代码，格式如下
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// Other code if needed...
#ifdef EVINCEDTEST
[EvincedEngine start];
#endif
return YES;
}步骤 4
- 在项目目录中运行
pod init。 - 选择测试目标并构建应用程序（确保该目标可以构建 iOS 12 及以上版本）。
- 使用摇动手势打开 Evinced SDK 屏幕。