本页列出了 Android Studio 预览版中引入的新功能。 预览版 build 可让您抢先体验 Android Studio 中的最新功能和改进。您可以下载这些预览版。如果您在使用 Android Studio 预览版时遇到任何问题,请与我们联系。您的错误报告有助于我们改进 Android Studio。
Canary 版包含正在积极开发中的最新功能,并且经过了小范围测试。虽然您可以使用 Canary build 进行开发,但请注意,功能可能会添加或更改。候选版本 (RC) 是 Android Studio 的下一个版本,几乎已准备好发布稳定版。下一个版本的功能集已稳定。如需了解 Android Studio 版本命名,请参阅 Android Studio 版本名称。
如需了解 Android Studio 预览版发布的最新资讯(包括每个预览版中的重要修正的列表),请参阅 Android Studio 博客中的版本更新。
当前版本的 Android Studio
下表列出了当前版本的 Android Studio 及其各自的渠道。
版本 | 频道 |
---|---|
Android Studio Narwhal 功能更新 | 2025.1.2 | 稳定版 |
Android Gradle 插件 8.12.0 | 稳定版 |
Android Studio Narwhal 3 功能更新 | 2025.1.3 | RC |
Android Studio Narwhal 4 功能更新 | 2025.1.4 | Canary 版 |
与 Android Gradle 插件预览版的兼容性
每个 Android Studio 预览版都会随附相应版本的 Android Gradle 插件 (AGP) 一起发布。Studio 的预览版应可与任何兼容的稳定版 AGP 搭配使用。不过,如果您使用的是 AGP 预览版,则必须使用相应的 Studio 预览版(例如,Android Studio Chipmunk Canary 7 与 AGP 7.2.0-alpha07)。尝试使用不同的版本(例如,Android Studio Chipmunk Beta 1 与 AGP 7.2.0-alpha07)会导致同步失败,并提示您更新到相应版本的 AGP。
如需查看废弃和移除的 Android Gradle 插件 API 的详细日志,请参阅 Android Gradle 插件 API 更新。
Studio Labs
借助 Studio Labs,您可以在 Android Studio 的稳定版中试用最新的 AI 实验性功能,从而更快地将我们的 AI 辅助功能集成到您的开发工作流程中。如需了解详情,请参阅 Studio Labs。
以下是目前在 Studio 实验室中提供的功能。
功能 | 说明 | 文档 |
---|---|---|
Compose 预览生成 | Gemini 可以自动为特定可组合函数或文件中的所有可组合函数生成 Compose 预览,包括预览参数的模拟数据。 | 生成 Compose 预览 |
附加图片 | 在查询中附加图片,以帮助生成界面、调试界面 bug、记录应用架构等。 | 附加图片 |
附加文件 | 将文件附加到查询中,有助于 Gemini 更好地了解问题的上下文,并确定需要更新哪些代码。 | 附加文件 |
转换界面 | 使用自然语言直接从 Compose 预览面板更新应用界面。 | 转换界面 |
Android Studio Narwhal 3 功能更新 | 2025.1.3
以下是 Android Studio Narwhal 3 功能更新 | 2025.1.3 中的新功能。
如需了解此版 Android Studio 中已修复的问题,请参阅已解决的问题。
可调整大小的 Compose 预览
Compose 预览现在支持动态调整大小,让您可以立即直观地了解界面如何适应不同的屏幕尺寸。
如需使用此功能,请在 Compose 预览中通过更改工具栏上的视图选项进入聚焦模式:

您现在可以通过拖动预览窗口的边缘来调整其大小:
或者,您也可以使用在预览调整大小后显示的调整大小工具栏:
如果您想将新尺寸另存为新的 Preview
注释,请使用右键点击菜单:

借助动态调整大小功能,您可以创建在任何屏幕尺寸上都能完美呈现的界面。
用于在相应模块下显示 build 文件的 Android 视图设置
新增了一项设置,可在 Android 视图中将 build 文件显示在其对应的模块下。当您处理包含多个模块的项目时,此视图会很有帮助。如需启用该视图,请打开 Android 视图旁边的选项菜单 。
然后选择 Appearance > Display Build Files In Module。

