支持库设置

注意：Android 9.0（API 级别 28）发布后，新版支持库 AndroidX 也随之诞生，它属于 Jetpack 的一部分。除了现有的支持库，AndroidX 库还包含最新的 Jetpack 组件。

您可以继续使用此支持库。以往的工件（这里指的是打包为 android.support.* 的 27 版及更早版本）在 Google Maven 中仍然可用。不过，所有新库的开发都将在 AndroidX 库中进行。

我们建议在所有新项目中使用 AndroidX 库。您还应该考虑将现有项目迁移到 AndroidX。

如何在开发项目中设置 Android 支持库取决于哪些功能 以及您希望为哪些 Android 平台版本提供支持， 应用。

本文档将指导您下载支持库软件包和添加库 您的开发环境

现在可通过 Google 的 Maven 获取支持库 存储库我们不再支持通过 SDK 下载库 但该功能很快就会被移除。

选择支持库

在将支持库添加到应用之前，请确定您要包含的功能 以及您想支持的最低 Android 版本。如需详细了解这些功能 请参阅 支持库功能。

添加支持库

要使用支持库，您必须修改应用的项目的 类路径依赖项。您必须对 您要使用的每个支持库

要将支持库添加到应用项目中，请执行以下操作：

1. 在项目的 settings.gradle 文件。

   dependencyResolutionManagement {
       repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
       repositories {
           google()
   
           // If you're using a version of Gradle lower than 4.1, you must
           // instead use:
           //
           // maven {
           //     url 'https://maven.google.com'
           // }
       }
   }
   

2. 对于要在其中使用支持库的每个模块，请在 模块的 build.gradle 文件的 dependencies 块。对于 例如，要添加 v4 core-utils 库，请添加以下代码：

   dependencies {
       ...
       implementation "com.android.support:support-core-utils:28.0.0"
   }
   

注意：使用动态依赖项（例如， palette-v7:23.0.+）可能会导致意外的版本更新和 回归不兼容性。我们建议您明确指定 库版本（例如 palette-v7:28.0.0）。

使用支持库 API

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

注意：将支持库添加到应用项目后， 强烈建议您缩减、混淆处理和优化 进行发布除了通过混淆保护您的源代码外，缩减大小 从应用包含的任何库中移除未使用的类，这样可以保留 尽可能缩减应用下载大小

有关如何使用支持库中某些功能的进一步指导，请参阅 Android 开发者 培训课程， 指南 和示例。如需详细了解支持库的各个类和方法，请参阅 请参阅 API 参考文档中的 android.support 软件包。

清单声明变更

如果您要增加现有应用的向后兼容性， Android API 版本和支持库，请务必更新应用的 清单。具体来说，您应更新 android:minSdkVersion 的元素 <uses-sdk> 标记替换为较低的新版本号，如下所示： 如下所示：

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

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

如果您使用的是 Gradle build 文件，build 文件中的 minSdkVersion 设置 覆盖清单设置。

plugins {
  id 'com.android.application'
}

android {
    ...

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

在此示例中，build 文件设置会告知 Google Play 您的应用的 应用可以安装在搭载 Android 4.1（API 级别 16）及更高版本的设备上。有关 请参阅 构建系统概览。

注意：如果您要包含多个支持库， 最低 SDK 版本必须是以下任一项所要求的最高版本： 指定库例如，如果您的应用同时包含 v14 Preference 支持库和 v17 Leanback 库，您的最低 SDK 版本必须为 17 或更高版本。