翻译一个源代码编译G1ROM的教程，很好很入门

liaowg

http://www.johandekoning.nl/
Android 1.5 HTC – 开发环境
June 7th, 2009
去年我买了一台Android开发版手机，希望能够成为首批使用这个了不起的手机和操作系统的用户。Android开发手机使我们能够用自己编译的Android版本来稍定制手机，那么为什么不用源代码开始编译/构造自己的Android操作系统呢。
编译/构造Android1.5版本的第一个步骤是建立开发环境，在http://source.android.com/download上有一个详细的描述。这里将我实际的操作过程一步一步的描述出来。
安装Ubuntu
我在虚拟机上安装的Ubuntu，用的版本是8.04，因为这是Google用的开发环境，用8.10有一些问题。
这里不解释如何安装Ubuntu，这实在太简单直接（甚至比安装Vista还容易。）
Ubuntu安装好以后用
apt-get update
apt-get upgrade
更新安装好的软件包版本
Required packaged
需要安装的包
为了用git拉源代码和build Android, 必须安装如下包，通过sudo apt-get install <包名称>来安装需要的软件包。
•        git-core
•        gnupg (this package was already installed)
•        sun-java5-sdk (don’t use java 6 because this will result in errors during build)
•        flex
•        bison
•        gperf
•        libsdl-dev
•        libesd0-dev (the last 0 is a zero)
•        libwxgtk2.6-dev
•        build-essential
•        zip (already installed)
•        curl
•        libncurses5-dev
•        zlib1g-dev
•        valgrind (this packge is optional)
可以通过组合apt-get命令来一次性的安装多个包
sudo apt-get install git-core gnupg sun-java5-jdk flex bison gperf libsdl-dev libesd0-dev libwxgtk2.6-dev build-essential zip curl libncurses5-dev zlib1g-dev valgrind
http://source.android.com/download 推荐Ubuntu 8.10用户安装新版的libreadline. 我发现其实8.04版本也需要这个软件，不然的饿话repo会出错。
sudo apt-get install libreadline5-dev
注意：android网站上用了不同的软件包名称，lib32readline5-dev，但是这个包不存在。
Java环境
这里我们要用Java 5，可能您的Ubuntu安装上已经有了Java 6，用下面的命令检查Java版本
update-java-alternatives -l
在我的机器上输出的是：
java-1.5.0-sun 53 /usr/lib/jvm/java-1.5.0-sun
If multiple versions are installed, use update-java-alternatives -s to change the default Java Environment. For example
如果机器上安装了多个版本，用 update-java-alternatives –s命令切换缺省的Java版本
update-java-alternatives -s java-1.5.0-sun
Java安装位置必须通过$JAVA_HOME变量设置，编辑您的用户主目录下的.bashrc文件，在结尾部分增加以下内容：
export JAVA_HOME=/usr/lib/jvm/java-1.5.0-sun-1.5.0.16
当然Java安装路径可能有差别，依赖于不同的小版本号，我的机器上是1.5.0.16。请检查您的Java安装路径。
Start a new terminal and check if $JAVA_HOME is working and pointing to the right location
启动一个新的控制台，检查$JAVA_HOME环境变量是否正确设置
echo $JAVA_HOME
You can also check if the correct Java version is used by running the command java –version
同时用java –version检查您用的Java版本是正确的
java -version
预期的输出：
java version "1.5.0_16"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_16-b02)
Java HotSpot(TM) Client VM (build 1.5.0_16-b02, mixed mode, sharing)
下一步
通过安装Ubuntu和相关的软件包，安装配置Java环境，准备好所有这些工作以后，下一步就是通过git下载源代码，build您自己的Android版本了。我将在下一个blog中介绍如何拖正确的代码版本。任何问题请通过下面的反馈部分提出来。

liaowg

