Android Studio for Platform (ASfP) 是 Google 官方推出的、专为 AOSP 平台开发者设计的强大 IDE。它能让你像开发普通 App 一样，高效地浏览、修改和调试 AOSP 的系统代码（包括 Java、C++ 和 Kotlin）。下面是如何导入并使用 AOSP 13 的完整指南。
为了让你对整个流程有个清晰的概览，下图汇总了从准备到开始开发的核心步骤。
flowchart TD A[“准备AOSP 13源码与环境”] --> B[安装ASfP] B --> C[“创建/导入 ASfP项目”] C --> D{配置项目参数} D --> E[“同步项目<br>（建立索引与依赖）”] E --> F[“浏览/修改代码”] F --> G[“编译与部署”] G --> H[“调试（Java/C++）”] H --> I[进入开发循环] E --> E1[“耗时较长<br>需耐心等待”] G --> G1[“使用 mm/mmm 命令<br>进行模块编译”]🔧 准备工作与安装
环境确认
操作系统：ASfP 目前官方仅支持Linux（推荐 Ubuntu 20.04 或更高版本）。你需要一个带有图形化桌面的环境。
AOSP 13 源码：确保你已经成功下载并完整编译过一份 AOSP 13 的源代码。这是 ASfP 能够正确建立索引和关联的基础 。
安装 ASfP
从 Android 开发者网站下载 ASfP 的 Linux 版安装包（.deb 文件）。
在终端中，使用以下命令安装：
sudo dpkg -i /path/to/your/downloaded/asfp-<version>-linux.deb安装后，可以通过执行
/opt/android-studio-for-platform/bin/studio.sh来启动 ASfP 。为了方便，你可以为其创建一个桌面快捷方式 。
🚀 导入 AOSP 13 源码
启动并创建项目
启动 ASfP。
在欢迎界面或
File菜单中，选择"Import Asfp Project" 。
配置项目参数
接下来会弹出一个配置对话框，需要正确填写以下关键信息 ：
配置项
说明
示例
Repo checkout
指向你的AOSP 13 源码的根目录。
/home/yourname/aosp-13Lunch Target
选择与你编译 AOSP 时相同的目标。注意： 若需调试系统进程，请选择
eng或userdebug版本 。aosp_x86_64-engModule Paths
关键！ 不要导入整个 AOSP，效率极低。只添加你当前重点开发的模块路径 。
frameworks/basepackages/apps/SettingsProject Name
为你的 ASfP 项目起个名字。
MyAOSP13同步项目
点击"Finish" 后，ASfP 会开始根据你的配置同步项目。这个过程会：
解析你指定模块的依赖关系。
为这些代码建立索引（索引过程可能耗时较长，且CPU占用高，请耐心等待）。
完成后，你就能在 IDE 中享受代码高亮、自动补全和精准跳转了。
💡 使用技巧：开发、编译与调试
导入成功后，你就可以开始真正的开发工作了。
代码浏览与修改：你现在可以像在普通 Android Studio 中一样，自由地浏览和修改 AOSP 的 Java、C++ 和 Kotlin 代码了。
编译部署
在 ASfP 中修改代码后，不建议直接在其中触发全系统编译。正确的方式是：
在终端中，进入到你的 AOSP 源码根目录。
执行
source build/envsetup.sh和lunch选择你的目标。使用
mm或mmm命令 来只编译你修改过的模块，这比编译整个系统快得多 。# 在模块目录下编译 cd packages/apps/Settings mm # 或从任意目录编译指定模块 mmm packages/apps/Settings编译完成后，将新的系统镜像刷入设备或启动模拟器来验证更改。
调试（Debugging）
ASfP 最强大的功能之一是能够调试系统进程。
确保设备可调试：你的设备（真机或模拟器）必须是
eng或userdebug版本，并且系统属性ro.debuggable为 1，这样才能调试system_process等系统核心进程 。附加调试器：
在代码中设置断点。
点击 ASfP 的调试按钮，选择"Attach Debugger to Android Process"。
在弹出的进程列表中，选择你要调试的系统进程（如
system_process、com.android.systemui等）。
选择调试类型：ASfP 支持Java Only、Native Only 和Dual (Java + Native) 调试。如果混合调试不稳定，可以尝试分别调试 Java 和 Native 代码 。
⚠️ 常见问题与解决
索引过程卡顿或内存溢出：索引大型模块（如
frameworks/base）非常消耗资源。建议在 ASfP 的设置中增加最大堆内存（-Xmx），例如设置为 8GB 或更高 。代码跳转不准确：确保在项目配置中正确指定了
Lunch Target和Module Paths。可以尝试File > Sync Soong Project来重新同步代码模型 。无法调试系统进程：检查设备是否为可调试版本。对于真机，可能需要获取 Root 权限并使用 Magisk 等工具修改系统属性 。
