• 更新 IDE 和 SDK 工具
    • 更新 IDE 和变更渠道
      • 删除未使用的 Android Studio 目录
    • 使用 SDK Manager 更新您的工具
      • 推荐的软件包
      • 编辑或添加 SDK 工具网站
      • 使用 Gradle 自动下载缺失的软件包

    更新 IDE 和 SDK 工具

    安装 Android Studio 后，您可以通过自动更新和 Android SDK Manager 轻松更新 Android Studio IDE 和 Android SDK 工具。

    更新 IDE 和变更渠道

    若有可用的 IDE 更新，Android Studio 将通过小气泡对话框通知您，您也可以点击 Help > Check for Update（在 Mac 中，点击 Android Studio > Check for Updates）手动检查更新。

    您可以通过以下发布渠道获取 Android Studio 更新：

    • Canary 版渠道：此渠道发布前沿版本，大约每周更新一次，可在 developer.android.com/studio/preview 下载。
      除了收到 Canary 版 Android Studio 外，您还会收到其他 SDK 工具的预览版本，包括 Android Emulator。

    虽然这些版本存在较多错误，但已经过测试，我们希望为您提供这些版本，以便您尝试新功能和提供反馈。此渠道不推荐用于生产开发。

    • 开发者版渠道：此渠道发布已通过所有内部测试的精选 Canary 版本。
    • 测试版渠道：此渠道发布基于稳定的 Canary 版本的候选版本，以便在进入稳定版渠道前获得反馈。
    • 稳定版渠道：官方稳定版本，可在 developer.android.com/studio 下载。
      如果您想要在生产 Android 项目中仍然使用稳定版本的同时试用预览版渠道（Canary、开发者或测试版），您可以同时安装两个版本。

    如需变更现有版本的更新渠道，请执行以下操作：

    • 点击 File > Settings（在 Mac 上，点击 Android Studio > Preferences），打开 Preferences 窗口。
    • 在左侧面板中，点击 Appearance & Behavior > System Settings > Updates。
    • 确保已选中 Automatically check for updates，然后从下拉列表中选择一个渠道（见图 1）。
    • 点击 Apply 或 OK。更新 IDE 和 SDK 工具 - Update the IDE and tools - 图1
      图 1. Android Studio 更新首选项。

    删除未使用的 Android Studio 目录

    更新 IDE 和 SDK 工具 - Update the IDE and tools - 图2
    在您首次运行 Android Studio 的主要版本时，如果无法找到 Android Studio 版本的对应安装，IDE 会寻找其目录，其中包含缓存、设置、索引和日志。随后，Delete Unused Android Studio Directories 对话框会显示这些未使用目录的位置、大小和最后更改时间，并提供删除目录的选项。

    Android Studio 认为应该删除的目录如下：

    • Linux：~/.AndroidStudio[Preview]version
    • Mac：~/Library/{Preferences, Caches, Logs, Application Support}/AndroidStudio[Preview]version
    • Windows：%USER%.AndroidStudio[Preview]version

    使用 SDK Manager 更新您的工具

    Android SDK Manager 帮助您下载 SDK 工具、平台和开发应用所需的其他组件。下载后，您可在标题为 Android SDK Location 的目录中找到每个软件包，如图 2 所示。

    要从 Android Studio 中打开 SDK Manager，请点击 Tools > SDK Manager，或点击工具栏中的 SDK Manager更新 IDE 和 SDK 工具 - Update the IDE and tools - 图3。如果您未在使用 Android Studio，可使用 sdkmanager 命令行工具下载工具。

    已安装的软件包如有更新，其旁边的复选框中会显示短划线 更新 IDE 和 SDK 工具 - Update the IDE and tools - 图4。

    • 如要更新项目或安装新项目，请点击复选框，其将显示对勾符号。
    • 如要卸载软件包，请点击以清除复选框。
      待下载的更新在左侧列中以下载图标 更新 IDE 和 SDK 工具 - Update the IDE and tools - 图5 表示。待执行的删除以红色十字 更新 IDE 和 SDK 工具 - Update the IDE and tools - 图6 表示。

    如要更新所选的软件包，请点击 Apply 或 OK，然后同意所有许可协议。
    更新 IDE 和 SDK 工具 - Update the IDE and tools - 图7
    图 2. Android SDK Manager。

    推荐的软件包

    您应该特别考虑 SDK Tools 选项卡中的以下工具：

    • Android SDK Build-Tools
    • 必备。包含构建 Android 应用的工具。请参阅 SDK Build Tools 版本说明。
    • Android SDK Platform-Tools
    • 必备。包含 Android 平台所需的各种工具，包括 adb 工具。
    • Android SDK Tools
    • 必备。包括 ProGuard 等基本工具。请参阅 SDK Tools 版本说明。
    • Android Emulator
    • 推荐。基于 QEMU 的设备模拟工具，可用于在真实的 Android 运行时环境中调试和测试您的应用。请参阅 Android Emulator 版本说明。
      请注意：之前由 Support Repository 软件包提供的大多数 API 库（例如 Android Support Library、Constraint Layout、Google Play 服务，以及 Firebase），现已转由 Google 的 Maven 代码库提供。使用 Android Studio 3.0 及更高版本创建的项目会自动在版本配置中添加此代码库。如您使用旧版项目，则必须手动将 Google 的 Maven 代码库添加至您的 build.gradle 文件。

    在 SDK Platforms 选项卡中，您还必须安装至少一个版本的 Android 平台。每个版本均提供多个不同的软件包。如仅下载所需版本，请点击版本名称旁边的复选框。

    如要查看各 Android 平台的所有可用软件包，请点击窗口底部的 Show Package Details。各版本的平台均提供以下软件包：

    • Android SDK Platform
    • 必备。您的开发环境中必须至少有一个平台，如此才可编译应用。为了在最新设备上提供最佳用户体验，请使用最新版本的平台作为构建目标。您的应用仍然可以在旧版系统上运行，但您必须以最新版本为目标构建应用，以便在安装最新版本 Android 的设备上运行应用时能够使用新功能。
    • Intel 或 ARM System Images
    • 推荐。运行 Android Emulator 需要系统映像。各版本的平台均包含受支持的系统映像。您也可以在稍后从 AVD Manager 中创建 Android Virtual Devices (AVD) 时下载系统映像。根据开发计算机的处理器选择 Intel 或 ARM。
      请注意：如果您计划使用 Google Play 服务中的 API（包括 Firebase），则必须使用 Google API 系统映像，或 Google Play 系统映像（后者包括 Play Store 应用）。

    以上列表并不详尽，您可以添加其他网站，以便从第三方网站下载更多软件包。

    在某些情况下，SDK 软件包可能需要另一个工具的特定最低修订版。如果存在这种情况，SDK Manager 将发出警告通知您，并将依赖项添加到您的下载列表。

    提示：您还可以自定义 build.gradle 文件，以使每个项目均使用特定的系统映像和编译选项。如需了解详细信息，请参阅配置 Gradle 构建。

    编辑或添加 SDK 工具网站

    要管理 Android Studio 检查 Android 工具和第三方工具更新的 SDK 网站，请点击 SDK Update Sites 选项卡。您可以添加其他提供自有工具的网站，然后从这些网站下载软件包。

    例如，某个移动运营商或设备制造商可能会提供由其基于 Android 系统的自有设备支持的额外 API 库。如要使用他们的库开发应用，您可以在 SDK Update Sites 中将其 SDK 工具的网址添加到 SDK Manager，以安装他们的 Android SDK 软件包。

    如果运营商或设备制造商在其网站上提供了 SDK 加载项的存储库文件，请按照下列步骤将其网站添加到 Android SDK Manager：

    • 点击 SDK Update Sites 选项卡。
    • 点击窗口底部的 Add更新 IDE 和 SDK 工具 - Update the IDE and tools - 图8。
    • 输入第三方网站的名称和网址，然后点击 OK。
    • 确保已选中 Enabled 列中相应的复选框。
    • 点击 Apply 或 OK。
      该网站提供的所有 SDK 软件包都将视情况显示在 SDK Platforms 或 SDK Tools 选项卡中。

    使用 Gradle 自动下载缺失的软件包

    如果从命令行运行构建，或者使用 Android Studio 3.3 或更高版本，只要您已经使用 SDK Manager 接受对应的 SDK 许可协议，Gradle 便可自动下载项目依赖的缺失 SDK 软件包。

    在您使用 SDK Manager 接受许可协议后，Android Studio 会在 SDK 主目录中创建一个许可目录。要让 Gradle 自动下载缺失的软件包，必须有此许可目录。

    请注意：使用 android 命令行工具接受许可协议不会创建此许可目录。您必须先使用 SDK Manager 接受协议，方可使用本功能。

    如果您已经在某个工作站上接受许可协议，但希望在另一个工作站上构建项目，则可将已接受的许可目录复制过去，以导出您的许可。要将许可复制至另一台设备，请执行以下步骤：

    • 在已经安装 Android Studio 的设备上，点击 Tools > Android > SDK Manager。注意窗口顶部的 Android SDK Location。
    • 导航至该目录，然后找到其中的 licenses/ 目录。（如果您没有看到 licenses/ 目录，请返回 Android Studio 并更新您的 SDK 工具，以确保接受许可协议。此时，当您再次返回 Android SDK 主目录时，应该就能看到该目录。）

    • 复制整个 licenses/ 目录，将其粘贴至您想要使用其构建项目的设备中的 Android SDK 主目录。
      此时 Gradle 就可以自动下载项目依赖的缺失软件包。

      请注意，您从 Android Studio 中运行的构建会自动停用此功能，因为 SDK Manager 要负责为 IDE 下载缺失的软件包。您还可以在项目的 gradle.properties 文件中设置 android.builder.sdkDownload=false，以手动停用此功能。