Android 1.5 HTC – 获取源代码
June 7th, 2009
Note (24 june 2009): contributed a patch to the Android Source (change 10501) for updating the extact-files.sh and AndroidBoard.mk scripts which where outdated for the proprietary files. This simplifies the process of getting the source a little bit.
Note (9 june 2009): I updated this blogpost to make wifi and the led light of your Android Dev Phone working inside your own build.
上一篇blog介绍了如何建立正确的开发环境。下一步是拖下代码并加上适当的补丁以便能够成功build。http://source.android.com/download上有git代码的部分，但是我会给出更详细的描述，包括让您的版本能支持Android开发手机。
Installing repo
安装repo
Open a terminal inside Ubuntu and make sure that you are inside your home directory
新开一个Ubuntu控制台：
cd ~
mkdir bin
在您的配置文件~/.bashrc结尾部分增加下面一行
export PATH=$PATH:~/bin
保存文件，推出控制台，打开一个新的控制台，检查bin目录是否正确加入到路径中：
echo $PATH
用curl下载repo脚本，修改为可执行文件
curl http://android.git.kernel.org/repo > ~/bin/repo
chmod a+x ~/bin/repo
Repo初始化
Android源代码的主目录约定为用户目录下的mydroid
cd ~
mkdir mydroid
cd mydroid
在mydroid目录下执行repo，注明android源代码在远程服务器上的目录，通过运行
repo init -u git://android.git.kernel.org/platform/manifest.git
您得到的是Android的主版本。问题是主版本更新很快，不是很稳定有很多实验性的代码，所以我通过特定的分支拖一个稳定的1.5版本
repo init -u git://android.git.kernel.org/platform/manifest.git -b android-1.5r2
Repo可能需要您的用户名和email地址，最好用您的Google账号，以后提交您的代码更新会有用。
Repo脚本执行成功会输出如下信息
repo initialized in /home/jcdekoning/mydroid
到现在我们只是配置了repo工具，还没有开始下载真正的代码，在mydroid目录下，您会发现一个隐藏的.repo目录
Repo configuration changes for Android Dev Phone
针对Andoid开发手机对repo配置的修改
现在当然可以下载源代码，但是我们必须针对Android开发手机（Dream，G1）对源代码做必要的更改，Google网站上有一篇文章（http://source.android.com/documentation/building-for-dream），但是已经过时了。
在.repo目录下，我们需要增加一个新的文件local_manifest.xml. 该文件包含开发手机需要的三个额外项目，同时会提出主版本的内核项目，因为HTC用了一个特殊的内核版本， local_manifest.xml文件的内容：
<?xml version="1.0" encoding="UTF-8"?>
<manifest>
  <remove-project name="kernel/common"/>
  <project path="kernel" name="kernel/msm" revision="refs/heads/android-msm-2.6.27"/>
  <project path="vendor/htc/dream" name="platform/vendor/htc/dream-open" revision="cupcake"/>
  <project path="hardware/msm7k" name="platform/hardware/msm7k" revision="refs/heads/master"/>
</manifest>
终于可以下载代码了
repo sync
坐下来，放松，喝点咖啡，当然您也可以看看我的其他blog文章，repo需要的时间实在太他妈长了。
Proprietary binaries
专有二进制代码
部分不开源的Dream特有代码必须从安装1.5cupcake版本的开发手机中提取出来，这些文件不是源代码树的一部分，但在开发手机上是必须的。在您的mydroid目录中会发现/vendor/htc/dream目录，其中有一个extract-files.sh脚本文件，通过调用adb命令用实际的设备中提取文件。不幸的是，这个文件也是过时的。
通过打上下述补丁更新extract-files.sh脚本和AndroidBoard.mk工程文件
repo download platform/vendor/htc/dream-open 10501
通过连上您的Android手机，在Ubuntu中执行下述脚本提取相关文件
./extract-files.sh
有的时候虚拟机上的Ubuntu连接终端不是很可靠，您可以考虑extract-files.sh脚本的另外一种方式
用unyaffs从HTC官方image中提取
如果您正确执行了extract-files.sh，请跳过这一节
Android采用了yaffs文件系统，通过下载unyaffs工具可以从Android映像文件中提取您需要的任何文件。
从 http://code.google.com/p/unyaffs/ 下载unyaffs工具，然后
cd ~/bin
chmod a+x unyaffs

