zxddesk

2022-11-23 11:05

NGINX Sprint China 2022--NGINX 年度旗舰盛会，已开启免费预约！>>>

终于弄清楚 shiboken 怎么用了，可是距离学习使用 Python 调用 C 模块已经过了 10 个月时间。

不管怎样，第一个例子，还是需要完整记录一下，备忘。

(注意：本文只是 windows 下使用 shiboken 的一个尝试，正常使用参考：使用 Shiboken 为 C++ 和 Qt 库创建 Python 绑定 )

生成 C++ 动态库

写个很简单的类：

+-- libfoo/
|      |-- foo.h
|      |-- foo.cpp
|      `-- foo.pro

foo.h 内容如下：

#ifndef FOO_H
#define FOO_H

#if defined _WIN32
    #if LIBFOO_BUILD
        #define LIBFOO_API __declspec(dllexport)
    #else
        #define LIBFOO_API __declspec(dllimport)
    #endif
#else
    #define LIBFOO_API
#endif

class LIBFOO_API Math
{
public:
    Math(){}
    ~Math(){}
    int squared(int x);
};

#endif // FOO_H

foo.cpp 内容如下：

#include "foo.h"

int Math::squared(int x)
{
    return x * x;
}

使用 qmake 来管理工程，对应的 foo.pro 如下

TEMPLATE = lib
TARGET = foo
HEADERS += foo.h
SOURCES += foo.cpp

DEFINES += LIBFOO_BUILD

运行 qmake 和 nmake 生成 foo.lib 和 foo.dll

生成胶水文件

需要准备的文件：

+-- foobinding/
|      |-- global.h
|      `-- typesystem_foo.xml

global.h 包含要提取的接口的头文件

#include "foo.h"

typesystem_foo.xml 包含要提取的信息

<?xml version="1.0"?>
<typesystem package="foo">
    <primitive-type name="int"/>
    <value-type name='Math'/>
</typesystem>

包的名字取为 foo，要导出的类为 Math，类中用到了 int 这一个基本类型。

然后在该目录下运行 shiboken (生成胶水代码)：

shiboken global.h --include-paths=../libfoo typesystem_foo.xml --output-directory=.

由于我们的 foo.h 不在该目录下，故需要指定其所在目录 (--include-paths)。

在当前目录下，最终将生成以下文件：

foo/foo_python.h
foo/foo_module_wrapper.cpp
foo/math_wrapper.h
foo/math_wrapper.cpp

胶水代码生成以后，我们就可以调用编译器进行编译：

编译胶水文件

+-- libfoo/
|      |-- foo.h
|      |-- foo.cpp
|      |-- foo.pro
|      |-- foo.dll
|      `-- foo.lib       
|
+-- foobinding/
|      |-- global.h
|      |-- typesystem_foo.xml
|      |
|      +---foo/
|            |-- foo_python.h 
|            |-- foo_module_wrapper.cpp
|            |-- math_wrapper.h
|            `-- math_wrapper.cpp

首先看看编译这几个胶水文件需要哪些东西：

	头文件路径	库文件
python		python27.lib
shiboken		shiboken-python2.lib
foo		foo.lib

直接调用 MSVC 的编译器进行编译：

cl /EHsc /LD foo/foo_module_wrapper.cpp foo/math_wrapper.cpp /ID:/python27/include /ID:/shiboken/dist/include/shiboken /I../libfoo /Fefoo.pyd  /link /LIBPATH:D:/python27/libs /LIBPATH:D:/shiboken/dist/lib /LIBPATH:../libfoo/release shiboken-python2.7.lib python27.lib foo.lib

生成 foo.pyd

测试

编译一个 Python 程序测试看看：

# -*- coding: utf-8 -*-

import unittest
import foo

class MathTest(unittest.TestCase):
    def testMath(self):
        '''Test case for Math class from foo module.'''
        val = 5
        math = foo.Math()
        self.assertEqual(math.squared(5), 5 * 5)
 
if __name__ == '__main__':
    unittest.main()

恩一切正常。

至此，已经全手动的过了一遍，如果要自动化，看来还是要继续好好学习 cmake 才行。

顺便抱怨一下，PySide 的 shiboken 和 PyQt4 的 sip 相比，易用性还是远远不够

参考

zxddesk

Shiboken 入门练习

Shiboken 入门练习

生成 C++ 动态库

生成胶水文件

编译胶水文件

测试

参考

导航

公告