创建或导入项目

Android Studio for Platform (ASfP) 可帮助您为 Android 开源项目 (AOSP) 设置开发环境。ASfP 基于 IntelliJ 工作区模型构建，支持手动配置和可共享的团队模板。

启动项目设置向导

您可以通过以下两种方式启动项目设置向导：

  • 在“欢迎”界面中：点击新建项目或导入 ASfP 项目。
  • 从打开的项目中：在主菜单中，依次选择 ASfP > Project > New Project 或 Import ASfP Project。

从模板导入

如果您的团队共享一个标准 .asfp-project 配置文件，您可以直接从该模板初始化工作区：

  1. 在项目设置向导中，选择从模板导入。
  2. 浏览并选择共享的 .asfp-project 或 .asfp-template YAML 文件。
  3. 向导根据模板填充项目设置后，验证本地 Repo 签出路径，然后点击 Finish。

手动配置

如需从头开始创建新的项目配置，请执行以下操作：

  1. 在项目设置向导中，选择手动配置项目，然后填写项目详细信息：

    • Repo 检出（模块路径）：指定本地 AOSP 源代码检出的根目录的绝对路径（例如 /path/to/aosp）。
    • 启动目标：输入您用于构建的启动目标（例如 aosp_cf_x86_64_phone-aosp_current-userdebug）。
    • 项目名称：为项目指定一个描述性名称。
    • 目录和模块：列出要包含在项目中的初始目录或 Soong 模块（相对于代码库根目录，例如 frameworks/base 或 packages/apps/Settings）。
    • 语言：如果您的工作流程包含 C、C++ 或 Rust 平台代码，请选择 C 或 C++ 或 Rust。默认情况下包含 Java、Kotlin 和 Android.bp。
    • 环境变量和 build 选项：在向导的环境变量字段中，添加任何自定义环境变量（例如 SOONG_ALLOW_MISSING_DEPENDENCIES=true），并可选择勾选 Soong 部分编译 (SOONG_PARTIAL_COMPILE) 复选框，以加快增量 build 的速度。

  2. 点击 Finish。ASfP 会创建项目结构，在项目根目录中生成 .asfp-project 配置文件，并运行初始同步。

分享或自定义项目配置

完成初始设置后，您可以随时通过修改 .asfp-project 文件（ASfP > 项目 > 打开配置）来自定义项目：

  • 添加或排除目录和 Soong 模块。
  • 启用其他语言（cpp、rust）。
  • 配置自定义 Soong 标志和环境变量。

如需将配置导出给队友，请右键点击 .asfp-project 标签页，然后选择导出为模板。

如需详细了解 .asfp-project 参数、同步模式和编辑器内 Android.bp 操作，请参阅项目概览和 Soong 工作流。