Android Studio 预览版中的新功能

此页面列出了 Android Studio 预览版中引入的新功能和改进。预览版提供 Android Studio 最新功能和改进的早期访问权限。您可以下载这些预览版本。如果您在使用 Android Studio 预览版时遇到任何问题，请告诉我们。您的错误报告有助于使 Android Studio 变得更好。

Canary 版本包含正在积极开发的前沿功能，并且经过轻度测试。虽然您可以将 Canary 版本用于开发，但请注意，功能可能会添加或更改。Release Candidates (RC) 是 Android Studio 的下一个版本，几乎可以发布稳定版。下一个版本的功能集已稳定。请参阅Android Studio 版本名称，了解 Android Studio 版本命名。

有关 Android Studio 预览版发布的最新消息，包括每个预览版中的显著修复列表，请参阅 Android Studio 博客中的发布更新。

当前 Android Studio 版本

下表列出了当前 Android Studio 版本及其各自的渠道。

版本 渠道
Android Studio Meerkat Feature Drop | 2024.3.2 稳定版
Android Gradle 插件 8.10.0 稳定版
Android Studio Narwhal | 2025.1.1 测试版
Android Studio Narwhal Feature Drop | 2025.1.2 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 更新。

Android Studio Narwhal | 2025.1.1

以下是 Android Studio Narwhal | 2025.1.1 中的新功能。

要查看此版本的 Android Studio 中修复的问题，请参阅已关闭的问题。

面向企业推出 Android Studio 中的 Gemini

Android Studio Narwhal Canary 5 引入了面向企业的 Android Studio 中的 Gemini。企业版 Gemini 包括 Android Studio 中 Gemini 的核心功能，以及企业级的安全和隐私功能等。要为您的团队或企业释放 AI 的力量，了解更多。

Android Studio 中的 Gemini 支持多模态图像附件

现在，您可以将图像直接附加到 Android Studio 中的 Gemini 提示。获取复杂技术图表的即时洞察，或使用设计模型生成相应的代码骨架。这种将视觉上下文无缝集成到 AI 辅助工作流中，解锁了效率和创造力的新水平。

Image attachment in Gemini in Android Studio
Android Studio 中的 Gemini：附加图片

Android Studio 中的 Gemini 支持文件附件

您现在可以将文件作为上下文附加到与 Android Studio 中的 Gemini 的聊天互动中。在查询栏中键入 @ 以调出文件完成菜单并选择要附加的文件。点击上下文下拉菜单，查看 Gemini 自动附加了哪些文件。您可以选择勾选或取消勾选文件。将鼠标悬停在最近文件上，查看最近附加的文件列表。

File attachment in Gemini in Android Studio
Android Studio 中的 Gemini：附加文件

使用 Gemini 生成可组合项的预览

可组合项预览可帮助您在 Android Studio 的设计时可视化您的可组合项。为了让您更轻松地将模拟数据作为预览参数包含在内，Android Studio 现在支持一个实验性功能：使用 Gemini 生成 Compose 预览。

要访问此工具，右键点击任何可组合项并导航到 Gemini > 生成“<可组合项名称>”预览。如果当前文件没有任何预览，右键点击并导航到 Gemini > 生成 Compose 预览。

虽然 Gemini 生成的代码可能并非每次都完美无缺，但它有助于提供一个有价值的起点，以加速您的开发工作流程。

您的反馈对于帮助我们提高准确性并将此集成打造为 Android 开发者更强大的资产至关重要。

Gemini appears about halfway down the right-click menu. Generate Preview appears near the bottom of the 2nd-level menu.
Gemini 可以为您的可组合项生成 Compose 预览。

Android Studio Narwhal Feature Drop | 2025.1.2

以下是 Android Studio Narwhal Feature Drop | 2025.1.2 中的新功能。

要查看此版本的 Android Studio 中修复的问题，请参阅已关闭的问题。

Android Studio 中的 Journeys

Android Studio 中的 Journeys 通过允许您使用自然语言描述每个测试的步骤和断言（称为旅程），帮助您轻松编写和维护端到端测试。通过利用 Gemini 的视觉和推理能力，用自然语言编写的步骤将转换为 Gemini 在您的应用上执行的操作，从而使您的旅程易于编写和理解。此外，您可以编写和描述更复杂的断言，Gemini 会根据其在设备上看到的内容进行评估，以确定您的旅程是否通过或失败。

