MagicDraw二次开发过程

文章目录

MagicDraw二次开发过程
- 帮助文档关键内容
- 插件开发流程
- - 1. 在plugins文件夹下创建插件文件夹
  - 2. 编写插件代码
  - 3. 编译并打包成*.jar*文件[³](#refer-anchor-1)
  - 4. 编写描述文件*plugin.xml*
- IDEA开发过程
- - 开发准备
  - 开发流程
  - 开发问题
  - - 1. ClassNotFoundException
    - 2. 仿真事件监听问题
    - 3. MagicDraw Systems of Systems Architect 2021X插件开发注意事项
    - 4. 调试时出现多个版本的插件
    - 5. 调试时的插件依赖问题与MagicDraw报错问题
- 参考资料

帮助文档关键内容

插件是唯一方式。

Plugins are the only one way to change the functionality of a modeling tool.
插件运行过程示意图：

插件管理器会扫描plugins下所有文件夹，文件夹内需要有插件描述文件，根据文件中的描述找到插件类，判断是否继承com.nomagic.magicdraw.plugins.Plugin，并实现了init()方法。

插件开发流程 1. 在plugins文件夹下创建插件文件夹 2. 编写插件代码

注：必须有一个类继承com.nomagic.magicdraw.plugins.Plugin

The plugin must contain at least one class derived from the com.nomagic.magicdraw.plugins.Plugin class.

3. 编译并打包成*.jar*文件³ 4. 编写描述文件plugin.xml IDEA开发过程开发准备

通过settings > Appearance & Behavior > Path Variables添加变量MAGIC_DRAW_INSTALL_DIRECTORY指向安装目录（便于多人开发时解决各计算机依赖包位置不同的问题）；
修改配置文件MagicDrawbinmagicdraw.properties，在JAVA_ARGS添加属性
```
-Dmd.plugins.dir="absolute path to plugins directory1;absolute path to 
plugins directory2"
```
目录直接写当前正在开发插件目录，这样启动MagicDraw后会到该目录加载插件(经过测试发现不修改配置，在启动IDEA调试后MagicDraw也可以加载插件)；

注：在.properties中需要使用转义字符，否则会导致配置不生效，所有插件丢失，示例如下
```
-Dmd.plugins.dir="C:\Program Files\MagicDraw\plugins;D:\09_Project\Simulation\SYSML\ide\intellij\MagicDraw development\plugins"
```

开发流程

创建空项目；
添加Libraries，并在Modules中设置Dependencies引用；

注：Libraries指向MAGIC_DRAW_INSTALL_DIRECTORYlib整个文件夹，并且需要手动设置递归(否则会出现依赖缺失)，在配置文件.idealibrariesxxx.xml文件下直接手动修改

Edit Configurations;

具体参数如下：

MagicDraw with all plugins

-Xmx2000M
-Xss1024K
-XX:PermSize=60M
-XX:MaxPermSize=200M
-DLOCALCONFIG=true
-Dmd.plugins.dir=${MAGIC_DRAW_INSTALL_DIRECTORY}/plugins;..
"-javaagent:${MAGIC_DRAW_INSTALL_DIRECTORY}/openapi/ide/lib/com.nomagic.magicdraw.intellij.launcher.jar"
-jar
"${MAGIC_DRAW_INSTALL_DIRECTORY}/openapi/ide/lib/com.nomagic.magicdraw.intellij.launcher.jar"

com.nomagic.magicdraw.LaunchGateway

-verbose

$MODULE_DIR$

创建插件类；

继承com.nomagic.magicdraw.plugins.Plugin，并实现init()、close()、isSupported()方法。

package simulation;

import com.nomagic.magicdraw.core.Application;
import com.nomagic.magicdraw.plugins.Plugin;


public class SimulationPlugin extends Plugin {
    public static boolean initialized;

    @Override
    public void init()
    {
        initialized = true;
        Application.getInstance().getGUILog().showMessage("Simulation plugin initialized.");
    }

    @Override
    public boolean close()
    {
        return true;
    }

    @Override
    public boolean isSupported()
    {
        return true;
    }
}

创建plugin.xml;

src同级目录下创建。

开发问题 1. ClassNotFoundException

引用MagicDrawlibbundles下的某些jar包时，编译没有问题，但是插件运行时报错，如Caused by: java.lang.ClassNotFoundException: org.json.JSONObject

报错信息：

2019-10-16 16:36:09,996 [main] ERROR PLUGINS - Can not start plugin My Plug-in 1
java.lang.NoClassDefFoundError: org/json/JSONObject
	at myplugin1.MyPlugin1.init(MyPlugin1.java:17)
	at com.nomagic.magicdraw.plugins.d.b(d.java:719)
	at com.nomagic.magicdraw.plugins.d.a(d.java:556)
	at com.nomagic.magicdraw.plugins.d.y(d.java:487)
	at com.nomagic.magicdraw.core.h.t(h.java:45)
	at com.nomagic.rcpf.product.o.a(o.java:283)
	at com.nomagic.rcpf.product.p.b(p.java:93)
	at com.nomagic.rcpf.product.p.a(p.java:77)
	at com.nomagic.magicdraw.core.Application.internalStart(Application.java:685)
	at com.nomagic.magicdraw.core.Application.start(Application.java:454)
	at com.nomagic.magicdraw.MagicDrawApplicationLauncher.launch(MagicDrawApplicationLauncher.java:24)
	at com.nomagic.magicdraw.ApplicationGateway.start(ApplicationGateway.java:46)
	at org.eclipse.equinox.internal.app.EclipseAppHandle.run(EclipseAppHandle.java:196)
	at org.eclipse.core.runtime.internal.adaptor.EclipseAppLauncher.runApplication(EclipseAppLauncher.java:134)
	at org.eclipse.core.runtime.internal.adaptor.EclipseAppLauncher.start(EclipseAppLauncher.java:104)
	at org.eclipse.core.runtime.adaptor.EclipseStarter.run(EclipseStarter.java:388)
	at com.nomagic.osgi.launcher.FrameworkLauncher$DefaultApplication.run(FrameworkLauncher.java:227)
	at com.nomagic.osgi.launcher.FrameworkLauncher.runFrameworkApplication(FrameworkLauncher.java:177)
	at com.nomagic.osgi.launcher.FrameworkLauncher.run(FrameworkLauncher.java:114)
	at com.nomagic.osgi.launcher.FrameworkLauncher.run(FrameworkLauncher.java:93)
	at com.nomagic.osgi.launcher.ProductionFrameworkLauncher.run(ProductionFrameworkLauncher.java:66)
	at com.nomagic.osgi.launcher.ProductionFrameworkLauncher.main(ProductionFrameworkLauncher.java:53)
	at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
	at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
	at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
	at java.lang.reflect.Method.invoke(Method.java:498)
	at com.nomagic.launcher.Launcher.startMainClass(Launcher.java:337)
	at com.nomagic.launcher.Launcher.start(Launcher.java:108)
	at com.nomagic.launcher.Launcher.main(Launcher.java:70)
Caused by: java.lang.ClassNotFoundException: org.json.JSONObject
	at java.net.URLClassLoader.findClass(URLClassLoader.java:382)
	at java.lang.ClassLoader.loadClass(ClassLoader.java:424)
	at java.lang.ClassLoader.loadClass(ClassLoader.java:357)
	... 29 more

解决方案：

在plugin.xml同级目录下创建lib文件夹，将引用的jar包复制到该目录下，同时在Project Structure/Libraries下添加lib目录，并将顺序调到最高，然后在plugin.xml中添加runtime>library引用

截图如下：

2. 仿真事件监听问题

需要在仿真开始前注册监听器，否则监听回调函数没有作用。

自定义监听类：CustomSimulationExecutionListener

import com.nomagic.magicdraw.simulation.execution.SimulationExecutionListener;
import com.nomagic.magicdraw.simulation.fuml.data.i;
import fUML.Semantics.CommonBehaviors.Communications.SignalInstance;

public class CustomSimulationExecutionListener extends SimulationExecutionListener {
    @Override
    public void eventTriggered(SignalInstance signal){
        i data = signal.getData();
        System.out.println("监听到信号被触发");
    }
}

注册监听器：MainAction

    @Override
    public void actionPerformed(ActionEvent e)
    {
        // TODO: 监听仿真过程中的事件
        CustomSimulationExecutionListener executionListener = new CustomSimulationExecutionListener();
        SimulationManager.registerSimulationExecutionListener(executionListener);

        // ...开始仿真等操作
    }

3. MagicDraw Systems of Systems Architect 2021X插件开发注意事项

必须基于JDK11进行开发，否则编译时会报空指针异常，project lanuage level设置为10；
Modules中按照MagicDraw Patch[安装目录/lib/path.jar]、MagicDradraw Brand[安装目录/lib/brand.jar brand_api.jar]、MagicDraw Libs[安装目录/lib]的顺序设置依赖;
引用其他的依赖，如simulation.jar，需要在发布时在plugin.xml中制指定runtime/library/name设置具体位置，否则会出现开发环境下正常，但是发布后找不到类而加载失败的情况；
特殊情况：通过plugin.xml设置依赖simulation.jar后，造成活动图的decision、状态图的choice在仿真过程中突然中断，需要通过插件依赖的方式设置依赖。

4. 调试时出现多个版本的插件

当使用IDEA进行调试开发时，可能会在enviroment/plugins下面出现多个版本的同一插件，原因是设置的启动配置中：

-Dmd.plugins.dir=${MAGIC_DRAW_INSTALL_DIRECTORY}/plugins;..

MagicDraw会到安装目录下的plugins文件夹以及当前项目的上级目录寻找所有的plugin.xml文件，然后加载对应插件，如果有多个版本的plugin.xml就会造成插件多次加载。

5. 调试时的插件依赖问题与MagicDraw报错问题

当正在开始的插件依赖于其他插件时，通常需要在Modules/Dependencies下设置依赖的jar包，部署发布时需要在plugin.xml中设置requires对插件的依赖。

有时会出现问题：部署发布后，插件以及MagicDraw都没有问题；但是开发调试过程中，MagicDraw本身功能却出现问题，如原本的仿真功能菜单为Run，当开发插件依赖仿真插件时，菜单变成了CONTEXT_TOOLBAR。

原因在于：发布后的插件，由于已经在plugin.xml中设置了插件依赖关系，MagicDraw软件本身会解决依赖问题；调试中的插件，虽然引用了所依赖插件的jar包，但是并没有把其下的所有jar包引进来，还可能是所依赖的插件本身又依赖于另一个插件，这些jar包都要包含进来。

开发过程中需要保证所有依赖的插件及依赖插件的父插件目录下的jar包，都需要引入进来。

参考资料

[1] MagicDrawmanualMagicDraw UserManual.pdf ：Developer Guide部分
[2] java.lang.NoClassDefFoundError
[3] Jar包反编译后修改源码再编译

MagicDraw二次开发过程

Java相关栏目本月热门文章