# Draw.io 使用指南:绘制UML状态图并保存本地 ## 一、进入绘制界面 1. 打开 [draw.io](https://app.diagrams.net/) 2. 选择「Create New Diagram」(创建新图表) 3. 选择存储位置:点击「Device」(设备)→ 暂时不保存 4. 选择模板:点击「Blank Diagram」(空白图表)→ 点击「Create」 ## 二、绘制UML状态图 ### 1. 启用UML状态图工具 在左侧工具栏找到并点击「More Shapes」(更多形状): - 展开「Software」(软件)→ 勾选「UML」 - 特别勾选「UML State Machine」(UML状态机) - 点击「Apply」(应用) ### 2. 绘制基本元素 #### 初始状态 - 从左侧「UML State Machine」工具栏拖拽「Initial State」(实心圆)到画布 #### 普通状态 - 拖拽「State」(圆角矩形)到画布 - 双击状态框输入状态名称(如:`scanner1_scanning`) - 右键点击状态 → 「Edit Style」(编辑样式)可修改颜色、边框等 #### 状态转换 - 从左侧工具栏拖拽「Transition」(带箭头的线)到画布 - 连接两个状态(起点状态 → 终点状态) - 双击箭头输入触发事件(如:`scanner1_complete`) #### 终止状态 - 从左侧工具栏拖拽「Final State」(同心圆)到画布(如果需要) ### 3. 高级设置 #### 转换条件 - 右键点击转换箭头 → 「Edit」(编辑)→ 「Add Condition」(添加条件) - 输入条件(如:`if position == upper_limit`) #### 状态动作 - 双击状态 → 进入编辑模式 - 输入格式:`状态名称\n/进入动作\n退出动作` - 示例:`scanner1_scanning\n/on_scanner1_scanning_start()\non_scanner1_scanning_stop()` #### 并行区域(可选) - 使用「Composite State」(复合状态)创建嵌套区域 - 用于表示并发执行的状态 ## 三、保存到本地 ### 1. 保存为.drawio格式(可编辑) - 点击顶部菜单栏「File」(文件)→ 「Save As」(另存为) - 选择「Device」(设备) - 选择保存位置(推荐保存到 `motor_service` 目录) - 输入文件名(如:`scanner_state_machine.drawio`) - 点击「Save」(保存) ### 2. 导出为图片格式(用于查看) - 点击顶部菜单栏「File」(文件)→ 「Export As」(导出为)→ 「PNG」 - 设置图片参数: - 「Include a border」(包含边框):可选 - 「Zoom」(缩放):100% - 「Transparent Background」(透明背景):可选 - 点击「Export」(导出) - 选择保存位置和文件名(如:`scanner_state_machine.png`) - 点击「Save」(保存) ### 3. 导出为PDF格式(用于文档) - 点击顶部菜单栏「File」(文件)→ 「Export As」(导出为)→ 「PDF」 - 设置PDF参数后点击「Export」(导出) ## 四、绘制示例(扫描器状态图) 按照之前的设计指南,绘制以下状态: - 初始状态 - `all_stopped` - `scanner1_scanning` - `scanner1_waiting` - `scanner2_scanning` - `scanner2_waiting` 并添加以下转换: - 初始状态 → `all_stopped` - `all_stopped` → `scanner1_scanning`(触发:`start_scanner1`) - `all_stopped` → `scanner2_scanning`(触发:`start_scanner2`) - `scanner1_scanning` → `scanner1_waiting`(触发:`scanner1_complete`) - `scanner2_scanning` → `scanner2_waiting`(触发:`scanner2_complete`) - `scanner1_waiting` → `scanner2_scanning`(触发:`start_scanner2`) - `scanner2_waiting` → `scanner1_scanning`(触发:`start_scanner1`) - 所有状态 → `all_stopped`(触发:`stop_all` 或 `emer_stop_all`) ## 五、注意事项 1. 定期保存:绘制过程中可按 Ctrl+S(Windows)或 Command+S(Mac)快速保存 2. 命名规范:使用有意义的状态名称和事件名称 3. 布局清晰:使用「Arrange」(排列)菜单调整状态布局 4. 颜色区分:使用不同颜色表示不同类型的状态(如:运行状态用绿色,停止状态用红色) 绘制完成后,将 `.drawio` 文件保存到 `motor_service` 目录,然后告诉我,我将根据您的状态图实现代码。