搭配 Android 適用的指令碼處理層使用貿易聯盟

撰寫 Android 專用 SL4A 的指令碼是自動化工具組,可透過與平台無關的方式呼叫 Android API。它支援透過 adb 進行的遠端自動化,以及透過一系列輕量轉譯層在裝置端執行指令碼。

專案位於 platform/external/sl4a

使用

您可以按照 SL4A README 手動建構及安裝。透過 Tradefed 執行時,您可以利用某些 harness 公用程式,讓使用更輕鬆。

下載並安裝

首先,您可以查看 BT-discovery-sl4a.xml,這是使用兩部裝置的交易設定範例。SL4A.apk 可在大多數裝置版本的 tests 資料夾中使用。

上述 Tradefed 範例會自動擷取版本、對兩部裝置進行閃燈作業,並在兩部裝置上安裝 SL4A.apk。您可以執行如下指令碼:

source build/envsetup.sh
lunch
make sl4a
tradefed.sh run google/example/BT-discovery-sl4a

或在建構完成後:

./tradefed.sh run google/example/BT-discovery-sl4a

使用 SL4A 在 Tradefed 中編寫測試

您可以按照上述測試範例操作:Sl4aBluetoothDiscovery.java。這就是在 Tradefed 測試中使用 SL4A 的流程示例。

SL4A API 說明文件

您可以產生可透過 SL4A 使用的回呼完整清單。在 SL4A 來源目錄 platform/external/sl4a/ 中執行下列指令:

python Docs/generate_api_reference_md.py

在「Docs」目錄中,您會看到 ApiReference.md 檔案,其中包含 SL4A 提供的 RPC 函式,以及 RPC 函式的說明文件。