Google Play의 대상 API 수준 요구사항 충족

Android 11 (API 수준 30) 미만에서 이전

이전할 Android 버전을 선택하세요.

Android 5(API 수준 21)로 이전

아래 버전에서 도입된 변경사항이 앱에 적용되었는지 확인하려면 각 버전별 동작 변경사항 페이지를 참고하세요.

• Android 5.0(API 수준 21)
• Android 4.4(API 수준 19)
• Android 4.1.x(API 수준 16)

다음 섹션의 안내를 따라 계속하세요.

Android 6(API 수준 23)으로 이전

다음 항목은 Android 6.0 이상 버전을 타겟팅하는 앱에 적용됩니다.

• 런타임 권한

  • 위험한 권한은 런타임에만 부여되기 때문에 UI 흐름에 이러한 권한을 부여할 여유가 확보되어야 합니다.

  • 가능한 경우 앱에서 권한 요청 거부를 처리할 준비가 되어 있어야 합니다. 예를 들어 사용자가 기기 GPS 액세스 권한 요청을 거부하면 앱에서 다른 방법으로 진행할 수 있어야 합니다.

Android 6.0(API 수준 23)에서 도입된 변경사항의 전체 목록을 확인하려면 해당하는 버전의 Android를 다루는 동작 변경사항 페이지를 참고하세요.

다음 섹션의 안내를 따라 계속하세요.

Android 7(API 수준 24)로 이전

다음 항목은 Android 7.0 이상 버전을 타겟팅하는 앱에 적용됩니다.

• 잠자기 및 앱 대기

  잠자기 및 앱 대기 최적화에 설명되어 있는 동작을 고려하여 설계합니다. 여기에는 여러 차례의 플랫폼 출시를 통해 도입된 점진적인 변경사항이 모두 포함됩니다.

  기기가 잠자기 및 앱 대기 모드일 때, 시스템은 다음과 같이 작동합니다.

  • 네트워크 액세스를 제한합니다.
  • 알람, 동기화, 작업을 연기합니다.
  • GPS 및 Wi-Fi 검색을 제한합니다.
  • 일반적인 우선순위를 갖는 Firebase 클라우드 메시징 메시지를 제한합니다.

• 권한 변경사항

  • 시스템에서 앱 비공개 디렉터리 액세스를 제한합니다.
  • 앱 외부에 file:// URI를 노출하면 FileUriExposedException이 트리거됩니다. 앱 외부로 파일을 공유해야 하는 경우 FileProvider를 구현합니다.

• 시스템에서 NDK가 아닌 라이브러리로의 링크를 금지합니다.

Android 7.0(API 수준 24)에서 도입된 변경사항의 전체 목록을 확인하려면 해당하는 버전의 Android를 다루는 동작 변경사항 페이지를 참고하세요.

다음 섹션의 안내를 따라 계속하세요.

Android 8(API 수준 26)로 이전

다음 항목은 Android 8.0 이상 버전을 타겟팅하는 앱에 적용됩니다.

• 백그라운드 실행 제한
  • 포그라운드에서 실행되지 않는 앱을 대상으로 한 서비스를 시스템에서 제한합니다.
    • startService()가 금지된 상태에서 앱이 startService()를 호출하려고 하면 예외가 발생합니다.
    • 포그라운드 서비스를 시작하려는 앱은 startForeground() 및 startForegroundService()를 사용해야 합니다.
    • JobScheduler API의 변경사항을 신중하게 검토하시기 바랍니다. 이는 Android 8.0(API 수준 26) 동작 변경사항 페이지에 설명되어 있습니다.
    • Firebase 클라우드 메시징을 사용하려면 Google Play 서비스 SDK의 버전 10.2.1 이상이 필요합니다.
    • Firebase 클라우드 메시징을 사용할 때 메시지 전달이 백그라운드 실행 제한의 영향을 받습니다. 메시지 수신 시 백그라운드 작업이 필요한 경우(예: 백그라운드 데이터 동기화 수행) 앱에서는 Firebase Job Dispatcher 또는 JobIntentService를 대신 사용하여 작업을 예약해야 합니다. 자세한 내용은 Firebase 클라우드 메시징 문서를 참고하세요.
  • 암시적 브로드캐스트
    • 암시적 브로드캐스트가 제한됩니다. 백그라운드 이벤트 처리에 관한 자세한 내용은 JobScheduler API 문서를 참고하세요.
  • 백그라운드 위치 액세스 제한
    • 백그라운드에서 실행되는 앱의 위치 데이터 액세스가 제한됩니다.
      • Google Play 서비스가 지원되는 기기에서는 통합 위치 정보 제공자를 통해 정기적으로 위치 업데이트를 받습니다.
• 알림 채널
  • 채널별로 알림 방해 속성을 정의해야 합니다.
  • 알림을 표시하려면 채널에 알림을 할당해야 합니다.
  • 이 플랫폼 버전에서는 NotificationCompat.Builder를 지원합니다.
• 개인 정보 보호
  • ANDROID_ID는 앱 서명 키별로 범위가 지정됩니다.

Android 8.0(API 수준 26)에서 도입된 변경사항의 전체 목록을 확인하려면 해당하는 버전의 Android를 다루는 동작 변경사항 페이지를 참고하세요.

Android 8 (API 26)에서 Android 9 (API 28)로 이전

