JAR 主機測試

您應實作 Java 封存檔 (JAR) 主機測試,以便提供軟體的完整程式碼涵蓋率。請按照操作說明建構本機單元測試。編寫小型單元測試,驗證特定函式,僅此而已。

範例

以下 Blueprint 檔案提供簡單的 Hello World JAR 主機測試範例,可根據您的需求複製及調整:platform_testing/tests/example/jarhosttest/Android.bp

這會對應至實際的測試程式碼,位於以下位置: platform_testing/tests/example/jarhosttest/test/android/test/example/helloworld/HelloWorldTest.java

為方便您參考,我們已將藍圖檔案的快照畫面附在本文中:

java_test_host {
    name: "HelloWorldHostTest",

    test_suites: ["general-tests"],

    srcs: ["test/**/*.java"],

    static_libs: [
        "junit",
        "mockito",
    ],
}

開頭的 java_test_host 宣告表示這是 JAR 主機測試。請參閱以下範例:frameworks/base/tools/powermodel/Android.bp

設定

請參閱下文,瞭解下列設定的說明:

  • 指定 java_test_host 模組類型 (在區塊開始) 時,必須提供 name 設定。這項設定會為模組命名,產生的 JAR 會具有相同的名稱和 .jar 後置字串。在以下範例中,產生的測試 JAR 檔案名稱為 HelloWorldHostTest.jar。此外,這項設定也會為模組定義 Make 目標名稱,方便您使用 make [options] <HelloWorldHostTest> 建構測試模組及其所有依附元件。

    name: "HelloWorldHostTest",
    
  • test_suites 設定可讓貿易聯盟測試控管工具輕鬆找到測試。您可以在此新增其他測試套件,例如 CTS,以便共用 JAR 主機測試。

    test_suites: ["general-tests"],
    
  • static_libs 設定會指示建構系統將命名模組的內容納入目前模組的產生 APK。這表示每個命名模組都應產生 .jar 檔案。模組的內容會用於在編譯期間解析 classpath 參照,並納入產生的 APK。

    static_libs: [
        "junit",
    ],