Skip to content

Latest commit

 

History

History
599 lines (495 loc) · 17.5 KB

set_up_femu.md

File metadata and controls

599 lines (495 loc) · 17.5 KB
Raw

启动 Fuchsia 模拟器

本指南提供关于在您的设备上安装和启动 Fuchsia 模拟器（FEMU）的方法说明。

步骤如下：

  1. 前提条件。
  2. 为 FEMU 构建 Fuchsia。
  3. 启用 VM 加速（可选）。
  4. 启动 FEMU。
  5. 发现 FEMU。

1. 前提条件 {#prerequisites}

运行 FEMU 需要您完成以下指南：

2. 为 FEMU 构建 Fuchsia {#build-fuchsia-for-femu}

要运行 FEMU，您首先要构建一个支持模拟器环境的 Fuchsia 系统镜像。本指南使用 qemu-x64 板型和 workstation_eng 产品作为示例。

要构建 FEMU 的 Fuchsia 镜像，请执行以下操作：

  1. 设置 Fuchsia 构建配置：

    fx set workstation_eng.qemu-x64 --release

  1. 构建 Fuchsia：

    fx build

要获取关于支持的板型和产品的更多信息，请参阅 Fuchsia 模拟器（FEMU）概述页面。

3. 启用 VM 加速（可选） {#enable-vm-acceleration}

（仅限Linux）大部分 Linux 设备支持通过 KVM 进行 VM 加速，这大大提高了模拟器的性能和可用性。

如果您的设备可以使用 KVM，请更新您的组权限来启用 KVM。

  • {Linux}

要在您的设备上启用 KVM，请执行以下操作：

注意：您只需要在每台设备上执行一次。

  1. 在您的设备上添加您自己到 kvm 组：

    sudo usermod -a -G kvm ${USER}
  1. 注销与您设备的所有桌面会话，然后重新登录。

  1. 要验证 KVM 配置正确，请运行以下命令：

    if [[ -r /dev/kvm ]] && grep '^flags' /proc/cpuinfo | grep -qE 'vmx|svm'; then echo 'KVM is working'; else echo 'KVM not working'; fi

  验证此命令输出以下行：

  ```none {:.devsite-disable-click-to-copy}
  KVM is working
  ```

  如果您看到 `KVM not working`，那么您可能需要重启您的设备，以使权限修改生效。
  • {macOS}

macOS 无需额外的设置。

在 macOS 上 Fuchsia 模拟器使用的是 Hypervisor 框架{: .external}，而不是 KVM。

4. 启动 FEMU {#start-femu}

启动包服务器

在启动模拟器之前，请启动包服务器。

要启动包服务器，请运行以下命令：

fx serve

注意：或者，您可以将 fx serve 进程置于后台。

启动模拟器

要在您的 Linux 设备启动模拟器，请执行以下操作：

  • {Linux}
  1. 通过运行以下命令配置 upscript：
  注意：如果您的设备使用了防火墙，您可能需要应用一些额外的配置来允许模拟器访问网络。这通常通过运行“upscript”来完成，该脚本为当前进程设置接口和防火墙访问规则。如果您位于企业网络，请联系您的内部网络团队来查看他们是否有现行的 upscript 供您使用。

  如果您没有使用防火墙，那么还需要进行一些配置才能启用 tun/tap 网络。位于 <code>{{ '<var>' }}FUCHSIA_ROOT{{ '</var>' }}/scripts/start-unsecure-internet.sh</code> 的 upscript 示例应该适用于大多数非企业网络。


  ```posix-terminal
  ffx config set emu.upscript {{ '<var>' }}FUCHSIA_ROOT{{ '</var>' }}/scripts/start-unsecure-internet.sh
  ```

  * `start-unsecure-internet.sh` 是一个 upscript 示例。
  * `FUCHSIA_ROOT` 是您 Fuchsia 目录的路径。
  1. 启动 FEMU
  1. 要启动可以访问外部网络的模拟器，请运行以下命令：

      ```posix-terminal
      ffx emu start --net tap
      ```

      * `--net` 指定模拟器的网络模式。`--net tap` 附加到 Tun/Tap 接口。

  1. 要启动不可访问外部网络的模拟器，请运行以下命令：

      ```posix-terminal
      ffx emu start --net none
      ```

启动模拟器会打开一个标题为 **Fuchsia Emulator** 的新窗口，当模拟器完成启动后，您会返回到命令提示符，模拟器会在后台运行。
  • {macOS}

要在 macOS 上启动 FEMU，请执行以下操作：

  1. 启动 FEMU：

    ffx emu start

 如果您在 macOS 上第一次（包括在重启后的第一次）启动 FEMU，则会有窗口弹出，询问您是否要允许 `aemu` 进程在您的设备上运行。请点击 **允许**（Allow）。

 该命令打开一个标题为 **Fuchsia Emulator** 的新窗口。当模拟器启动完成后，您会返回到命令提示符，模拟器会在后台运行。

  1. （可选）如果您需要指定已启动的 Fuchsia 模拟器，您可以在同一终端运行 fx set-device 命令。

    fx set-device {{ '<var>' }}NAME{{ '</var>' }}

 请替换以下内容：

 * `NAME`：请从 `ffx emu list` 或 `ffx target list` 命令的输出中选择希望使用的值。`fuchsia-emulator` 为默认值。

5. 发现 FEMU {#discover-femu}

要将 Fuchsia 模拟器发现为正在运行的 Fuchsia 设备，请运行以下命令：

ffx target list

该命令的输出类似于以下内容：

$ ffx target list
NAME                      SERIAL       TYPE                    STATE      ADDRS/IP                            RCS
fuchsia-emulator    <unknown>    workstation_eng.qemu-x64    Product    [fe80::866a:a5ea:cd9e:69f6%qemu]    N

fuchsia-emulator 是 Fuchsia 模拟器的默认节点名称。

ffx target list 的输出受 --net 选项影响，具体如下：

  • --net none 禁用网络，这导致设备在运行 ffx target list 时无法被发现。
  • --net tap 和 --net user 允许设备在运行 ffx target list 时能被发现。

后续步骤

要了解关于 Fuchsia 设备命令和 Fuchsia 工作流的更多内容，请参阅探索 Fuchsia。

附录

本章节提供额外的 FEMU 选项。

查看所有可用的标记（flag）

要查看模拟器所支持标记的完整列表，请运行以下命令：

ffx emu start --help

在没有 GUI 支持的情况下运行 FEMU

如果您不需要图形界面或者在远程工作流下工作，您可以在无头模式（headless mode）下运行 FEMU：

ffx emu start --headless

指定 FEMU 使用的 GPU

默认情况下，FEMU 启动器尝试检测主机是否有可用于图形渲染的 GPU。如果需要显式设置渲染类型，那么您可以使用带有以下选项的 --gpu 标记：

GPU 仿真方式 说明 标记
硬件（主机 GPU） 直接使用主机设备的 GPU 进行 GPU 处理。 ffx emu start --gpu host
软件（主机 CPU） 使用主机设备的 CPU 来模拟 GPU 处理。 ffx emu start --gpu guest
SwiftShader 使用 SwiftShader 库来模拟 GPU 处理。 ffx emu start --gpu swiftshader_indirect
自动 如果有可用的 GPU 硬件，则解析为 host，如果没有可用的 GPU 硬件，则解析为 swiftshader_indirect。auto 是当前默认值。 ffx emu start --gpu auto

重启 FEMU {#reboot-femu}

要重启 FEMU，请运行以下 ffx 命令：

ffx target reboot

停止 FEMU {#stop-femu}

要停止 FEMU，请运行以下 ffx 命令：

ffx emu stop

配置 IPv6 网络 {#configure-ipv6-network}

本节提供关于在 Linux 设备上使用 TUN/TAP{: .external} 为 FEMU 配置 IPv6 网络的方法说明。

  • {Linux}

注意：这必须在每台设备上完成一次。

要使用 TAP 网络{: .external} 在 FEMU 中启用网络，请执行以下操作：

  1. 设置 tuntap：

    sudo ip tuntap add dev qemu mode tap user $USER

  1. 为 qemu 启用网络：

    sudo ip link set qemu up
  • {macOS}

macOS 不需要额外的 IPv6 网络设置。

用户网络（SLIRP）{: .external}是 macOS 上 FEMU 的默认网络设置——虽然此设置不支持 Fuchsia 设备发现，但您仍然可以使用 fx 工具（例如，fx ssh）与您的 FEMU 实例进行交互。