Eclipse安装SysML v2插件说明
一、前置环境准备
所需软件及下载链接
- 1. Eclipse Modeling Tools
下载地址：Eclipse Modeling Tools 2025-12 - 2. Java开发工具包（JDK）（需提前安装）
- 3. SysML v2安装包
下载地址：SysML-v2-Release 官方发布页 - 4. GraphViz（PlantUML依赖工具）
下载地址：Graphviz 官方下载页
二、SysML v2插件安装步骤
因Eclipse 市场上没有提供SysML v2版本,需手动安装
- 1. 启动Eclipse并打开目标工作空间。
- 2. 点击顶部菜单栏的 帮助 > 安装新软件。
- 3. 在弹出窗口中点击 添加...，然后选择 归档文件...。
- 4. 浏览并选中SysML v2安装包中的压缩文件 org.omg.sysml.site.zip（可自定义名称），点击 添加。
- 5. 在安装窗口的“可用软件”列表中，勾选 KerML和SysML编辑器 分类，点击 下一步。
- 6. 跟随向导完成安装流程（若弹出安全提示，选择 仍然安装），安装完成后重启Eclipse。
三、PlantUML图形可视化配置
1. Eclipse 市场搜 PlantUML，进行安装 （方法一）
2. 手动安装 (方法二)
Eclipse通过PlantUML实现SysML图表渲染，配置步骤如下：
- 1. 安装带SysML v2扩展的PlantUML：
再次打开 帮助 > 安装新软件，在“工作与更新站点”输入框中填写：
https://github.com/himi/p2-update-puml-sysmlv2/raw/main/updates
勾选对应组件后完成安装。 - 2. 安装并初始化GraphViz：
从Graphviz下载页获取对应系统的安装包，安装后执行命令 dot -c 完成初始化（详情见：Graphviz配置指南）。 - 3. 手动配置GraphViz路径（若Eclipse未自动识别）：
打开 偏好设置 > PlantUML，在“Graphviz path”中填写程序路径 （ 详情见：PlantUML Eclipse配置文档）。 - 1. Mac （Homebrew）用户路径提示：若通过Homebrew安装Graphviz后Eclipse无法找到dot程序，需在 Graphviz path 中填写： /opt/homebrew/Cellar/graphviz/{your version}/bin/dot （将{your version}替换为实际安装的版本号）** Windows ** 需在 Graphviz path 中填写：c:/{your location}/bin/dot.exe
四、模型库与建模项目安装
前置操作（更新旧版本时）
若需更新早期SysML v2版本，先从工作空间中删除 `kerml`、`sysml`、`sysml.library` 项目，并勾选 **从磁盘删除项目内容**。安装步骤
- 1. 点击顶部菜单栏 文件 > 导入。
- 2. 在“导入”窗口中选择 通用 > 将现有项目导入工作空间，点击 下一步。
- 3. 点击 浏览，选中本地的 sysml.library 目录，点击 确定。
- 4. 在“项目”列表中勾选 sysml.library，并勾选 将项目复制到工作空间，点击 完成。
- 5. 关闭 项目 > 自动构建，然后点击 项目 > 清理...，仅选择 sysml.library 进行构建。
- 6. 对 kerml 和 sysml 项目重复上述1-5步（注意：必须先完成sysml.library的导入与构建）。
安装后可选配置
若需重新开启自动构建，需打开 **偏好设置 > 通用 > 工作空间 > 构建**，调整构建顺序，确保 `sysml.library` 位于 `kerml`、`sysml` 之前。五、模型文件使用指南
- 1. 打开模型文件：双击后缀为 .kerml 或 .sysml 的文件，自动用对应编辑器打开。
- 2. 创建新文件：
- • KerML文件：在 kerml/src 目录下创建，后缀为 .kerml。
- • SysML文件：在 sysml/src 目录下创建，后缀为 .sysml。
- 3. 模型库文件说明：可查看 sysml.library 项目中的文件，但请勿修改这些库文件。
- 4. 显示SysML图表：
点击 窗口 > 显示视图 > 其他...，在“PlantUML”分类中选择“PlantUML”视图；该视图会基于当前编辑器中选中的文本渲染图表（支持树、互联、状态机视图）。
补充说明
发布说明
本版本性能已优化，但包含多个名称解析错误的文件（尤其是依赖Quantities and Units库时），处理耗时可能较长。网络问题解决方案
如遇网络波动导致安装/升级失败，可重复执行对应步骤；或通过 **帮助 > 升级** 功能多次尝试重新连接更新源。 [HostFaster 是一个勉强给大陆程序员用于获取 GitHub 相关域名最优 IP 地址的工具](https://github.com/qiancy/hostFaster)