配置下载Android源代码的过程及问题解决
最近在学习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的初始化
便可看到如第五步中所示的正确结果。3.在第四步的时候终端会询问如下问题:
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帐号进行认证。通常在公司内部网络或者用虚拟机下运行的话,会经常遇到这个问题。
解决方法:
1. 浏览器登录https://android.googlesource.com/new-password,并用gmail帐号登录;
2. 点击网页上的“是”(有些资料上写的是点击“允许访问”,我看到到是“是”),得到类似如下结果:
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)]: hust.mczy@gmail.com
Your identity is: MC <hust.mczy@gmail.com>
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
之后可以做自己的事,让程序自动下载,当你蓦然回首的时候,它已经默默下载成功了。。
总结:
好了,基本上大部分出现的问题都是由于这两个原因造成的,所以对于其他原因,这里我就不详谈了。如果各位按照以上步骤仍然无法下载成功,欢迎给我留言,相信大家互相探讨学习,一定能够客服困难,共同进步!
谢谢~~