交叉编译 python

下载、解压 python 源代码

从 python.org 下载。

导入交叉编译 patch

参考自 python-2.7-001-support-for-build.patch,2.7.11 的修改地方有稍微变化,详见如下 patch。

Python 虽然使用 autoconf,但是事实上代码中已经包含 configure 文件,因此下文代码给出的是修改 configure.ac 并执行 autoconf 后生成的 configure 文件。

patch 的使用方法,在 python 源代码根目录下执行:

1
patch -p1 < ../0001-cross-compile.patch

python 2.7.11 交叉编译 patch:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
diff --git a/Makefile.pre.in b/Makefile.pre.in
index ee73edd..730db7e 100644
--- a/Makefile.pre.in
+++ b/Makefile.pre.in
@@ -237,7 +237,8 @@ LIBFFI_INCLUDEDIR= @LIBFFI_INCLUDEDIR@

##########################################################################
# Parser
-PGEN= Parser/pgen$(EXE)
+BUILDPGEN= Parser/pgen$(EXE)
+PGEN_FOR_BUILD= @PGEN_FOR_BUILD@

PSRCS= \
Parser/acceler.c \
@@ -635,14 +636,14 @@ Modules/pwdmodule.o: $(srcdir)/Modules/pwdmodule.c $(srcdir)/Modules/posixmodule

$(GRAMMAR_H): $(GRAMMAR_INPUT) $(PGENSRCS)
@$(MKDIR_P) Include
- $(MAKE) $(PGEN)
- $(PGEN) $(GRAMMAR_INPUT) $(GRAMMAR_H) $(GRAMMAR_C)
+ $(MAKE) $(BUILDPGEN)
+ $(PGEN_FOR_BUILD) $(GRAMMAR_INPUT) $(GRAMMAR_H) $(GRAMMAR_C)
$(GRAMMAR_C): $(GRAMMAR_H) $(GRAMMAR_INPUT) $(PGENSRCS)
$(MAKE) $(GRAMMAR_H)
touch $(GRAMMAR_C)

-$(PGEN): $(PGENOBJS)
- $(CC) $(OPT) $(LDFLAGS) $(PGENOBJS) $(LIBS) -o $(PGEN)
+$(BUILDPGEN): $(PGENOBJS)
+ $(CC) $(OPT) $(LDFLAGS) $(PGENOBJS) $(LIBS) -o $(BUILDPGEN)

Parser/grammar.o: $(srcdir)/Parser/grammar.c \
$(srcdir)/Include/token.h \
diff --git a/configure b/configure
index 7dab897..bf16c0e 100755
--- a/configure
+++ b/configure
@@ -734,6 +734,7 @@ UNIVERSALSDK
CONFIG_ARGS
SOVERSION
VERSION
+PGEN_FOR_BUILD
PYTHON_FOR_BUILD
host_os
host_vendor
@@ -2911,6 +2912,13 @@ else
fi


+if test "$cross_compiling" = yes; then
+ PGEN_FOR_BUILD="${PGEN_FOR_BUILD}"
+else
+ PGEN_FOR_BUILD='$(BUILDPGEN)'
+fi
+
+

if test "$prefix" != "/"; then
prefix=`echo "$prefix" | sed -e 's/\/$//g'`
@@ -6334,6 +6342,12 @@ fi


