- 需要使用 cmake (version > 3.12)
- c++编译器支持
c++11 - 如需生成 code coverage 报告，则需要安装 lcov
- 编译 python 版本需安装 python3
项目支持的 cmake 编译选项如下：
| 编译选项 | 默认值 | 说明 |
|---|---|---|
| FLOWCHART_DEBUG | OFF | 开启远程调试功能，外放版本请不要打开 |
| BUILD_PYTHON | OFF | 编译 python 模块 |
| BUILD_LUAJIT | OFF | 编译 luajit 模块，为ON时，需要配置 LUAJIT_INCLUDE_PATH 与 LUAJIT_LIB |
| LUAJIT_INCLUDE_PATH | - | luajit 的头文件目录 |
| LUAJIT_LIB | - | luajit 的库文件 |
| BUILD_WASM | OFF | 编译为 WASM 模块 |
FLOWCHART_DEBUG 为ON时编译带有调试功能的版本
windows 上编译 python 模块：
cmake -G "Visual Studio 15 Win64" .. -DBUILD_PYTHON=ON -DFLOWCHART_DEBUG=ON -DCMAKE_BUILD_TYPE=Releasewindows 上编译 luajit 模块：
cmake -G "Visual Studio 15 Win64" .. -DBUILD_PYTHON=ON -DFLOWCHART_DEBUG=ON \
-DLUAJIT_INCLUDE_PATH=D:/LuaJIT-2.0.5/src \
-DLUAJIT_LIB=D:/LuaJIT-2.0.5/src/luajit.lib
linux 上编译 lua 模块可以直接使用 build_lua.sh
linux 上编译 wasm 模块，需提前准备好 emscripten：
$ emcmake cmake .. -DBUILD_WASM=ON -DCMAKE_BUILD_TYPE=Debug由于CMake对于Visual Studio项目的Debug配置中，一些选项参数没有与Release进行区分导致的。
-
预定义宏里面加上
_DEBUG， 这是由于Python的pyconfig.h里面:# if defined(_DEBUG) # pragma comment(lib,"python36_d.lib") # elif defined(Py_LIMITED_API) # pragma comment(lib,"python3.lib") # else # pragma comment(lib,"python36.lib") # endif /* _DEBUG */
-
c/c++ => 代码生成 => 运行库 修改为
/MDd
编译出来的debug版本的dll，直接使用python.exe加载会出现该错误。具体解决办法为：
- 将 xxx.pyd 改名为 xxx_d.pyd
- 使用python_d.exe来加载该C扩展
luajit 的默认编译方式为 mixed 会生成一个静态链接的 luajit，在 luajit 的 makefile 里面修改为 BUILDMODE= dynamic 即可
可以参考 test文件夹下lua和python文件夹中test_开头的lua或python文件。
所有函数都位于 asyncflow module下
初始化函数
- setup(interval : int); 初始化函数，参数为
step的默认时间间隔 - importjson(filename: str); 加载流程图文件，参数为文件名，也可为json字符串
- import_event(filename: str); 加载event信息
对象函数
- register(obj: object); 将对象纳入到流程图管理中来
- attach(obj: object, chart_name: str); 将流程图挂载的 obj 上
- start(obj: object); 启动对象运行
运行函数
- step(milliseconds: int); 驱动流程图运行一次，参数用于控制流程图内部的时间流逝
- event(obj: object, event_id: int, params ...); 向指定对象发送事件，等待该事件的节点将被激活，并在接下来的 step 中开始运行
销毁函数
- deregister(obj: object); 将对象从流程图管理中移除，该对象将不再受流程图的控制
- exit(); 销毁整个流程图管理器