下载官方cupcake image文件http://www.htc.com/www/support/android/adp.html ，注意版本是Android 1.5，下载system image (signed-dream_devphone_userdebug-img-148830.zip). 在您的主目录下创建htc目录存放下载的zip文件(mkdir ~/htc)。请不要更改目录名，不然要修改一系列的脚本。
Zip文件找那个包含下述映像
•        boot.img
•        recovery.img
•        system.img
•        userdata.img
在我们完成编译以后也会生成这几个image文件，用unyaffs工具解包system.img文件
cd ~/htc
sudo ~/bin/unyaffs system.img
接下来编辑一个 htc-copy.sh脚本，存储在~/htc，内容如下
#!/bin/sh

mkdir -p ~/mydroid/vendor/htc/dream/proprietary
cp ~/htc/etc/AudioFilter.csv ~/mydroid/vendor/htc/dream/proprietary/AudioFilter.csv
cp ~/htc/etc/AudioPara4.csv ~/mydroid/vendor/htc/dream/proprietary/AudioPara4.csv
cp ~/htc/etc/gps.conf ~/mydroid/vendor/htc/dream/proprietary/gps.conf
cp ~/htc/etc/firmware/brf6300.bin ~/mydroid/vendor/htc/dream/proprietary/brf6300.bin
cp ~/htc/bin/akmd ~/mydroid/vendor/htc/dream/proprietary/akmd
cp ~/htc/lib/libhtc_ril.so ~/mydroid/vendor/htc/dream/proprietary/libhtc_ril.so
cp ~/htc/lib/libaudioeq.so ~/mydroid/vendor/htc/dream/proprietary/libaudioeq.so
cp ~/htc/lib/libqcamera.so ~/mydroid/vendor/htc/dream/proprietary/libqcamera.so
cp ~/htc/lib/libgps.so ~/mydroid/vendor/htc/dream/proprietary/libgps.so
cp ~/htc/lib/libhgl.so ~/mydroid/vendor/htc/dream/proprietary/libhgl.so
cp ~/htc/lib/libOmxCore.so ~/mydroid/vendor/htc/dream/proprietary/libOmxCore.so
chmod 755 ~/mydroid/vendor/htc/dream/proprietary/akmd

cp ~/htc/lib/libhtc_acoustic.so ~/mydroid/vendor/htc/dream/proprietary/libhtc_acoustic.so
cp ~/htc/lib/libjni_pinyinime.so ~/mydroid/vendor/htc/dream/proprietary/libjni_pinyinime.so
cp ~/htc/lib/libmm-adspsvc.so ~/mydroid/vendor/htc/dream/proprietary/libmm-adspsvc.so
cp ~/htc/lib/libOmxH264Dec.so ~/mydroid/vendor/htc/dream/proprietary/libOmxH264Dec.so
cp ~/htc/lib/libOmxMpeg4Dec.so ~/mydroid/vendor/htc/dream/proprietary/libOmxMpeg4Dec.so
cp ~/htc/lib/libOmxVidEnc.so ~/mydroid/vendor/htc/dream/proprietary/libOmxVidEnc.so
cp ~/htc/lib/libopencorehw.so ~/mydroid/vendor/htc/dream/proprietary/libopencorehw.so
cp ~/htc/lib/libpvasf.so ~/mydroid/vendor/htc/dream/proprietary/libpvasf.so
cp ~/htc/lib/libpvasfreg.so ~/mydroid/vendor/htc/dream/proprietary/libpvasfreg.so
cp ~/htc/lib/libspeech.so ~/mydroid/vendor/htc/dream/proprietary/libspeech.so
cp ~/htc/lib/hw/lights.goldfish.so ~/mydroid/vendor/htc/dream/proprietary/lights.goldfish.so
cp ~/htc/lib/hw/sensors.trout.so ~/mydroid/vendor/htc/dream/proprietary/sensors.trout.so
cp ~/htc/etc/wifi/Fw1251r1c.bin ~/mydroid/vendor/htc/dream/proprietary/Fw1251r1c.bin
cp ~/htc/etc/wifi/tiwlan.ini ~/mydroid/vendor/htc/dream/proprietary/tiwlan.ini

