Stay organized with collections
Save and categorize content based on your preferences.
The Android SDK Upgrade Assistant is a tool in Android Studio that helps you
upgrade the
targetSdkVersion, or
the API level that your app targets. It's important to keep your
targetSdkVersion up to date so you can use the platform's latest features. The
Android SDK Upgrade Assistant is available in Android Studio Giraffe and higher.
The Android SDK Upgrade Assistant helps you save time and effort when updating
the targetSdkVersion:
For each migration step, it highlights the major breaking changes and how
to address them.
It tries to filter the full list of changes to only show steps relevant
to your app. It'll show a step if it's not certain though, so you might still
see steps that you can skip.
For some changes, it pinpoints where exactly in your code the changes need
to be made.
To open the Android SDK Upgrade Assistant, go to
Tools > Android SDK Upgrade Assistant. In the Assistant panel, select
the API level that you want to upgrade to for guidance. For the best experience,
you should upgrade targetSdkVersion values one level at a time.
Report bugs
To help us create the best experience for you, please submit feedback and bugs
using the
issue tracker.
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 2023-11-30 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2023-11-30 UTC."],[],[],null,["# Use the Android SDK Upgrade Assistant\n\nThe Android SDK Upgrade Assistant is a tool in Android Studio that helps you\nupgrade the\n[`targetSdkVersion`](/guide/topics/manifest/uses-sdk-element#target), or\nthe API level that your app targets. It's important to keep your\n`targetSdkVersion` up to date so you can use the platform's latest features. The\nAndroid SDK Upgrade Assistant is available in Android Studio Giraffe and higher.\n| **Important:** Starting August 31, 2023, all apps must target Android 13 (API level 33) or higher to be submitted to Google Play for review and remain discoverable for all Google Play users. Configuring your app to target a recent API level ensures that users benefit from security and performance improvements while your app can still run on lower Android versions (down to the specified `minSdkVersion`). To learn more, see the [Google Play target API level requirement](/google/play/requirements/target-sdk).\n\nThe Android SDK Upgrade Assistant helps you save time and effort when updating\nthe `targetSdkVersion`:\n\n- For each migration step, it highlights the major breaking changes and how to address them.\n- It tries to filter the full list of changes to only show steps relevant\n to your app. It'll show a step if it's not certain though, so you might still\n see steps that you can skip.\n\n | **Note:** If you need to reset the step filters, close and reopen your project or restart the Studio IDE. The SDK Upgrade Assistant filters the migration steps once at the beginning of each project session, so you might want to reset the step filters if you've checked out another version of your project for which previously hidden steps apply.\n- For some changes, it pinpoints where exactly in your code the changes need to be made.\n\nTo open the Android SDK Upgrade Assistant, go to\n**Tools \\\u003e Android SDK Upgrade Assistant** . In the **Assistant** panel, select\nthe API level that you want to upgrade to for guidance. For the best experience,\nyou should upgrade `targetSdkVersion` values one level at a time.\n\nReport bugs\n-----------\n\nTo help us create the best experience for you, please submit feedback and bugs\nusing the\n[issue tracker](https://issuetracker.google.com/issues/new?component=1267157&template=1750462)."]]