由于 Gemini 会根据目标推断要执行的操作，因此旅程对您应用的布局或行为的细微变化更具弹性，从而在针对不同版本的应用和不同设备配置运行时，减少了不稳定测试的数量。

直接从 Android Studio 针对任何本地或远程 Android 设备编写和运行旅程。IDE 提供了一种新的编辑体验，用于创建旅程，以及丰富的成果，可帮助您更好地跟踪 Gemini 的推理和旅程的执行。

Android Studio 中的 Gemini 的 Agent 模式

Android Studio 中的 Gemini 的 Agent 模式是一项新的 AI 功能，旨在处理超出您与 Gemini 聊天所能体验的复杂、多阶段开发任务。要使用 Agent 模式，点击侧边栏中的 Gemini，然后选择 Agent 选项卡。您可以描述一个复杂的目标，例如生成单元测试或修复错误，Agent 会制定一个跨项目多个文件的执行计划。Agent 建议编辑并迭代修复错误以达到目标。您可以查看、接受或拒绝建议的更改，并要求 Agent 根据您的反馈进行迭代。

备份和同步

您现在可以使用您的 Google 或 JetBrains 帐户将 Android Studio 设置备份到云存储。这有助于同步您的设置，例如键盘映射、代码编辑器设置、系统设置等。要开始使用，请执行以下任一操作：

  • 在 Android Studio 中打开项目后，通过点击 IDE 右上角的头像并点击登录来登录您的 Google 帐户。

    1. 按照出现的对话框中的提示操作，并确保勾选复选框以授权 Android Studio 访问您的 Google 帐户存储。
    2. 按照提示授权 Android Studio。

  • 导航到设置 > 备份和同步。

    1. 选择 Google 以使用您的 Google 帐户存储同步您的应用数据在不同的 Android Studio 安装之间。或者，您可以使用 JetBrains 帐户同步您的应用数据在 IntelliJ 和 Android Studio 安装之间。
    2. 按照提示授权 Android Studio 访问您首选帐户的存储后，返回 Android Studio。
    3. 在设置 > 备份和同步页面上，您可以查看要同步到您帐户的应用数据类别。
    4. 要禁用备份和同步，请取消勾选启用此功能的复选框。

如果您已将数据同步到所选设备，Android Studio 会为您提供从远程存储下载设置（这是默认选项）或上传本地设置并覆盖同步到远程存储的设置的选项。

建议的崩溃修复

在 Android Studio Meerkat Feature Drop 中，我们推出了针对应用质量洞察工具窗口中报告的崩溃的 Gemini 洞察。现在，Android Studio 可以使用 Gemini 分析崩溃数据和您的源代码，以建议潜在的修复。在应用质量洞察工具窗口中选择崩溃后，导航到洞察选项卡，并在 Gemini 为崩溃生成洞察后点击建议修复。然后，Gemini 会生成建议的代码更改，您可以在编辑器差异选项卡中查看并接受。

嵌入式 XR 模拟器

XR 模拟器现在默认以嵌入式状态启动。您现在可以直接在 Android Studio 中部署应用程序、导航 3D 空间和使用布局检查器。

The XR Emulator now launches by default in the embedded state.
直接在 Android Studio 中使用 XR 模拟器。

Compose 预览改进

Android Studio Narwhal Feature Drop 引入了对 Compose 预览的几项改进。

通过最新的导航改进，Compose 预览交互现在更加高效。点击预览名称可跳转到预览定义，或点击单个组件可跳转到定义它的函数。鼠标悬停状态在您将鼠标悬停在预览帧上时提供即时视觉反馈。改进的键盘箭头导航简化了在多个预览之间的移动，从而加快了 UI 迭代和优化。

预览选择器

Compose 预览选择器现已可用。要尝试，请点击 Compose 代码中的任何 @Preview 注解。

可调整大小的预览

在 Android Studio 的 Compose 预览的焦点模式下，您现在可以通过拖动其边缘来调整预览窗口的大小。

16 KB 页面大小支持

Android Studio Narwhal Feature Drop 增加了对转换为 16 KB 页面大小的改进支持。为了帮助您顺利完成此转换，Android Studio 现在在构建与 16 KB 设备不兼容的 APK 或 Android App Bundle 时提供主动警告。使用 APK 分析器，您还可以找出哪些库与 16 KB 设备不兼容。为了在此新环境中测试您的应用，Android Studio 中还提供了一个专用的 16 KB 模拟器目标，与现有 4 KB 映像并行。

布局检查器中的子项重组

