Program Overview

Welcome to the Android P Developer Preview, a program that gives you everything you need to make your apps compatible and build for the next version of Android. It's free, and you can get started right away just by downloading the Preview tools.

Hardware and emulator system images

Run and test your apps on Pixel, partner devices, and the Android Emulator.

Latest platform code

We’ll provide multiple updates during the Preview, so you’ll be testing against the latest platform changes.

New behaviors and capabilities

Start work early to support new platform behaviors.

Feedback and support

Report issues and give us feedback using our issue tracker. Connect with other developers in the Developer Community.

Timeline and updates

The P Developer Preview runs from 7 March 2018 until the final Android P public release to AOSP and OEMs, planned for Q3 2018.

At key development milestones, we’ll deliver updates for your development and testing environment. Each includes SDK tools, preview system images, emulators, API reference, and API diffs. The milestones are listed below.

  • Preview 1 (initial release, alpha)
  • Preview 2 (incremental update, beta)
  • Preview 3 (final APIs and official SDK, Play publishing, beta)
  • Preview 4 (release candidate for testing)
  • Preview 5 (release candidate for final testing)
  • Final release to AOSP and ecosystem

For developers, the focus during the early part of the preview is on making sure your current app is compatible with the new platform, and providing early feedback. In the later part of the preview—but ongoing throughout and beyond the preview—focus on adopting new features in your app and targeting the new platform.

Please see the migration guide for easy steps to make your app compatible with the new platform, then target the new platform when you're ready.

The first two preview milestones provide an early test and development environment that help you identify compatibility issues in your current apps and plan migration or feature work needed to target the new platform. This is the priority period in which to give us your feedback on features and APIs and file compatibility issues — for all of these, please use the issue tracker. You can expect some API changes across these updates.

At preview 3 you’ll have access to the final P APIs and SDK to develop with, as well as updated beta system images to test system behaviors and features. Android P will provide a standard API level at this time. You can begin final compatibility testing of your legacy apps and refine any new code that is using the P APIs or features.

Also starting in preview 3, you’ll be able to publish apps to devices running Android P at the official API level, such as consumer devices that have opted into the Android Beta program. You can publish into the Google Play alpha and beta channels first, so you can test your apps with Android Beta consumers before distributing broadly on the store.

At previews 4 and 5 you’ll have release candidate builds—which include the final APIs and near-final system images—for development and testing.

As you test and develop on Android P, we strongly recommend keeping your development environment up-to-date as preview updates are released.

We’ll notify you when preview updates are available via the Android Developers Blog, as well as this site and the Android Developer Community.

What's in the P Developer Preview?

The P Developer Preview includes everything you need to test your existing apps on a variety of screen sizes, network technologies, CPU/GPU chipsets, and hardware architectures.

SDK tools

With Android Studio 3.1, you can download these components through the SDK Manager:

  • P Developer Preview SDK and tools
  • P Developer Preview emulator system image (32-bit & 64-bit)
  • P Developer Preview emulator system image for Android TV (32-bit)

We’ll provide updates to these development tools at each milestone as needed.

For complete SDK setup instructions, see the migration guide.

System images for a variety of hardware devices

The Developer Preview includes system images for a variety of Pixel and partner devices that you can use for developing and testing. See Get Android P for details.

You can see a list of all supported devices and get details on how to install Android P on them from the Android P Beta Devices page. Depending on the device, you can sign up for over-the-air updates or download and flash an Android P beta build manually.

OTA Updates for Pixel through the Android Beta Program

If you have a Pixel 2, Pixel 2 XL, Pixel, or Pixel XL device, you can enroll the device in the Android Beta program to get updates to Android P beta over-the-air (OTA). For details, see the Get Android P page or visit https://g.co/androidbeta to enroll.

Documentation and sample code

These documentation resources are available on the Developer Preview site to help you learn about Android P:

  • Migrating to Android P has step-by-step instructions for getting started.
  • The Behavior Changes point you to key areas you'll want to test.
  • Documentation of new APIs, including a Features & APIs page, and detailed developer guides on key features such as notification channels, autofill, and others.
  • Release notes for the current version of the P Developer Preview, including change notes.

API Reference and diff report

The full preview API reference is available online. New APIs are watermarked for visibility and show "Android P Developer Preview". Note that you can only use these APIs if you are building with the P Preview SDK.

Note: To show the P APIs, make sure to set the API Level selector to "P" in the left navigation on any reference page.

To get a detailed view of new, modified, and removed APIs in each preview release, we recommend starting with the diff reports:

Changes in the diff reports link you to the related API reference documentation.

Support resources

As you test and develop on the P Developer Preview, please use these channels to report issues and give feedback:

  • Developer Preview Issue Tracker is your primary feedback channel. You can report bugs, performance issues, and general feedback through the issue tracker. You can also check for known issues and find workaround steps. We’ll keep you updated on your issue as it’s triaged and sent to the Android engineering team for review.
  • For details on how to report various kinds of issues, see the Feedback page.
  • The Android P Developer Community is a Google+ community where you can connect with other developers working with Android P. You can share observations or ideas or find answers to questions about Android P.

Targeting, preview APIs, and publishing

The P Developer Preview provides a development-only system and Android library that does not have a standard API level. If you want to target the new platform and build with the new Android P APIs, you target the preview version of Android P by setting your app's targetSdkVersion, minSdkVersion, and Gradle compileSdkVersion to to 'P', 'P', and 'android-P', respectively. For details, see how to update your build configuration for Android P.

The P Developer Preview delivers preview APIs — the APIs will not be official until the final SDK is released, currently planned for the third quarter of 2018. This means that you can expect API changes over time, especially during the initial weeks of the program. We’ll provide a summary of changes to you with each update of the Android P Developer Preview.

Note: Although preview APIs may change, underlying system behaviors are typically stable and ready for testing against right away.

Google Play prevents publishing of apps targeting the P Developer Preview. When the Android P final SDK is available, you’ll be able to target the official Android P API level and publish your app to Google Play via the alpha, beta, and production release channels. Meanwhile, if you want to distribute an app targeting Android P to testers, you can do so via email or by direct download from your site at any time.

How to get started

To get started, install Android P on your hardware device or set up an emulator for compatibility testing. See Get Android P for details. Then review the migration guide for an outline of steps for both compatibility testing and building for Android P.

Thank you for participating in the Android P Developer Preview program!