Android Studio for Platform 版本说明

Android Studio for Platform (ASfP) 是用于 Android 平台开发的官方 IDE。本页总结了 ASfP 中提供的最新功能、平台专用增强功能和质量改进。

2026 年平台功能弃用（Rabbit | 2026.2 和 Panda 2 | 2025.3.2）

ASfP 的最新版本基于 IntelliJ 2026.2 基础平台，对项目设置和启动可靠性、Soong 构建集成、AI 智能体功能、Cuttlefish 虚拟设备管理、C、C++、Rust 和混合调试以及平台测试进行了重大改进。

项目设置、模板和同步性能

  • Workspace Model 项目架构：项目构建已 迁移到 IntelliJ Workspace Model API，从而简化了初始项目 设置并提高了 IDE 在大型 AOSP 源代码树中的稳定性。
  • 使用项目模型快照即时启动：ASfP 现在会在启动时缓存并 从快照恢复项目模型，从而消除了重新打开大型 AOSP 工作区时多余的 初始索引延迟。
  • 可共享的项目模板（导入和导出）:
    • 从模板导入：在设置 向导中选择从模板导入并指向共享的 .asfp-project YAML 文件，以引导新的 AOSP 项目。
    • 导出到模板：右键点击 .asfp-project 编辑器标签页（或从 ASfP > Project 菜单）并选择 导出到模板，与团队成员共享项目配置 。
  • 增强的设置向导选项：在项目创建期间直接配置自定义构建环境 变量并启用Soong 部分编译（SOONG_PARTIAL_COMPILE） 。
  • 灵活的同步模式：
    • 部分同步：同步特定模块或目录，而无需运行完整的代码库同步。
    • 无构建同步：快速刷新 IDE 项目结构和模块根 而无需触发 Soong 构建。
    • 同步和完整构建：通过单个操作触发组合的项目同步和完整的 Soong 构建。
  • 优化的搜索范围和符号链接支持：out/ 目录中的内容和生成的 gen IML 会自动从项目 搜索范围中排除，以确保文件和符号查找快速且无干扰。ASfP 还支持跨 AOSP 代码库的符号链接源代码根。

编辑器内 Android.bp 构建、部署和编辑器智能

  • `Android.bp` 中的构建、运行和调试装订线图标Android.bp ：Android.bp`Android.bp` 中的每个命名模块 在 name: 旁边都包含一个 构建 装订线图标，而测试 模块 (*_test 和 *_test_host) 和 android_app 模块包含一个 运行 装订线图标，用于直接从编辑器运行或调试目标。
  • 上下文部署和 Flash 运行配置：从Android.bp 文件中的可部署目标创建和启动 Soong 部署运行配置，支持通过adb、自定义 Shell 脚本、adevice 或flashall进行部署，并提供预运行 Soong 构建钩子。
  • 打开对应的 Android.bp 文件和编辑器智能：右键点击 任何源文件或目录，然后选择 打开对应的 Android.bp 文件，以跳转到其模块声明（解析 defaults 链、 glob 和符号链接）。在 Android.bp 中，Ctrl+点击 模块或 srcs 引用，查看可点击的 N Usages 内嵌提示，并将指针悬停在属性（包括范围限定的 target.*、arch.* 和 multilib.* 属性）上，以查看内嵌 Soong 文档。
  • 专用 Soong 工具窗口：通过 任务状态指示器监控 Soong 同步和构建进度，触发构建操作，并从 Soong 工具窗口运行 Soong 命令。

Cuttlefish 虚拟设备管理和多屏幕镜像

  • 设备管理器中的多设备设置：使用您的 本地 AOSP 检出直接在设备管理器中创建和管理多设备 Cuttlefish 虚拟设备设置。
  • Cuttlefish 工具窗口中的跨屏显示镜像：在专用的 Cuttlefish 工具窗口中使用 内置的 Cuttlefish 跨屏显示镜像，该窗口专为多显示屏 Android Automotive OS (AAOS) 和 软件定义汽车 (SDV) 开发而构建。

Android Studio 中的 AI 和用于平台开发的内置智能体

  • 内置智能体，包含 Soong 构建和测试工具：Android Studio 中的 AI 将平台专用的 Soong 构建和 atest 执行工具集成到 内置智能体中，使智能体能够规划多步修改、编译 Soong 目标，并运行 atest 平台测试，并在内嵌结构化结果 。
  • 企业版和 BYOM 支持：使用 内置 Gemini 模型、Gemini Code Assist、Gemini Enterprise 许可访问Android Studio 中的 AI，或使用 您自己的 API 密钥通过Bring Your Own Model (BYOM)连接自定义模型端点。

