Create a project

Android Studio makes it easy to create Android apps for various form factors, such as handsets, tablets, TV, and Wear devices. This page shows you how to start a new Android app project or import an existing project.

Start a new project

The New Project wizard lets you choose the form factors for your app and populates the project structure with everything you need to get started.

Step 1: Start and configure the project

If you don't have a project opened, Android Studio shows the Welcome screen, where you can click Start a new Android Studio project.

If you do have a project opened, click File > New > New Project.

In the Configure your new project screen that appears, you can set the name of your app, the package name, and the location of your project. If you want to use C++ and/or Kotlin code in your project, check the corresponding checkboxes to set up your project accordingly. You can always add C++ code and add Kotlin code later.

Figure 1. The Create Android project screen.

Enter the values for your project then click Next.

Step 2: Select form factors and API level

The next window lets you select the device form factors you want to build for, and the minimum version you want to support for each. For each device you select, the wizard adds a corresponding module to your project.

Each module contains all the code and resources that will be built into an Android app package (APK) for the corresponding device. If you later decide to add support for a new device, you can add a module at that time. And you can share code and resources between modules using an Android library.

For more information about the Android project structure and module types, read Projects Overview.

Figure 2. The Target Android Devices screen.

To see more information about the different Android versions, click Help me choose. This opens a new window that shows the distribution of devices running each version of Android. Click on an API level to see a summary of top features introduced in that version. To return to the wizard, click OK.

Tip: You can also see the latest version distribtions here.

Once you've selected your form factors and API versions, click Next.

Step 3: Add an activity

The next screen lets you select an activity type to add to your app, as shown in figure 3. This screen displays a different set of activities for each of the form factors you selected earlier.

Figure 3. The Add an Activity screen for a mobile form factor.

Choose an activity type then click Next.

Note: If you choose "Add No Activity," click Finish to create the project.

Step 4: Configure your activity

The next screen lets you configure the activity to add to your app, as shown in figure 4.

Figure 4. The Configure Activity screen.

Enter the activity name, the layout name, and the activity title. Then click Finish. Android Studio now sets up your project and opens the IDE.

Now you're ready to develop your app. If you're new to Android development, start with Getting Started on Android.

To learn about configuring your build with Gradle, see Configure Your Build.

Import an existing project

To import an existing project into Android Studio, proceed as follows:

  1. Click File > New > Import Project.
  2. In the Select Eclipse or Gradle Project to Import window that appears, navigate to the root directory of the project you want to import.
  3. Click OK.

Android Studio then opens the project in a new IDE window.

If you are importing a project from version control, use the File > New > Project from Version Control menu. For more information about importing projects from version control, read IntelliJ’s VCS-Specific Procedures.

If you are importing an existing Eclipse ADT project into Android Studio, how you add the project depends on its structure. To read more about importing projects from Eclipse, see Migrate to Android Studio from Eclipse.