Android SDK 업그레이드 어시스턴트는 앱에서 타겟팅하는 targetSdkVersion 또는 API 수준을 업그레이드하는 데 도움이 되는 Android 스튜디오의 도구입니다. 플랫폼의 최신 기능을 사용할 수 있도록 targetSdkVersion를 최신 상태로 유지하는 것이 중요합니다. Android SDK 업그레이드 어시스턴트는 Android 스튜디오 Giraffe 이상에서 사용할 수 있습니다.
Android SDK 업그레이드 어시스턴트를 사용하면 targetSdkVersion을 업데이트할 때 요구되는 시간과 노력을 절약할 수 있습니다.
각 마이그레이션 단계에서 주요 브레이킹 체인지와 해결 방법이 강조표시됩니다.
전체 변경사항 목록을 필터링하여 앱과 관련된 단계만 표시합니다. 확실하지 않은 경우 단계를 표시하므로 건너뛸 수 있는 단계가 계속 표시될 수도 있습니다.
일부 변경사항의 경우 코드에서 변경해야 할 정확한 위치를 파악합니다.
Android SDK 업그레이드 어시스턴트를 열려면 Tools > Android SDK Upgrade Assistant로 이동합니다. Assistant 패널에서 업그레이드할 API 수준을 선택합니다. 최상의 환경을 구현하려면 targetSdkVersion 값을 한 번에 한 수준씩 업그레이드해야 합니다.
버그 신고
Google에서 최상의 환경을 제공할 수 있도록 Issue Tracker를 사용하여 의견과 버그를 제출해 주세요.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-07-27(UTC)
[null,null,["최종 업데이트: 2025-07-27(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)."]]
