기본 호환성을 확인합니다. Android 10을 실행하는 새 기기를 구매하거나 업데이트하는 사용자가 게시된 기존 앱을 바로 사용할 수 있는지를 가능한 한 빨리 확인해야 합니다. 앱을 테스트하여 충분히 작동하는지 확인한 다음 앱의 호환 버전을 사용자에게 게시합니다.
Android 10 기능 및 API로 빌드합니다. 그런 다음 Android 10에서 새로운 기능과 API를 살펴봅니다. 개발 환경을 설정하고, 앱의 targetSdkVersion을 변경하고, 앱과 관련된 새로운 API로 빌드합니다.
다음 섹션에서는 이러한 각 단계에서 해야 할 일을 강조하여 설명합니다.
시작하기 전에 앱을 실행하고 테스트할 하드웨어 기기 또는 에뮬레이터를 준비했는지 확인하세요.
1단계: 기본 호환성
이 단계의 목표는 앱이 Android 10에서 실행될 때 나타날 수 있는 기능 회귀 또는 기타 영향을 식별한 다음 이를 해결하고 사용자에게 업데이트된 버전을 게시하는 것입니다. 호환성 지원을 위해 compileSdkVersion을 선택적으로 변경할 수는 있지만 앱의 targetSdkVersion을 변경하거나 새 API를 사용해서는 안 되는 경우가 많습니다.
일부 플랫폼 변경사항은 앱의 동작에 영향을 줄 수 있으므로 모든 흐름을 통해 기존 앱의 기능을 테스트하는 것이 중요합니다. 호환되는 앱 버전을 게시할 때 업데이트 노트에서 Android 10 지원을 사용자에게 알리는 것이 좋습니다.
사용자가 Android 10으로 원활하게 전환하도록 지원하려면 호환되는 앱 버전을 가능한 한 빨리 게시하는 것이 좋습니다. 기기에서 Android 10 업데이트 수신을 시작하기 전에 하는 것이 가장 바람직합니다.
테스트 수행
호환성 테스트는 앱 출시를 준비할 때 진행하는 테스트와 유형이 동일합니다. 이 시점에서 핵심 앱 품질 가이드라인과 테스트 권장사항을 검토하는 것이 좋습니다.
앱에 영향을 줄 수 있는 알려진 동작 변경사항을 숙지해야 합니다. 이러한 동작 변경사항은 targetSdkVersion을 변경하지 않은 경우에도 앱에 적용됩니다. 변경사항을 미리 검토하면 영향을 받을 수 있는 영역을 식별하여 문제를 더 빨리 디버깅할 수 있습니다.
Android 10에서는 개인 정보 보호가 폭넓게 변경되었으므로, 주요 개인 정보 변경사항을 검토하고 앱에 미칠 수 있는 영향을 파악해야 합니다.
2단계: Android 10으로 빌드
준비가 되면 Android 10의 새로운 기능과 API를 살펴보고 새로운 환경으로 앱을 개선할 수 있습니다. 새 API로 개발을 시작하려면 Android 스튜디오에서 Android 10 (API 29) SDK를 설정하고 targetSdkVersion과 compileSdkVersion을 모두 29로 변경해야 합니다.
targetSdkVersion을 변경할 때는 Android 10(API 29) 이상을 타겟팅할 경우 앱에 적용되는 시스템 동작 변경사항도 고려해야 합니다.
일부 동작 변경사항은 회귀 또는 비정상 종료를 일으킬 수 있으므로, targetSdkVersion을 변경하는 앱 업데이트를 게시하기 전에 변경사항을 검토하고 철저히 테스트해야 합니다.
SDK 다운로드
Android 10으로 앱을 빌드하기 위해 SDK 패키지를 다운로드하려면 먼저 Android 스튜디오의 최신 버전을 사용해야 합니다. 자세한 내용은 SDK 설정을 참고하세요.
테스트 수행
앞서 설명한 준비가 완료되면 앱을 빌드한 후 테스트를 통해 Android 10을 타겟팅할 경우 올바르게 작동하는지 확인할 수 있습니다.
이 시점에서 핵심 앱 품질 가이드라인과 테스트 권장사항을 검토하는 것이 좋습니다.
targetSdkVersion을 29로 설정하고 앱을 빌드하는 경우 알아야 하는 특정한 플랫폼 변경사항이 있습니다. Android 10 동작 변경사항 페이지에 설명된 이러한 변경사항 중 일부는 앱 동작에 상당한 영향을 미치거나 앱의 비정상 종료를 일으킬 수 있으며, 이는 아직 새 API를 사용하지 않더라도 마찬가지입니다.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-08-27(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-08-27(UTC)"],[],[],null,["Welcome! Android 10 has many new APIs for building new experiences, as well as\nupdated system behaviors that can affect your app when it's running on Android\n10 devices.\n\nTo get started, we recommend reviewing the [system behavior changes](/about/versions/10/behavior-changes-all),\n[privacy changes](/about/versions/10/privacy/changes), and [new features and APIs](/about/versions/10/highlights), then migrating your apps\nin these two phases:\n\n1. [Ensure basic compatibility](#compat). As soon as possible, make sure your existing published app is ready for users who are updating or purchasing new devices running Android 10. Test your app to verify that it's fully functional, then publish the compatible version of the app to users.\n2. [Build with Android 10 features and APIs](#use_apis). Next, explore the new features and APIs in Android 10. Set up your development environment, change your app's `targetSdkVersion`, and build with the new APIs that are relevant for your app.\n\nThe following sections highlight what you'll need to do in each of these phases.\nBefore you get started, make sure you've [prepared a hardware device](/about/versions/10/get) or\nemulator) to run and test your app.\n\nPhase 1: Basic compatibility\n\nThe goal of this phase is to identify any functionality regressions or other\nimpacts when your app is running on Android 10, then address them and publish an\nupdated version to users. In many cases you shouldn't need to change your app's\n`targetSdkVersion` or use new APIs, although you can optionally change your\n`compileSdkVersion` to support compatibility.\n\nIt's important to test the functionality of your existing app through all flows,\nbecause some platform changes can affect the way your app behaves. When you\npublish the compatible version of your app, we recommend notifying users of\nAndroid 10 support in your update notes.\n\n\nTo give your users a smooth transition to Android 10, we recommend publishing a\ncompatible version of your app as early as possible --- ideally before\ndevices begin receiving Android 10 updates.\n\nPerform testing\n\nCompatibility testing entails the same type of testing you perform when\npreparing to release your app. This is a good time to review the [core app\nquality guidelines](/develop/quality-guidelines/core-app-quality) and [best practices for testing](/training/testing).\n\nMake sure to familiarize yourself with the known behavior changes that can\naffect your app. [These behavior changes](/about/versions/10/behavior-changes-all) will apply to your app, even if you\nhaven't changed your `targetSdkVersion`. Reviewing the changes in advance will\nhelp you to identify possible impact areas and debug any issues more quickly.\n\nAndroid 10 includes extensive changes for privacy, so make sure you also [review\nthe key privacy changes](/about/versions/10/privacy/changes) and understand the possible impacts on your app.\n\nPhase 2: Build with Android 10\n\nWhenever you are ready, you can explore the new features and APIs in Android 10\nand enhance your app with new experiences. To start developing with the new\nAPIs, you'll need to set up the Android 10 (API 29) SDK in Android Studio and\nchange both your `targetSdkVersion` and `compileSdkVersion` to `29`.\n\nWhen you change your `targetSdkVersion`, you'll also need to account for [system\nbehavior changes](/about/versions/10/behavior-changes-10) that apply to your app when you are targeting Android 10\n(API 29) or higher.\n\nSome behavior changes might cause regressions or crashes, so make sure to review\nthe changes and test thoroughly before publishing an app update that changes\nyour `targetSdkVersion`.\n| **Note:** The previously described steps to [ensure platform compatibility](#compat) are prerequisite to targeting your app to Android 10, so be sure to complete those steps first.\n\nGet the SDK\n\nTo get the SDK packages to build your app with Android 10, first make sure\nyou're using the latest version of [Android Studio](/studio). To learn more, read\n[Set up the SDK](/about/versions/10/setup-sdk).\n\nPerform testing\n\nWith the previously described preparations complete, you can build your app and\nthen test it further to make sure it works properly when targeting Android 10.\nThis is another good time to review the [core app quality guidelines](/develop/quality-guidelines/core-app-quality) and\n[best practices for testing](/training/testing).\n\nWhen you build your app with the `targetSdkVersion` set to `29`, there are\nspecific platform changes you should be aware of. Some of these changes, which\nare described on the [Android 10 behavior changes](/about/versions/10/behavior-changes-10) page, can significantly\naffect your app's behavior or cause crashes --- even if you don't yet use new\nAPIs."]]
