三分钟学会用Lua调用C/C++函数库

跟着本文, 大家只需要简单的4个步骤就能build出自己的C/CPP语言DLL库供Lua require随意调用.

需要准备的软件

• Visual Studio 2015/2017
• Lua5.1 source code (click to download)

step1: 建DLL工程

使用VisualStudio2017, 新建一个Win32 Console Application

1

2

step2: 拷lua5.1代码

创建成功后, 从Lua5.1 source file(百度搜索lua5.1 source file下载)中, 拷贝所有的源代码.c和.h文件到项目文件夹中. 我们其实有更简洁的引用lua.lib而不是直接拷贝源代码的方式, 但是新手入门先用这个方法不容易出错.

3

拷贝完文件后, 要在Visual Studio IDE中右键项目名 --> 添加 --> 现有项目, 选中所有刚才复制的lua5.1源代码.

step3: 写DllMain.cpp代码

新建DllMain.cpp文件, 写上如下的代码. 代码很简短, 而且写好了注释供大家参考.

extern "C" {
#include "lua.h"  
#include "lualib.h"  
#include "lauxlib.h"
};
#include   
using namespace std;

extern "C" int ShowMsg(lua_State* luaEnv) { 
    cout << "Hello world from clibs!" << endl;
    return 0; // 返回值个数为0个.  
}

// part one: 要导出的函数列表
static luaL_Reg luaLibs[] = {
    { "ShowMsg", ShowMsg},
    { NULL, NULL }
};

// part two: DLL入口函数，Lua调用此DLL的入口函数.  
extern "C" __declspec(dllexport)
int luaopen_WinFeature(lua_State* luaEnv) {   //WinFeature是modole名, 将来require这个名字
    const char* const LIBRARY_NAME = "WinFeature"; //这里也写WinFeature
    luaL_register(luaEnv, LIBRARY_NAME, luaLibs);  //关键一行, 在luaState上注册好这个lib
    return 1;
}

step4: build出dll库

点击build --> build solution (ctrl + shift + B)生成出xxx.dll库文件.
在项目的Debug文件夹中取出所需的dll库.

debug文件夹中取出xxx.dll文件

再把这个xxx.dll库复制到C:\Program Files (x86)\Lua\5.1\clibs文件夹下即可. (这里路径名仅供参考, 要以大家的实际lua路径为准)

extra: 测试是否成功

require "WinFeature"
WinFeature.ShowMsg() -- it should prints "Hello world from clibs!"

cmd结果

显然, 我们成功了!!!

参考资料&扩展阅读

绑定Lua和C/C++的库
What does “#pragma comment” mean?