• 전원 관리
  • 앱 대기 버킷은 지연된 작업, 우선순위가 높은 메시지의 알람 및 할당량 등 앱 참여도에 따라 새로운 백그라운드 제한사항을 도입합니다.
  • 절전 모드 개선을 통해 앱 대기 상태인 앱의 제한사항이 개선되었습니다.
• 포그라운드 서비스 권한
  • 일반 권한 FOREGROUND_SERVICE(런타임 권한 아님)를 요청해야 합니다.
• 개인 정보 보호 변경사항
  • 백그라운드 센서 액세스 제한
  • 통화 기록 액세스가 제한되며 이제 CALL_LOG 권한 그룹에 포함됩니다.
  • 전화번호 액세스가 제한되며 READ_CALL_LOG 권한을 요청합니다.
  • Wi-Fi 정보 액세스 제한

Android 9.0(API 수준 28)에 도입된 변경사항의 전체 목록을 확인하려면 동작 변경사항을 참고하세요.

Android 9 (API 수준 28)에서 Android 10 (API 수준 29)으로 이전

• 전체 화면 인텐트가 있는 알림
  • 일반 권한 USE_FULL_SCREEN_INTENT(런타임 권한 아님)를 요청해야 합니다.
• 폴더블 및 큰 화면 기기 지원
  • 이제 여러 활동이 동시에 '재개됨' 상태에 있을 수 있지만, 실제로 하나의 활동에만 포커스가 있습니다.
    • 이 변경사항은 onResume() 및 onPause() 동작에 영향을 미칩니다.
    • onTopResumedActivityChanged()를 구독하여 감지할 수 있는 '최상위 재개'라는 새로운 수명 주기 개념
      • 하나의 활동만 '최상위 재개'될 수 있습니다.
  • resizeableActivity를 false로 설정하면 자동으로 앱을 더 좁은 가로세로 비율로 레터박스 처리하는 minAspectRatio를 앱에서 추가로 지정할 수 있습니다.
• 개인 정보 보호 변경사항
  • 범위 지정 저장소
    • 외부 저장소 액세스는 앱별 디렉터리 및 앱에서 만든 특정 미디어 유형으로만 제한됩니다.
  • 앱이 백그라운드에 있는 동안 위치 액세스가 제한되며 ACCESS_BACKGROUND_LOCATION 권한이 필요합니다.
  • IMEI 및 일련번호와 같이 재설정할 수 없는 식별자 액세스가 제한됩니다.
  • 사용자의 걸음 수와 같은 신체 활동 정보 액세스가 제한되며 ACTIVITY_RECOGNITION 권한이 필요합니다.
  • 일부 텔레포니, 블루투스, Wi-Fi API 액세스가 제한되며 ACCESS_FINE_LOCATION 권한을 요청합니다.
  • Wi-Fi 설정 액세스 제한
    • 앱에서는 더 이상 Wi-Fi를 직접 사용 설정 또는 사용 중지할 수 없으며 설정 패널을 사용해야 합니다.
    • Wi-Fi 네트워크 연결 시작 시 제한사항으로 WifiNetworkSpecifier 또는 WifiNetworkSuggestion을 사용해야 합니다.

Android 10(API 수준 29)에서 Android 11(API 수준 30)로 이전

• 개인 정보 보호
  • 범위 지정 저장소 적용: 앱에서 전용 위치를 사용하여 앱 관련 파일 형식, 미디어 파일 형식, 기타 파일 형식을 저장하고 액세스하는 범위 지정 저장소 모델을 채택해야 합니다.
  • 권한 자동 초기화: 사용자가 몇 개월 동안 앱과 상호작용하지 않았다면 시스템에서 앱의 민감한 권한을 자동으로 초기화합니다. 이는 대부분 앱에 영향을 미치지 않습니다. 앱이 주로 사용자 상호작용 없이 백그라운드에서 작동한다면 사용자에게 자동 재설정을 사용 중지하도록 요청할 수 있습니다.
  • 백그라운드 위치 정보 액세스: 앱에서 포그라운드와 백그라운드 위치 정보 액세스 권한을 별도로 요청해야 합니다. 런타임 권한 대화상자가 아닌 앱 설정에서만 백그라운드 위치 액세스 권한을 부여할 수 있습니다.
  • 패키지 공개 상태: 앱이 기기에 설치된 앱과 서비스 목록을 쿼리하면 반환된 목록이 필터링됩니다.
    • TTS(텍스트 음성 변환) 또는 음성 인식 서비스를 사용하면 서비스를 위해 쿼리 요소를 매니페스트 파일에 추가해야 합니다.
• 보안
  • 압축된 `resource.arsc` 파일이 더 이상 지원되지 않음
  • 이제 APK 서명 체계 v2가 필요합니다. 이전 버전과의 호환성을 위해 개발자는 계속 APK 서명 체계 v1로 서명해야 합니다.
  • 비 SDK 인터페이스 관련 제한사항이 있습니다. 현재 비 SDK 인터페이스의 일부가 차단되어 있으므로 API 수준 30을 타겟팅하는 앱에는 비 SDK 인터페이스를 사용하지 않는 것이 좋습니다. 차단된 비 SDK 인터페이스의 전체 목록은 Android 11에서 차단된 비 SDK 인터페이스를 참고하세요.

Android 11 (API 수준 30)에서 도입된 변경사항의 전체 목록을 확인하려면 동작 변경사항 페이지를 참고하세요.

이전 섹션의 안내를 따라 API 31로 계속 업데이트합니다.