# Enable PGO flags.
+
+
+
+
+
+
# Extract the first word of "llvm-profdata", so it can be a program name with args.
set dummy llvm-profdata; ac_word=$2
{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
--
1.9.1

创建 build 目录

在 python 源代码下创建 build-pcbuild-mips 目录,分别用于编译 PC pgen(交叉编译时用到)与交叉编译 mips python。该目录做 configure、make、make install,编译时用于保存临时生成的文件,保证 python 源代码干净。

编译本地 Python 与 pgen

用于生成 grammar 所需要文件用。

1
2
3
4
5
cd build-pc

../configure CC=gcc CXX=g++ AR=ar RANLIB=ranlib LDFLAGS="-L/usr/lib -L/usr/lib64 -L/usr/local/lib -L/usr/local/lib64" CFLAGS="-I/usr/include -I/usr/local/include"

make python Parser/pgen

配置

配置交叉编译环境变量

比如 CC、CFLAGS、LDFLAGS 等。

configure 配置

配置命令如下:
configure 的 prefix 只支持绝对路径。

1
2
3
cd build-mips

../configure --host=mips64-octeon-linux-gnu --build=x86_64-linux-gnu --prefix=/home/sunyongfeng/python-install --disable-ipv6 ac_cv_file__dev_ptmx=no ac_cv_file__dev_ptc=no ac_cv_have_long_long_format=yes PGEN_FOR_BUILD=../build-pc/Parse/pgen

问题:

  • --enable-FEATURE,不清楚有哪些 features ,怎么配置;
  • --enable-PACKAGE,不清楚有哪些 package,怎么配置。

配置完了之后,在 Modules 目录会生成 Setup 文件。x86 的默认编译会编译到必须的模块,而 mips64 的交叉编译很多模块没有编译下,如 socket 等。修改 Modules/Setup 文件,定制想编译的内置模块。以下是基础模块,目前还不清楚如果不想内置的话要如何编译。
定制内置模块,参见这篇博文 《定制 Python 嵌入 C++: (四) 定制 Python 内建模块》,讲述各个内置模块的功能。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
# Modules that should always be present (non UNIX dependent):                                       

array arraymodule.c # array objects
cmath cmathmodule.c _math.c # -lm # complex math library functions
math mathmodule.c _math.c # -lm # math library functions, e.g. sin()
_struct _struct.c # binary structure packing/unpacking
time timemodule.c # -lm # time operations and variables
operator operator.c # operator.add() and similar goodies
_testcapi _testcapimodule.c # Python C API test module
_random _randommodule.c # Random number generator
_collections _collectionsmodule.c # Container types
_heapq _heapqmodule.c # Heapq type
itertools itertoolsmodule.c # Functions creating iterators for efficient looping
strop stropmodule.c # String manipulations
_functools _functoolsmodule.c # Tools for working with functions and callable objects
_elementtree -I$(srcdir)/Modules/expat -DHAVE_EXPAT_CONFIG_H -DUSE_PYEXPAT_CAPI _elementtree.c # elementtree accelerator
#_pickle _pickle.c # pickle accelerator
datetime datetimemodule.c # date/time type
_bisect _bisectmodule.c # Bisection algorithms

unicodedata unicodedata.c # static Unicode character database

编译

简单的 make 命令即可。

安装

命令 make install -i,安装 binlibshareman 等目录至 ./configure 中配置的 prefix 目录。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
sunyongfeng@R04220:~/python-install$ ls
bin include lib share
sunyongfeng@R04220:~/python-install$ ls -al *
bin:
总用量 9612
drwxr-xr-x 2 sunyongfeng sunyongfeng 4096 5月 13 16:51 .
drwxr-xr-x 6 sunyongfeng sunyongfeng 4096 5月 15 10:58 ..
-rwxrwxr-x 1 sunyongfeng sunyongfeng 123 5月 13 16:38 2to3
-rwxrwxr-x 1 sunyongfeng sunyongfeng 121 5月 13 16:38 idle
-rwxrwxr-x 1 sunyongfeng sunyongfeng 106 5月 13 16:38 pydoc
lrwxrwxrwx 1 sunyongfeng sunyongfeng 7 5月 13 16:51 python -> python2
lrwxrwxrwx 1 sunyongfeng sunyongfeng 9 5月 13 16:51 python2 -> python2.7
-rwxr-xr-x 1 sunyongfeng sunyongfeng 9793952 5月 13 16:51 python2.7
-rwxr-xr-x 1 sunyongfeng sunyongfeng 1709 5月 13 16:51 python2.7-config
lrwxrwxrwx 1 sunyongfeng sunyongfeng 16 5月 13 16:51 python2-config -> python2.7-config
lrwxrwxrwx 1 sunyongfeng sunyongfeng 14 5月 13 16:51 python-config -> python2-config
-rwxrwxr-x 1 sunyongfeng sunyongfeng 18569 5月 13 16:38 smtpd.py

include:
总用量 12
drwxr-xr-x 3 sunyongfeng sunyongfeng 4096 5月 13 16:51 .
drwxr-xr-x 6 sunyongfeng sunyongfeng 4096 5月 15 10:58 ..
drwxr-xr-x 2 sunyongfeng sunyongfeng 4096 5月 13 16:51 python2.7

lib:
总用量 16312
drwxr-xr-x 4 sunyongfeng sunyongfeng 4096 5月 13 16:51 .
drwxr-xr-x 6 sunyongfeng sunyongfeng 4096 5月 15 10:58 ..
-r-xr-xr-x 1 sunyongfeng sunyongfeng 16670684 5月 13 16:51 libpython2.7.a
drwxr-xr-x 2 sunyongfeng sunyongfeng 4096 5月 13 16:51 pkgconfig
drwxr-xr-x 28 sunyongfeng sunyongfeng 20480 5月 13 16:51 python2.7

share:
总用量 12
drwxr-xr-x 3 sunyongfeng sunyongfeng 4096 5月 13 16:51 .
drwxr-xr-x 6 sunyongfeng sunyongfeng 4096 5月 15 10:58 ..
drwxr-xr-x 3 sunyongfeng sunyongfeng 4096 5月 13 16:51 man
sunyongfeng@R04220:~/python-install$

打包放到目标机上,配置目标机的 PATH,加上 python 的 bin 目录。

问题

编译依赖

交叉编译的时候,如果没有配置好 CFLAGS、LDFLAGS 之类的变量,可能找不到 python 编译所依赖的头文件或库文件。最终体现在编译的结果(此处可能因不同的变量配置而不同):

1
2
3
4
5
6
7
8
Python build finished, but the necessary bits to build these modules were not found:
_bsddb _curses _curses_panel
_sqlite3 _ssl _tkinter
bsddb185 bz2 dbm
dl gdbm imageop
linuxaudiodev ossaudiodev readline
sunaudiodev zlib
To find the necessary bits, look in setup.py in detect_modules() for the module's name.
  • sqlite3 依赖配置
    修改 python 源码根目录下的 setup.py 文件,在 detect_modules 函数下,找到 sqlite3 的头文件配置,添加上交叉编译下的 sqlite3 头文件目录。

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    sqlite_inc_paths = [ '/usr/include',                                                        
    '/usr/include/sqlite',
    '/usr/include/sqlite3',
    '/usr/local/include',
    '/usr/local/include/sqlite',
    '/usr/local/include/sqlite3',
    ]
    if cross_compiling:
    sqlite_inc_paths = [ '/home/sunyongfeng/workshop/prj/images/header/',
    '/home/sunyongfeng/workshop/prj/images/header/sqlite',
    '/home/sunyongfeng/workshop/prj/images/header/sqlite3',
    ]
  • ssl 依赖配置
    类似 sqlite3,在 setup.py 文件的 detect_modules 函数下,找到 ssl 相关的头文件与库文件配置,添加上交叉编译下的 ssl 头文件与库文件目录。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
# Detect SSL support for the socket module (via _ssl)                                       
search_for_ssl_incs_in = [
'/usr/local/ssl/include',
'/usr/contrib/ssl/include/',
'/home/sunyongfeng/workshop/prj/images/header/',
]
ssl_incs = find_file('openssl/ssl.h', inc_dirs,
search_for_ssl_incs_in
)
if ssl_incs is not None:
krb5_h = find_file('krb5.h', inc_dirs,
['/usr/kerberos/include'])
if krb5_h:
ssl_incs += krb5_h
ssl_libs = find_library_file(self.compiler, 'ssl',lib_dirs,
['/usr/local/ssl/lib',
'/usr/contrib/ssl/lib/',
'/home/sunyongfeng/workshop/prj/images/rootfs/lib64'
] )
  • ncurses

    维基百科 ncurses(new curses)是一个程序库,它提供了API,可以允许程序员编写独立于终端的基于文本的用户界面。它是一个虚拟终端中的“类GUI”应用软件工具箱。它还优化了屏幕刷新方法,以减少使用远程shell时遇到的延迟。

  • readline
    如果 readline 模块编译失败,会导致退格键、方向键等不可用。下面错误中”^”位置是退格键。
    交叉编译 python 前需要先编译好 libreadline ,并将头文件和库文件放到默认可索引到的路径。

1
2
3
4
5
6
>>> print "abc"
File "<stdin>", line 1
print "abc"
^
SyntaxError: invalid syntax
>>>

环境变量

目前还不清楚为何 export $PATH 后,运行 python 命令找不到 python lib 库,而且找不到 site 模块。而使用绝对路径访问 python 没有问题。

1
2
3
4
5
6
7
8
9
10
11
/tmp/bin # python
Could not find platform independent libraries <prefix>
Could not find platform dependent libraries <exec_prefix>
Consider setting $PYTHONHOME to <prefix>[:<exec_prefix>]
ImportError: No module named site

/tmp/bin # /tmp/bin/python
Python 2.7.11 (default, May 16 2016, 17:11:59)
[GCC 4.3.3] on linux2
Type "help", "copyright", "credits" or "license" for more information.
>>>

通过配置环境变量解决:

1
2
3
export PYTHONHOME=/usr/lib/python2.7
export PYTHONPATH=.:$PYTHONHOME:$PYTHONHOME/site-packages
export PATH=$PATH:$PYTHONHOME:$PYTHONPATH

裁剪考虑

  • lib/libpython2.7.a, 16M
  • lib/test, 30M

附一:Python 内建模块功能说明

直接引自 定制 Python 嵌入 C++: (四) 定制 Python 内建模块,内容可能已过时,不过有参考价值。

  1. array (Modules/arraymodule.c) (http://docs.python.org/library/array.html) 一个可以存放基本类型的高效数组, 提供了和序列类似的操作. 使用放法类似于 a = array.array(‘b’, [10, 20, 30]), 不常使用, 可以考虑去除.
  2. _ast (Python/Python-ast.c) (http://docs.python.org/library/ast.html) 抽象语法树, 供 Python 程序解析处理 Python 语法相关的库, 这个模块的源代码是由脚本自动生成的. 由于 Python-ast.c 本身还会被解释器的其它地方引用, 不能删除, 所以, 如果是为了压缩解释器大小, 保留这个库也没关系. 如果是为了定制 python 的功能, 也可以屏蔽这个库, 但是源代码需要保留, 不能从工程中删掉.
  3. audioop (Modules/audioop.c) (http://docs.python.org/library/audioop.html) 一个音频处理的库, 仅 Win32 平台有效.
  4. binascii (Modules/binascii.c) (http://docs.python.org/library/binascii.html) 提供二进制和 ASCII 码的转换, 会被 uu, base64, binhex 这些库引用. 建议保留.
  5. cmath (Modules/cmathmodule.c) (http://docs.python.org/library/cmath.html) 提供复数操作的函数
  6. errno (Modules/errnomodule.c) (http://docs.python.org/library/errno.html) 提供标准的错误码定义, 在很多地方中都会使用, 需要保留.
  7. future_builtins (Modules/future_builtins.c) (http://docs.python.org/library/future_builtins.html) 对那些在 Python2.x 和 Python3 中都有但是意义不一样的函数提供的包装. 使用这里面的函数可以保证调用了正确的版本的函数.
  8. gc (Modules/gcmodule.c) (http://docs.python.org/library/gc.html) Python 的垃圾收集接口. 当然保留.
  9. imageop (Modules/imageop.c) (http://docs.python.org/library/imageop.html) 一些图像处理的函数.
  10. math (Modules/mathmodule.c) (http://docs.python.org/library/math.html) 提供了 C 标准库中的那些数学函数.
  11. _md5 (Modules/md5module.c) 提供了 MD5 算法.
  12. nt (Modules/posixmodule.c) 一些操作系统习惯的函数, 比如打开文件等等.
  13. operator (Modules/operator.c) (http://docs.python.org/library/operator.html) 提供了操作符的等价函数
  14. signal (Modules/signalmodule.c) (http://docs.python.org/library/signal.html) 信号机制, 提供异步事件的回调.
  15. _sha, _sha256, _sha512 三种 SHA 的加密算法模块.
  16. strop (Modules/stropmodule.c) 提供了一些优化的字符串操作.
    17.time (Modules/timemodule.c) (http://docs.python.org/library/time.html) 时间操作库.
  17. thread (Modules/threadmodule.c) Python 线程的底层模块, threading 会使用 thread 库.
  18. cStringIO (Modules/cStringIO.c) (http://docs.python.org/library/stringio.html) StringIO 的高效版本.
  19. cPickle (Modules/cPickle.c) (http://docs.python.org/library/pickle.html) Python 的序列化模块.
  20. msvcrt (PC/msvcrtmodule.c) (http://docs.python.org/library/msvcrt.html) VC 运行时库的包装, 包括一些文件和屏幕操作函数.
  21. _locale (Modules/_localemodule.c) 提供本地化支持的模块.
  22. _subprocess (PC/_subprocess.c) (http://docs.python.org/library/subprocess.html) 操作子进程的库, 平台相关的.
  23. _codecs (Modules/_codecsmodule.c) (http://docs.python.org/library/codecs.html) 定义了 Python 的编码器相关接口.
  24. _weakref (Modules/_weakref.c) (http://docs.python.org/library/weakref.html) 创建对象的弱引用.
  25. _hotshot (Modules/_hotshot.c) (http://docs.python.org/library/hotshot.html) 类似于 Profiler 模块, 而且将来可能被移除, 现在把它去掉也不错.
  26. _random (Modules/_randommodule.c) 随机数模块.
  27. _bisect (Modules/_bisectmodule.c) (http://docs.python.org/library/bisect.html) 一个基于二分算法, 可以让插入一个数据岛排序的序列后序列仍然有序的库.
  28. _heapq (Modules/_heapqmodule.c) (http://docs.python.org/library/heapq.html) 实现堆栈数据结构算法的库.
  29. _lsprof (Modules/_lsprof.c) (http://docs.python.org/library/profile.html) Profiler 模块, 统计程序执行的性能.
  30. itertools (Modules/itertoolsmodule.c) (http://docs.python.org/library/itertools.html) 一些迭代器操作的模块.
  31. _collections (Modules/_collectionsmodule.c) (http://docs.python.org/library/collections.html) 提供了几个高级的容器类.
  32. _symtable (Modules/symtablemodule.c) (http://docs.python.org/library/symtable.html) 符号表管理模块.
  33. mmap (Modules/mmapmodule.c) (http://docs.python.org/library/mmap.html) 文件内存映射支持模块.
  34. _csv (Modules/_csv.c) (http://docs.python.org/library/csv.html) 为 CSV 模块的内部支持. CSV 模块提供了读写 CSV 文件的功能.
  35. _sre (Modules/_sre.c) 正则表达式的匹配引擎.
  36. parser (Modules/parsermodule.c) (http://docs.python.org/library/parser.html) 操作 Python 语法树的模块.
  37. _winreg (PC/_winreg.c) Windows 注册表操作模块.
  38. _struct (Modules/_struct.c) 提供在 Python 和 C 之间转换数据类型的功能.
  39. datetime (Modules/datetimemodule.c) (http://docs.python.org/library/datetime.html) 日期时间操作函数.
  40. _functools (Modules/_functoolsmodule.c) (http://docs.python.org/library/functools.html) 函数相关操作模块.
  41. _json (Modules/_json.c) (http://docs.python.org/library/json.html) JSON 数据格式操作模块.
  42. xxsubtype (Modules/xxsubtype.c) 这是一个测试相关的模块. 运行 test_descr.py 时会用到.
  43. zipimport (Modules/zipimport.c) 这个模块主要用于从 zip 文件中导入 Python 的模块.
  44. zlib (Modules/zlibmodule.c) 这个模块提供了 zip 压缩和解压功能, 基于 GNU zip 实现.
  45. _multibytecodec, _codecs_cn, _codecs_hk, _codecs_iso2022, _codecs_jp, _codecs_kr, _codecs_tw (Modules/cjkcodecs/*) 这些模块提供了 CJK(中日韩统一表意文字) 的编码和解码. 去掉这部分可以减小 python 解释器 600 多 K.
  46. marshal (Python/marshal.c) (http://docs.python.org/library/marshal.html) 为 Python 对象提供序列化的模块.
  47. imp (Python/import.c) (http://docs.python.org/library/imp.html) 这个模块提供了 Python 里的 import 语句的实现.
  48. main, builtin, sys, exceptions, _warnings 这部分模块在 config.c 设置里只是一个名字占位符.
  49. _io (Modules/_iomodule.c) (http://docs.python.org/library/io.html) 新版本的 Python 输入输出模块, 在 Python 3 中为默认的输入输出处理方法.

附二:Python 最佳编译依赖

直接译自 Python Deployment

键入如下命令自动安装一些依赖:

1
$ sudo apt-get build-dep python2.7

确认安装如下列下的其他 -dev 包。

  • python-dev
  • libncurses5-dev
  • libsqlite3-dev
  • libbz2-dev
  • libreadline-dev
  • libdb4.8-dev
  • tcl8.5-dev,tk8.5-dev

下面这个包在 ubuntu 早期版本(如 10.04)并没有自动安装,需确认一下。

  • libssl-dev
  • libexpat1-dev
  • libreadline6-dev
  • libgtk2.0-dev

如果想支持 xml 相关:

  • libxml2-dev
  • libxslt1-dev

如果想支持 MySQLdb (在 pypi 中实际命令为 MySQL-python):

  • libmysqlclient-dev

最终的 make 结果(编译结果)如能如下:

1
2
3
4
Python build finished, but the necessary bits to build these modules were not found:
_tkinter bsddb185 dl
gdbm imageop sunaudiodev
To find the necessary bits, look in setup.py in detect_modules() for the module's name.

这个编译 log 提示哪些模块没有被编译到,注意其中有一些并不是必需的或过时的:

  • bsddb185: Older version of Oracle Berkeley DB. Undocumented. Install version 4.8 instead.
  • dl: For 32-bit machines. Deprecated. Use ctypes instead.
  • imageop: For 32-bit machines. Deprecated. Use PIL instead.
  • sunaudiodev: For Sun hardware. Deprecated.
  • _tkinter: For tkinter graphy library, unnecessary if you don’t develop tkinter programs.

参考文献