查看“使用手册 - 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启动时报错。
[[文件: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动作
|-
|站点
|routing
|必经点
|参考使用手册-routing字段使用
|-
|路径
|speed
|该路径速度
|speed:1000，代表在此段路径上车辆速度切换为1000
|-
|路径
|direction
|该路径方向
|direction:1代表此段路径为单行道且只能正向，2代表反向，0不限制方向
|}

=== 2.4 移动车辆 ===
在创建好站点、路径，添加好车辆之后，可以控制小车移动，如果使用模拟车，需要先选中模拟车，右键点击站点，模拟车就会移动到该站点，如果使用真实小车，小车会出现在定位的位置上。点击初始化，模拟车需要双击“去某地”，然后左键点击想去的站点，真实车辆直接使用右键单击想去的站点，就会生成路径并执行。
[[文件:2b1affdb3bbb4bcc744d5d0b00e205c.png|无|缩略图|600x600像素]]
[[文件:97ed37cbbd7788e915864afb3d57834.png|无|缩略图|600x600像素]]

=== 2.5 使用进程 ===
工程师会针对业务场景设计进程，如自动充电、链式搬运等，点击进程-添加即可添加对应的进程，添加进程后需启动进程，并且可以点击下方的按钮，会有对应的动作。

[[文件:A7565cb223c4523e633f86060cebb8d.png|无框|600x600像素]]

=== 2.6 保存 ===
此步骤为最关键的一步，建议经常进行保存，点击保存项目，新建文件进行保存，建议命名格式为：日期-时间，也请不要覆盖之前的项目文件，保证出问题后方便回滚。记得每次修改，都在最新的工程文件基础上修改。