编译

环境要求

需要使用 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=Release

windows 上编译 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

编译的常见问题

Visual Studio项目，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

Fatal Python error: PyThreadState_Get: no current thread

编译出来的debug版本的dll，直接使用python.exe加载会出现该错误。具体解决办法为：

将 xxx.pyd 改名为 xxx_d.pyd
使用python_d.exe来加载该C扩展

linux 链接 luajit 时提示使用 -fPIC

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(); 销毁整个流程图管理器

gokasiko/asyncflow

编译