交叉编译libX11

0 前言    

    本文探索如何将libX11移植到ARM开发板。

1 源码

    从参考资料[1]或这里下载相关源码，本文下载源码为：libX11-1.5.0.tar.bz2。

    新建一个src目录，并且将源码解压到其中：

mkdir src
tar axvf libX11-1.5.0.tar.bz2 -C src

2 配置

    创建一个用于目录作为libX11的安装位置(因为是交叉编译，所以不能使用默认的安装目录，否则会破坏ubuntu系统):

mkdir libX11_install

2.1 环境变量设置

    为了方便配置，可以先设置环境变量(具体值要根据你的目录名和交叉工具链名进行修改)：

export PREFIX=/home/liyihai/downloads/libX11_install
export HOST=arm-arago-linux-gnueabi

    将上述内容保存为env.sh，然后执行以下命令使其生效:

source env.sh

2.2 configure

    进入libX11-1.5.0目录，执行下面命令进行配置

./configure --prefix=$PREFIX --host=$HOST

    配置结果如下：

X11 will be built with the following settings:
 Loadable i18n module support:            no
 Loadable xcursor library support:        yes
 Threading support:                       yes
 Use Threads safe API:                    yes
 Threads stubs in libX11:                 no
 XCMS:                                    yes
 Internationalization support:            yes
 XF86BigFont support:                     no
 XKB support:                             yes
 XLOCALEDIR environment variable support: yes
 Compose table cache enabled:             no
 Functional specs building enabled:       yes

2.2.1 拓展

    后来在配置libX11-1.6.12时遇到下面错误

    可通过--cache-file参数解决上述错误[7][8]：

echo "xorg_cv_malloc0_returns_null=yes" > arm-linux.cache

./configure --prefix=$PREFIX --host=$HOST --cache-file=arm-linux.cache

3 编译

    配置好后，就可可以执行以下命令进行编译

make

3.1 X11/X.h: No such file or directory

    在移植过程中，遇到各种各样的错误是难免的，关键是找到问题的所在，从而解决它。下面是进行编译时遇到的第一个错误：

make[3]: Entering directory `/home/liyihai/downloads/src/libX11-1.5.0/modules/im/ximcp'
  CC     imCallbk.lo
In file included from ../../../include/X11/Xlibint.h:41:0,
                 from imCallbk.c:38:
../../../include/X11/Xlib.h:44:19: fatal error: X11/X.h: No such file or directory
compilation terminated.
make[3]: *** [imCallbk.lo] Error 1

    下载xproto-7.0.23.tar.bz2（可到这里下载更新版本），然后将其加压到上面创建的src目录中，进入xproto-7.0.23目录，执行以下命令来配置和安装xproto。

./configure --prefix=$PREFIX --host=$HOST
make
make install

    这时，上面创建的libX11_install目录中就多了一些目录(inclue、lib、share)和其它相关文件，其中include/X11目录包含了X.h文件。

    然而，就算有了X.h头文件，在编译过程中编译工具也不会自动找到它。其实，使用find命令可以找到ubuntu的/usr/include/X11中是存在X.h这头文件的。现在是交叉编译，交叉编译工具不会自动的到/usr/include目录中去寻找头文件，当然也不会到libX11_install/include这个用户自己创建的目录去找，除非用户指定。

    然而，由于Makefile的内容太多，而且非常复杂，直接修改其中的includedir变量时，发现无济于事。这时，唯一的办法就是指定PKG_CONFIG_PATH环境变量(原因请看《pkg-config》)。

    将2.1中的环境变量添加“export PKG_CONFIG_PATH=$PREFIX/lib/pkgconfig”：

export PREFIX=/home/liyihai/downloads/libX11_install
export HOST=arm-arago-linux-gnueabi
export PKG_CONFIG_PATH=$PREFIX/lib/pkgconfig  # 新增

   然后再次source env.sh使其生效，然后按照2.2小节的方法重新配置libX11，然后再次编译即可。

3.2 X11/Xtrans/Xtrans.h: No such file or directory

    下载xtrans-1.2.7.tar.bz2（可到这里下载最新版本），解压到src目录中，然后使用3.1同样的方法配置和安装xtrans。

    然后，继续编译libX11即可解决此问题。

3.3 X11/extensions/XKBproto.h: No such file or directory

    下载kbproto-1.0.6.tar.bz2，解压到src目录中，然后使用3.1同样的方法配置和安装xbproto。

    然后，继续编译libX11即可解决此问题。

3.4 X11/extensions/XI.h: No such file or directory

    下载inputproto-2.2.tar.bz2，解压到src目录中，然后使用3.1同样的方法安配置和安装inputproto。

    然后，继续编译libX11即可解决此问题。

3.5 xcb/xcb.h: No such file or directory

    下载libxcb-1.8.1.tar.bz2（可到这里下载更新版本），解压到src目录中，然后使用3.1同样的方法配置和安装libxcb。在配置libxcb的过程中，会出现以下错误

（1）configure: error: XCB requires xsltproc.

    那是因为ubuntu中没有xsltproc这个工具导致的可以使用下面命令安装一个：

sudo apt-get install xsltproc

（2）No package 'xcb-proto' found

    Ubuntu PC需要安装：

sudo apt-get install xcb-proto

    此外，需要交叉编译：

    下载xcb-proto-1.7.1.tar.bz2（可到这里下载更新版本），解压到src目录中，然后使用3.1同样的方法配置和安装xcb-proto。

（3）X11/Xauth.h: No such file or directory

     下载libXau-1.0.7.tar.bz2，然后使用3.1同样的方法配置和安装libXau。

（4）cannot find -lXau

    由于已经完成了libXau的安装，因此libXau.so库已经存在libX11_install/lib目录中。这时编译器却找不到它。因此需要指定库的路径。在env.sh中添加LD_LIBRARY_PATH设置，如下所示：

export PREFIX=/home/liyihai/downloads/libX11_install
export HOST=arm-arago-linux-gnueabi
export LD_LIBRARY_PATH=$PREFIX/lib
export PKG_CONFIG_PATH=$PREFIX/lib/pkgconfig

    执行source env.sh命令使其生效。

    继续编译libxcb，这时没有新的错误。编译成功后make install安装即可。

3.6 X11/extensions/xf86bigfproto.h: No such file or directory

     后来交叉编译libX11-1.6.12时遇到该错误，下载xorgproto-2020.1.tar.bz2（可到这里下载更新版本），解压，然后使用3.1同样的方法配置和安装即可。

wget https://xorg.freedesktop.org/archive/individual/proto/xorgproto-2020.1.tar.bz2

4 安装

    安装libX11是最省事的，直接执行以下命令即可。

make install

5 总结

    本文只是编译了libX11最基本的功和模块，还有其它模块没有包含在内。参考资料[4]的X11移植部分，就涉及了许多其它模块的下载和编译，本人觉得这过于复杂，因此自己总结出这篇文章，探索了libX11的基本安装过程。

   本文所有的源码都是从参考资料[1]处下载的。如果读者觉得在里面找起来不便，可以直接点击本文中各源码包的名字，可以跳转到我上传到csdn中的源码的下载页面。

参考资料

[1]X Window System Version 11 Release 7.7

[2]编译TinyX（安装移植X Window）

[3]TinyX的交叉编译 

[4]arm上tinyx的编译

[5]tinyX+GTK+2.0forarm

[6]交叉编译libxcb与X11

[7]configure:checking whether malloc(0) returns NULL

[8]编译libX11-1.6.10出现checking whether malloc(0) returns NULL... configure: error错误解决方法