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

與應從物件儲存區複製到測試目錄的檔案名稱相符的 regex 字串清單