ModelBox端云协同AI开发套件（Windows）SDK安装篇

本文将介绍ModelBox SDK的安装方法，开发者首先需要参考 此教程 完成设备的注册。

1. 安装Git for Windows

ModelBox中有些脚本的执行依赖bash，使用Git bash也可以让开发者在Windows上获得与Linux相同的执行环境，因此需要安装Git for Windows。

注意在安装过程中，要勾选 sh 文件的默认应用为 Git for Windows（默认是选中的）：

操作完成后打开Git bash，可以使用Linux命令执行某些操作：

2. 下载ModelBox sdk

1）在HiLens管理控制台专业版的技能开发-工具/插件板块下载Windows系列的ModelBox sdk：

2）新建一个用于ModelBox开发的文件夹（注意路径中不能有中文和空格），将下载的sdk压缩包移动到该路径并解压，使用VS Code打开该文件夹：

可以看到ModelBox sdk的目录结构：

其中modelbox-win10-x64文件夹即为ModelBox核心库，包含ModelBox运行环境、内置的功能单元等。另外，为了做到开箱即用，可以看到sdk中已经包含了Python运行环境（python-embed目录），AI应用常用的OpenCV、NumPy等三方库也已经内置，开发者无需手动安装。

此外，我们也推荐安装一些VS Code插件，提高开发效率。

Python

后面教程会涉及到ModelBox的Python功能单元开发，推荐安装Python插件，微软官方出品，可以进行语法高亮、自动补全、代码跳转等：

Even Better TOML

ModelBox中的流程图、配置文件等使用 TOML 语法编写，因此我们推荐安装 Even Better TOML 插件，可以进行语法检查、关键字高亮、文件排版等：

3）打开Terminal

后面的很多操作需要用到VSCode的命令行工具，在VS Code菜单栏点击“Terminal”菜单，点击“New Terminal”：

将会打开一个新的“Terminal”：

4）ModelBox技能模板

我们准备了一些口罩检测、手势检测、人体姿态识别等AI技能模板，存放在华为云OBS中；然后在ModelBox sdk中提供了一个solution.bat工具，用于下载云侧的技能模板，执行.\solution.bat -l可看到当前已有的技能模板：

注意，如果是第一次执行solution.bat工具，会先去下载安装相关的obs工具：

安装完成后再执行一次.\solution.bat -l，就可以看到技能模板了。如果obs工具下载失败，可能是pip源设置有问题，请先执行 .\create.bat -t server -n car_det -s car_det 创建一个工程，此时会自动配置好全局pip源。

3. AI应用示例

1）创建工程

ModelBox sdk中提供了create.bat工具，用于创建ModelBox工程、创建功能单元、工程打包等，在VSCode的Terminal中执行.\create.bat可看到辅助工具的用法介绍：

在Terminal中执行如下命令可以创建车辆检测技能（车辆检测技能模板已内置在sdk中）：

PS D:\modelbox\modelbox-win10-x64-1.2.0> .\create.bat -t server -n car_det -s car_det

D:\modelbox\modelbox-win10-x64-1.2.0>set BASE_PATH=D:\modelbox\modelbox-win10-x64-1.2.0\

...

D:\modelbox\modelbox-win10-x64-1.2.0>python.exe D:\modelbox\modelbox-win10-x64-1.2.0\\create.py -t server -n car_det -s car_det
sdk version is modelbox-win10-x64-1.2.0
复制了 4 个文件
复制了 9 个文件
success: create car_det in D:\modelbox\modelbox-win10-x64-1.2.0\workspace
PS D:\modelbox\modelbox-win10-x64-1.2.0>

在创建工程过程中会弹出命令行窗口，显示 dos2unix 命令执行信息：

可以看到创建好的工程结构如下：

2）运行应用

车辆检测技能默认会打开工程中的测试视频（data/car_test_video.mp4），检测画面中的车辆，将车辆画框再输出到另一个视频文件中，首先执行如下命令进入到车辆检测工程目录：

PS D:\modelbox\modelbox-win10-x64-1.2.0> cd .\workspace\car_det\
PS D:\modelbox\modelbox-win10-x64-1.2.0\workspace\car_det>

然后执行如下命令启动应用：

PS D:\modelbox\modelbox-win10-x64-1.2.0\workspace\car_det> .\bin\main.bat
...
[2022-10-31 20:26:57,035][ INFO][mock_communicate.cc:651 ] Task SUCCEEDED, Mock will exit application
...
[2022-10-31 20:26:57,241][ INFO][   job_manager.cc:82  ] delete job : IVA_JOB
请按任意键继续. . .

看到“Task SUCCEEDED”、“请按任意键继续”等字样，即表示应用运行完毕，可以看到在hilens_data_dir目录下生成了car_test_result.mp4文件，用播放器打开将看到车辆检测效果：

至此，ModelBox开发环境已准备完毕，可以进行AI应用开发了。

4. 常见错误：

1）未安装 Git for Windows 错误：

在创建工程过程中弹出如下错误提示：

创建工程的命令行提示如下信息：

PS D:\modelbox\modelbox-win10-x64-1.2.0> .\create.bat -t server -n car_det -s car_det

...

success: create car_det in D:\modelbox\modelbox-win10-x64-1.2.0\workspace
系统无法执行指定的程序。
PS D:\modelbox\modelbox-win10-x64-1.2.0>

这些信息都表明 Git for Windows 未安装，请参考第1节进行安装。

2）sh 文件未关联 Git for Windows 错误：

在运行应用（执行.\bin\main.bat）时出现如下toml格式错误：

这些信息表明未正确执行dos2unix格式转换，根本原因在于 sh 文件未关联 Git for Windows ，导致工程中的 build_project.sh 未正确执行（该文件需要使用Git运行），解决方案如下：

a. 在Windows桌面的搜索框搜索“默认应用”：

b. 进入“默认应用”界面后，拉到下方点击“按文件类型指定默认应用”：

c. 在“按文件类型指定默认应用”页面找到sh文件的设置条目，确保其默认应用为Git for Windows，如果未指定或被设置为其他应用，应当修改成Git for Windows：