布局检查器支持子项重组计数。即使正在重组的可组合项在组件树中折叠在父项之下，您现在也可以看到重组计数。当您看到子项重组计数增加时，您可以打开树并找到重组发生的位置。

Layout Inspector supports Child recomposition counts
布局检查器支持子项重组计数。

Android 视图设置以在相应模块下显示构建文件

Android 视图中有一个新设置，用于在其相应模块下显示构建文件。当您处理具有许多模块的项目时，此视图会很有帮助。要启用此视图，请转到文件（macOS 上为 Android Studio）设置 > 外观与行为 > 项目工具窗口并选择 [Android 视图] 在模块中显示构建文件。

打开新项目时使用项目视图的新设置

有一个新设置，用于默认在新项目中打开项目视图。要启用此设置，请转到文件（macOS 上为 Android Studio）> 设置 > 外观与行为 > 项目工具窗口并选择将项目视图设为默认。

禁用自动同步的新设置

Android Studio 现在提供一个设置，用于将默认的自动同步模式（例如，打开项目时自动运行同步）切换到带有提醒的新手动同步模式。默认行为仍然是自动同步。要切换到手动同步，请转到文件（macOS 上为 Android Studio）> 设置 > 构建、执行、部署 > 构建工具，并将项目同步模式设置为带有提醒的手动同步作为项目同步模式。

Android Studio 中的 Play 政策洞察测试版

Android Studio 现在包含关于可能影响您应用的 Google Play 政策的更丰富的洞察和指导。此信息可帮助您从一开始就构建更安全的应用程序，从而防止可能中断发布过程并稍后花费更多时间和资源修复的问题。

从 Android Studio Narwhal Feature Drop 开始，您可以将 Play 政策洞察视为 Lint 检查。这些 Lint 检查将显示以下信息：

  • 政策概述。
  • 避免常见陷阱的注意事项。
  • 指向 Play 政策页面的链接，您可以在其中找到完整的正式政策以及更多有用的信息和资源。

此功能旨在提供有用的预审查指导，以便您可以获得更顺畅的应用提交体验。它不涵盖所有政策，也不提供最终的应用审查决定。请务必查看政策中心中的完整政策，以确保合规性。

要查看您的项目是否有任何 Play 政策洞察，请转到代码 > 检查 Play 政策洞察… 洞察将列在“问题”工具窗口中，并且还会作为 Lint 警告出现在相应文件中。

Play Policy Insights in Android Studio
Android Studio Narwhal Feature Drop 中的 Play 政策洞察。

我们正在积极发展和改进此集成。如果您有任何反馈，请报告。

Android Studio Narwhal Feature Drop 至少需要 AGP 4.0

项目必须使用 AGP 4.0 或更高版本才能与 Android Studio Narwhal Feature Drop 兼容。请参阅 AGP 和 Android Studio 兼容性要求。

通过 Android 设备流媒体提供合作伙伴设备实验室

合作伙伴设备实验室是由 Google OEM 合作伙伴（如三星、小米、OPPO、一加、vivo 等）运营的设备实验室，并扩展了 Android 设备流媒体中可用的设备选择。此服务处于测试阶段，并可在 Android Studio 的最新 Canary 版本中使用。要了解更多信息，请参阅连接到合作伙伴设备实验室。



使用应用备份和恢复进行测试和开发

确保应用的Android 备份和恢复正常工作是确保用户在切换到新设备或从云端恢复后仍能使用您的应用的关键方面。然而，测试应用的数据备份和恢复是否正常工作可能会很困难。

Android Studio Narwhal 提供了生成应用备份并将其恢复到另一设备的方法。这对于测试您的应用在从设备到设备或从云备份恢复应用数据时是否按预期运行非常有用，或者如果您想更快地设置具有开发和调试应用所需数据的测试设备。

生成备份

要生成备份文件，请执行以下操作：

  1. 将应用的调试版本部署到已连接的设备
  2. 使用以下操作之一生成备份：
    • 从正在运行的设备窗口中，点击工具栏中的备份应用数据操作
    • 从主菜单栏中选择运行 > 备份应用数据
    • 从设备资源管理器 > 进程选项卡中，右键点击应用进程并选择备份应用数据
  3. 在出现的对话框中，执行以下操作：
    • 确认您要生成备份的应用的应用 ID
      • 选择是要生成设备到设备、云还是云 (未加密) 备份
    • 确认要保存的备份的名称和位置。默认情况下，备份会保存到当前 Android Studio 项目的根目录。
      为您的应用生成备份。
  4. 当 Android Studio 询问是否可以停止应用时，点击确定。为了生成备份，Android Studio 必须停止应用进程。

