AndroidTestUtilities

添加于版本 3.7。

创建一个自动将指定数据加载到 Android 设备上的测试。

简介

使用此模块可以将测试 Android 设备行为所需的数据推送到连接的 Android 设备上。该模块将接受文件和库，以及各自独立的目标位置。它将创建一个测试，该测试将文件加载到设备对象存储中，并从指定的目标位置链接到它们。仅当文件尚未在对象存储中时，才会上传文件。

例如

include(AndroidTestUtilities)
android_add_test_data(
  example_setup_test
  FILES <files>...
  LIBS <libs>...
  DEVICE_TEST_DIR "/data/local/tests/example"
  DEVICE_OBJECT_STORE "/sdcard/.ExternalData/SHA"
  )

在构建时，将创建一个名为 "example_setup_test" 的测试。在命令行中使用 ctest(1) 运行此测试，以将数据加载到 Android 设备上。

模块函数

android_add_test_data

android_add_test_data(<test-name>
  [FILES <files>...] [FILES_DEST <device-dir>]
  [LIBS <libs>...]   [LIBS_DEST <device-dir>]
  [DEVICE_OBJECT_STORE <device-dir>]
  [DEVICE_TEST_DIR <device-dir>]
  [NO_LINK_REGEX <strings>...]
  )

android_add_test_data 函数用于复制运行项目特定测试所需的文件和库。在主机操作系统上，这是在构建时完成的。对于设备上测试，文件在运行时由生成的测试加载到设备上。

此函数接受以下命名参数

FILES <files>...

零个或多个测试所需的文件

LIBS <libs>...

零个或多个测试所需的库

FILES_DEST <device-dir>

数据文件预计存放的绝对路径

LIBS_DEST <device-dir>

库文件预计存放的绝对路径

DEVICE_OBJECT_STORE <device-dir>

数据在设备上存储位置的绝对路径

DEVICE_TEST_DIR <device-dir>

设备上测试位置根目录的绝对路径

NO_LINK_REGEX <strings>...

与应从对象存储复制到测试目录的文件名匹配的正则表达式字符串列表