Android Studio 是开发 Android 应用的官方 IDE，包含构建 Android 应用所需的所有功能。
本页列出了稳定渠道中的最新版本 Android Studio Narwhal 功能更新的多项新功能和改进。您可在此处下载最新版本，也可在 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 功能更新 | 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 和云服务兼容性
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 功能更新开始。
以下是 Android Studio Narwhal 功能更新中的新功能。
Android Studio 中处于智能体模式的 Gemini
Android Studio 中 Gemini 的智能体模式是一项新的 AI 功能，旨在处理通过与 Gemini 聊天无法完成的复杂多阶段开发任务。如需使用代理模式，请点击边栏中的 Gemini，然后选择代理标签页。您可以描述一个复杂目标，例如生成单元测试或修复错误，智能体就会制定一个涵盖项目中多个文件的执行方案。代理会建议进行编辑，并以迭代方式修复 bug 以实现目标。您可以查看、接受或拒绝建议的更改，并要求智能体根据您的反馈进行迭代。
Gemini 中的规则
借助 Gemini 中的规则，您可以在提示库中定义首选的编码样式或输出格式。您还可以提及自己偏好的技术栈和语言。您只需设置一次这些偏好设置，它们就会自动应用于您随后向 Gemini 发送的所有提示。规则有助于 AI 了解项目标准和偏好，从而提供更准确、更量身定制的代码辅助功能。例如，您可以创建一条规则，例如“Always give me concise responses in Kotlin”。
如需设置规则，请依次前往 Android Studio > 设置 > 工具 > Gemini > 提示库 > 规则，然后在编辑器中修改文本。使用下拉菜单在 IDE 级层或项目级层存储规则：
- IDE 级规则仅供您自己使用，并且可用于多个项目。
- 项目级规则可以在处理同一项目的团队成员之间共享。如需在整个团队中共享提示，您必须将
.idea文件夹添加到版本控制系统。
嵌入式 XR 模拟器
现在，XR 模拟器默认以嵌入状态启动。现在，您可以部署应用、在 3D 空间中导航，并直接在 Android Studio 中使用布局检查器。
XR 项目模板
Android Narwhal Feature Drop 引入了一个专门为 Jetpack XR 设计的新项目模板。这为您提供了坚实的基础，其中包含样板代码，可让您立即开始沉浸式体验开发之旅。
适用于 XR 的嵌入式布局检查器
嵌入式布局检查器现在支持 XR 应用，可让您在 XR 环境中检查和优化界面布局。详细了解应用的组件结构，并找出潜在的布局问题，从而打造更完善、更高效的体验。
16 KB 页面大小支持
Android Studio Narwhal 功能更新改进了对过渡到 16 KB 页面大小的支持。为了帮助您顺利完成此过渡，Android Studio 现在会在构建与 16 KB 设备不兼容的 APK 或 Android App Bundle 时主动发出警告。您还可以使用 APK 分析器找出哪些库与 16 KB 设备不兼容。为了让您可以在这个新环境中测试应用，Android Studio 中还提供了一个专用的 16 KB 模拟器目标平台，与现有的 4 KB 映像并存。
使用 Gemini 转换界面
现在，您可以在 Compose 预览环境中直接在预览中使用自然语言转换界面代码。如需使用该功能，请在“Compose 预览”中右键点击，然后选择 Transform UI With Gemini。然后，输入自然语言请求（例如“将这些按钮居中对齐”），引导 Gemini 调整布局或样式，或者在预览中选择特定的界面元素，以便提供更完善的上下文。然后，Gemini 会就地修改您的 Compose 界面代码，您可以查看并批准这些修改，从而加快界面开发工作流程。
|
|
Compose 预览导航改进
借助最新的导航改进，Compose 预览互动现在更加高效。点击预览名称可跳转到预览定义，点击各个组件可跳转到定义该组件的函数。悬停状态会在您将鼠标悬停在预览帧上时提供即时视觉反馈。 改进的键盘箭头导航功能可让您轻松浏览多个预览，从而更快地迭代和优化界面。
Compose 预览选择器
Compose 预览选择器现已推出。如需试用，请点击 Compose 代码中的任意 @Preview 注释。
布局检查器中的子级重组
布局检查器支持子级重组计数。现在，即使正在重组的可组合项在组件树中折叠在父项下，您也可以看到重组次数。当您看到子重组次数增加时，可以打开树并找到发生重组的位置。
用于停用自动同步的新设置
Android Studio 现在提供了一项设置，可让您从默认的“自动同步”模式（例如，在打开项目时自动运行同步）切换到新的“手动同步”模式（带有提醒）。默认行为仍为自动同步。如需切换到手动同步，请依次前往 File（在 macOS 上，请依次前往 Android Studio）> Settings > Build, Execution, Deployment > Build Tools，然后将项目同步模式设置为手动同步（带提醒）。
通过 Android 设备串流功能提供的合作伙伴设备实验室
合作伙伴设备实验室是由 Google OEM 合作伙伴（例如 Samsung、Xiaomi、OPPO、OnePlus、vivo 等）运营的设备实验室，可扩展 Android 设备串流中可用的设备选择范围。此服务目前处于 Beta 版阶段，可在最新 Canary 版 Android Studio 中使用。如需了解详情，请参阅连接到合作伙伴设备实验室。
默认采用 K2 模式
Android Studio 现在默认使用 K2 Kotlin 编译器。这款新一代编译器可显著提升 IDE 和 build 的性能。 通过启用 K2，我们为未来的 Kotlin 编程语言功能奠定了基础，并为 Kotlin 开发者提供了更快、更强大的开发体验。