您可以在项目 > Android 工具窗口的备份文件节点下查看您生成的备份。

备份类型

您可以为您的应用生成不同类型的备份。生成备份时，选择与您要测试的场景相关的备份类型：

  • 设备到设备： 生成您的应用备份，类似于设备到设备传输期间创建的备份。在设备到设备传输中，应用的备份数据直接发送到另一台设备，例如通过 USB 或 Wi-Fi。
  • 云： 生成您的应用备份，类似于保存到用户 Google 帐户存储中的备份。当用户设置新设备时，他们可以选择从云备份恢复。
  • 云 (未加密)： 生成您的应用备份，类似于保存到用户 Google 帐户存储中且未启用客户端加密的设备上的备份。

恢复应用数据

要恢复应用数据，请执行以下操作：

  1. 将您的应用部署到已连接的设备。应用应具有与要恢复到设备上的备份文件相同的应用 ID。
  2. 导航并点击以下操作之一：
    • 从正在运行的设备窗口中，点击工具栏中的恢复应用数据操作，然后从最近历史记录中选择一个备份文件或点击浏览。
    • 从主菜单栏导航到运行 > 恢复应用数据。
    • 从设备资源管理器 > 进程选项卡中，右键点击应用进程并选择恢复应用数据。
    • 从项目 > Android 工具窗口中，右键点击备份文件节点下的备份，然后选择恢复应用数据。
  3. 如果适用，请从最近历史记录中选择备份，或点击浏览从本地存储中选择要恢复的备份文件。

或者，您可以将备份文件作为运行配置的一部分，这样部署应用也会从备份文件恢复应用数据。为此，请执行以下操作：

  1. 从主菜单栏导航到运行 > 编辑配置。
  2. 选择一个应用运行配置并导航到恢复选项。
    运行配置中的恢复选项。
  3. 要从备份中恢复应用，请勾选恢复应用状态旁边的复选框。
  4. 从最近历史记录中选择一个备份文件，或者浏览并从本地存储中选择备份文件。
  5. 如果您只想在全新安装应用时恢复应用数据，请勾选仅在全新 APK 安装时恢复旁边的复选框。如果您要部署到新的测试设备并希望恢复数据以帮助调试和应用开发，此选项会很有帮助。
  6. 点击确定保存运行配置。
  7. 使用运行配置部署您的应用，以测试将应用数据恢复到已连接的设备。

Android Studio XR 支持可用

Android Studio Narwhal 包含对使用 Jetpack XR 构建沉浸式体验的开发者的支持！此版本引入了工具，可帮助您更高效地实验、部署和调试 XR 应用程序。

Compose 预览截图测试工具

使用 Compose 预览截图测试工具测试您的 Compose UI 并防止回归。新工具可帮助您生成 HTML 报告，从而让您直观地检测应用 UI 的任何更改。在Compose 预览截图测试中了解更多信息。

嵌入式布局检查器组件树增强功能

得益于几项关键改进，与嵌入式布局检查器中的组件树交互现在更加直观和高效。这些更新旨在简化您的工作流程，并为您提供对 Compose UI 结构的更清晰洞察。

  1. 水平滚动：您现在可以在组件树内水平滚动，从而更容易导航和检查宽或深层嵌套的布局而不会丢失上下文。
  2. 选中时自动滚动：在组件树中选择项目现在将自动水平和垂直滚动视图，以使所选项目清晰地聚焦。这确保您感兴趣的元素始终位于中心位置。
  3. 改进的关系可视化：我们改进了组件树内的支持线，以提供更明确的视觉提示，用于理解节点关系。虚线现在清楚地指示父节点与其子节点之间的调用堆栈关系，帮助您更有效地跟踪程序连接。实线继续表示树中所有其他标准父子关系。

这些增强功能旨在提供更流畅、更高效的调试体验，让您能够快速理解和完善 UI。

The component tree in the Embedded Layout Inspector now supports horizontal scrolling and automatic scrolling on selection.
嵌入式布局检查器组件树增强功能

Android Studio Narwhal Feature Drop 至少需要 AGP 4.0

项目必须使用 AGP 4.0 或更高版本才能与 Android Studio Narwhal Feature Drop 兼容。请参阅 AGP 和 Android Studio 兼容性要求。