Android Studio 中的 Play 政策洞见
Android Studio 现在包含更丰富的数据洞察和指导,可帮助您了解可能会对应用产生影响的 Google Play 政策。这些信息有助于您从一开始就构建更安全的应用,从而避免出现可能会中断发布流程并需要耗费更多时间和资源才能在日后解决的问题。
从 Android Studio Narwhal 3 功能更新开始,您可以将 Play 政策洞见视为 lint 检查。这些 lint 检查将显示以下信息:
- 政策概览。
- 了解应做和不应做的事项,避免常见的误区。
- 指向 Play 政策页面的链接,您可以在这些页面上找到完整的正式政策以及更多实用信息和资源。
此功能旨在提供有用的预审核指导,以便您更顺利地提交应用。此功能并未涵盖所有政策,也不会提供最终的应用审核决定。请务必前往政策中心查看完整政策,以获取相关指导。我们也在积极改进和完善此集成。 如果您有任何反馈,请报告。
如需查看您的项目是否有任何 Play 政策数据分析,请依次前往“Code”(代码)>“Inspect for Play Policy Insights…”(检查有无 Play 政策数据分析…)。数据分析将列在“Problems”(问题)工具窗口中,并且还会以 Lint 警告的形式显示在相应文件中。

使用应用备份和恢复功能进行测试和开发
确保 Android 备份和恢复功能在您的应用中正常运行,对于确保用户在改用新设备或从云端恢复数据后继续使用您的应用至关重要。不过,测试数据备份和恢复是否适用于您的应用可能比较困难。
Android Studio Narwhal 提供了一些方法,可用于生成应用的备份并将其恢复到其他设备。如果您想测试应用在将应用数据从一台设备恢复到另一台设备或从云端备份恢复时是否按预期运行,或者如果您想以更快的速度设置测试设备,以便使用开发和调试应用所需的数据,那么此功能会很有用。
生成备份
如需生成备份文件,请执行以下操作:
- 将应用的调试版本部署到连接的设备
- 使用以下任一操作生成备份:
- 在 Running Device 窗口中,点击工具栏中的 Backup App Data 操作
- 从主菜单栏中依次选择 Run > Backup App Data
- 在设备浏览器 > 进程标签页中,右键点击应用进程,然后选择备份应用数据
- 在显示的对话框中,执行以下操作:
- 确认要为其生成备份的应用的应用 ID
- 选择要生成设备到设备、云端或云端(未加密)备份
- 确认要保存的备份的名称和位置。默认情况下,备份会保存到当前 Android Studio 项目的根目录中。
为应用生成备份。
- 确认要为其生成备份的应用的应用 ID
- 当 Android Studio 询问是否可以停止应用时,点击 Ok。为了生成备份,Android Studio 必须停止应用进程。
您可以在 Project > Android 工具窗口中的 Backup Files 节点下查看生成的备份。
备份类型
您可以为应用生成不同类型的备份。生成备份时,请选择与要测试的场景相关的备份类型:
- 设备到设备:生成应用的备份,类似于在设备到设备传输期间创建的备份。在设备到设备传输中,应用的备份数据会直接发送到另一台设备,例如通过 USB 或 Wi-Fi。
- 云端:生成应用的备份,类似于保存到用户 Google 账号存储空间中的备份。用户设置新设备时,可以选择从云端备份中恢复数据。
- 云端(未加密):生成应用的备份,类似于保存到用户 Google 账号存储空间中的备份(在未启用客户端加密的设备上)。
注意:使用该功能测试云端、云端(未加密)或设备到设备备份时,生成的备份不会像实际备份流程那样发送到云端或其他设备。它会生成应用的备份,就像要将备份保存到云端或发送到其他设备一样。为任何备份类型生成的备份都可以在 Project > Android 工具窗口的 Backup Files 下找到。
恢复应用数据
如需恢复应用数据,请执行以下操作:
- 将应用部署到连接的设备。应用应具有与您要恢复到设备上的备份文件相同的应用 ID。
- 找到并点击以下操作之一:
- 在 Running Device 窗口中,点击工具栏中的 Restore App Data 操作,然后从最近的历史记录中选择一个备份文件,或点击 Browse。
- 从主菜单栏中依次选择 Run > Restore App Data。
- 在 Device Explorer > Processes 标签页中,右键点击应用进程,然后选择 Restore App Data。
- 在 Project > Android 工具窗口中,右键点击 Backup Files 节点下的某个备份,然后选择 Restore App Data。
- 如果适用,请从最近的历史记录中选择备份,或点击浏览以从本地存储空间中选择要恢复的备份文件。
或者,您也可以在运行配置中添加备份文件,这样在部署应用时,系统也会从备份文件中恢复应用数据。为此,请执行以下操作:
- 从主菜单栏中依次选择 Run > Edit Configurations。
- 选择应用运行配置,然后前往恢复选项。
恢复运行配置中的选项。 - 如需从备份恢复应用,请勾选恢复应用状态旁边的复选框。
- 您可以从最近的历史记录中选择备份文件,也可以浏览并从本地存储空间中选择备份文件。
- 如果您只想在全新安装应用时恢复应用数据,请勾选 Only restore on fresh apk installation 旁边的复选框。如果您要部署到新的测试设备,并希望恢复数据以帮助进行调试和应用开发,此选项会很有用。
- 点击 OK 以保存运行配置。
- 使用运行配置部署应用,以测试将应用数据恢复到已连接的设备。
Proguard 检查
Android Studio 现在包含检查功能,可防止出现编写不当的 Proguard 规则或阻止 R8 优化的规则。过于宽泛的 keep 规则(例如 -keep class **.*
)和消费者 Proguard 规则配置(例如 dontshrink
和 -dontoptimize
)现在会在 Studio IDE 中触发警告。为了制定出允许代码缩减的有效保留规则,请将规则范围限定为特定软件包,并明确说明要保留的内容。
项目级上下文的 AGENT.md 文件
现在,您可以在项目中包含 AGENT.md
文件。这些是 Markdown 文件,可为 Gemini 提供项目专属的指令、编码风格规则和其他指导信息作为上下文。
Gemini 会自动发现并应用项目内名为 AGENT.md
的任何文件中的指令。如果不存在 AGENT.md
文件,Gemini 会改为查找 GEMINI.md
文件作为后备。
用于停用自动同步的新设置
Android Studio 现在提供了一项设置,可让您从默认的“自动同步”模式(例如,在打开项目时自动运行同步)切换到新的“手动同步”模式(带有提醒)。默认行为仍为自动同步。如需切换到手动同步,请依次前往 File(在 macOS 上,请依次前往 Android Studio)> Settings > Build, Execution, Deployment > Build Tools,然后将项目同步模式设置为手动同步(带提醒)。
从 YouTube 工作室实验室毕业的功能
自 Narwhal 3 功能更新起,Studio Labs 中的以下实验性功能已变为稳定版:
Android Studio Narwhal 4 功能更新 | 2025.1.4
以下是 Android Studio Narwhal 4 功能更新 | 2025.1.4 中的新功能。
如需了解此版 Android Studio 中已修复的问题,请参阅已解决的问题。
Android Studio 学习路线
Android Studio 的 Journeys 可让您使用自然语言来描述每个测试(称为“journey”)的步骤和断言,从而轻松编写和维护端到端测试。通过利用 Gemini 的视觉和推理能力,以自然语言编写的步骤会转换为 Gemini 在您的应用上执行的操作,从而使您能够轻松编写和理解用户历程。此外,您还可以编写和描述更复杂的断言,Gemini 会根据其在设备上看到的内容来评估这些断言,以确定您的测试历程是通过还是失败。
由于 Gemini 会推理出要执行哪些操作才能实现目标,因此即使应用布局或行为发生细微变化,历程也能更可靠地运行,从而在针对不同版本的应用和不同的设备配置运行时,减少测试不稳定的情况。
直接在 Android Studio 中针对任何本地或远程 Android 设备编写和运行历程。IDE 提供全新的编辑器体验,可用于设计历程,还提供丰富的结果,帮助您更好地了解 Gemini 的推理过程以及历程的执行情况。
备份与同步

