自己翻译的,按照意思翻个大概,留着参考,凑合着看吧。
原文是:Android官网的《Support Library Setup》
你在你开发的项目中配置什么Android Support Libraries,
取决于你想要用什么特性和你想要你的应用支持到哪个Android平台。
这个文档会教你下载Support Library包并把它加到你的开发环境中。
下载 Support Library
Android Support Library包是作为Android SDK的补充而提供下载的,
它通过Android SDK Manager来获得。请按照下面的说明来获得Support Library文件。
To download the Support Library through the SDK Manager:
通过SDK Manager下载Support Library:
- 打开Android SDK Manager
- 在SDK Manager的窗口,把Packages列表滚动到底部,找到Extras这个目录,
如果有必要的话,点击目录小箭头让它展开具体的内容。 - 选择Android Support Library这个选项。
注意:如果你是用Android Studio开发的,则是进行选择并安装Android Support Repository的操作。 - 点击Install packages...按钮。
(我:这里可能是“Install 几个 packages”的按钮,然后有个弹窗问你接不接受,那肯定要接受才行的。)
上图是已在Android SDK Manager中选择了Android Support Library 。
下载完成后,你的Android SDK目录就会安装Support Library的文件。
Support Library那些文件会在你 SDK:<sdk>/extras/android/support/
directory 的目录。
选择Support Library
Before adding a Support Library to your application, decide what features you want to include and the lowest Android versions you want to support. For more information on the features provided by the different libraries, see Support Library Features.
在添加一个Support Library到你的应用之前,
要先决定你想要支持什么特性和你想要支持的Android最低版本。
更多关于不同Library提供什么特性的信息,可以参考官网《Support Library Features》这篇介绍(另外,还可以参考这篇《Android各个Support Library介绍》)。
添加Support Library
为了使用Support Library,你必须修改在你开发环境中应用程序项目的classpath dependencies(姑且叫它“环境变量依赖关系”吧)。对于每个你想要去使用的Support Library,你都必须要执行这个“修改”的操作。
一些Support Library除了编译的类,还包含一些图片和XML文件这样的资源。
例如,v7 appcompat 和 v7 gridlayout 。
如果你不确定某个Support Library是否包含这些资源,可以通过Support Library Features 这个页面来检查。下面的内容将讲述如何为你的应用程序项目添加 有或者没有 资源文件的Support Library。
添加没有资源文件的Library
要为你的项目添加一个没有资源文件的Support Library:
- 请确保你已经在SDK Manager下载了 Android Support Repository;
- 打开你应用程序的build.gradle文件;
- 在
dependencies
这部分代码中,添加support library。例如,要增加v4这个support library,就加下面这一行代码:
dependencies {
...
compile "com.android.support:support-v4:18.0.+"
}
添加有资源文件的Library
To add a Support Library with resources (such as v7 appcompat for action bar) to your application project:
要为你的项目添加一个有资源文件的Support Library(例如 v7 appcompat的action bar):
- 请确保你已经在SDK Manager下载了 Android Support Repository;
- 打开你应用程序的build.gradle文件;
- 在
dependencies
这部分代码中,添加support library特性标识符。例如,要增加appcompat项目,在dependencies
这部分代码增加"com.android.support:appcompat-v7:18.0.+"
这句,就像下面这样:
dependencies {
...
compile "com.android.support:appcompat-v7:18.0.+"
}
使用Support Library的API
Support Library那些为现有框架API提供支持的类,通常跟框架的类有相同的名字,
但是它们是位于android.support class的包,或者有一个*Compat
这样的后缀。
特别提醒:当你用Support Library那些类的时候,一定要确保你import的类是来自合适的包。例如,当要用ActionBar的类:
- 使用Support Library时是
android.support.v7.app.ActionBar
- 在API level 11或以上开发时是
android.app.ActionBar
请注意:在你的项目包含了Support Library后,我们强烈推荐你在应用APK发布之前使用ProGuard这个工具。它除了可以保护你的源代码,还可以把你应用中包含了的那些Library中无用的代码移除掉,这样就能够让你的应用尽可能小。更多信息请点击ProGuard的页面阅览。
【截取自ProGuard 的页面】ProGuard 工具通过移除无用的代码以及使用语义隐晦的名称来重命名类、字段和方法,从而达到压缩、优化和混淆代码的目的。最终您将获得一个较小的 .apk文件,此文件更难于进行反向工程。由于 ProGuard 会使应用更难于进行反向工程,因此当应用使用对安全性要求极高的功能时(例如,当您向应用授予许可时),您必须使用此工具。
Android developer官网的training, guides和samples提供了更多关于Support Library的用法。更多关于某一个Support Library类和方法的信息,可以在“API 参考”的页面点击 android.support查看。
Manifest Declaration Changes
如果你正通过添加Support Library到早期的Android API来为你现有的应用做向下兼容,请记住要修改你应用的manifest。特别要记住,要去更新manifest中<uses-sdk>
这一项标签里面的android:minSdkVersion
,把它更称更低的版本号,像下面这样:
<uses-sdk
android:minSdkVersion="7"
android:targetSdkVersion="17" />
manifest的设置会告诉Google Play,你的应用可以安装在Android 2.1 (API level 7) 和以上版本的设备。
如果你是用Gradle来构建文件,则在build文件中修改minSdkVersion
的设置。
apply plugin: 'com.android.application'
android {
...
defaultConfig {
minSdkVersion 8
...
}
...
}
这种情况下,build文件的设置会告诉Google Play你应用的build variant可以安装在Android 2.2 (API level 8) 和以上版本的设备。更多关于build variant的信息,请参考 Build System Overview。
因为build variant又是另一个知识点,所以就不翻译了。
……
好吧,其实是我不会
请注意:如果你是在你的应用中包含v4 support和v7 appcompat的Library,
你应该将minimum SDK版本指定为"7"(而不是"4")。
你引入到你项目的最高版本Support Library决定了应用可以运行的最低API版本。
代码示例
Each Support Library includes code samples to help you get started using the support APIs. The code is included in the download from the SDK Manager and is placed inside the Android SDK installation directory, as listed below:
每个Support Library都包含代码示例来帮助你上手它的API。从SDK Manager的下载后就会有这些代码,它们是放在Android SDK的安装目录,如下所示:
- 4v Samples:
<sdk>/extras/android/support/samples/Support4Demos/
- 7v Samples:
<sdk>/extras/android/support/samples/Support7Demos/
- 13v Samples:
<sdk>/extras/android/support/samples/Support13Demos/
- App Navigation:
<sdk>/extras/android/support/samples/SupportAppNavigation/
网友评论