测试实用程序库

此库实现了帮助程序，用于为 ffx 子工具编写 e2e 测试。

其中包括：

• 用于减少设置样板文件的测试夹具
• ffx 的封闭执行环境（通过 ffx_isolate）
• 低级模拟器生成实用程序（用于刷写和 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。

/!\ 此模拟器出现一个空磁盘 /!\

这是设计所致。如需使用紫红色图片进行 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.