现在,您可以使用 Google 账号或 JetBrains 账号将 Android Studio 设置备份到云端存储空间。这有助于同步您的设置,例如键映射、代码编辑器设置、系统设置等。如需开始使用,请执行以下操作之一:
在 Android Studio 中打开项目后,点击 IDE 右上角的头像,然后点击登录,登录您的 Google 账号。
- 按照随即显示的对话框中的提示操作,并务必勾选相应复选框,以授权 Android Studio 访问您的 Google 账号存储空间。
- 按照提示为 Android Studio 授权。
依次前往设置 > 备份与同步。
- 选择 Google,以使用 Google 账号存储空间在不同的 Android Studio 安装之间同步应用数据。或者,您也可以使用 JetBrains 账号在 IntelliJ 和 Android Studio 安装之间同步应用数据。
- 按照提示授权 Android Studio 访问首选账号的存储空间后,返回到 Android Studio。
- 在设置 > 备份与同步页面上,您可以查看要同步到您账号的应用数据类别。
- 如需停用“备份与同步”,请取消选中启用该功能的复选框。
如果您已将数据同步到所选设备,Android Studio 会提供以下选项:从远程存储空间下载设置(默认选项),或上传本地设置并覆盖同步到远程存储空间的设置。
针对崩溃问题的建议修复
在 Android Studio Meerkat 功能更新中,我们针对 App Quality Insights 工具窗口中报告的崩溃推出了 Gemini 洞见。现在,Android Studio 可以使用 Gemini 分析崩溃数据和您的源代码,从而建议潜在的修复方案。在 App Quality Insights 工具窗口中选择一个崩溃问题后,前往数据分析标签页,然后在 Gemini 为该崩溃问题生成数据分析后,点击建议修复。然后,Gemini 会生成建议的代码更改,您可以在编辑器差异标签页中查看并接受这些更改。

新增了使用“项目”视图打开新项目的设置
新增了一项设置,可让新项目默认在“项目”视图中打开。 如需启用此设置,请依次前往 File(在 macOS 上,则为 Android Studio)> Settings > Advanced Settings > Project View,然后选择 Set Project view as the default。
Compose 预览版屏幕截图测试工具
使用 Compose 预览版屏幕截图测试工具测试 Compose 界面并防止出现回归。借助此新工具,您可以生成 HTML 报告,直观地检测应用界面中的任何变化。如需了解详情,请参阅 Compose 预览版屏幕截图测试。
嵌入式布局检查器组件树增强功能
借助几项关键改进,现在在嵌入式布局检查器中与组件树互动更加直观高效。 这些更新旨在简化您的工作流程,并让您更清楚地了解 Compose 界面结构。
- 横向滚动:您现在可以在组件树中横向滚动,从而更轻松地浏览和检查宽布局或深度嵌套布局,而不会丢失上下文。
- 选择时自动滚动:现在,在组件树中选择某个项后,视图会自动水平和垂直滚动,以便将所选内容清晰地显示在焦点位置。这样可确保您感兴趣的元素始终位于中心位置。
- 改进了关系可视化:我们改进了组件树中的支持线,以便提供更明确的视觉提示,帮助您了解节点关系。虚线现在可以清晰地指示父节点与其子节点之间的调用堆栈关系,从而帮助您更有效地跟踪程序化连接。实线继续表示树中的所有其他标准父级-子级关系。
这些增强功能旨在提供更顺畅、更高效的调试体验,让您能够快速了解和优化界面。

使用本地 LLM
借助 Android Studio Narwhal 4 功能更新,您可以选择为 IDE 的 AI 功能提供支持的 LLM。