平台调试（调试工具窗口中的“Attach”标签页和 LLDB）

  • 固定的“Attach”标签页（Run > Attach to Android Process） ：
    • 已加载的共享库 (Libraries)、Build ID 和符号：在 附加之前检查已加载的 .so 库和 8 字符 ELF Build ID。ASfP 会将每个 Build ID 与 out/target/product/<device>/symbols（symbols/.build-id 索引）进行匹配， 并在验证后显示对勾图标（将指针悬停在经过验证的行上可查看已解析的 .debug 路径），如果缺少符号，则显示警告图标。
    • Java、C++ 和 Rust 附加：选择 Java 调试程序、原生 调试程序 或两者，以打开链接的 <process> (<pid>) 和 <process> (<pid>)-jdwp 调试标签页。选择 C++ 或 Rust 服务会隐藏 Java 调试程序 并显示 Java debugging unavailable, not a Java process.
    • 一键 Root 设备并启用 JDWP：使用 Show system processes 进行过滤，点击 Root Device 以运行 adb root（Device is rooted），或点击 Enable JDWP 以设置 persist.debug.dalvik.vm.jdwp.enabled=1 并重启 userdebug 设备。
  • LLDB 调试程序增强功能、Rust 可视化工具和 ART 信号 直通：
    • 内置 lldb-dap 会话支持条件断点、C++ 和 Rust 异常断点、编辑器中的内嵌变量值、Drop Frame、智能 Step Into 和来自 AOSP 预构建的自动 Rust Pretty-Printer (String、Vec、HashMap、Option)。
    • 将 LLDB 附加到 ART 和 JNI 进程会自动直通内部 ART SIGSEGV 和 SIGBUS null 检查或 GC 信号，而不会出现虚假停止。
    • rust-analyzer 系统会自动从 prebuilts/rust-toolchain/linux-x86/stable/rust-analyzer（回退 到 prebuilts/rust/linux-x86/stable/rust-analyzer）检测，并禁止显示生成的 'proc-macro' not found 文件中虚假的 out/soong/.intermediates 通知。

平台测试以及 cc_test 和 rust_test 调试

  • 调试 android_test、cc_test 和 rust_test 目标：从 Android.bp 或测试方法装订线图标启动调试会话：
    • android_test 模块使用 atest --wait-for-debugger 启动并附加 Java 调试程序。
    • cc_test、cc_test_host、rust_test 和 rust_test_host 模块 直接在内置 LLDB 下使用 Build Native Test Module 和 Deploy with atest (atest --collect-tests-only --disable-teardown) 启动前任务启动。
  • 双目标 host_supported: true 和每台机器 LLDB 模板：对于具有 host_supported: true 的 cc_test 和 rust_test 模块，**Soong Test** 配置中同时启用了 Run on: Device 和 Host 单选按钮，并提供独立的每目标 LLDB 设置卡片、Program arguments、atest arguments 和 Launch JSON (DAP Settings)。

IDE 内更新和平台质量

  • 自动 IDE 内更新通知：从 ASfP 2026.2.2 Canary 1 开始，ASfP 会在后台自动检查新版本，并通过 Android Studio and Plugin Updates 对话框在 IDE 中通知您，其中包含最新 .deb 软件包的下载 按钮和 终端安装说明。随时使用 Help > Check for Updates 检查更新。
  • 持久 -current-linux.deb 渠道链接：对于自动化脚本和 命令行设置，最新的稳定版和 Canary 版软件包可通过 持久网址访问： https://dl.google.com/android/asfp/asfp-current-linux.deb（稳定版）和 https://dl.google.com/android/asfp/asfp-canary-current-linux.deb（Canary 版）。
  • 磁盘版本不匹配检测：ASfP 会检测 IDE 运行时磁盘上的底层 .deb安装是否已更新，并 提示您重新启动。
  • 默认 AOSP 版权和提交检查：包含预配置的 默认 AOSP 版权标头配置文件和提交消息格式 检查，这些检查是针对平台贡献量身定制的。
  • 增加默认内存分配：默认最大堆大小已从 20 GB 增加到 30 GB ，以支持大型 AOSP 源代码树。