Android Studio Jellyfish | 2023.3.1

Android Studio 是开发 Android 应用的官方 IDE,包含构建 Android 应用所需的所有功能。

本页列出了稳定渠道中的最新版本 Android Studio Jellyfish 的多项新功能和改进。您可在此处下载最新版本,也可在 Android Studio 中依次点击 Help > Check for updates(在 macOS 上则为 Android Studio > Check for updates)更新到最新版本

如需了解此版 Android Studio 中已修复的问题,请参阅已解决的问题

如需查看旧版 Android Studio 的版本说明,请参阅过往版本

如需抢先体验即将发布的功能和改进,请参阅 Android Studio 预览版 build

如果您在 Android Studio 中遇到问题,请查看已知问题问题排查页面。

Android Gradle 插件和 Android Studio 兼容性

Android Studio 构建系统以 Gradle 为基础,并且 Android Gradle 插件 (AGP) 添加了几项专用于构建 Android 应用的功能。下表列出了各个 Android Studio 版本所需的 AGP 版本。

Android Studio 版本 所需的 AGP 版本
考拉 | 2024 年 1 月 1 日 3.2-8.5
水母 | 2023 年 3 月 1 日 3.2-8.4
Iguana | 2023.2.1 3.2-8.3
Hedgehog | 2023.1.1 3.2-8.2
Giraffe | 2022.3.1 3.2-8.1
Flamingo | 2022.2.1 3.2-8.0

旧版

Android Studio 版本 所需的 AGP 版本
Electric Eel | 2022.1.1 3.2-7.4
Dolphin | 2021.3.1 3.2-7.3
Chipmunk | 2021.2.1 3.2-7.2
Bumblebee | 2021.1.1 3.2-7.1
Arctic Fox | 2020.3.1 3.1-7.0

如需了解 Android Gradle 插件的新变化,请参阅 Android Gradle 插件版本说明

特定 Android API 级别所要求的最低工具版本

Android Studio 和 AGP 需要满足最低版本要求才能支持特定 API 级别。如果使用的 Android Studio 或 AGP 版本低于项目的 targetSdkcompileSdk 所要求的版本,可能会导致意外问题。我们建议您使用最新的预览版 Android Studio 和 AGP 来处理以预览版 Android OS 为目标平台的项目。您可以安装 Android Studio 的预览版以及稳定版

Android Studio 和 AGP 的最低版本如下所示:

API 级别 最低 Android Studio 版本 最低 AGP 版本
VanillaIceCream 预览版 水母 | 2023 年 3 月 1 日 8.4
34 Hedgehog | 2023.1.1 8.1.1
33 Flamingo | 2022.2.1 7.2

以下是 Android Studio Jellyfish 中的新功能。

补丁版本

以下是 Android Studio Jellyfish 和 Android Gradle 插件 8.4 中的补丁版本列表。

Android Studio Jellyfish | 2023.3.1 补丁 2 和 AGP 8.4.2(2024 年 6 月)

重要安全更新:Android Studio Iguana | 2023.2.1 及更高版本的 GitHub 插件中有一个安全漏洞,可能会导致未经授权的人员泄露访问令牌。

修复程序:JetBrains 解决了 IntelliJ 平台产品中的问题,并且 Android Studio Jellyfish | 2023.3.1 补丁 2 (2023.3.1.20) 中提供了该修复程序。

如果您已有稳定版上的 Android Studio build,可以依次点击 Help > Check for Updates(在 macOS 上,依次点击 Android Studio > Check for Updates)来获取更新。否则,请下载最新的稳定版 build

此外,如果您在 IDE 中积极使用了 GitHub 拉取请求功能,我们强烈建议您撤消该插件使用的所有 GitHub 令牌。如果该插件可以使用 OAuth 集成或个人访问令牌 (PAT),请检查二者,并根据需要撤消:

  • 如需撤消 OAuth 集成的访问权限,请转到应用 > 已获授权的 OAuth 应用,然后撤消 JetBrains IDE 集成令牌的访问权限。
  • 如需撤消 PAT 的访问权限,请转到个人访问令牌,并删除为 GitHub 插件颁发的令牌。默认令牌名称是 IntelliJ IDEA GitHub 集成插件,但您可能使用的是自定义名称。

撤消令牌的访问权限后,您需要重新设置该插件,使所有插件功能(包括 Git 操作)重新正常工作。

对于由此带来的任何不便,我们深表歉意。并敦促所有用户立即更新,以保护他们的代码和数据。

本次要更新还包含这些 bug 修复

Android Studio Jellyfish | 2023.3.1 补丁 1 和 AGP 8.4.1(2024 年 5 月)

此项次要更新包含这些 bug 修复

隆重推出 Android Studio 中的 Gemini

Android Studio 中的 Gemini 是 Android 开发的编码助手。它是 Android Studio 中依托 AI 技术的对话式体验,可帮助您回答 Android 开发查询,帮助您提高工作效率。如需了解详情,请参阅在 Android Studio 中探索 Gemini

新的登录流程

