最近在学习Android底层框架,今天打算研究一下Android源代码,源码的下载过程可没有想像的顺利。主要原因是网上的很多资料都是多年以前的,而一些网站都发生了变更,所以域名也会失效。OK,废话少说,我把遇到的各种问题和大家分享一下,希望大家能对号入座,避免浪费不必要的时间~
以下是我按照正常下载过程总结出的步骤,遇到的问题将在后面讲述。
第一步:创建下载脚本文件(repo)的存放目录(可任意),这里我选用 ~/android/bin
# mkdir ~/android/bin //创建repo目录 #PATH= ~/android/bin:$PATH //为repo工具配置环境变量,方便后面使用
第二步:下载repo文件:(出错点)
# curl https://dl-ssl.google.com/dl/googlesource/git-repo/repo > ~ /bin/repo//下载repo文件 # chmod a+x ~/bin/repo //修改repo文件的权限设定repo其实是一个应python脚本对Git的封装,主要是为了简化下载Android源代码的步骤。
第三步:创建用于存放Android源代码的目录(可任意),这里我选用~/android/bin/android_source:
# mkdir android_source //创建文件目录 # cd android_source //进入该目录
第四步:初始化:(出错点)
# repo init -u https://android.googlesource.com/platform/manifest //repo的初始化
此时便会要求repo工具自动下载Android源代码(默认是Master分支,也可以下载其他分支)。
如果下载其他分支,使用一下语句:
# repo init -u https://android.googlesource.com/platform/manifest -bandroid-4.4.2_r2 //下载Android4.4.2源代码如果要下载其他版本,分支名参考官方网站:http://git.omapzoom.org/?p=platform/manifest.git;a=tags
随后可看到终端输出如下信息:
Getting repo ... from git://codeaurora.org/tools/repo.git remote: Counting objects: 2818, done. remote: Compressing objects: 100% (863/863), done. remote: Total 2818 (delta 1907), reused 2818 (delta 1907) Receiving objects: 100% (2818/2818), 959.24 KiB | 798 KiB/s, done. Resolving deltas: 100% (1907/1907), done. From git://codeaurora.org/tools/repo * [new branch] aosp-new/maint -> origin/aosp-new/maint * [new branch] aosp-new/master -> origin/aosp-new/master * [new branch] aosp-new/stable -> origin/aosp-new/stable * [new branch] caf-stable -> origin/caf-stable * [new branch] master -> origin/master * [new branch] stable -> origin/stable * [new tag] v1.10.4 -> v1.10.4 * [new tag] v1.12.16 -> v1.12.16 * [new tag] v1.12.2 -> v1.12.2 * [new tag] v1.6.8.1 -> v1.6.8.1 * [new tag] v1.7.5 -> v1.7.5
可以看到Android源代码中的分支([new branch]和[new tag])。
第五步:开始下载Android源代码:
# repo sync //同步,即下载源代码至此,下载Android源代码的基本步骤就到此结束,如果顺利的话,Linux终端可以看到如下的信息:
之后会正式开始下载源代码,下载过程漫长,会根据具体情况的不同速度差异很大,整个过程Git会尽可能占用带宽,朋友们需要耐心等待。
下载过程中可能遇到的问题:
1.首先容易出错的是第二步,这里由于网站或者本地网络的问题,可能会出现如下故障:
root@mc-virtual-machine:~/android/bin# curl https://dl-ssl.google.com/dl/googlesource/git-repo/repo > ~/android/bin/repo % Total % Received % Xferd Average Speed Time Time Time Current Dload Upload Total Spent Left Speed 0 0 0 0 0 0 0 0 --:--:-- 0:00:21 --:--:-- 0
下载会卡在一开始,而且卡住的概率很高。此时不必急着检查问题,可能是暂时的网络故障,可以ctrl + c 中断之后再次执行,尝试多次通常可解决此问题。
2.其次容易出错的地方便是第四步。
由于站点的问题,有些朋友在第四步执行repo init命令的时候会报错,如下:
此时再次执行第四步:./bin/repo: 行 1: 未预期的符号 `newline' 附近有语法错误 ./bin/repo: 行 1: `<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 2.0//EN">'
解决方法:更换repo下载站点,使用如下命令# curl "http://php.webtutor.pl/en/wp-content/uploads/2011/09/repo" > ./repo //获取repo
# repo init -u https://android.googlesource.com/platform/manifest //repo的初始化便可看到如第五步中所示的正确结果。
root@mc-virtual-machine:~/android/bin/android_source# repo init -u https://android.googlesource.com/platform/manifest error: Failed to connect to 2404:6800:4005:c00::52: Network is unreachable while accessing https://android.googlesource.com/platform/manifest/info/refs fatal: HTTP request failed fatal: cannot obtain manifest https://android.googlesource.com/platform/manifest由于访问是匿名的,为了防止连接过多,谷歌对同一IP地址的连接数做了一定的限制。这里需要用gmail帐号进行认证。
Username: git-hust.mczy.gmail.com Password: 1/3t2difm8LDvgpYCdci5nripSiQuWBaIv
随后会在终端中输出如下验证信息:然后将网页上由machine开头到两行复制下来,在linux终端里新建~/.netrc文本文档,复制进去,保存退出。最后在域名中加一个“/a”,完整命令如下
# repo init -u https://android.googlesource.com/platform/manifest //repo的初始化
Your Name [root]: MC Your Email [root@mc-virtual-machine.(none)]: [email protected] Your identity is: MC <[email protected]> is this correct [y/n]? y Testing colorized output (for 'repo diff', 'repo status'): black red green yellow blue magenta cyan white bold dim ul reverse Enable color display in this user account (y/n)?
此时需要验证gmail邮箱,然后输入用户名和Gmail邮箱,选择Y回车即可。
4.最后一步在执行repo sync时,可能会报如下错误:
fatal: '../platform/abi/cpp.git' does not appear to be a git repository fata
解决方法:
进入安装repo的bin目录下一个叫.repo的目录,打开manifest.xml文件(命令gedit manifest.xml)并找到fetch属性,在我的文件中显示fetch="..",将fetch修改为fetch="git://Android.git.linaro.org/",保存并退出。再次执行repo sync 即可开始下载。
5.另外还有一个很少出现的错误。同样是在repo sync时,如果出现如下错误:
remote: Sending approximately 1.11 GiB ... remote: Counting objects: 42, done remote: Finding sources: 100% (42/42) remote: Sending approximately 200.67 MiB ... remote: Counting objects: 18, done remote: Finding sources: 100% (18/18) error: RPC failed; result=56, HTTP code = 2000 KiB/s fatal: The remote end hung up unexpectedly fatal: 过早的文件结束符(EOF) fatal: index-pack failed error: RPC failed; result=56, HTTP code = 200 fatal: The remote end hung up unexpectedly fatal: early EOF fatal: unpack-objects failed error: RPC failed; result=56, HTTP code = 200 fatal: The remote end hung up unexpectedly fatal: 过早的文件结束符(EOF) fatal: index-pack failed error: RPC failed; result=56, HTTP code = 200 fatal: The remote end hung up unexpectedly fatal: 过早的文件结束符(EOF) fatal: index-pack failed这个问题挺尴尬的,这是由于网络信号不顺畅造成的,比较Android官方网站设在国外,国内的网络常常会故障。大家可以留意一下在崩溃之前终端显示的下载速度,是不是由M编程KB ,然后慢慢变小,最后直接崩溃。。。
解决方法:
网络不顺通常是一时的,这里的办法除了换网之外只有反复执行 repo sync。当然这里完全不需要自己去反复执行,可以通过编写一个脚本程序,让计算机在下载崩溃后自动重新下载。在代码目录建立一个脚本(sh)文件,输入如下:
#!/bin/bash echo ¨================start repo sync===============¨ repo sync -f -j10 while [ $? == 1 ]; do echo ¨================sync failed, re-sync again=============¨ sleep 3 repo sync -f -j10 done之后可以做自己的事,让程序自动下载,当你蓦然回首的时候,它已经默默下载成功了。。
总结: