环境安装（按使用场景）

本文介绍本项目开发环境的搭建方式，按 4 种实际使用场景组织文档，每个场景一篇自包含的安装指南，所有步骤均写成可直接复制的命令。

选择你的场景

场景	编译环境位置	是否使用 Docker	适用人群	文档
一	Windows PC 内置 WSL	否	只有一台 Windows PC，希望在本地完成编译	场景一
二	Ubuntu 服务器	否	有独立的 Ubuntu 服务器，Windows PC 仅作远程客户端	场景二
三	Windows PC 内置 WSL 再内置 Docker	是	只有一台 Windows PC，希望在本地用 Docker 容器编译	场景三
四	Ubuntu 服务器内置 Docker	是	有独立的 Ubuntu 服务器，希望在服务器上用 Docker 容器编译	场景四

场景一：开发板直接与宿主机（WSL）同网段通信，通过 WSL 内原生 tftpd-hpa 服务下载编译产物。
场景二：编译在 Ubuntu 服务器上完成；开发板与 Windows PC 同网段，可选在 Windows PC 上部署 tftpd64 提供 TFTP 服务、开启 OpenSSH Server 供 Agent 远程烧写（见场景二文档文末章节）。
场景三：开发板与宿主机同网段通信，编译在 Docker 容器内进行。
场景四：编译在 Ubuntu 服务器的 Docker 容器内完成；开发板与 Windows PC 同网段，可选在 Windows PC 上部署 tftpd64 提供 TFTP 服务、开启 OpenSSH Server 供容器内 Agent 远程烧写（见场景四文档文末章节）。

执行位置标注：每个命令块前都会标明执行位置，例如 PowerShell（管理员）、WSL 终端（root）、Ubuntu 服务器终端（root）、容器内，请严格在对应位置执行。
镜像源：APT、Docker、Rust、pip 均使用华为云镜像，避免国内网络访问受限。

拉取工程代码：所有场景的环境搭建完成后，均可执行以下命令拉取 hi_aiot_solution 工程：

repo init -u https://gitcode.com/HiSpark/hi_aiot_solution_manifest.git -b main
repo sync
repo start master --all

编译测试：进入工程目录后执行以下命令编译 framework_media 案例：
```
bash scripts/build.sh --target cv610_ev_board samples framework_media
```