使用开发者帐号登录 Android Studio 后,您可以直接从 IDE 中受益于各种 Google 开发者服务,例如在 App Quality Insights 中查看 Firebase Crashlytics 和 Android Vitals 报告,通过 Android Studio 中的设备串流访问真实的远程设备,以及使用 Android Studio 中的 Gemini 编写更高质量的代码。

借助 Android Studio Jellyfish,您可以更轻松地添加和管理帐号,并且只需为 IDE 提供每项功能所需的权限。首先,请执行以下某项操作:

  • 前往上文提到的其中一项功能,并按照提示登录,并提供必要的权限。
  • 如果您已登录,可以依次点击 File(在 macOS 上为 Android Studio)> Settings > Tools > Google Accounts 来管理帐号和权限。

在 Android Studio 中通过 Device Streaming 访问真实设备

借助 Android Studio 中的 Device Streaming,您可以安全地连接到托管在 Google 安全数据中心内的远程实体 Android 设备。它由 Firebase 提供支持,是针对真实设备(包括 Google Pixel 8 Pro、Pixel Fold、部分三星设备等)测试应用的最快速、最简单的方法。

在 Android Studio 中使用 Device Streaming 的动画。

连接到设备后,您可以部署应用、查看屏幕、与设备互动(包括旋转或展开设备),以及通过 SSL 直接连接 adb 与设备执行任何其他操作,所有这些操作都无需离开 Android Studio。当您使用完设备后,Google 会擦除您的所有数据并将设备恢复出厂设置,然后再将其提供给其他开发者。

在当前 Beta 版期间,您可以通过 Spark 或 Blaze 方案免费使用设备串流功能。如需开始使用,请在 Android Studio 中登录您的开发者帐号,并选择一个 Firebase 项目。如果您还没有 Firebase 项目,可以很容易创建一个。如需了解详情,请参阅 Android Studio 中的设备串流

App Quality Insights 支持 ANR、自定义数据和多事件

通过对 ANR 报告、自定义数据和多事件的支持,深入了解 Android Studio Jellyfish 中的应用质量数据分析 (AQI) 崩溃报告:

  • 遍历事件:现在,按时间倒序探索 Crashlytics 报告中的多个事件,揭示模式以加快调试速度。
  • 探索自定义数据:查看每个崩溃报告的自定义键/值和日志(选择报告后,在“键”和“日志”标签页中找到它们)。
  • 分析 ANR:直接在 Android Vitals 和 Crashlytics 标签页中访问和调查 ANR。
App Quality Insights 中的多事件、ANR 和自定义数据。

嵌入式布局检查器

布局检查器现在默认嵌入在 Running Devices 工具窗口中。这项集成可节省屏幕空间,将您的工作流集中到一个工具窗口中,并显著提升性能,将渲染速度提升 50%。您可以轻松在深入检查应用与应用交互,以及使用快照实现界面的 3D 可视化。如需了解全部功能,请参阅使用布局检查器调试布局

App Links Assistant 现在支持验证应在您的网站上发布的 Digital Asset Links JSON 文件

此功能扩展了您在应用的清单文件中声明的 intent 过滤器的现有验证功能。对于清单文件中声明的每个网域,Google 助理会在您的网站上解析该文件,执行七次验证检查,并详细说明如何修正所有错误。

可以按以下步骤开始操作:

  1. 在 Android Studio 中,依次点击 Tools > App Links Assistant
  2. 双击链接可详细了解 Google 助理执行的检查,并了解如何修复错误配置。

请验证您的 JSON 文件的格式是否正确,以便上传到您的网域,从而提供顺畅的用户体验。

基准配置文件安装

对于使用 AGP 8.4 或更高版本的项目,在设备上安装后,Android Studio Jellyfish 会自动编译基准配置文件。这包括通过基准配置文件生成器模块或从 Compose 等库生成的基准配置文件。自动安装可让您在本地安装发布版应用时以及使用低开销性能剖析时,体验基准配置文件的性能优势。

Compose 界面检查中新增了色盲检查

Compose UI Check 包含新的色盲模拟和检查,使您能够为所有用户打造视觉无障碍体验。只需从 Compose 预览进入界面检查模式,即可在不同类型的色觉缺陷下查看 Compose 界面,确保您的设计保持清晰易用。

Compose 界面检查 Colorblind 示例

使用设备镜像重定向音频

从 Android Studio Jellyfish Canary 5 开始,您可以将音频从已连接的实体设备重定向到计算机扬声器或耳机。借助音频重定向,您可以让耳机保持连接到计算机的状态,同时聆听计算机和已连接的手机,而无需手动重新连接到一台设备,然后再重新连接到另一台设备。如需启用音频重定向,请依次前往 Android Studio > Settings > Tools > Device Mirroring,然后选择 Redirect audio from local devices。请注意,无论设置如何,对于搭载 Android 12 或更高版本的 Firebase Test Lab 设备,始终会重定向音频。

IntelliJ 2023.3 平台更新

Android Studio Jellyfish 包含 IntelliJ 2023.3 平台版本,该版本具有许多新功能,例如全面支持最新的 Java 21 编程语言功能、包含修改操作的直观浮动工具栏,以及调试程序中的 Run to Cursor 内嵌选项(可加快工作流程)。如需了解详情,请参阅 IntelliJ 版本说明