4. 开发环境搭建
Embedded Wizard（简称 EW）是一套面向嵌入式设备的可视化 HMI 开发工具链，其核心价值在于“用 PC 上的可视化编辑 + 自动生成 C 代码”替代手写 GUI 逻辑。要顺利进入后续章节的界面开发，第一步必须把工具链、许可证、工程模板、目标平台和编译运行链路全部打通。本章按“安装 → 许可 → 建工程 → 选平台 → 编译运行”的顺序，给出可复现的操作路径与常见问题排查方法。
一、核心原理：EW 工具链的组成与数据流
Embedded Wizard 并不是一个“只画界面”的软件，它由三部分协同工作：EW 编辑器（IDE）负责可视化建模与代码生成；生成器（Generator）把 Chora 代码、控件树、资源编译成平台无关的 C 代码；目标平台集成层（Platform Package / BSP）提供显示驱动、触摸输入、定时器、内存管理等底层适配。三者关系可以用下面的数据流图表示：
理解这条链路后，安装与配置就不再是“点下一步”，而是有明确目标的：让编辑器能生成代码、让生成器能找到平台包、让工具链能编译出可执行文件。
二、安装与许可证配置
Embedded Wizard 官方提供 Windows 版安装包，安装过程本身不复杂，但许可证配置是新手最容易卡住的一步。EW 采用“编辑器免费 + 目标平台授权”的模式：编辑器可以免费下载使用，但要把生成的代码编译到具体目标平台，需要对应的平台许可证（License Key）。
- 下载安装包：从 Embedded Wizard 官网获取对应版本的安装程序，建议选择与教程一致的稳定版本，避免平台包不兼容。
- 安装路径：路径中不要包含中文或空格，例如使用
D:\EW\EmbeddedWizard，否则生成器调用工具链时可能因路径解析失败而报错。 - 获取许可证：在官网注册账号后，根据目标平台申请评估版或商业版 License，通常会收到一个
.ewl或文本格式的密钥文件。 - 配置许可证：打开 EW 编辑器，进入
Help → License或安装目录下的License配置项，导入密钥并确认状态显示为有效。
三、工程创建与目标平台选择
EW 的工程（Project）不是从空白文件开始，而是基于“模板 + 平台包”创建。推荐流程如下：
1. File → New Project
2. 选择模板：如 "Application Template" 或 "Minimal Template"
3. 选择目标平台：如 STM32F4 / i.MX RT / Raspberry Pi / Win32 Simulation
4. 设置工程名与路径：D:\EW_Projects\MyFirstHMI
5. 确认平台包版本与工具链路径
6. 点击 Create，生成 .ew 工程文件与目录结构目标平台的选择直接决定后续编译方式。常见平台可分为三类：PC 仿真平台（Win32 Simulation）用于快速验证界面逻辑，不需要硬件；MCU 平台（STM32、NXP、Renesas 等）需要交叉编译工具链和 BSP；MPU/Linux 平台（Raspberry Pi、i.MX8 等）通常使用 GCC 交叉编译并在目标系统运行。下表对比了三类平台的适用场景：
| 平台类型 | 典型目标 | 工具链 | 适用阶段 |
|---|---|---|---|
| PC 仿真 | Win32 Simulation | Visual Studio / MinGW | 界面逻辑验证、快速迭代 |
| MCU 平台 | STM32F4/F7、i.MX RT | GCC ARM / IAR / Keil | 资源受限设备、实时性要求高 |
| MPU/Linux | Raspberry Pi、i.MX8 | GCC 交叉编译 | 复杂界面、多任务、大屏 |
四、首次编译运行与常见误区
工程创建完成后，第一次编译建议先在 PC 仿真平台跑通，再切换到目标硬件。这样可以把“界面逻辑错误”和“平台适配错误”分开定位。典型操作是：在 EW 编辑器中点击 Build → Build and Run，编辑器会调用生成器生成 C 代码，再调用工具链编译，最后启动仿真窗口或下载到目标板。
首次编译常见的报错与处理方式：
- 找不到平台包：检查安装时是否勾选了对应 Platform Package，或在
Project Settings → Platform中重新指定路径。 - 工具链路径错误：在
Settings → Build Environment中确认 GCC/IAR/Keil 的安装路径，路径中同样避免中文和空格。 - 许可证无效：确认 License 与目标平台一致，评估版过期需重新申请。
- 链接失败或内存溢出：检查链接脚本中的 Flash/RAM 配置，适当裁剪资源或调整堆栈大小。