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>...

與應該從物件儲存區複製到測試目錄的檔案名稱相符的正規表示式字串列表