1 适用范围

本文档适用于希望使用基于SylixOS进行Python扩展库开发的用户。

2 SylixOS Python简介

Python是一门面向对象的解释型的脚本语言，Python具有丰富和强大的库。它常被昵称为胶水语言，能够把用其他语言制作的各种模块（尤其是C/C++）很轻松地联结在一起。常见的一种应用情形是，使用Python快速生成程序的原型（有时甚至是程序的最终界面），然后对其中有特别要求的部分，用更合适的语言改写，比如3D游戏中的图形渲染模块，性能要求特别高，就可以用C/C++重写，而后封装为Python可以调用的扩展类库。

目前SylixOS支持的Python为3.6.4版本，支持绝大多数内建库，但并未移植扩展库。

3 SylixOS Python扩展库开发

可扩展性是Python的一大特色，Python的扩展库可以基于Python语言开发，也可通过C、JAVA等语言进行开发。

本文将介绍如何使用RealEvo-IDE开发C语言版本的SylixOS Python扩展库。C语言版本Python扩展库开发有以下两种方式。

3.1 基于python ctypes模块开发

SylixOS下的Python支持ctypes内建模块。此模块的CDLL方法会调用SylixOS操作系统的dlopen()函数，从而导入用户开发的C/C++动态库。

编写简单的动态库lib_demo，代码如程序清单 3.1所示。

程序清单 3.1 动态库demo

#include <stdio.h>

void lib_func (void)

{

printf("lib_func call!\n");

}

void hello (void)

{

printf("Hello SylixOS!\n");

}

int fact(int n)

{

if (n <= 1)

return 1;

else

return n * fact(n - 1);

}

将lib_demo编译上传至目标设备中。新建一个Python脚本test.py，使用VI编辑器编辑python脚本，内容如下：

import ctypes

demo=ctypes.CDLL("/lib/lib_demo.so")

print("-------------")

demo.lib_func()

print("-------------")

demo.hello()

print("-------------")

print(demo.fact(10))

print("-------------")

保存后执行“python test.py”，结果如图 3.1 所示。

图 3.1 python脚本执行结果

脚本执行结果显示，动态库内的函数被成功调用。

3.2 基于Python扩展库模板开发

除了使用ctypes直接导入SylixOS动态库外，python本身也提供自定义扩展库的模板。通过模板封装的C/C++动态库，可以直接使用python的“import”方法导入模块。

依然以lib_demo为例，首先需要添加所需头文件的路径。头文件在SylixOS的/lib/python3/include目录下提供，可自行拷贝至开发的动态库目录下。环境配置（以实际环境为准）如图 3.2 所示。

图 3.2 选择动态库头文件路径

接着封装动态库，主要分为4步：

a、包含Python头文件；

添加头文件：#include <Python.h>

b、利用样板来包装函数；

将lib_demo中的fact()函数封装如下（并非修改原函数，而是添加封装函数）

static PyObject *lib_demo_fact(PyObject *self,PyObject *args) {

int num;

if(!(PyArg_ParseTuple(args,"i",&num))) {       //获取Python传递的参数

return NULL;

}

return (PyObject*)Py_BuildValue("i",fact(num));

//将结果转换为Python类型并返回

}

c、为每个模块增加PyMethodDef ModuleMethods[]数组；

static PyMethodDef lib_demoMethods [] = {

{"fact",lib_demo_fact,METH_VARARGS},            //函数名，包装函数名，解析

{"hello",lib_demo_hello,METH_NOARGS},

{"lib_func",lib_demo_lib_func,METH_NOARGS},

{NULL,NULL},                                         //作为结束

};

d、编写初始化函数。

static struct PyModuleDef lib_demoModule = {

PyModuleDef_HEAD_INIT,     //默认

"lib_demo",                  //模块名

NULL,

-1,

lib_demoMethods             //上面的数组

};

PyMODINIT_FUNC

PyInit_lib_demo(void)

{

return  PyModule_Create(&lib_demoModule);

}

封装完成后的lib_demo如程序清单 3.2 所示。

程序清单 3.2 封装完成的lib_demo

#include <Python.h>

#include <stdio.h>

int lib_func (void)

{

printf("lib_func call!\n");

return 0;

}

int hello (void)

{

printf("Hello SylixOS!\n");

return 0;

}

int fact(int n)

{

if (n <= 1)

return 1;

else

return n * fact(n - 1);

}

static PyObject *lib_demo_fact(PyObject *self,PyObject *args) {

int num;

if(!(PyArg_ParseTuple(args,"i",&num))) {                  //获取Python传递的参数

return NULL;

}

return (PyObject*)Py_BuildValue("i",fact(num));           //将结果转换为Python类型并返回

}

static PyObject *lib_demo_hello(PyObject *self,PyObject *args) {

return (PyObject*)Py_BuildValue("i",hello());

}

static PyObject *lib_demo_lib_func(PyObject *self,PyObject *args) {

return (PyObject*)Py_BuildValue("i",lib_func());

}

static PyMethodDef lib_demoMethods[] = {

{"fact",lib_demo_fact,METH_VARARGS},//函数名，包装函数名，解析

{"hello",lib_demo_hello,METH_NOARGS},

{"lib_func",lib_demo_lib_func,METH_NOARGS},

{NULL,NULL},//作为结束

};

static struct PyModuleDef lib_demoModule = {

PyModuleDef_HEAD_INIT,     //默认

"lib_demo",                //模块名

NULL,

-1,

lib_demoMethods            //上面的数组

};

PyMODINIT_FUNC

PyInit_lib_demo(void)

{

return  PyModule_Create(&lib_demoModule);

}

将编译完成后的lib_demo.so上传至目标设备的/lib/python3/lib/python3.6/lib-dynload目录下。创建并编辑python脚本test2.py，内容如下。

import lib_demo as demo

print("-------------")

demo.lib_func()

print("-------------")

demo.hello()

print("-------------")

print(demo.fact(10))

print("-------------")

保存后执行“python test2.py”，输出结果如图 3.3 所示。

图 3.3 test2脚本执行结果

脚本运行结果显示，lib_demo模块能被成功导入。