android sdk 文档导读之前传：初涉

    看到csdn博客上面其它大牛的系列性android博客，小弟确实十分羡慕。所以经过一番思想斗争后，小弟终于要打算写写系列性的博客了。通过对一些选题的推敲，我决定对android的sdk文档进行一个比较彻底的研读，并通过博文的形式和大家分享分享，交流交流。哈哈，现在想起来就热血沸腾啊！

    这就是第一次尝试啦。这篇文章主要介绍了android sdk文档的结构和使用方法以及pakage index里面的android这一条的相关知识。

    好啦，废话少说，开动！

一、楔子：关于android sdk文档

    第一，什么是android sdk文档？

    这个问题太白痴了：看到这里，你肯定会在心里这么想。但且慢，这个问题我觉得还是值得谈谈的，理由嘛，看了下面的你就不点自明了。android sdk的全名是android software develop kit，也就是android程序开发工具组。这也就是说，它本质上也就是一个供大家使用的工具而已--和锤子、扳手一样（怪不得代表android开发的logo会是小机器人腰里别着一个扳手和一个锤子   ）。既然是一个工具，而且是由谷哥大大最近几年才猛顶起来的一个新型工具，那么如果想让我们这些对它感兴趣的人能够把它使用自如的话，就必然得有一份详尽的说明书来阐述它在哪里用、怎么用以及如何才是在最好的用。android sdk文档则起到了这个作用：它包含了该工具的几乎各种情况下使用的组件（也就是android sdk中包含的各种类）的介绍--UI构建时、Gps模块调用时、数据库操作时、硬件调用时等等；它让你能够知道各种工具组件该怎么使用--各种类所包含的方法、字段介绍几乎都已涵盖，基本上有一定基础的同学看过即知如何使用该类；它可以使你知道怎样才是在最好的使用该工具--哪些方法已经过期它会告诉你，一些类的特殊属性它会教你怎么最好地使用（例如android.app.Service类的 startForeground (int id, Notification notification) 方法处它就教会了我用java反射机制来调用父类无法继承给子类的final方法）。到了这里，我们可以这么描述android sdk文档了：一份android sdk的使用说明书。

 

    第二，哪里可以看到sdk文档？

    看sdk文档有两个途径，在线网页浏览和离线文档浏览。

    在线的地址是：developer.android.com（被河蟹掉了，表示极为不解，可以去这里，感谢FaxLJ的提醒）

    离线查看无需你再去单独下载文档包，因为如果你当初下载android sdk时选择完整下载了，文档就被一并下载到本地了。一般andorid sdk的根目录里的docs文件夹就是文档所在地，里面有一个index.html，打开它就可以看到sdk文档的homepage。

    个人推荐离线查看，虽然可能不是最新版本的文档，但总比翻墙被龟速折磨来的好些╮(╯▽╰)╭。

    第三、文档重要性。

    以前我刚开始学java的时候曾经做过一件很脑残的事情：看到System.out.println("Hello World!");这一句代码时我就想知道System是一个什么样的东西，于是就去网上搜索--可是花了很多时间，也看了一些文章，但就还是无法对System有一个系统性的了解--还是到后来了解到java文档，把java文档下载下来（java文档在sdk里默认是不包含的）后去看了才把它了解透--What a shame!好了，不用我说你也就应该了解到了sdk文档的重要性：文档是官方提供的，所以具有无以伦比的权威性；文档是起说明式作用的，所以你想要知道什么，"骡迹"上是都会给你提供的；因为文档是很重要的，所以文档是很重要的。我建议大家要养成一个习惯，以后遇到疑问时，首先应该想到去sdk文档上查找，然后再去百度上google：这样做一来可以锻炼自己理解E文的能力，二来也会让自己的印象更深刻些。

    第四、关于文档的好东东推荐