cp ~/htc/lib/modules/wlan.ko ~/mydroid/vendor/htc/dream/wlan.ko
cp ~/htc/lib/hw/lights.msm7k.so ~/mydroid/vendor/htc/dream/proprietary/lights.msm7k.so
cp ~/htc/etc/AudioPreProcess.csv ~/mydroid/vendor/htc/dream/proprietary/AudioPreProcess.csv
执行htc-copy.sh脚本将官方ROM中的文件拷贝到源代码目录~/mydroid/vendor/htc/dream。
chmod a+x htc-copy.sh
./htc-copy.sh
到~/mydroid/vendor/htc/dream/proprietary目录下检查文件是否拷贝正确。
What’s next?
下一步
源代码和补丁都正确到位了，下一步就是build Linux内核和Android了

liaowg

Android 1.5 HTC – 编译
June 8th, 2009
Building内核
如下：
cd ~/mydroid/kernel
export ARCH=arm
export CROSS_COMPILE=arm-eabi-
export PATH=$PATH:~/mydroid/prebuilt/linux-x86/toolchain/arm-eabi-4.2.1/bin
cp arch/arm/configs/msm_defconfig .config
make oldconfig && make
build成功以后将会生成如下文件 ~/mydroid/arch/arm/boot/zImage. 该文件将会在Androidbuild过程中用到。
修改HTC工程
我们需要SdkSetup使得接电话正常（用于将手机至于provisioned状态）并让home（房子）键工作，但是这个软件缺省没有发布，所以我们必须修改htc_dream.mk文件。修改~/mydroid/vendor/htc/dream/ htc_dream.mk文件，在开始部分加入一下内容
PRODUCT_PACKAGES := \
Calculator \
Email \
ImProvider \
SdkSetup \
VoiceDialer
Building Android
cd ~/mydroid
创建配置文件~/mydroid/buildspec.mk，该文件包含以下两行
TARGET_PRODUCT:=htc_dream
TARGET_PREBUILT_KERNEL:=kernel/arch/arm/boot/zImage
现在可以开始了
make
What’s next?
下一步
烧鸡，祈祷不要变砖
Blogpost in the Building Android 1.5 serie
•        Building Android 1.5 – Build environment
•        Building Android 1.5 – Getting the source
•        Building Android 1.5 – Building the source
•        Building Android 1.5 – Flashing the phone
•        Building Android 1.5 – Google Apps and audio files
Tags: Android, English
Posted in Uncategorized | 25 Comments »

liaowg

