Skip to content

Most visited

Recently visited

navigation

支持库设置

如何在开发项目中设置 Android 支持库取决于您想要使用的功能,以及您希望应用支持的 Android 平台版本范围。

本文档将指导您下载支持库软件包以及向开发环境中添加库。

下载支持库

Android 支持存储库软件包作为 Android SDK 的辅助组件提供,可以通过 Android SDK 管理器下载。请按照以下说明操作,获取支持库文件。

要通过 SDK 管理器下载支持库,请执行以下操作:

  1. 启动 Android SDK 管理器
  2. 在 SDK 管理器窗口中,滚动到 Packages 列表末尾,找到 Extras 文件夹并展开(如有必要)以显示其内容。
  3. 选择 Android Support Repository 项。
  4. 点击 Install packages... 按钮。

图 1. Android SDK 管理器以及选择的 Android 支持存储库。

下载后,此工具会将支持库文件安装到您现有的 Android SDK 目录中。库文件位于 SDK 的以下子目录中:<sdk>/extras/android/m2repository/com/android/support/ 目录。

选择支持库

在将支持库添加到应用之前,确定您想要包含的功能以及希望支持的最低 Android 版本。如需了解有关不同库所提供功能的详细信息,请参阅支持库功能

添加支持库

要使用支持库,您必须在开发环境中修改应用项目的类路径依赖关系。必须针对想要使用的每个支持库执行该步骤。

要向应用项目中添加支持库,请执行以下操作:

  1. 确保已使用 SDK 管理器下载 Android 支持存储库
  2. 打开应用的 build.gradle 文件。
  3. 将支持库添加到 dependencies 部分。例如,要添加 v4 core-utils 库,请添加以下行:
    dependencies {
        ...
        compile "com.android.support:support-core-utils:24.2.0"
    }
    

注意:使用动态依赖关系(例如 palette-v7:23.0.+)可能会导致意外的版本更新和回归不兼容问题。我们建议明确指定库版本(例如 palette-v7:24.2.0)。

使用支持库 API

为现有框架 API 提供支持的支持库类与框架类通常具有相同的名称,但前者位于 android.support 类软件包中,或带有 *Compat 后缀。

注意:使用支持库中的类时,确保从相应的软件包中导入类。例如,应用 ActionBar 类时:

  • 使用支持库时为 android.support.v7.app.ActionBar
  • 仅为 API 级别 11 或以上开发时为 android.app.ActionBar

:将支持库添加到应用项目后,我们强烈建议使用 ProGuard 工具准备要发布的应用 APK。除了保护您的源代码外,ProGuard 工具还可以从添加到应用的任意库中移除不使用的类,从而使应用的下载大小尽可能小。如需了解详细信息,请参阅 ProGuard

如需使用支持库某些功能的更多指导,请参见 Android 开发者培训课程指南和示例。如需了解有关支持库中各个类和方法的详细信息,请参阅 API 参考中的 android.support 软件包。

清单声明变更

如果您计划增加现有应用对带有支持库的旧版本 Android API 的向后兼容性,请确保更新应用的清单。具体而言,您应将清单中 <uses-sdk> 标记的 android:minSdkVersion 元素更新为较低的新版本号,如下所示:

  <uses-sdk
      android:minSdkVersion="14"
      android:targetSdkVersion="23" />

清单设置告知 Google Play 您的应用可以安装在 Android 4.0(API 级别 14)及更高版本的设备上。

如果您使用 Gradle 构建文件,构建文件中的 minSdkVersion 设置将替换清单设置。

apply plugin: 'com.android.application'

android {
    ...

    defaultConfig {
        minSdkVersion 16
        ...
    }
    ...
}

在这种情况下,构建文件设置将告知 Google Play 您应用的默认构建变体可以安装在 Android 4.1(API 级别 16)及更高版本的设备上。如需了解有关构建变体的详细信息,请参阅构建系统概览

:如果添加多个支持库,则最低的 SDK 版本必须是任意指定库所要求的最高版本。例如,如果您的应用中包含 v14 Preference 支持库v17 Leanback 库,则最低的 SDK 版本必须为 17 或更高。

This site uses cookies to store your preferences for site-specific language and display options.

Get the latest Android developer news and tips that will help you find success on Google Play.

* Required Fields

Hooray!

Follow Google Developers on WeChat

Browse this site in ?

You requested a page in , but your language preference for this site is .

Would you like to change your language preference and browse this site in ? If you want to change your language preference later, use the language menu at the bottom of each page.

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a short survey?
Help us improve the Android developer experience.
(Sep 2017 survey)