Create or import a project
Stay organized with collections
Save and categorize content based on your preferences.
Android Studio for Platform (ASfP) helps you set up your development environment
for the Android Open Source Project (AOSP). This page explains how to
start a new project or import an existing one.
Create a new project
If you don't have a project open, click New Project on the Welcome
screen. 
If you already have a project open, select ASfP > Project > New Project
from the menu.
Fill in the project configuration details in the wizard: 
- Module paths: Specify the absolute path to the root of your AOSP
source code checkout (for example,
/path/to/aosp).
- Lunch target: Enter the lunch target you use for building (for
example,
aosp_arm64-eng).
- Project name: Give your project a descriptive name.
- Directories / modules: List the initial directories or modules you
want to include in your project, separated by commas. These should be
relative paths from the repository root (for example,
frameworks/base,
packages/apps/Settings). You can add more or refine this selection later.
Click Finish. ASfP creates the project structure and the .asfp-project
configuration file.
After the initial project setup, you can further customize your project by
editing the .asfp-project file located in the project root. This file lets
you:
- Add or remove directories and modules.
- Enable support for other languages like Rust or C++.
- Configure build flags and environment variables.
- Specify test sources.
For detailed information on all configuration options, see the Projects
overview. After editing .asfp-project, you'll need to sync the project for
the changes to take effect.
Import an existing project
ASfP doesn't have a separate "import" action. To open an existing ASfP project
configuration:
- Select ASfP > Project > New Project.
- In the Project Name field, navigate to and select the directory
containing the existing
.asfp-project file you want to open. The fields in
the wizard will populate based on the selected .asfp-project file.
- Click Finish. ASfP opens and indexes the project.
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2025-09-04 UTC.
[null,null,["Last updated 2025-09-04 UTC."],[],[],null,["Android Studio for Platform (ASfP) helps you set up your development environment\nfor the [Android Open Source Project (AOSP)](https://source.android.com/). This page explains how to\nstart a new project or import an existing one.\n\nCreate a new project\n\n1. If you don't have a project open, click **New Project** on the Welcome\n screen.\n\n2. If you already have a project open, select **ASfP \\\u003e Project \\\u003e New Project**\n from the menu.\n\n3. Fill in the project configuration details in the wizard:\n\n - **Module paths:** Specify the absolute path to the root of your AOSP source code checkout (for example, `/path/to/aosp`).\n - **Lunch target:** Enter the lunch target you use for building (for example, `aosp_arm64-eng`).\n - **Project name:** Give your project a descriptive name.\n - **Directories / modules:** List the initial directories or modules you want to include in your project, separated by commas. These should be relative paths from the repository root (for example, `frameworks/base,\n packages/apps/Settings`). You can add more or refine this selection later.\n4. Click **Finish** . ASfP creates the project structure and the `.asfp-project`\n configuration file.\n\nConfigure and customize your project\n\nAfter the initial project setup, you can further customize your project by\nediting the `.asfp-project` file located in the project root. This file lets\nyou:\n\n- Add or remove directories and modules.\n- Enable support for other languages like Rust or C++.\n- Configure build flags and environment variables.\n- Specify test sources.\n\nFor detailed information on all configuration options, see the [Projects\noverview](/studio/platform/projects). After editing `.asfp-project`, you'll need to sync the project for\nthe changes to take effect.\n\nImport an existing project\n\nASfP doesn't have a separate \"import\" action. To open an existing ASfP project\nconfiguration:\n\n1. Select **ASfP \\\u003e Project \\\u003e New Project**.\n2. In the **Project Name** field, navigate to and select the directory containing the existing `.asfp-project` file you want to open. The fields in the wizard will populate based on the selected `.asfp-project` file.\n3. Click **Finish**. ASfP opens and indexes the project."]]
