Create a project

Stay organized with collections Save and categorize content based on your preferences.

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.

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

If you do have a project opened, create a new project by selecting File > New > New Project from the main menu.

You then see the Create New Project wizard, which lets you choose the type of project you want to create and populates with code and resources to get you started. This page guides you through creating a new project using the Create New Project wizard.

Choose your project

In the Choose your project screen that appears, you can select the type of project you want to create from categories of device form factors, which are shown as tabs near the top of the wizard. For example, figure 1 shows a project with a basic Android Activity for a phone and tablet selected.

Figure 1. In the first screen of the wizard, choose the type of project you want to create.

By selecting the type of project you want to create, Android Studio can include sample code and resources to help you get started.

After you make a selection, click Next.

Configure your project

The next step is to configure some settings and create your new project, as described below and shown in figure 2. If you're creating a Native C++ project, you can learn more about the options you need to configure by reading Create a new project with C/C++ support.

Figure 2. Configure your new project with a few settings.

  1. Specify the Name of your project.
  2. Specify the Package name. By default, this package name becomes your project's namespace (used to access your project resources) and your project's application ID (used as the ID for publishing). To learn more, see Configure the app module.
  3. Specify the Save location where you want to locally store your project.
  4. Select the Language you want Android Studio to use when creating sample code for your new project. Keep in mind, you are not limited to using only that language in the project.
  5. Select the Minimum API level you want your app to support. When you select a lower API level, your app can't use as many modern Android APIs. However, a larger percentage of Android devices are able to run your app. The opposite is true when selecting a higher API level. If you want to see more data to help you decide, click Help me choose.
  6. If you want your project to use AndroidX libraries by default, which are improved replacements of the Android Support libraries, check the box next to Use AndroidX artifacts. To learn more, read the AndroidX overview.
  7. When you're ready to create your project, click Finish.

Android Studio creates your new project with some basic code and resources to get you started. If you later decide to add support for a different device form factor, you can add a module to your project later. And if you want to share code and resources between modules, you can do so by creating an Android library.

For more information about the Android project structure and module types, read the Projects overview. If you're new to Android development, altogether, start with Getting Started on Android.

Import an existing project

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

  1. Click File > New > Import Project.
  2. In the 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 and indexes its contents.

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 Migrating from Eclipse.