本頁面由 Cloud Translation API 翻譯而成。

元件測試

Fuchsia Test Runner Framework 可讓開發人員為並使用不同語言與執行階段的元件目標裝置。這個架構提供測試執行器元件， fuchsia.test.Suite 通訊協定，並與常見的特定語言整合這些測試架構，例如 GoogleTest (C++)

test_manager 元件負責在 Fuchsia 上執行測試裝置。檢查實作測試套件通訊協定並啟動的元件做為子項元件也就是說，test_manager 也必須負責為每個測試套件提供功能，建立所謂的 測試領域。

這張圖表顯示測試執行器架構如何為
公開測試套件，並讓開發人員工具能執行測試
Fuchsia 裝置上。

ffx test 等開發人員工具會與以下項目的 test_manager 通訊執行測試套件並擷取結果。

測試執行工具

測試執行器是測試執行器架構與常用轉接器開發人員依自己偏好的架構撰寫測試的架構語言。每個測試執行元件元件都會公開 fuchsia.test.Suite 能力可讓 test_manager 列舉並執行個別測試。使用測試架構支援，宣告適當的執行作業 runner。

荒漠油廠

{
    // Execute tests using language-specific runner
    program: { runner: "rust_test_runner" },
    // Expose test suite protocol to test manager
    capabilities: [
        { protocol: "fuchsia.test.Suite" },
    ],
    expose: [
        {
            protocol: "fuchsia.test.Suite",
            from: "self",
        },
    ],
}

C++

{
    // Execute tests using language-specific runner
    program: { runner: "gtest_runner" },
    // Expose test suite protocol to test manager
    capabilities: [
        { protocol: "fuchsia.test.Suite" },
    ],
    expose: [
        {
            protocol: "fuchsia.test.Suite",
            from: "self",
        },
    ],
}

為簡化整合作業，測試執行器架構提供資訊清單資料分割 為每個語言專屬的執行元件。以下是對等的測試執行元件 CML，用於宣告之前範例元件測試中的功能。

荒漠油廠

{
    include: [ "//src/sys/test_runners/rust/default.shard.cml" ]
}

C++

{
    include: [ "//src/sys/test_runners/gtest/default.shard.cml" ]
}

單元測試

單元測試重點會驗證元件中的個別程式碼單元系統中的其他元件不同單元測試應該是密封的，也就是不需要或提供測試以外的功能。

Fuchsia 建構系統提供額外的 GN 目標，以便進行單元測試元件：

fuchsia_unittest_package()：會自動處理的單一元件套件產生最低的元件資訊清單來參照測試二進位檔且不需要額外的功能
fuchsia_unittest_component()：可產生相同的基本元件資訊清單如果您需要建構應用程式將多個單元測試元件放入同一個 fuchsia_package()。

以下是納入單元測試的 BUILD.gn 程式碼片段範例：

import("//build/components.gni")

executable("bin_test") {
  sources = [ "main_test.cc" ]
  deps = [
    "//src/lib/fxl/test:gtest_main",
    "//third_party/googletest:gtest",
  ]
  testonly = true
}

fuchsia_unittest_package("hello-world-unittests") {
  deps = [
    ":bin_test",
  ]
}

只有在測試用的測試元件和其他目標時，才需要將設為 true 的 testonly 屬性。

練習：回音單元測試

在本練習中，您要使用以下程式碼，將單元測試新增至 echo-args 元件中：測試 Runner 架構，並在 FEMU 環境中執行這些測試。

實作單元測試

單元測試可驗證元件的內部功能是否像。對於 echo-args 元件，您將驗證 greeting() 函式會傳回預期值。

新增下列單元測試函式，驗證 greeting() 函式 (如果提供一個、兩個或三個引數時)：

荒漠油廠

echo-args/src/main.rs：

#[cfg(test)]
mod tests {
    #[fuchsia::test]
    async fn test_greet_one() {
        let names = vec![String::from("Alice")];
        let expected = "Alice";
        assert_eq!(super::greeting(&names), expected);
    }

    #[fuchsia::test]
    async fn test_greet_two() {
        let names = vec![String::from("Alice"), String::from("Bob")];
        let expected = "Alice and Bob";
        assert_eq!(super::greeting(&names), expected);
    }

    #[fuchsia::test]
    async fn test_greet_three() {
        let names = vec![String::from("Alice"), String::from("Bob"), String::from("Spot")];
        let expected = "Alice, Bob, Spot";
        assert_eq!(super::greeting(&names), expected);
    }
}

fuchsia::test 屬性會移除 Rust 中的元件測試，例如將每個測試案例初始化記錄。

C++

echo-args/echo_unittest.cc：

#include <gtest/gtest.h>

#include "vendor/fuchsia-codelab/echo-args/echo_component.h"

TEST(EchoTest, TestGreetOne) {
  std::vector<std::string> names = {"Alice"};
  std::string expected = "Alice";
  ASSERT_TRUE(echo::greeting(names) == expected);
}

TEST(EchoTest, TestGreetTwo) {
  std::vector<std::string> names = {"Alice", "Bob"};
  std::string expected = "Alice and Bob";
  ASSERT_TRUE(echo::greeting(names) == expected);
}

TEST(EchoTest, TestGreetThree) {
  std::vector<std::string> names = {"Alice", "Bob", "Spot"};
  std::string expected = "Alice, Bob, Spot";
  ASSERT_TRUE(echo::greeting(names) == expected);
}

更新建構設定

在 BUILD.gn 檔案中新增以下規則，產生新的單元測試套件：

荒漠油廠

echo-args/BUILD.gn：

group("tests") {
  testonly = true
  deps = [ ":echo-args-unittests" ]
}

fuchsia_unittest_package("echo-args-unittests") {
  deps = [ ":bin_test" ]
}

C++

echo-args/BUILD.gn：

group("tests") {
  testonly = true
  deps = [ ":echo-args-unittests" ]
}

executable("unittests") {
  output_name = "echo-args-test"
  testonly = true

  sources = [ "echo_unittest.cc" ]

  deps = [
    ":cpp-lib",
    "//src/lib/fxl/test:gtest_main",
    "//third_party/googletest:gtest",
  ]
}

fuchsia_unittest_package("echo-args-unittests") {
  deps = [ ":unittests" ]
}

這項規則會將單元測試封裝成使用以下網址的元件：

fuchsia-pkg://fuchsia.com/echo-args-unittests#meta/echo-args-unittests.cm

執行單元測試

更新頂層建構目標，同時建構元件套件和測試套件：

荒漠油廠

echo-args/BUILD.gn：

import("//build/components.gni")
import("//build/rust/rustc_binary.gni")


group("echo-args") {
  testonly = true
  deps = [
    ":package",
    ":tests",
  ]
}

C++

echo-args/BUILD.gn：

import("//build/components.gni")


group("echo-args") {
  testonly = true
  deps = [
    ":package",
    ":tests",
  ]
}

再次執行 fx build 以建構測試套件：

fx build

使用 ffx test 指令執行這個套件中的單元測試。確認測試通過：

ffx test run \
    fuchsia-pkg://fuchsia.com/echo-args-unittests#meta/echo-args-unittests.cm

組織元件

偵錯元件