OpenEmbedded 入门 （二）：编译Openmoko的3个版本
Openmoko目前主要有OM2007.2、ASU和FSO三个版本。我在 “Android能用Linux打败Linux手机吗？” 的第3节对这3个版本做过简单介绍。最近我编译过这3个版本，本文是编译过程的简单记录。我在freerunner样机上测试构建的映像，所以构建时硬件平台都选择了om-gta02。
1 准备环境
1.1 安装需要的软件
我的工作环境是WinXP+VMWare+Ubuntu7.10。我去年在这个虚拟机上编译过Openmoko，后来又编译过Poky、Android。我记不清为编译安装过哪些软件。只能根据Openmoko的wiki，列出以下需要安装的软件：
sudo apt-get install subversion build-essential help2man diffstat texi2html texinfo cvs gawk zip unzip \ cogito bzip2 libncurses5-dev zlib1g-dev libssl-dev libgtk2.0-dev ca-certificates python-pysqlite2 \ sqlite3 sqlite3-doc python-pysqlite2-dbg quilt python-psyco ccache gcc-3.4 g++-3.4 libsdl1.2-dev lynx \ git-core libxtst-dev
我的虚拟机上确实已经安装过这些软件。
1.2 使用bash
Ubuntu7.10的shell默认是dash。无论是编译内核还是OE，黑客都会建议我们改用bash。可以先用ls查看当前使用的shell：
$ ls -l /bin/sh
如果指向dash，可以改成bash：
$ sudo rm -f /bin/sh $ sudo ln -s /bin/bash /bin/sh
1.3 资源需求
OE对内存、硬盘的要求都比较高。我的虚拟机设置了1G内存。
我将OE环境的储藏间sources目录单独放在一个20G的虚拟硬盘上。每个OE环境也使用一个20G的虚拟硬盘。在编译成功后，不含sources目录的OE环境大约占用12G左右硬盘。我在编译过Openmoko的3个版本后，sources目录硬盘使用情况如下：
文件系统 1K-块 已用 可用 已用% 挂载点 /dev/sdb1 20635700 3669312 15918152 19% /oe
sources目录目前占用3.5G。我的所有OE环境都用这个sources目录。
第一次编译需要快速的网络连接。如果把sources目录保存下来，重新编译一般不需要网络连接。我曾经在没有网络连接的情况下，完整地编译过Poky。
2 编译FSO
FSO提供了Makefile，按照官方说法，只要下载Makefile，make一下就可以了：
wget http://downloads.freesmartphone.org/Makefile make fso-testing-image
通过阅读Makefile，可以了解构建的流程。我没有直接执行“make fso-testing-image”，而是一边看Makefile，一边逐步执行，以了解发生的事情。我执行的流程如下。
2.1 流程
2.1.1 建立目录下载Makefile
执行：
mkdir -p /poky/fso cd /poky/fso wget http://downloads.freesmartphone.org/Makefile
2.1.2 通过git更新makefile
执行：
make setup-common
目标setup-common的任务如下：
setup-common common/.git/config: [ -e common/.git/config ] || \ ( git clone git://git.freesmartphone.org/fso-makefile.git common && \ rm -f Makefile && \ ln -s common/Makefile Makefile ) touch common/.git/config
从git仓库下载了最新的makefile，放到了./common目录，并在当前目录建立common/Makefile的链接。
2.1.3 通过svn得到bitbake
执行：
make setup-bitbake
目标setup-bitbake的任务如下：
setup-bitbake bitbake/.svn/entries:
[ -e bitbake/.svn/entries ] || \
( svn co svn://svn.berlios.de/bitbake/${BITBAKE_VERSION} bitbake )
touch bitbake/.svn/entries
从svn仓库签出指定版本的bitbake，放在./bitbake目录。
2.1.4 通过git得到OpenEmbedded
执行：
make setup-openembedded
目标setup-openembedded的任务如下：
setup-openembedded openembedded/.git/config: [ -e openembedded/.git/config ] || \ ( git clone git://git.openembedded.net/openembedded openembedded ; \ cd openembedded ; \ git config --add remote.origin.fetch '+refs/heads/*:refs/remotes/*' ) ( cd openembedded && \ ( git branch | egrep -e ' org.openembedded.dev$$' > /dev/null || \ git checkout -b org.openembedded.dev --track origin/org.openembedded.dev )) ( cd openembedded && git checkout org.openembedded.dev ) touch openembedded/.git/config
通过git得到OpenEmbedded元数据，放到./openembedded目录。
2.1.5 准备fso-testing目录
执行：
make setup-fso-testing
目标setup-fso-testing的任务如下：
so-%/.configured: common/.git/config bitbake/.svn/entries openembedded/.git/config [ -d fso-$* ] || ( mkdir -p fso-$* ) [ -e downloads ] || ( mkdir -p downloads ) [ -e fso-$*/Makefile ] || ( cd fso-$* ; ln -sf ../common/openembedded.mk Makefile ) [ -e fso-$*/setup-env ] || ( cd fso-$* ; ln -sf ../common/setup-env . ) [ -e fso-$*/downloads ] || ( cd fso-$* ; ln -sf ../downloads . ) [ -e fso-$*/bitbake ] || ( cd fso-$* ; ln -sf ../bitbake . ) [ -e fso-$*/openembedded ] || ( cd fso-$* ; ln -sf ../openembedded . ) [ -d fso-$*/conf ] || ( mkdir -p fso-$*/conf ) [ -e fso-$*/conf/site.conf ] || ( cd fso-$*/conf ; ln -sf ../../common/conf/site.conf . ) [ -e fso-$*/conf/auto.conf ] || ( \ echo "DISTRO = \"openmoko\"" > fso-$*/conf/auto.conf ; \ echo "MACHINE = \"om-gta02\"" >> fso-$*/conf/auto.conf ; \ echo "IMAGE_TARGET = \"fso-image\"" >> fso-$*/conf/auto.conf ; \ echo "DISTRO_TARGET = \"openmoko-feed\"" >> fso-$*/conf/auto.conf ; \ echo "INHERIT += \"rm_work\"" >> fso-$*/conf/auto.conf ; \ ) [ -e fso-$*/conf/local.conf ] || ( \ echo "# require conf/distro/include/moko-autorev.inc" > fso-$*/conf/local.conf ; \ echo "# require conf/distro/include/fso-autorev.inc" >> fso-$*/conf/local.conf ; \ ) rm -rf fso-$*/tmp/cache touch fso-$*/.configured
这个目标的任务比较长，但很简单。阅读时将“$*”换成“testing”。这个目标建立了./fso-testing和./download目录。在./fso-testing目录，建立以下链接：
lrwxrwxrwx 1 lvjie lvjie 25 2008-11-13 13:11 Makefile -> ../common/openembedded.mk lrwxrwxrwx 1 lvjie lvjie 19 2008-11-13 13:11 setup-env -> ../common/setup-env lrwxrwxrwx 1 lvjie lvjie 12 2008-11-13 13:11 downloads -> ../downloads lrwxrwxrwx 1 lvjie lvjie 10 2008-11-13 13:11 bitbake -> ../bitbake lrwxrwxrwx 1 lvjie lvjie 15 2008-11-13 13:11 openembedded -> ../openembedded
建立./fso-testing/conf目录。建立链接site.conf，创建文件auto.conf和local.conf。
2.1.6 检查fso-testing目录
下面开始执行./common/openembedded.mk里的目标。执行：
cd fso-testing make setup-image-fso-image make setup-machine-om-gta02 make create-topdir make downloads make bitbake make openembedded
这些目标的任务如下：
BUILD_DIRS = downloads REQUIRED_DIRS = bitbake openembedded setup-image-%: ( grep "IMAGE_TARGET = \"$*\"" conf/auto.conf > /dev/null ) || \ sed -i -e 's/^IMAGE_TARGET[[:space:]]*=[[:space:]]*\".*\"/IMAGE_TARGET = \"$*\"/' conf/auto.conf setup-machine-%: ( grep "MACHINE = \"$*\"" conf/auto.conf > /dev/null ) || \ sed -i -e 's/^MACHINE[[:space:]]*=[[:space:]]*\".*\"/MACHINE = \"$*\"/' conf/auto.conf create-topdir: conf/topdir.conf . conf/topdir.conf && test "`pwd`" = "$$TOPDIR" || echo "TOPDIR='`pwd`'" > conf/topdir.conf conf/topdir.conf: echo "TOPDIR='`pwd`'" >$@ $(BUILD_DIRS): test -d $@ || if test -d ../$@; then ln -s ../$@ .; else mkdir $@; fi $(REQUIRED_DIRS): test -d $@ || if test -d ../$@; then ln -s ../$@ .; else exit 1; fi
setup-image-fso-image保证conf/auto.conf中的IMAGE_TARGET是fso-image。setup-machine-om-gta02保证conf/auto.conf中的MACHINE是om-gta02。 create-topdir检查topdir.conf内容是否是上一层目录。downloads、bitbake和openembedded保证这些链接已经建立。
如果直接make映像，下面就要bitbake了。不过，在bitbake前我还想做两点改动。
2.1.7 让download指向自己的代码仓库
执行：
cd .. rm -f downloads ln -s /oe/sources downloads cd fso-testing
我让downloads指向我的代码仓库，这样可以避免重复下载。
2.1.8 去掉rm_work
执行：
sed -i -e /rm_work/d conf/auto.conf
这个命令删除掉conf/auto.conf中包含rm_work的行。读者当然可以用vi直接编辑删除。为了便于表述，我写了一行sed命令。 -i参数表示修改当前文件。-e后面是要执行的脚本。模式/rm_work/定位要操作的行，d命令就是删除。
rm_work命令在每个包编译完成后自动删除工作目录中除temp目录外的其它目录，包括源代码目录。 temp目录里只有构建脚本和日志记录。我编译的目的就是修改、利用源代码，当然要去掉这个命令。
2.1.9 开始bitbake
通过前面的步骤，我们已经建立好构建环境。以后要构建任何东西，只要进入fso-testing目录，source一下脚本setup-env，然后bitbake需要的东西就可以了。例如：我们现在可以执行：
. setup-env bitbake fso-image
就开始构建fso映像了。
2.2 意外
如果不出意外，我们只要等十几个到几十个小时，就可以构建成功了。不过，有时会遇到一些小问题。我在构建FSO映像时就碰到执行qemu-native_svn.bb时do_compile失败。其实，我没打算用qemu仿真。
我删除掉./openembedded/packages/qemu/qemu-native_svn.bb文件，这样bitbake会自动使用qemu-native_0.9.1.bb。编译就可以通过了。最后成功构建了映像。映像在tmp/deploy/glibc/images/neo1973目录。 bitbake在你执行它的目录建立tmp目录。
2.3 运行
刷机、运行，截了几幅图：
图1是zhone的界面，当前zhone的主要功能都是灰的，不能用。图3是我自己安装的FBReader，我可以在路上看看英文文档。图4是待机后解锁的画面，依次按1234解锁。
3 编译ASU
3.1 流程
3.1.1 建立目录下载Makefile
执行：
mkdir -p /poky/moko cd /poky/moko wget http://svn.projects.openmoko.org/svnroot/mokomakefile/trunk/Makefile
3.1.2 建立构建环境
执行：
make setup make setup-machine-om-gta02
用“make setup”可以建立构建环境。setup-machine-om-gta02将local.conf中的MACHINE设为om-gta02：
setup-machine-%: setup-config ( grep "MACHINE = \"$*\"" build/conf/local.conf > /dev/null ) || \ sed -i -e 's/^MACHINE[[:space:]]*=[[:space:]]*\".*\"/MACHINE = \"$*\"/' \ build/conf/local.conf
3.1.3 让sources指向自己的代码仓库
执行：
ln -s /oe/sources sources
让./sources指向自己的代码仓库，可以避免重复下载。
3.1.4 去掉rm_work
执行：
sed -i -e /rm_work/d build/conf/local.conf
去掉local.conf中的rm_work，保留源代码。
3.1.5 开始bitbake
通过前面的步骤，已经建立好构建环境。以后要构建任何东西，只要source一下脚本setup-env，然后在./build目录bitbake需要的东西就可以了。例如：我们现在可以执行：
. setup-env cd build bitbake openmoko-asu-image
就开始构建asu映像。
3.2 意外
又遇到一个小问题。执行illume_svn.bb时do_fetch失败，找不到版本35818。我修改./openembedded/conf/distro/include/sane-srcrevs.inc，将EFL_SRCREV从35818改成36540。FSO映像使用了版本36540。编译就可以通过了。最后成功构建了映像。
3.3 运行
刷机、运行，截了几幅图：
4 编译OM2007.2
4.1 流程
我在构建asu的目录构建OM2007.2版本。环境是现成的，只要执行：
cd /poky/moko . setup-env cd build bitbake openmoko-devel-image
就可以了。因为构建asu时已经构建了工具链和很多软件包，所以这次构建只用了2.5小时，就成功构建了映像，没有发生什么意外。在刚构建过asu时，这块虚拟硬盘用了12G；构建完OM2007.2后，这块虚拟硬盘用了15G。
4.2 运行
刷机、运行，又截了几幅图：
5 结束语
OpenMoko目前的3个版本确实都算不上可用的方案。但通过构建这3个方案，我们可以看到大量已构建的开源方案，也可以从OpenMoko的方案中学习经验或吸取教训。在这3个方案中我最期待的就是FSO方案中用D-Bus封装的手机API了。相对于OpenMoko环境，我更喜欢Poky环境的简洁。我编译过一个freerunner版本的Poky，加上FSO方案的API，就可以得到一个干净的手机开发环境。只要有时间，我就可以在这个环境上制作自己的手机软件。