1. 前言
学习编程三年，已经确信，学习一门技术最好的资料就是官方文档。如今，拖沓了很久的Android学习计划，终于启动。学习资料：Android官方文档；学习方法：写demo写博客（总结）。
2. 阅读途径
2.1. 官网
http://developer.android.com/index.html
不幸的是，这个网站的国内访问速度，慢到令人发指。很多时候，根本打不开。当然，如果你喜欢翻墙玩，就另当别论。
2.2. 国内镜像站
不得不说，咱们国家有很多雷锋。国外的网站不好访问，那就在国内搭建一个镜像站，方便大家访问。这里郝同学推荐几个国内镜像站供大家使用：
1、踏得网
http://wear.techbrood.com/training/index.html
2、Android中文API
http://www.android-doc.com
http://www.android-doc.com/reference/packages.html
http://www.android-doc.com/guide/components/activities.html
3、Android官方培训课程中文版(v0.9.2)
http://hukai.me/android-training-course-in-chinese/index.html
2.3. 离线文档
打开adt中的SDK Manager，安装Documentation for Android SDK。安装好之后，在adt/sdk/docs目录下，就是官方文档了。
当然，我们也可以直接下载别人下载打包好的官方文档，速度会快很多。
这时候问题来了，docs里的很多文件，会加载谷歌的字体和js。这样，严重拖慢了打开速度。
3. 解决办法
3.1. 修改index.html
打开index.html，然后注释掉stylesheet和js两个地方：
3.2. 修改本机hosts文件
C:\Windows\System32\drivers\etc\hosts
增加如下部分：
1
2
| 127.0.0.1 fonts.googleapis.com
127.0.0.1 www.google.com
|
3.3. Java实现批量注释
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
|
import java.io.BufferedReader;
import java.io.BufferedWriter;
import java.io.File;
import java.io.FileNotFoundException;
import java.io.FileReader;
import java.io.FileWriter;
import java.io.IOException;
public class FormatDoc {
public static int j=1;
public static void main(String[] args) {
File file = new File("D:/android/android-sdk-windows/docs/");
searchDirectory(file, 0);
System.out.println("OVER");
}
public static void searchDirectory(File f, int depth) {
if (!f.isDirectory()) {
String fileName = f.getName();
if (fileName.matches(".*.{1}html")) {
String src= "<(link rel)[=]\"(stylesheet)\"\n(href)[=]\"(http)://(fonts.googleapis.com/css)[?](family)[=](Roboto)[:](regular,medium,thin,italic,mediumitalic,bold)\"( title)[=]\"roboto\">";
String src1 = "<script src=\"http://www.google.com/jsapi\" type=\"text/javascript\"></script>";
String dst = "";
annotation(f, src, dst);
annotation(f, src1, dst);
}
} else {
File[] fs = f.listFiles();
depth++;
for (int i = 0; i < fs.length; ++i) {
File file = fs[i];
searchDirectory(file, depth);
}
}
}
public static void annotation(File f, String src, String dst) {
String content = FormatDoc.read(f);
content = content.replaceFirst(src, dst);
int ll=content.lastIndexOf(src);
System.out.println(ll);
FormatDoc.write(content, f);
System.out.println(j++);
return;
}
public static String read(File src) {
StringBuffer res = new StringBuffer();
String line = null;
try {
BufferedReader reader = new BufferedReader(new FileReader(src));
int i=0;
while ((line = reader.readLine()) != null) {
if (i!=0) {
res.append('\n');
}
res.append(line);
i++;
}
reader.close();
} catch (FileNotFoundException e) {
e.printStackTrace();
} catch (IOException e) {
e.printStackTrace();
}
return res.toString();
}
public static boolean write(String cont, File dist) {
try {
BufferedWriter writer = new BufferedWriter(new FileWriter(dist));
writer.write(cont);
writer.flush();
writer.close();
return true;
} catch (IOException e) {
e.printStackTrace();
return false;
}
}
}
|
3.4. C++实现批量注释
详见参考文档：优化Android离线文档的访问速度。
velable兄很牛逼，感谢他分享给我们的代码和文档！郝同学存入了网盘一份，方便大家下载。
源代码：http://yunpan.cn/cj7VgRg9tUS6e 访问密码 edb4
文档：http://yunpan.cn/cj7Vsaavmey62 访问密码 4e38
4. 参考文档
Android帮助文档本地打开慢的解决方案
http://blog.csdn.net/wc0077/article/details/39669885
优化Android离线文档的访问速度
http://git.oschina.net/velable/OptAndroidDocs
Android离线文档，急速访问+搜索功能正常。
http://git.oschina.net/velable/Android_Offline_Docs
