Skip to content

Most visited

Recently visited


Set up your development environment

This page describes how to set up a development environment for Android Instant Apps onto a Linux, macOS, or Windows development machine.

Check your system requirements

To develop an instant app, you need the following:

In Android Studio, use the Android SDK Manager to install the following packages:

Install the Instant Apps Development SDK

  1. Open the Android SDK Manager by clicking Tools > Android > SDK Manager.
  2. Click the SDK Tools tab.
  3. From the list, select Instant Apps Development SDK.
  4. Click Apply.
  5. After the Component Installer completes the installation, click Finish.

For more information about how to use the Android SDK Manager, see Android SDK Tool Updates.

Set up your device or emulator

You can develop instant apps on the following devices and emulators:

To setup your device or emulator, follow these instructions:

  1. Make sure you've signed into a Google account on the device or emulator. You can do this in the Settings app by tapping Accounts > Google. Note that you can use a test account for this purpose.

  2. When you first run an instant app on your device or emulator, Android Studio installs or updates the following:

    • Google Play Services - Android Instant Apps requires version 10.0.84 or higher.
    • Google Play for Services for Instant Apps - the instant apps runtime.
    • WH Dev Manager - a developer tool that lets you locally install and launch instant apps from your workstation (without deploying to Google Play).
  3. To confirm that everything is configured properly, open the Settings app and navigate to Apps > Google Play Services for Instant Apps or run the command adb shell pm list packages | grep "".

The first time you navigate to a instant app, the system automatically asks you to opt-in as shown below.

You can also manually opt-in to or opt-out of Android Instant Apps in the Settings app by going to Google > Instant Apps. Note that if you do not opt-in, developer mode does not work on the device.

If you run into issues setting up your development environment or provisioning your device for Android Instant Apps, see Troubleshoot Development Issues.

Next steps

Now that you set up your development environment, you can create a simple instant app.

This site uses cookies to store your preferences for site-specific language and display options.

Get the latest Android developer news and tips that will help you find success on Google Play.

* Required Fields


Browse this site in ?

You requested a page in , but your language preference for this site is .

Would you like to change your language preference and browse this site in ? If you want to change your language preference later, use the language menu at the bottom of each page.

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a short survey?
Help us improve the Android developer experience.
(Sep 2017 survey)