简单的使用Swig将C++标准库编写的动态库提供给C#使用方法
处于工作要求,需要把Qt和opencv编写的动态库提供给客户的的csharp程序使用,因此花时间研究了这个方法,本人的方法比较简单,就是提供一个C++标准的动态库作为桥,可以在动态库中再调用opencv和qt编写的动态库,降低了耦合度,也有利于我自己修改接口而不需要别人干预;
来说步骤了
1.首先需要配置swig 官网下载
http://www.swig.org/
官网上下载了最新的安装包 这个是我下载的地址,3.0.12
https://sourceforge.net/projects/swig/files/swigwin/swigwin-3.0.12/swigwin-3.0.12.zip/download?use_mirror=jaist
下载完成后,配置程序目录到系统环境,主要是为了减少后期输入
我的是win10 配置如下
配置好环境变量对于win10来说可以直接使用,其他的可能需要重启,如果你vs开着,需要关闭vs,重新开一下
2.编写 C++桥 动态库,本人使用vs2017,所以和vs2015稍微有一点区别
先新建空项目
接着修改工程属性为动态库
接着创建一个类对应的资源文件,其中头文件定义在下一个截图
类中用到的参数定义在下面的文件中,这样子写是为了给大家一个参照,如何引入其他头文件,但是请勿在你的最外层类的头文件中包含非标准c++的类型头文件,因为后面找不到无法转换,切记只能是包含C++标准;网上有的把类声明成为导出,方便其他c++也可以编译调用,这个我测试了一下,比较麻烦,需要引入window.h和后面添加window.i配置,所以就不这么玩,这个玩法只是为了给c#做桥
如果你想包含其他的非标准头文件,想使用呢 ,方法如下:
请忽略我的头文件找不到错误,只是为了示例 ,这个也是C++常用的,前置声明,然后只是使用类的指针或者引用;
在cpp用引用头文件,加速编译和防止重复引用;
代码写好了,接下来就该配置关于swig的转换规则
3.编写转换的配置文件
我个人理解的配置文件的意义就是替换对应的类、函数、类型成为其他语言中通用的数据类型
说明一下,上面的module后面跟的名称需要和你动态库名称相同(去掉dll),也要和后面命令中的一致
头文件包含顺序需要按照你自己代码中的先后使用顺序来,因为我最先在gloabal**中使用了标准c++的类型,因此需要先包含对应头文件,之后包含我自己的头文件,注意看格式,具体为什么要这么做,请参考官方文档,我是下载了官方的pdf,后面也会上传;
4.接着一部就是调用命令,你可以选择到你的工程目录调用cmd执行命令,也可以在vs编译后添加命令,后者比较方便而已
我使用后者
我的命令写在txt文档中,方便查看
命令依次是
调用环境变量中的swig 程序
将c++
转换到 c#
生成中间文件
名称如***wrapper
生成的c#的文件,都使用名称空间 ***namespace
调用的swig配置替换模板文件是 *.i
注意,请勿使用回车
将上述命令复制粘贴到vs的配置下
开始编译吧
,编译后会在工程目录下生成一堆cs文件和一个cpp文件,就是命令中的中间文件
最后把中间文件添加到工程,再次编译生成对应的dll库
完成了一半
接下来创建C#控制台程序测试
vs2017是没有向导的,因此直接生成了工程
依次完成下面圈着的地方:
复制c++工程生成的cs文件到c#工程下
使用刚才定义的名称空间引入我们的类型数据
编写测试代码
编译
等等还不能运行的
我们编译了刚刚的文件,但是运行时候需要c++编译的动态库,所以要到c++工程生成的dll拷贝到c#bin目录下
好了运行测试如下代码
结果如上
好了以上就是全部的步骤,可能你会想,如果你已经有了一个C++或者C的第三方库,这么可以掉用接口呢;
C语言的话swig提供了extern的方法,具体看官方手册,但是我自己写的话就直接引入他的头文件在cpp里面重载实现调用就可以了;
如果是其他的如qt,opencv的库,也是差不多,在cpp文件中引入,对应的写函数编写,切记不要把第三方的头文件引入到你的桥的头文件中,这个肯定不能转换成功
下载点击下面:
示例代码 地址 CpptoCsharp.zip