使用 Android Compatibility Package 来简化开发工作

使用 Android Compatibility Package 来简化开发工作

http://yunfeng.sinaapp.com/?p=182

在今年3月份的时候,Android发布了一个被称为”compatibility package“的兼容开发包. 该兼容开发包主要包含了Android最新平台上的最酷的特性,这样的话,当你在为旧版本的Android设备开发程序的时候,就可以使用这个兼容开发包来使用最新的Android特性,而不用自己重新开发,
从而减轻了开发者的开发任务.

其中最常用的2个组件就是ViewPager和Fragment. 例如在Google+ app中信息流中就使用了.效果如下:



比如在Android 3.0中包含了几个新加的特性, 这些功能可以通过android compatibility package v4 来在旧版本上使用:

Fragment

FragmentManager

FragmentTransaction

ListFragment

DialogFragment

LoaderManager

Loader

AsyncTaskLoader

CursorLoader

Android 兼容开发包的类库名称(jar包的名称)是”android-support-vX.jar”,其中的”X”代表该兼容开发包支持的最小版本号. 目前只
包含2个版本一个是v4 需要android 1.6以上的系统才能使用; 一个是v13 需要andorid 3.2以上的系统才能使用.

下载Android兼容开发包

通过”Android SDK and AVD Manager”可以下载,具体操作过程:

启动 SDK and AVD Manager.如果你使用的是Eclipse,可以通过菜单 Window > Android SDK and AVD Manager; 如果你使用的是Windows操作系统,可以通过sdk目录中的 “

SDK Manager.exe"来启动; 如果你使用的是linux系统 可以通过<sdk>/tools 目录中的android脚本来启动.

选择左边的”Available packages”,然后展开右边的” Android Repository”, 然后选择最下面的”Android Compatibility package ” 然后点击右下方的” Install selected”按钮.

等待安装完成后的提示信息.

使用下载工具(例如 迅雷)自己下载安装:
由于一些众所周知的原因,Google的服务在国*内时不时的不能正常使用, 在下载Andorid开发工具的时候也是如此, 有时候下载了80%了 结果提示下载失败! 如果您经常遇到这种情况或者下载速度很慢, 可以通过其他方式下载.
最新版本的兼容开发包的下载地址是: https://dl-ssl.google.com/android/repository/compatibility_r03.zip 大小是541696字节, 效验码(sha1)是”49e32c0aca8e52c2e9a398912a68c036583b917f”
下载完后把compatibility_r03.zip 这个文件解压到 <sdk>/extras/android/ 目录下即可. 解压后可以得到一个compatibility目录, 该目录下有各个版本的兼容开发包目录,上面下载的开发包包含2个版本 一个是v4;一个是v13. 每个目录下面分别包含示例代码和开发包的源代码.

如何使用兼容开发包

使用兼容开发包和使用第三方jar包一样,直接添加到项目引用的类库中就可以了:

在您的andorid项目跟目录中创建一个名称为”

libs"的目录

复制您要使用版本的兼容开发包到

libs/

目录.支持API Level 4 (Android 1.6)的jar包位于:

<sdk>/extras/android/compatibility/v4/android-support-v4.jar

.

把该jar包添加到类路径中.如果您使用Eclipse,只需要在Package Explorer中选中”libs”目录下的”android-support-v4.jar” 然后点击右键, 选中 Build Path > Add to Build Path. 添加成功后您会发现该jar包出现到了一个名称为”Referenced Libraries”的节点中.

现在您的app就可以使用兼容开发包了,所有支持的特性都在

android.support

包中 (例如,

android.support.v4

).

Tip: 如果要更详细的研究这些API如何使用,请参看位于

extras/android/compatibility/<version>/samples/ 目录中的示例代码.

参考文档

当前该工具包并没有提供开发文档,但是您可以使用javadoc工具来自己生成, 你可以通过如下步骤来生成v4版本的docs文档:

cd <sdk>/extras/android/compatibility/v4/
mkdir docs
javadoc -sourcepath src/java/ -subpackages android.support.v4 -d docs

使用浏览器打开

docs/index.html

文件即可查看文档.

更多示例

除了下载的兼容开发包内附带的示例项目外, Google I/O App 也是一个使用了该工具的一个示例, 研究下这个项目的代码,可以看看如何在项目中使用兼容开发包.