Eclipse安装SysML v2插件教程

Eclipse安装SysML v2插件说明

一、前置环境准备

所需软件及下载链接

1. 1. Eclipse Modeling Tools
   下载地址：Eclipse Modeling Tools 2025-12
2. 2. Java开发工具包（JDK） （需提前安装）
3. 3. SysML v2安装包
   下载地址：SysML-v2-Release 官方发布页
4. 4. GraphViz（PlantUML依赖工具）
   下载地址：Graphviz 官方下载页

二、SysML v2插件安装步骤

因Eclipse 市场上没有提供SysML v2版本,需手动安装

1. 1. 启动Eclipse并打开目标工作空间。
2. 2. 点击顶部菜单栏的 帮助 > 安装新软件。
3. 3. 在弹出窗口中点击 添加... ，然后选择 归档文件... 。
4. 4. 浏览并选中SysML v2安装包中的压缩文件 org.omg.sysml.site.zip（可自定义名称），点击 添加。
5. 5. 在安装窗口的“可用软件”列表中，勾选 KerML和SysML编辑器 分类，点击 下一步。
6. 6. 跟随向导完成安装流程（若弹出安全提示，选择 仍然安装），安装完成后重启Eclipse。

三、PlantUML图形可视化配置

1. Eclipse 市场搜 PlantUML，进行安装 （方法一）

2. 手动安装 (方法二)

Eclipse通过PlantUML实现SysML图表渲染，配置步骤如下：

1. 1. 安装带SysML v2扩展的PlantUML：
   再次打开 帮助 > 安装新软件，在“工作与更新站点”输入框中填写：
   https://github.com/himi/p2-update-puml-sysmlv2/raw/main/updates
   勾选对应组件后完成安装。
2. 2. 安装并初始化GraphViz：
   从Graphviz下载页获取对应系统的安装包，安装后执行命令 dot -c 完成初始化（详情见：Graphviz配置指南）。
3. 3. 手动配置GraphViz路径（若Eclipse未自动识别）：
   打开 偏好设置 > PlantUML，在“Graphviz path”中填写程序路径 （ 详情见：PlantUML Eclipse配置文档）。
4. 1. 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. 1. 点击顶部菜单栏 文件 > 导入。
2. 2. 在“导入”窗口中选择 通用 > 将现有项目导入工作空间，点击 下一步。
3. 3. 点击 浏览，选中本地的 sysml.library 目录，点击 确定。
4. 4. 在“项目”列表中勾选 sysml.library，并勾选 将项目复制到工作空间，点击 完成。
5. 5. 关闭 项目 > 自动构建，然后点击 项目 > 清理... ，仅选择 sysml.library 进行构建。
6. 6. 对 kerml 和 sysml 项目重复上述1-5步（注意：必须先完成sysml.library的导入与构建）。

安装后可选配置

  若需重新开启自动构建，需打开 **偏好设置 > 通用 > 工作空间 > 构建**，调整构建顺序，确保 `sysml.library` 位于 `kerml`、`sysml` 之前。

五、模型文件使用指南

1. 1. 打开模型文件：双击后缀为 .kerml 或 .sysml 的文件，自动用对应编辑器打开。
2. 2. 创建新文件：
3. • • KerML文件：在 kerml/src 目录下创建，后缀为 .kerml。
   • • SysML文件：在 sysml/src 目录下创建，后缀为 .sysml。
4. 3. 模型库文件说明：可查看 sysml.library 项目中的文件，但请勿修改这些库文件。
5. 4. 显示SysML图表：
   点击 窗口 > 显示视图 > 其他... ，在“PlantUML”分类中选择“PlantUML”视图；该视图会基于当前编辑器中选中的文本渲染图表（支持树、互联、状态机视图）。

补充说明

发布说明

 本版本性能已优化，但包含多个名称解析错误的文件（尤其是依赖Quantities and Units库时），处理耗时可能较长。

网络问题解决方案

 如遇网络波动导致安装/升级失败，可重复执行对应步骤；或通过 **帮助 > 升级** 功能多次尝试重新连接更新源。

 [HostFaster 是一个勉强给大陆程序员用于获取 GitHub 相关域名最优 IP 地址的工具](https://github.com/qiancy/hostFaster)