一、概述
众所周知,Android移动操作系统是Google花费了很大的财力、物力及人力的前提下,推广到世界各个角落,以开放源代码的方式(当然也不是完全开放所有),使其在世界范围内迅速漫延开来,到目前虽说只有三四年的时间 ,火热程度,也不用我细说了,看看业界新闻就明白了。这里我们主要讨论Android系统源代码的下载,这里我们先了解两个工具:
1、Git
Git是面向Linux内核管理的一个工具,它是一种分布式的版本控制系统,即每一个工作目录下都是一个完整的仓库,因此也支持离线工作, 在本地提交后,便会稍后更新到服务器上。它这种结构比集中式版本控制系统(如常见的SVN、CVS等只有一个完整仓库)更加健壮。
2、repo
其实repo只是用Python编写的一个脚本,它是为了更好、更方便地管理Android操作系统下多个组成部分,如Kernel、Dalivk、Bionic、prebuild、build等多个项目。repo的目的就是为了统一管理这些项目,简化Git的使用过程。
3、curl
curl是一个利用URL语法在命令行模式下的文件传输工具。这里我们用它来获取repo脚本。
二、源代码下载步骤
1、环境介绍:
首先介绍一下我的环境:Windows7下通过Vmare 7.1虚拟出Ubuntu10.4.2 系统 (当然将Ubuntu安装到硬盘上也一样,只是我这Linux系统不方便上网)
2、操作步骤:
1)、安装Git工具
命令:sudo apt-get install git
当然也可以去http://git-scm.com上下载最新版本的源代码,在本地编译安装,这里不详述了。
2)、安装curl:
命令:sudo apt-get install curl
2)、获取repo脚本并赋执行权限:
说明一下,我打算将此脚本放到~/bin目录下面,并将此目录加入到环境变量PATH里,以方便运行repo
命令:mkdir ~/bin
cd ~/bin
curl http://android.git.kernel.org/repo>~/bin/repo
chmod 755 repo
若已经将~/bin目录添加到PATH变量中了,就可以在任意目录下执行repo了。
3)、初始化库
首先创建你要存放Android源代码的目录,这里我下载到~/android_src目录下,
命令:mkdir ~/android_src
cd ~/android_src
repo init –u git://android.git.kernel.org/platform/manifest.git
repo sync
上面这句命令会将当前主线上的最新版本的源代码库全部取下来,若只需要其中一部分代码,也可通过再加一个-b [branchname]参数来取指定的分支代码。
此下载过程就跟网络情况,下载时间一般都会很长,我这具体时间也不太清楚,一般是晚上睡觉前开始下载,早上起来一看,已经下载完毕了。
三、扩展
待补充。。。
本文的目录结构
1、源码的下载
2、编译环境的搭建
3、编译源代码
4、允许模拟器
5、相关出错的处理方法
Google于2013.07.25发布了Android4.3的源码及其相关产品,下面把本人在ubuntu10.04 的64位系统上下载源码,和编译源码做个记录备份,也供有需要的人参考,难免有错,敬请见谅,还忘勿吝啬指出。
源代码下载、编译环境安装、源代码编译和运行模拟器的过程中可能会出现的一些错误在本文最后一章节,若出现类似错误,可以参考。
1、 源码的下载
源代码的下载,首先需要安装以下工具软件:curl 和 git-core
1.1安装curl:
打开终端,可以使用按Ctrl+Alt +T的快捷方式打开终端
在终端中执行命令:sudo apt-get install curl
1.2安装git-core
1.2.1在用户目录下新建bin目录
在终端中执行:mkdir ~/bin
1.2.2安装git-core
在终端中执行:curl https://dl-ssl.google.com/dl/googlesource/git-repo/repo > ~/bin/repo
给repo执行权限:chmod a+x ~/bin/repo
注:若是下载repo失败可以到我百度网盘中去下载,下面给出链接:
http://pan.baidu.com/share/link?shareid=3522233410&uk=4278685087
将~/bin添加环境变量,作用是:git软件下载安装在此目录,在别的目录运行可能提示出错:会找不到此软件。
在终端中执行命令:PATH=~/bin:$PATH
1.3 下载源代码
1.3.1进入要源代码将要保存的目录
如我的源代码保存在:、/opt/android4.3
在终端中执行:cd /opt/android4.3 进入到android4.3目录中
1.3.2 下载源代码
对于下载不同版本的android,指定一个manifest分支(即只指明android对应的版本),使用-b参数(即下载某个版本的源代码),目前关于Android 4.3的源码有以下分支:我们可以选择自己需要下载的:
* [new branch] android-4.3_r0.9 -> origin/android-4.3_r0.9
* [new branch] android-4.3_r0.9.1 -> origin/android-4.3_r0.9.1
* [new branch] android-4.3_r1 -> origin/android-4.3_r1
* [new branch] android-4.3_r2 -> origin/android-4.3_r2
* [new branch] android-4.3_r2.1 -> origin/android-4.3_r2.1
我们选择下载最新的源码,具体命令:
~/bin/repo init -u https://android.googlesource.com/platform/manifest -b android-4.3_r2.1
执行此命令会下载一些文件到我们电脑中,这条命令的主要作用是初始化我们要下载的源码的的一些配置文件,看到类似下面的提示,表示初始化完成。
repo has been initialized in /opt/android4.3username@user-desktop:/opt/android4.3$
初始化完成后,会在/opt/android4.3目录中生成一个.repo的目录(此目录为隐藏属性的文件,我们可以在终端中使用ls -la命令,或者在文件浏览器中选择“查看”,然后勾选“显示隐藏文件”,就可以看到此目录),此目录保存了将要下载的源代码的相关信息,下面我们开始下载源码
同步获取源码
#~/bin/repo sync
如果中间出现中断,这个很正常,你可以再次输入 ~/bin/repo sync 命令来进行下载。
可以写一个脚本,当中断后,又自动开始下载,可以在我网盘中下载此脚本:reposync
http://pan.baidu.com/share/link?shareid=3522233410&uk=4278685087
把reposync脚本放在你源码的目录,执行./reposync命令就可以了。
根据网速的不同,下载时间也有快慢,最好在睡觉前或下班后下载代码,由于源文件比较大,一般国内都要5小时左右甚至更久。
若是出现以下信息,表示代码以下载完成:
Fetching projects: 100% (166/166), done.
Syncing work tree: 100% (165/165), done.
源代码下载完成后,/opt/android4.3文件夹的大小为20G左右,其中.repo有10 G+。
运行~/bin/repo sync 还可以重新校对下载的源码,若是有问题或遗漏了一些文件会重新下载,并从.repo目录中导出到实际源码中
注:此步可能会出现下载错误,请查看本文最后部分的说明
2、编译环境的搭建
首先若是没有修改源,请修改为国内的源,从而提高软件的下载安装的速度
可以参考下面博客的内容添加一些速度快的源,如:台湾源、Ubuntu官方上海源、网易、搜狐、
http://hi.baidu.com/houxn22/item/48f0f7d150657c16d80e4468
安装编译所需的软件
1、 安装jdk
官方推荐安装jdk1.6的,现在不支持命令安装了,只有Oracle官网下载,或者可以在本人百度网盘下面的地址中下载:
http://pan.baidu.com/share/link?shareid=2263608836&uk=4278685087
打开后选择jdk-6u45-linux-x64.bin。
安装完后修改环境变量。
2、 安装其它一些编译所需软件
在终端中执行:sudo apt-get install git-core gnupg flex bison gperf build-essential \
zip curl zlib1g-dev libc6-dev lib32ncurses5-dev ia32-libs \
x11proto-core-dev libx11-dev lib32readline5-dev lib32z-dev \
libgl1-mesa-dev g++-multilib mingw32 tofrodos python-markdown \
libxml2-utils xsltproc
基本只要安装以上软件即可,官方网站上说的其它一些软件或者设置可以不用理会。
注:此步可能会出现错误,请查看本文最后部分的说明
3、编译源代码
3.1编译初始化:
在终端中执行:
source build/envsetup.sh
或:
. build/envsetup.sh
执行后输出:
source build/envsetup.sh including device/asus/grouper/vendorsetup.shincluding device/asus/tilapia/vendorsetup.shincluding device/generic/armv7-a-neon/vendorsetup.shincluding device/generic/armv7-a/vendorsetup.shincluding device/generic/mips/vendorsetup.shincluding device/generic/x86/vendorsetup.shincluding device/samsung/maguro/vendorsetup.shincluding device/samsung/manta/vendorsetup.shincluding device/samsung/toroplus/vendorsetup.shincluding device/samsung/toro/vendorsetup.shincluding device/ti/panda/vendorsetup.shincluding sdk/bash_completion/adb.bash
3.2选择编译目标:
在终端中执行下面的命令:
lunch
之后选择你要编译的设备,选择后,会初始化编译的项目的相关文件。
3.3编译代码:
在终端中执行:make -j4
-j4:表示用四个线程来编译
编译根据不同机器的配置不同所需时间也有很大差异。
出现以下信息表示编译完成:
target Java: ContactsTests (out/target/common/obj/APPS/ContactsTests_intermediates/classes)
target Dex: Contacts
Done!
Install: out/target/product/generic/system/app/Browser.odex
Install: out/target/product/generic/system/app/Browser.apk
Note: Some input files use or override a deprecated API.
Note: Recompile with -Xlint:deprecation for details.
Copying: out/target/common/obj/APPS/Contacts_intermediates/noproguard.classes.dex
target Package: Contacts (out/target/product/generic/obj/APPS/Contacts_intermediates/package.apk)
'out/target/common/obj/APPS/Contacts_intermediates/classes.dex' as 'classes.dex'...
Processing target/product/generic/obj/APPS/Contacts_intermediates/package.apk
Done!
Install: out/target/product/generic/system/app/Contacts.odex
Install: out/target/product/generic/system/app/Contacts.apk
build/tools/generate-notice-files.py out/target/product/generic/obj/NOTICE.txt out/target/product/generic/obj/NOTICE.html "Notices for files contained in the filesystem images in this directory:" out/target/product/generic/obj/NOTICE_FILES/src
Combining NOTICE files into HTML
Combining NOTICE files into text
Installed file list: out/target/product/generic/installed-files.txt
Target system fs image: out/target/product/generic/obj/PACKAGING/systemimage_intermediates/system.img
Running: mkyaffs2image -f out/target/product/generic/system out/target/product/generic/obj/PACKAGING/systemimage_intermediates/system.img
Install system fs image: out/target/product/generic/system.img
DroidDoc took 5331 sec. to write docs to out/target/common/docs/doc-comment-check
编译可能出现的错误,请查看本文最后部分的说明
4、运行模拟器
在终端中执行:emulator
运行模拟器可能出现的错误,请查看本文最后部分的说明
5、相关问题的解决办法
5.1 下载源代码可能会提示的错误
5.1.1error: Exited sync due to fetch errors...
方法一:不理会他,重新执行repo sync命令。
方法二:
关于这个问题其实google是有说明的http://source.android.com/source/downloading.html,为了防止连接数过多,每个ip都需要认证。。。
第一步:从这里the password generator获取用户名和密码,前提是你在之前填写了你的真实姓名和邮箱
第二步:将上面的页面上以machine开头的两行复制到 ~/.netrc文件中
第三步:repo init -u https://android.googlesource.com/a/platform/manifest 多了个“/a”
然后就可以repo sync了
特别注意.netrc文件是在用户的根目录下,root用户就是/目录下,如果没有的话就自己建一个,把权限改为 *00
5.1.2若是出现这个错误:Exited sync due to gc errors
表示代码基本下载完,需要从repo里面导出来,但是git的版本太低,不支持1.72以下版本。
添加这个源:deb http://ftp.de.debian.org/debian sid main。
在终端中执行:gedit /etc/apt/source.list
在文件的最后添加deb http://ftp.de.debian.org/debian sid main,并保存退出
回到终端中执行:sudo apt-get update
更新完后,安装高版本的git工具
在终端中执行:sudo apt-get install git-core
5.2安装编译环境的软件可能会出现的问题
下列软件包有未满足的依赖关系: libasound2: 破坏: libasound2-plugins (< 1.0.24-0ubuntu3) 但是 1.0.22-0ubuntu6 正要被安装 libglib2.0-0: 破坏: gnome-control-center (< 1:3) 但是 1:2.30.0-0ubuntu4 正要被安装 ppp: 破坏: network-manager (<= 0.8.0.999-1) 但是 0.8-0ubuntu3 正要被安装E: 破损的软件包
某些源有问题,为高版本 ubuntu的源 ,删除即可,如安装高版本的git所用的源就是ubuntu 10.4之后的源,用在10.04上就可以会有问题,引起此提示。
在终端中执行:gedit /etc/apt/source.list
把文件的最后 deb http://ftp.de.debian.org/debian sid main 删除,并保存退出
回到终端中执行:sudo apt-get update
再次重新安装编译环境的软件
5.3、编译可能会遇到的问题:
5.3.1运行make命令后,提示以下错误:/bin/bash: java: command not found
首先检查是否确实安装了jdk,在终端中输入:java -version ,若是有安装jdk,就会显示jdk的版本信息,提示出错,说明没有安装jdk,那么就安装jdk。
安装jdk后还是提示上面的错误信息,则按执行以下命令建立链接文件来解决问题:
sudo ln -s /jdk1.6.0_21/bin/jar ~/bin/jar
sudo ln -s /jdk1.6.0_21/bin/java ~/bin/java
sudo ln -s /jdk1.6.0_21/bin/javac ~/bin/javac
sudo ln -s /jdk1.6.0_21/bin/javah ~/bin/javah
sudo ln -s /jdk1.6.0_21/bin/javadoc ~/bin/javadoc
重新编译若还是提示一样的错误,再执行下面的命令:
sudo ln -s /jdk1.6.0_21/bin/jar /bin/jar
sudo ln -s /jdk1.6.0_21/bin/java /bin/java
sudo ln -s /jdk1.6.0_21/bin/javac /bin/javac
sudo ln -s /jdk1.6.0_21/bin/javah /bin/javah
sudo ln -s /jdk1.6.0_21/bin/javadoc /bin/javadoc
至此java的问题应该可以解决
5.3.2 编译出现以下错误提示:
============================================
Checking build tools versions...
************************************************************
You are attempting to build with the incorrect version
of java.
Your version is: java version "1.6.0_24".
The correct version is: Java SE 1.6.
Please follow the machine setup instructions at
https://source.android.com/source/download.html
************************************************************
build/core/main.mk:141: *** stop。 停止。
切换从普通用户登,然后修改源码目录的存取权限:chmod 777 src
之后再运行编译命令再次编译
5.3.3 No command 'lunch' found, did you mean:
解决方法:
运行以下命令:
source build/envsetup.sh
之后再次运行编译命令:lunch full-eng或lunch full-user ……..
5.4运行模拟器可能会出现的问题:
No command 'emulator' found, did you mean:
编译成功之后,在终端运行emulator命令,却提示:
No command 'emulator' found, did you mean:
Command 'qemulator' from package 'qemulator' (universe)
emulator: command not found
解决方法:
重新运行以下命令:
source build/envsetup.sh
lunch full-eng
之后再次运行 emulator 命令
网上介绍下载、编译Android方法一坨,读万卷书不如行万里路,以下是笔者亲身经历的(笔者是使用的系统是ubuntu 13.04)。
安装git:
下载是一个漫长的过程!~~~~~~~让它慢慢下载吧!我们忙别的去了~~
重启电脑后发现错误,提示:
No command 'repo' found, did you mean:
Command 'rep' from package 'rep' (universe)
Command 'repl' from package 'nmh' (universe)
Command 'repl' from package 'mailutils-mh' (universe)
repo: command not found
只要删除repo 重新设置一下就OK了。
这一步编译出root, system, data三个目录和system.img(系统镜像文件)、userdata.img(用户数据)、ramdisk.img(emulator文件系统)三个镜像,位于out/target/product /generic目录下。这样Android系统就编译完了,可以在Emulator下执行,也可以下载到你的板子上运行!
编译生成的root文件夹内容与android运行时根目录内容相似,ramdisk根文件系统中包含一些对于启动android的很重要的文件,比如内核启动完后加载的第一个进程init、一些重要的配置文件等,总之它控制着整个android的启动。根据init.rc,init.goldfish.rc来初始化并装载系统库、程序等直到开机完成。init.rc脚本包括了文件系统初始化、装载的许多过 程。init.rc的工作主要是:
1)设置一些环境变量
2)创建system、sdcard、data、cache等目录
3)把 一些文件系统mount到一些目录去,如,mount tmpfs tmpfs /sqlite_stmt_journals
4)设置一些文件的 用户群组、权限
5)设置一些线程参数
6)设置TCP缓存大小
生成的system.img,ramdisk.img,userdata.img映像文件是采用cpio打包、gzip压缩的,可以通过file命令验 证:file ramdisk.img,
输出: ramdisk.img: gzip compressed data, from Unix, last modified:Wed Mar 18 17:16:10 2009 ,
我们可以学习怎么样把 ramdisk.img解压出来。
将ramdisk.img复制一份到任何其他目录下,将其名称改为 ramdisk.img.gz,并使用命令 gunzip ramdisk.img.gz,然后新建一个文件夹,叫ramdisk吧,进入,输入 命令cpio -i -F ../ramdisk.img,这下,你就能看见并操作ramdisk里面的内容了。然后把Android源码编译后生成的system和 userdata里的文件复制到 ramdisk/system和ramdisk/userdata下。这样就得到一个文件系统了。还会发现,根文件系统下的sys就是一个linux。
在android 1.5 模拟器上加载 android 2.1 的系统:
本 文编译出来的3个img文件是2.1版的。可以用system.img和ramdisk.img 替换1.5的版本:
命令如下:
打 开android 1.5的模拟器 ,同时加载system.img和ramdisk.img
emlator -avd sdk_1_5 -ramdisk [ramdisk.img路径] -system [system.img的路径]
启 动后可以看到设置中的手机版本变成了2.1版。
关于这个其实google是有说明的http://source.android.com/source/downloading.html,为了防止连接数过多,每个ip都需要认证。。。
第一步:从这里 the password generator 获取用户名和密码
第二步:将上面的页面上以machine开头的两行复制到 ~/.netrc文件中
第三步:repo init -u https://android.googlesource.com/a/platform/manifest 多了个“/a”
然后就可以repo sync了
特别注意.netrc文件是在用户的根目录下,root用户就是/目录下,如果没有的话就自己建一个,把权限改为 *00