Android Studio 是开发 Android 应用的官方 IDE，包含构建 Android 应用所需的所有功能。
本页列出了稳定渠道中的最新版本 Android Studio Narwhal 3 功能更新的多项新功能和改进。您可在此处下载最新版本，也可在 Android Studio 中依次点击 Help > Check for updates（在 macOS 上则为 Android Studio > Check for updates）更新到最新版本
这是 Android Studio 的稳定版。请注意，补丁可能包含新的次要功能和 bug 修复。如需了解 Android Studio 版本命名，请参阅 Android Studio 版本名称。
如需了解此版 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 版本 |
|---|---|
| Narwhal 3 功能更新 | 2025.1.3 | 4.0-8.13 |
| Narwhal 功能更新 | 2025.1.2 | 4.0-8.12 |
| Narwhal | 2025.1.1 | 3.2-8.11 |
| Meerkat 功能更新 | 2024.3.2 | 3.2-8.10 |
| Meerkat | 2024.3.1 | 3.2-8.9 |
| Ladybug 功能更新 | 2024.2.2 | 3.2-8.8 |
| Ladybug | 2024.2.1 | 3.2-8.7 |
| Koala 功能更新 | 2024.1.2 | 3.2-8.6 |
| Koala | 2024.1.1 | 3.2-8.5 |
| Jellyfish | 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 版本低于项目的 targetSdk 或 compileSdk 所要求的版本，可能会导致意外问题。我们建议您使用最新的预览版 Android Studio 和 AGP 来处理以预览版 Android OS 为目标平台的项目。您可以安装 Android Studio 的预览版以及稳定版。
Android Studio 和 AGP 的最低版本如下所示：
| API 级别 | 最低 Android Studio 版本 | 最低 AGP 版本 |
|---|---|---|
| 36.0 | Meerkat | 2024.3.1 Patch 1 | 8.9.1 |
| 35 | Koala 功能更新 | 2024.2.1 | 8.6.0 |
| 34 | Hedgehog | 2023.1.1 | 8.1.1 |
| 33 | Flamingo | 2022.2.1 | 7.2 |
Android Studio 和 Cloud 服务兼容性
Android Studio 包含各种服务集成，可帮助您和您的团队在开发、发布和维护 Android 应用时更快地取得进展。这包括 Android Studio 中的 Gemini、Play Vitals 和 Firebase Crashlytics 等云服务。云服务仅适用于最新稳定版渠道版本的 Android Studio、之前最新的三个主要版本以及与这些版本关联的补丁。如果版本超出该兼容性窗口，服务集成将被停用，您需要更新 Android Studio。
目前与 Cloud 服务兼容的 Android Studio 版本
自 Android Studio Meerkat 功能更新发布稳定版以来，所有版本的 Studio 都与 Cloud 服务兼容。强制执行将从 Android Studio Narwhal 功能更新开始。
Studio Labs
借助 Studio Labs，您可以在 Android Studio 的稳定版中试用最新的 AI 实验性功能，从而更快地将我们的 AI 辅助功能集成到您的开发工作流程中。如需了解详情，请参阅 Studio Labs。
以下是目前在 Studio 实验室中提供的功能。
| 功能 | 说明 | 文档 |
|---|---|---|
| Compose 预览生成 | Gemini 可以自动为特定可组合函数或文件中的所有可组合函数生成 Compose 预览，包括预览参数的模拟数据。 | 生成 Compose 预览 |
| 转换界面 | 使用自然语言直接从 Compose 预览面板更新应用界面。 | 转换界面 |
以下是 Android Studio Narwhal 3 功能更新中的新功能。
可调整大小的 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 3 Feature Drop 提供了一些方法，可让您为应用生成备份并将其恢复到另一台设备。如果您想测试应用在将应用数据从一台设备恢复到另一台设备或从云端备份恢复时是否按预期运行，或者如果您想以更快的速度设置测试设备，以便使用开发和调试应用所需的数据，那么此功能会很有用。
生成备份
如需生成备份文件，请执行以下操作：
- 将应用的调试版本部署到连接的设备
- 使用以下任一操作生成备份：
- 在 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，然后将项目同步模式设置为手动同步（带提醒）。
Gemini 中的图片附件
您现在可以附加图片文件，并随提示提供更多信息。例如，您可以附加界面模拟或屏幕截图，让 Gemini 了解应用的布局。因此，Gemini 可以根据提供的图片生成 Compose 代码，也可以解释界面屏幕截图的可组合项和数据流。如需了解详情，请参阅在查询中附加图片。
Gemini 中的 @文件上下文
现在，您可以在 Android Studio 中与 Gemini 进行聊天互动时，将项目文件作为上下文附加。这样一来，您就可以在 Gemini 的提示中快速引用文件。在 Gemini 对话输入框中，输入 @ 以显示文件补全菜单，然后选择要附加的文件。您还可以点击上下文下拉菜单，查看 Gemini 自动附加了哪些文件。这样，您就可以更好地控制发送给 Gemini 的上下文。如需了解详情，请参阅将文件附加到查询中。
