測試公用程式庫

這個程式庫會實作輔助程式，以便為 ffx 子工具編寫 e2e 測試。

本指南涵蓋的內容：

• 使用測試韌體來減少設定樣板
• ffx 的密封執行環境 (透過 ffx_isolate)
• 低階模擬器產生公用程式 (用於 Flash 和 OTA 測試)

預計包括：

• ffx 指令輸出的比對器 (b/293217132)
• 透過合併 ffx_e2e_emu 整合 ffx emu (b/295230484)

用量

Subtool e2e 測試通常位於 src/developer/ffx/tests。這與 ffx self-test，但使用 rustc_test 執行測試，而非子工具。

在 BUILD.gn 中：

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

if (is_host) {
  rustc_test("ffx_<something>_test") {
    testonly = true
    edition = "2021"
    source_root = "src/tests.rs"

    sources = [ "src/tests.rs" ]

    deps = [
      "//src/developer/ffx/testing:ffx_testing",
      "//src/lib/fuchsia",
      "//src/lib/testing/fixture",
    ]

    # If using ffx_testing::Emu: Only one emulator can be spawned at a time.
    # These lower level emulators use TAP networking, which is required for IPv6
    # support.
    # args = [ "--test-threads=1" ]
  }
}

在 src/tests.rs 中：

use ffx_testing::{base_fixture, TestContext};
use fixture::fixture;

// base_fixture sets up the test environment this test
#[fixture(base_fixture)]
#[fuchsia::test]
async fn my_test(ctx: TestContext) {
  let _daemon = ctx.isolate().start_daemon().await.unwrap();

  let output = ctx.isolate().ffx(&["daemon", "echo"]).await.expect("daemon echo");
  assert!(output.status.success());
}

低階模擬器

低階模擬器可以使用 Emu::start。可以控制 經由 ffx 連線後如需使用模擬器的測試，請參閱 ffx_target_test。

/!\ 此模擬器提供空白磁碟 /!\

這是設計所致。如要測試含有 Fuchsia 映像檔的 e2e 測試，請使用 ffx_e2e_emu 程式庫為 //src/developer/ffx/lib/e2e_emu。

use ffx_testing::Emu;

let emu = Emu::start(&ctx);

// NOTE: If using serial, make sure to drain or close the serial stream when no longer in use.
// Failure to do so will result in QEMU halting.
{
  let serial = emu.serial().await;

  // ...
}

// Dropping or letting the emu go out of scope cleans up the emulator.