编译

环境要求

• 需要使用 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 与 python 模块：

REM win_build.bat
cmake . -Bwin-build -G "Visual Studio 16 2019" -Ax64 ^
    -DBUILD_LUAJIT=ON -DBUILD_PYTHON=ON -DBUILD_TEST=ON -DFLOWCHART_DEBUG=ON ^
    -DLUAJIT_INCLUDE_PATH=./thirdparty/LuaJIT-2.1.0-beta3/src ^
    -DLUAJIT_LIB=./thirdparty/LuaJIT-2.1.0-beta3/src/lua51.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下，接口参见lua版本导出接口

论文介绍

对于 asyncflow 的结构可以参见 Asyncflow: A visual programming tool for game artificial intelligence - ScienceDirect

引用信息见仓库里面的 asyncflow.bib 文件