happyll / ndk-python Goto Github PK

[前言]
网上有一些ndk编译python的做法，但按照教程做总是不成功，可能是环境版本不一样，导致很多地方的配置都不成功。
网上的大多是python-2.x的编译方法，由于我没有3.x的环境，所以没有真正测试，但我的方法应该可以胜任3.x的移植。
网上的教程大多只有做法，没有解释，这篇教程加上了每一步为什么这么做的解释。
本教程所用的方法涉及底层，目测极其复杂，请慎重阅读。

[制作目的]
不是：编译一个可执行文件Python.exe
而是：把python源文件编译成静态库，用在项目里面，简化一些cpp不容易处理的问题，比如xml,json读写等
不是：需要python的所有特性和库
而是：尽可能编译python的标准功能
最终结果：编译出了一个标准库的子集，有一些功能缺失。

[环境配置]
已经安装好的Python环境，假设Python版本号是[py-version]。
下载[py-version]对应的源码，因为跨平台编译需要用到PC上的Python解释器，所以源码和环境的版本号一定要对应。
NDK环境，已经配置好环境变量。

[我的配置]
PC:Apple-10.9.5, Python-2.7.5
源码:Python-2.7.5

[制作过程]
*新建一个ndk工程(ndk-python)
	目录结构为:	ndk-python|jni(文件夹，存放Android.mk和Application.mk文件)
				ndk-python|src(文件夹，存放要编译的源码)
*将要编译的python-2.7.5源码拷贝到ndk工程
	cp Python-2.7.5/Python ndk-python/src; Python目录是python的语法核心
	cp Python-2.7.5/Objects ndk-python/src; Objects目录是python的核心对象
	cp Python-2.7.5/Parser ndk-python/src; Parser目录是语法解释器
	cp Python-2.7.5/Modules ndk-python/src; Modules目录是标准库的一部分
	cp Python-2.7.5/Include ndk-python/src; Include目录包含了所有的头文件
*生成pyconfig.h
	pyconfig.h是python用来支持跨平台编译的文件，每个平台都不一样，需要自己用configure脚本生成
	把gen-config.h.sh拷贝到Python-2.7.5目录里面，执行。
	正确执行后，会生成一个pyconfig.h的文件。
	把pyconfig.h拷贝到ndk-python/src/Include
	准备工作结束
*编写Application.mk
	APP_PLATFORM不能用19，android-19有一个语言相关的结构体不正确
	本次编译用的是android-21
*编译并排错
	运行sh compile.sh
	
	错误: pyport.h:886:2:
	原因: pyconfig.h没有正确生成，导致 LONG_BIT!=8*SIZEOF_LONG
	解决: 修改pyconfig.h, 把SIZEOF_LONG的值改成4, 因为ndk的默认值就是4

	错误: 
	原因: ndk中va_list不是array
	解决: 删除pyconfig.h中的#define VA_LIST_IS_ARRAY 1

	错误: dynload_aix.c:11:21 找不到sys/ldr.h
	原因: 这个文件是用来在python中导入aix格式的C库的，由于用不到，所以直接删掉
	解决: 删掉dynload_*.c，这是一系列相同类型的文件

	错误: mactoolboxglue.c:27:0 找不到Carbon/Carbon.h
	原因: 不知道原因，但mactoolboxglue.c看起来没什么用
	解决: 直接删掉mactoolboxglue.c

	错误: pymath.c里面的汇编代码出错
	原因: 不知道，但汇编代码经常是不可移植的，况且这两个函数看起来也没什么用。
	解决: 注释pyconfig.h里面的#define HAVE_GCC_ASM_FOR_X87 1

	错误: pythonrun.c:32:22 找不到langinfo.h
	原因: ndk没有这个文件
	解决: 注释pyconfig.h里面的 #define HAVE_LANGINFO_H 1

	错误: strtod.c errno的定义与ndk冲突
	原因: 不知道
	解决: 删掉strtod.c里面的extern  int     errno;

	错误: multiple definition of 'PyOS_Readline'
	原因: pgenmain多定义了一次
	解决: 删掉pgenmain.c,pgen_tokenizer.c

	错误: 一些链接错误
	原因: 缺少某些Modules文件
	解决: 拷贝gcmodule.c, getbuildinfo.c, 到Modules

	错误: 一些链接错误
	原因: 加载C动态库的功能出错了,由于不需要在python代码里加载C库，所以直接删掉
	解决: 删掉importdl.c, 删掉pyconfig.h里面HAVE_DYNAMIC_LOADING

	错误: 一些链接错误
	原因: 没有python默认加载哪些模块的配置了
	解决: 拷贝config.c到Modules，config.c配置的大多是Modules里面的模块，由于没有编译Modules，所以删掉config.c里面的Modules相关配置

	错误: 目前已经可以正常使用了，但是在测试的时候，发现某些必须的库不能正确加载，所以要编译那些库
	原因: 这些库应该是包含在Modules目录里的
	解决: 编译Modules目录(不含子目录)里面以_开头的文件，删除其中不能编译的(_bsddb,_cursor,_elementtree,_hashopenssl,_ssl,_tkinter,_ctypes,_multiprocessing,_sqlite,expat,zlib)

	错误: 一些链接错误
	原因: 一些必须要有的模块不是以_开头，所以被删掉了
	解决: 把(gcmodule.c,getbuildinfo.c,config.c,等等)模块加到编译列表里面

	错误: Py_Initialize(): no module named site
	原因: site依赖另一个不能编译的模块,所以直接把site去掉算了
	解决: 在pyconfig.h里面define NDK_PY_NO_SITE 1

	错误: 在Android上运行的时候，setdefaultencoding('utf-8')导致崩溃
	原因: pyconfig.h中的类型大小定义出错
	解决: 重新定义一个pyandroidconfig.h,并在Python.h中增加条件编译。

	错误: 
	原因: 
	解决: 

	错误: 一些优化
	原因: src/Objects/stringlib/ctype.h文件名和系统的ctype.h冲突，每次xcode编译的时候都要把它从搜索目录里去掉，索性直接把它换个名字
	解决: ctype.h重命名为ndk_changed_ctype.h，并修改所有include的源码

	错误: 剩下一些警告
	原因: 位操作可能越界，不知道ndk为什么这么提示，大致看了一下，不太可能越界。
	解决: 无法解决。

	编译成功。

[最终结果]
	Modules目录:常用功能编译完成。
	其它目录:除了Python调用C库的方法(dynload_*.c)外，都编译完成。
	
[使用须知]
	这次提取出来的文件，没有zlib相关功能，所以在使用的时候，需要另外把zlib库加进来。如果是cocos项目，由于cocos本身集成了zlib，所以不用管这个问题了。
	实际运行的时候，需要把Python-2.7.5/Lib目录拷贝到一个ndk-python程序可以读取的地方，这个目录也是python标准库的一部分，可以只拷贝其中的一部分