LLM 必须位于本地计算机上,如果您互联网连接受限或对 AI 模型的使用有相关限制,或者您只是想尝试使用开源研究模型,那么这种方式会很有优势。
本地 LLM 可替代 Android Studio 中内置的 LLM 支持。 不过,Android Studio 中的 Gemini 通常可提供最佳 Android 开发体验,因为 Gemini 经过 Android 调整,并且支持 Android Studio 的所有功能。借助 Gemini,您可以为 Android 开发任务选择各种模型,包括免费的默认模型或通过付费 Gemini API 密钥访问的模型。
如需支持本地 LLM,您需要在本地计算机上安装 LLM 提供程序(例如 LM Studio 或 Ollama),并选择兼容的模型。
Android SDK 升级助理现在支持 Android 16 / API 36
Android SDK 升级助理中已添加从 Android 15 / API 35 到 Android 16 / API 36 的迁移。如需获取迁移方面的帮助,请依次点击 Tools > Android SDK Upgrade Assistant。
Android Gradle 插件 9.0
Android Gradle 插件 9.0 是 AGP 的一个全新主要版本,带来了 API 和行为变更。
如需更新到 Android Gradle 插件 9.0.0-alpha02,请使用 Android Studio Narwhal 4 Feature Drop | 2025.1.4 中的 Android Gradle 插件升级助理。
AGP 升级助理有助于在升级项目时尽可能保留现有行为,即使您尚未准备好采用 AGP 9.0 中的所有新默认设置,也可以将项目升级为使用 AGP 9.0。
兼容性
Android Gradle 插件 9.0.0-alpha02 支持的最高 Android API 级别为 API 级别 36。
Android Gradle 插件 9.0.0-alpha02 需要 Gradle 9.0.0。
行为变更
Android Gradle 插件 9.0 具有以下新行为:
行为 | 建议 |
---|---|
Android Gradle 插件 9.0 默认使用 NDK 版本 r28c 。
|
请考虑明确指定要使用的 NDK 版本。 |
Android Gradle 插件 9.0 默认要求库的消费者使用相同或更高的编译 SDK 版本。 |
使用库时,请使用相同或更高的编译 SDK。
如果无法做到这一点,或者您想为所发布库的消费者提供更多时间来切换,请明确设置 AarMetadata.minCompileSdk 。
|
AGP 9.0 包含对以下 Gradle 属性默认值的更新。 这样,您就可以选择在升级时保留 AGP 8.13 行为:
已移除的功能
Android Gradle 插件 9.0 移除了以下功能:
- 嵌入式 Wear OS 应用支持
AGP 9.0 移除了对嵌入式 Wear OS 应用的支持,Play 中不再支持该功能。这包括移除wearApp
配置和AndroidSourceSet.wearAppConfigurationName
DSL。如需了解如何将应用发布到 Wear OS,请参阅分发到 Wear OS 平台。
更改了 DSL
Android Gradle 插件 9.0 包含以下重大 DSL 变更:
- 移除了
CommonExtension
的形参化。 就其本身而言,这只是一个源代码级破坏性变更,旨在帮助避免未来出现源代码级破坏性变更,但这也意味着 DSL 块方法需要从CommonExtension
移至ApplicationExtension
、LibraryExension
、DynamicFeatureExtension
和TestExtension
。
移除了 DSL
Android Gradle 插件 9.0 移除了以下内容:
AndroidSourceSet.jni
,因为它无法正常运行。AndroidSourceSet.wearAppConfigurationName
,因为这与已移除的嵌入式 Wear OS 应用支持有关。BuildType.isRenderscriptDebuggable
,因为它无法正常运行。Installation.installOptions(String)
。它已被Installation.installOptions
的可变属性取代。VariantBuilder.targetSdk
和targetSdkPreview
,因为它们在库中没有意义。请改用GeneratesApkBuilder.targetSdk
或GeneratesApkBuilder.targetSdkPreview
。实验性但从未稳定过的
PostProcessing
块。ProductFlavor.setDimension
,已由dimension
属性取代Variant.unitTest
,因为它不适用于com.android.test
插件。unitTest
可用于扩展HasUnitTest
的VariantBuilder
子类型。VariantBuilder.enableUnitTest
,因为它不适用于com.android.test
插件。enableUnitTest
可用于扩展HasUnitTestBuilder
的VariantBuilder
子类型。移除了
VariantBuilder.unitTestEnabled
,取而代之的是在扩展HasUnitTestBuilder
的VariantBuilder
子类型上命名更一致的enableUnitTest
。
已移除的 Gradle 属性
以下 Gradle 属性最初添加的目的是为了全局停用默认启用的功能。
自 AGP 8.0 或更低版本以来,这些功能已默认停用。仅在使用这些功能的子项目中启用它们,以提高构建效率。
属性 | 功能 | 替换 |
---|---|---|
android.defaults.buildfeatures.aidl |
在所有子项目中启用 AIDL 编译 |
仅在包含 AIDL 源文件的子项目中启用 AIDL 编译,方法是在这些项目的 Gradle build 文件中设置以下属性:
android { buildFeatures { aidl = true } } |
android.defaults.buildfeatures.renderscript |
在所有子项目中启用 RenderScript 编译 |
仅在包含 renderscript 源的子项目中启用 renderscript 编译,方法是在这些项目的 Gradle build 文件中设置以下属性:
android { buildFeatures { renderScript = true } } |
已移除的 API
Android Gradle 插件 9.0 移除了以下内容:
- 已废弃并停用的
BaseExtension.registerTransform
API,这些 API 仅用于在以 AGP 4.2 或更低版本为目标平台的同时,允许针对最新 AGP 版本进行编译。
强制执行的 Gradle 属性
如果您设置了以下 Gradle 属性,AGP 9.0 会抛出错误。
Android Gradle 插件升级助理不会将使用这些属性的项目升级到 AGP 9.0。
属性 | 功能 |
---|---|
android.r8.integratedResourceShrinking |
资源缩减现在始终作为 R8 的一部分运行,之前的实现已被移除。 |