Android源码中学习文档如何查看

备注：源码中的docs包是Android7.0中的docs包。
Android源码中其实已经给开发者提供好了开发文档。我们常常需要翻墙上google官网查阅一些资料。但是今天发现其实Android源码中已经自带了google官网的学习文档，我们本地使用google_appengine引擎就可以在本地查阅google的学习文档了。

1、下载google_appengine源码包

这个在CSDN上可以下载到,如下所示，我本人就是使用这个版本，成功运行起来了。
google_appengine源码下载地址

2、编译文档源码

• 文档源码的位置就是Android源码根目录的docs目录下。如下图中的docs
  

  

• 编译文档源码，在源码根目录下执行下面命令。
  make online-sac-docs
  执行完后，会在/out/target/common/docs/online-sac生成，可供google_appengine解析的文档，如果直接打开是不形的。

3、运行google_appengine查看google原生文档

执行下面命令：其中dev_appserver.py就是google_appengine源码包解压出来后的python脚本。当然它的路径也是可以随便放的。

    python /bin/google_appengine/dev_appserver.py \
    out/target/common/docs/online-sac \
    --address 0.0.0.0 --port 8080 &
   
   
1
2
3
   
   

    
    
   
   

当时我本地执行命令

shzk11@SHZKTMP11U:~/bin$ python /home/shzk11/bin/google_appengine/dev_appserver.py /home/shzk11/bin/apache-tomcat-7.0.59/webapps/online-sac
INFO     2017-06-07 04:40:40,092 sdk_update_checker.py:242] Checking for updates to the SDK.
INFO     2017-06-07 04:40:40,591 api_server.py:171] Starting API server at: http://localhost:34442
INFO     2017-06-07 04:40:40,680 dispatcher.py:182] Starting module "default" running at: http://localhost:8080
INFO     2017-06-07 04:40:40,681 admin_server.py:117] Starting admin server at: http://localhost:8000
INFO     2017-06-07 04:44:02,165 module.py:640] default: "GET /index.html HTTP/1.1" 200 12158
INFO     2017-06-07 04:44:03,108 module.py:640] default: "GET /assets/css/default.css HTTP/1.1" 200 91976
INFO     2017-06-07 04:44:03,116 module.py:640] default: "GET /assets/js/android_3p-bundle.js HTTP/1.1" 200 421863
INFO     2017-06-07 04:44:03,123 module.py:640] default: "GET /assets/images/sac_logo.png HTTP/1.1" 200 2298
INFO     2017-06-07 04:44:03,125 module.py:640] default: "GET /assets/js/docs.js HTTP/1.1" 200 81579
INFO     2017-06-07 04:44:03,151 module.py:640] default: "GET /images/android_framework_small.png HTTP/1.1" 200 110311
INFO     2017-06-07 04:44:03,337 module.py:640] default: "GET /assets/images/more_mid.png HTTP/1.1" 200 958
INFO     2017-06-07 04:44:03,337 module.py:640] default: "GET /assets/images/more_bottom.png HTTP/1.1" 200 1055
INFO     2017-06-07 04:44:03,337 module.py:640] default: "GET /assets/images/more_top.png HTTP/1.1" 200 1447
INFO     2017-06-07 04:44:03,337 module.py:640] default: "GET /assets/images/icon_more.png HTTP/1.1" 200 1098
   
   
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
   
   

    
    
   
   

运行效果，注意看地址：

呵呵，以后可以本地查看google官网文档了。