Android 1.5 HTC – 烧机
July 3rd, 2009
通过上面三篇文章的学习，各位应该已经生成了烧机需要的Andoid影响文件。现在我们有一些必要的准备工作，以确保烧机成功
注1：烧机将会抹掉手机上的所有数据（不包括SD卡），电话、短信什么的。当然可能保留userdata分区不写，但这经常会导致一些奇怪的结果，所以我们尽量备份数据，然后将userdata区一并重写
注2：一般而言烧机不会让您的手机变砖，即使您的build不工作至少可以启动bootloader。什么事都有万一，所以我不能对您的手机的损坏负责。要清楚您到底在做什么，除了一步步的指导，我会试图给您足够的信息，让您知道为什么要这样做。有什么问题请在Android Platform Forum  (http://groups.google.com/group/android-platform)提问。
基带Radio image
基带Radio image负责通信模块工作，也是不开源的所以得从HTC网站下载 (http://www.htc.com/www/support/android/adp.html).
我们的build基于cupcake版本，所以您必须用1.5版本的Radio image。老的版本是不兼容的
通过手机菜单确认您的手机基带版本，主画面：menu/设置/关于手机/Baseband版本应该是62.50s.20.17H_2.22.19.16I (just like the download name ota-radio-2_22_19_26I)，如果不对，请升级您的基带版本（按照 http://www.htc.com/www/support/android/adp.html指导来，非常简单）
   
About phone screen
Fastboot
烧机过程需要fastboot工具，用我们刚刚编译生成的版本~/mydroid/out/host/linux-x86/bin
cp ~/mydroid/out/host/linux-x86/bin/fastboot/ ~/bin
（中文注：不建议用Windows版本，我总用不起来，Mac就算了） If you are a Windows user, you should use the fastboot executable provided by HTC. I don’t know if building the source on Mac OS X is as clear as on Ubuntu (it should be possible to compile the source) and that the fastboot version can be used.
Ubuntu中连接手机
In a previous blog post I explained how to connect your device with Ubuntu which runs within VMWare as Virtual Machine. Those steps (http://www.johandekoning.nl/inde ... -and-vmware-server/) are also relevant when running Ubuntu natively (except for the VMWare steps).  Or follow the steps (when for example you want to use fastboot with Windows) which are written for the Android SDK http://developer.android.com/guide/developing/device.html
Flashing the device
烧机
So the HTC Android 1.5 version is running well? You made sure that the right radio version is installed? Fastboot is working properly? And made (optionally) a backup of your important data?
都准备好了，开始烧机了
首先您的机器要支持fastboot模式，Android开发机都支持，咱们买的G1刷一个SPL就可以了，具体操作到hiapk.com上查看。
如下步骤，很多文章都有，就简单翻一下
首先关机
按住camera键开机，屏幕出现三个踩滑板的机器人（也可能是彩虹什么的，无所谓了），打印HBOOT
按返回键，进入fastboot模式
连接USB，进入fastboot usb模式
Blog上说只能用开发机，G1不支持flash，实际上G1刷一个SPL就OK了
要烧的image在一下目录：
~/mydroid/out/target/product/dream
检查这几个文件是不是存在
•        boot.img (用于启动设备，包含内核)
•        system.img (Android系统，包含框架，驱动，应用，一切的一切)
•        userdata.img (用户数据，也可以不刷这个分区，可以保留原来的用户数据，但是保险期间，刷一下也无妨)
•        recovery.img
在输出目录中（~/mydroid/out/target/product/dream）执行下述命令烧机
sudo fastboot flash boot boot.img
sudo fastboot flash system system.img
sudo fastboot flash recovery recovery.img
sudo fastboot flash userdata userdata.img
（中文注：不知道别人怎么样，我的fastboot必须在root下执行，所以我加了一个sudo，这样的话，可能环境就不一样了，可能您需要为fastboot工具加上路径，如sudo /home/xxx/bin/fastboot flash boot boot.img）
Fastboot会先传输image文件，成功后再烧机写特定的分区。
（中文注：您需要一条好一点的USB线，我开始的时候因为USB先的问题总是不成功，还以为烧死了，电脑城的垃圾线十有八九不行的）
完了重启
fastboot reboot
还活着
第一次重启需要较长的时间，不要急。
（中文注：google上的kernel版本和HTC目前发布的WiFi驱动版本有点冲突，WiFi还起不来
内核输出:
[ 175.928619] wlan: version magic ‘2.6.27-00393-g6607056 preempt mod_unload ARMv6 ‘ should be ‘2.6.27-00394-gc6c6056 preempt mod_unload ARMv6 ‘
kernel 2.6.27-00394-gc6c6056
wlan.ko 2.6.27-00393-g6607056
这个问题比较麻烦，尚未解决）
Can
•        Wifi and bluetooth should work properly (because we added the right driver versions)
•        The Home button will work and you will have the Silent and Airplane option when holding the END CALL button (this is done by the SdkSetup package)
•        The led light should work when you get an SMS or connect the device
•        You should be able to make and receive calls
•        Camera, GPS and all the other sensors should be working fine
•        Start applications like Browser, Calculator, etc
•        Make use of 3G connection
•        Use android in a different language. The HTC version of Android has only the English language pack. Your own version has multiple language support.
Can’t
•        Use the Calendar application. Because this application depends on some Google libraries which are not on the system. I was looking how to seperate the Calendar application so that it is not Google dependent (and submit the source back to the source tree)
•        No Market application.
•        No Google applications (like GMail, GTalk, Maps).
•        No nice ringtones. The media directory which contains all the ringtones which are normally there is not part of the built.
•        No synchronization with Google (like contacts and calendar)
下一步
I will write another post about how to add the Google Apps, Market and ringtones to your own build. For now the flashing part is completed (so turn on the lights again   ). Questions and other feedback can be given to this post.
Blogpost in the Building Android 1.5 serie
•        Building Android 1.5 – Build environment
•        Building Android 1.5 – Getting the source
•        Building Android 1.5 – Building the source
•        Building Android 1.5 – Flashing the phone
•        Building Android 1.5 – Google Apps and audio files
Tags: Android, English, Ubuntu
Posted in Uncategorized | 13 Comments »

liaowg

格式都乱了，做个PDF贴上来

其实谈不上什么翻译，就是把过程走了一轮，其中有些问题跟作者确认了一下

keel

这个一定要支持！辛苦翻译了！

lyhapple

呵呵.很好的东西,是不是可以完全自己来做个性化的系统呢.当然,技术要相当牛B的

linmuzhang

哇，看不懂，不过还是支持。。。。。辛苦了

liaowg

现在有一个问题是，Kernel和wlan驱动的版本冲突，不然就可以用了

所以我用了两天又烧回去了

（中文注：google上的kernel版本和HTC目前发布的WiFi驱动版本有点冲突，WiFi还起不来
内核输出:
[ 175.928619] wlan: version magic ‘2.6.27-00393-g6607056 preempt mod_unload ARMv6 ‘ should be ‘2.6.27-00394-gc6c6056 preempt mod_unload ARMv6 ‘
kernel 2.6.27-00394-gc6c6056
wlan.ko 2.6.27-00393-g6607056
这个问题比较麻烦，尚未解决）

keel

这个与ROM的制作好像还有一点距离，请问楼主system.img 是否就是ROM里面的system目录？
怎么使用下载的ROM生成一个system.img？或者由system.img转成update.zip里面的system目录？

liaowg

生成的就是烧机的ROM

不过采用的是SPL方式烧机，用fastboot工具，至于怎么做成update.zip，我不清楚，清楚的人能出来介绍下吗

system.img就是system目录了，用unyaffs工具就还原成system目录了

keel

感谢楼主，希望有人讲一下ROM的zip包制作方法

elvischen

专业的我都无法看了，只能膜拜....

meta

生成的就是烧机的ROM

不过采用的是SPL方式烧机，用fastboot工具，至于怎么做成update.zip，我不清楚，清楚的人能出来介绍下吗

system.img就是system目录了，用unyaffs工具就还原成system目录了
liaowg 发表于 2009-7-15 13:04

把system.img和boot.img压缩到一起就是update.zip了。

liaowg

把system.img和boot.img压缩到一起就是update.zip了。
meta 发表于 2009-7-16 15:50

没有这么简单，都是yaffs文件系统，有一个简单的办法就是替换，重新签名。不过挺麻烦的