使用手册 - Simple:从使用到开发：修订间差异

2023年10月19日 (四) 10:55的版本

Simple：从使用到开发

1.认识simple

1.1 认识Simple根目录

下图是某项目的Simple根目录，其中SimpleComposer.exe为Simple的应用程序，simple.json为配置文件，根目录下的各种.dll库文件为依赖项，如本项目中用到AbstractChainDeliveryMission类，就引用自MDCSToolBox.dll中。其余json文件，如1510.json为Simple的工程文件。plugins文件夹下存储了工程师开发的当前场景的插件。

下图为错误示范，由于开发项目时引用不规范，导致编译出很多无用的dll库文件，且直接放在Simple根目录下，有时会导致Simple启动时报错。

链接=文件:2e1c582f8ddd429e798bbc9f3f7ef65.png|无框|600x600像素

1.2 认识simple.json文件

下图为simple.json文件中的内容，autoload代表了自动加载此工程文件，ip及port为simple监听的ip及端口。

1.3 加载simple插件

打开Simple文件夹，在Plugin里面会有工程师提供的当前场景的插件（默认名称AMRScene.dll），根据车型以及业务场景的不同，工程师会编写对应的插件，如果插件有更新，替换Simple/Plugins目录内AMRScene.dll即可。AMRScene.pdb为调试所用，可以简单的理解为，当程序异常或报错时，可以在控制台看到异常的程序在哪一行。

2.如何使用Simple

2.1 simple主界面

如下图，为simple主界面，界面中的各个元素的功能如标注中所示。

2.2 创建小车

如下图，点击车辆-添加，可以选择添加的小车类型，本地模拟可以添加模拟车，实际生产中需添加本项目车型。

添加车辆后，若为本地模拟，只需要设置速度，将速度填写在speed字段中；若为实际车辆，还需要填写ip地址，填写在address字段中。

2.3 创建站点和路径

如下图所示，点击场景-添加，即可添加站点和路径，首先添加站点，添加路径时需要将站点连接起来。

2.4 添加/修改站点、路径字段

如下图所示，选中站点或路径时，可以看到添加的字段。字段需要根据程序中所写的内容进行添加。

simple中内置了很多字段，如下表


字段类型	字段名称	字段含义	举例
站点	mustFree	必空点	给某个点设置mustFree:[1,2,3]，代表此站点被锁时，id为1、2、3的站点不允许被其它点锁定
站点	codeArrive	到达此点动作	codeArrive:agv.Put();代表到达此点后执行Put动作
站点	codeLeave	离开此点动作	codeLeave:agv.Put();代表离开此点时执行Put动作
站点	codeQueue	队列动作	codeQueue:agv.Put();代表在此点发生路径切换时执行Put动作

@@ 第1行： / 第1行： @@
 == Simple：从使用到开发 ==
+=== 1.认识simple ===
+==== 1.1 认识Simple根目录 ====
+下图是某项目的Simple根目录，其中SimpleComposer.exe为Simple的应用程序，simple.json为配置文件，根目录下的各种.dll库文件为依赖项，如本项目中用到AbstractChainDeliveryMission类，就引用自MDCSToolBox.dll中。其余json文件，如1510.json为Simple的工程文件。plugins文件夹下存储了工程师开发的当前场景的插件。
+[[文件:74d434da04a4ade031a8bc9dbbcede2.png|无|缩略图|600x600像素]]
+下图为错误示范，由于开发项目时引用不规范，导致编译出很多无用的dll库文件，且直接放在Simple根目录下，有时会导致Simple启动时报错。
+[[index.php?title=文件:2e1c582f8ddd429e798bbc9f3f7ef65.png|链接=文件:2e1c582f8ddd429e798bbc9f3f7ef65.png|无框|600x600像素]]
+==== 1.2 认识simple.json文件 ====
+下图为simple.json文件中的内容，autoload代表了自动加载此工程文件，ip及port为simple监听的ip及端口。
+[[文件:60968e237ab0e1f7a3d4b899dc6b7c0.png|无|缩略图|600x600像素]]
+==== 1.3 加载simple插件 ====
+打开Simple文件夹，在Plugin里面会有工程师提供的当前场景的插件（默认名称AMRScene.dll），根据车型以及业务场景的不同，工程师会编写对应的插件，如果插件有更新，替换Simple/Plugins目录内AMRScene.dll即可。AMRScene.pdb为调试所用，可以简单的理解为，当程序异常或报错时，可以在控制台看到异常的程序在哪一行。
+=== 2.如何使用Simple ===
+==== 2.1 simple主界面 ====
+如下图，为simple主界面，界面中的各个元素的功能如标注中所示。
+[[文件:Cb0653332cab21edd407a7d9eb74773.png|无框|600x600像素]]
+==== 2.2 创建小车 ====
+如下图，点击车辆-添加，可以选择添加的小车类型，本地模拟可以添加模拟车，实际生产中需添加本项目车型。
+添加车辆后，若为本地模拟，只需要设置速度，将速度填写在speed字段中；若为实际车辆，还需要填写ip地址，填写在address字段中。
+[[文件:Fb9ada5c49d9168b9b929eb67b903ff.png|无框|600x600像素]]
+==== 2.3 创建站点和路径 ====
+如下图所示，点击场景-添加，即可添加站点和路径，首先添加站点，添加路径时需要将站点连接起来。
+[[文件:C22d3bd3efeec25bfd0136b6f25e70b.png|无框|600x600像素]]
+==== 2.4 添加/修改站点、路径字段 ====
+如下图所示，选中站点或路径时，可以看到添加的字段。字段需要根据程序中所写的内容进行添加。
+[[文件:9a34d2b545f5958370b05a9107befa2.png|无|缩略图|600x600像素]]
+simple中内置了很多字段，如下表
+{| class="wikitable"
+|+
+!字段类型
+!字段名称
+!字段含义
+!举例
+|-
+|站点
+|mustFree
+|必空点
+|给某个点设置mustFree:[1,2,3]，代表此站点被锁时，id为1、2、3的站点不允许被其它点锁定
+|-
+|站点
+|codeArrive
+|到达此点动作
+|codeArrive:agv.Put();代表到达此点后执行Put动作
+|-
+|站点
+|codeLeave
+|离开此点动作
+|codeLeave:agv.Put();代表离开此点时执行Put动作
+|-
+|站点
+|codeQueue
+|队列动作
+|codeQueue:agv.Put();代表在此点发生路径切换时执行Put动作
+|}