-
这里推荐一个在线源码阅读的网站 , 速度非常快 , 而且支持文件名查询 , 如果你想找某一个类在哪个模块但是又不清楚的话 , 就可以使用它先搜一下 ;
-
首先要安装一个GitBash (小乌龟也可以 , 但是GitBash比较灵活 , 推荐使用) ;
下载URL : https://git-scm.com/downloads
如果下载链接失效 , 直接搜索GitBash找到一个下载即可
GitBash安装好以后就可以直接使用 , 不需要登录等操作 ;
-
由于有墙 , 所以谷歌托管代码的网站 https://android.googlesource.com 上不去 , 有下面两种方法解决这个问题 :
- 使用梯子或者海外节点下载 ;
- 使用清华大学的开源软件镜像站进行下载 (它与谷歌托管代码的网站是同步的 , 而且不需要用梯子 , 速度挺快的) ;
AOSP(Android Open Source Project)相关页面为 :
https://mirrors.tuna.tsinghua.edu.cn/help/AOSP/
使用方法为 : 下载url中的
https://android.googlesource.com/ 全部使用
https://aosp.tuna.tsinghua.edu.cn/ 代替即可
(参考 Google 教程 https://source.android.com/source/downloading.html)
(有墙 , 但是网上有文档) 在正式下载源码前 , 还有很重要的一个步骤 , 就是选择你想要下载的源码版本以及想要下载的模块 , 比如你想要查看蓝牙模块中BLE相关的代码 , 但是不同版本实现的bluetooth不一样 , 4.3前没有 BLE 而4.4以后有了 BLE , 这时候你就要手动选择安卓版本 , 接下来就讲解如何获取对应版本的模块以及查找下载路径 ;
-
首先需要把Android的Manifest拉取下来(由于是清单文件 , 所以此git库非常的小 , 仅仅是一些配置信息)
执行 git clone https://aosp.tuna.tsinghua.edu.cn/platform/manifest.git manifest
这行命令的最终结果为 :
如果你在D盘执行这行命令 , 那么gitbash会创建一个manifest的目录 , 然后把.git目录和相应的文件拉取到这个新目录中 ;
目录为 D:manifest/...
这个目录下有一个 default.xml 文件 , 这个文件中就有你需要的android源码的路径以及模块名字 ;
可是这时候android版本可能不是你需要的版本 ;
所以最好手动指定一下版本 ; 当把这个清单文件拉取下来后 , 在gitbash窗口中进入对应目录 , 如果不会操作可以关掉以后在该目录中 右键->GitBash here ;
-
接下来就是查找版本了
执行 git tag
这时候会出现所以打了tag的版本(一般只有正式版本才会打tag) , 然后从里面找出你需要的android版本 , 把名字复制下来 ;
打了tag的有很多 , 其中除了Android源码还有Gradle , android-cts , android-sdk 的源码 , 注意不要找错了 ; -
当你找到了需要的android版本以后(这里以 android-6.0.1_r81 版本为例)
执行 : git checkout android-6.0.1_r81
这时候你的分支就由master变为 android-6.0.1_r81 了
这个时候打开 D:manifest/default.xml , 然后就可以看到不同project(工程/模块)的path , name等信息了 ;
在最前面的default标签中 , 有当前清单对应的版本信息了 (revision属性)
到了这一步 , 几乎可以说大功告成了 , 接下来只要拼接好git库的url , 然后执行clone命令就可以了 ;
这里以默认的输入法OpenWnn模块为例
(之所以用这个为例是因为framework/base在github上已经托管了 , 但是其他的没有找到 , 而packages目录下的那些默认的app也是需要分析的)
首先从path中定位到你需要的模块路径 , 然后把它的name记录下来 ;
<project path="packages/inputmethods/OpenWnn" name="platform/packages/inputmethods/OpenWnn" groups="pdk-fs" />
这里的 path 是工程目录下对应的路径 , name是下载时候拼接url用的 ;
下载url拼接原则为 : "https://aosp.tuna.tsinghua.edu.cn/" + name + ".git"
示例如下 :
执行 : git clone https://aosp.tuna.tsinghua.edu.cn/platform/packages/inputmethods/OpenWnn OpenWnn
- 接着就等待下载进度走完了 , 就可以进行查阅修改等操作了 ;
- 果你想用梯子的话 , 那么所有操作只需要把
https://aosp.tuna.tsinghua.edu.cn/ 替换回
https://android.googlesource.com/即可 ;
包括获取manifest的步骤 ; - 由于清单文件可能会改变(比如Google调整了目录结构) , 所以在拉取一个模块前最好能够更新一下清单文件 ;
