2. 简介

Windows 环境部署工具用于在后摩设备的 Windows 系统上，一键完成运行后摩大道软件平台提供的应用开发示例所需的环境配置，包括关键环境变量的设置与必要的环境初始化，帮助用户快速具备样例运行条件。

3. 环境准备

3.1. 环境依赖

该工具支持平台如下：

Windows 11

3.2. 运行环境

工具可在下面环境中运行：

运行时开发工具包：

可使用运行时开发工具包 houmo_tcim_runtime_<target_hw>_${distro}_$arch-<release>.tar.gz。详情参看《后摩大道^® M50 TCIM用户手册》。

3.3. Windows环境准备

执行下面步骤通过运行Windows 环境部署工具，部署示例环境：

安装软件平台驱动。详情参看《后摩大道^® M50 软件平台驱动安装指南》。
烧写和升级后摩设备固件镜像。详情参看《后摩大道^® M50 HmUpdateTool 工具使用指南》。
下载应用开发示例包。该工具位于应用开发示例包 houmo-examples_<release>.zip 中 houmo-examples-xh2\tools\win_envs 目录下。
满足以下 Python 环境要求：
1. 系统中已安装 Python 3.9至3.13版本。
2. Python 已正确配置到系统 PATH 中。可在命令提示符（cmd）中执行以下命令进行验证：
  
  注意
  
  不支持通过 py 启动器选择 Python 版本，请确保运行环境中不依赖 py 命令。
```
python --version
```
  若输出的 Python 版本符合要求，则表示环境配置正确。
3. 当系统中存在多个 Python 解释器时，需将使用的 Python 安装目录调整到系统环境变量 PATH 列表的最前位置。修改完成后，需重新打开命令行窗口，使环境变量配置生效。
  
  Python 命令最终调用的是 PATH 环境变量中排在最前的 Python 可执行文件。如果该解释器版本不符合要求，就会导致工具运行失败或行为异常。
  
  可通过以下命令查看当前系统中可被找到的所有 Python 解释器路径：
```
where python
```
  该命令会按 PATH 环境变量的搜索顺序依次输出 Python 解释器路径。
下载和配置Visual Studio C++生成工具。
1. 下载方式如下：
  - 下载社区版vs2022工具。
  - 下载Visual Studio 2022官方版本。
2. 运行Visual Studio C++生成工具，勾选 使用 C++ 的桌面开发 工作负载，然后完成安装。
配置应用开发示例环境。
1. 打开命令提示符并以管理员身份运行。在命令提示符窗口中，切换到 examples 目录：
```
cd /d {path/of/examples}
```
2. 安装示例运行所需的 Python 依赖：
```
pip install -r tools/win_envs/requirements.txt
```
安装运行时开发工具包。
1. 下载运行时开发工具包：
  1. 登录后摩开发者社区。
  2. 在 请先选择板级类别 下拉列表中选择使用的后摩板级产品。
  3. 在版本列表中选择下载的版本号，再在 AI模型类别筛选器 、平台架构筛选器 、操作系统筛选器 下拉菜单中分别选择AI模型类型、平台架构和操作系统，找到资源名为Runtime SDK的下载资源，选中该资源左边复选框。
  4. 点击 直接下载、wget链接、批量直接下载 或 wget批量下载 按钮。
2. 检查并安装依赖如下：
  - Windows 11
  - Python 3.9至3.13版本
  - Loguru
  - CMake 3.16.3+
  - Visual Studio 2022 version 17.0
  - OpenCV（可选）
3. 设置其他依赖，详情参看运行时开发工具包中 houmo-examples-xh2\tools\win_envs\README.MD。
4. 执行下面指令安装运行时开发工具：
```
pip3 install houmo-tcim-runtime_<target_hw>_${distro}_$arch-<release>.tar.gz
```
5. 安装完成后，执行以下命令，确认运行时开发工具包是否安装成功以及版本是否正确：
```
pip list
```
6. 切换回 examples 目录，继续后续操作：
```
cd /d {path/of/examples}
```
在 houmo-examples-xh2 目录下执行下面命令设置环境变量：

注意

必须使用管理员权限打开命令行提示符窗口。
1. 清除历史环境变量设置：
```
env.bat --reset
```
  指令执行过程中可能需要设置 HOUMO_SDK_PATH、CMAKE_PATH、OPENCV_PATH 等环境变量。
2. 关闭命令行提示符窗口。
3. 使用管理员权限打开命令行提示符窗口，设置环境变量：
```
env.bat --set
```
  用户需要检查reset指令输出的Warning部分的路径是否正确。如果不正确需要自行删除。
4. 关闭命令行提示符窗口。

详情参看 houmo-examples-xh2\tools\win_envs\README.MD。

3.4. 工具获取

该工具位于应用开发示例包 houmo-examples_<release>.zip 中 houmo-examples-xh2/tools/win_envs 目录下。详情参看下载应用开发示例包。