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，就可以得到一个干净的手机开发环境。只要有时间，我就可以在这个环境上制作自己的手机软件。