[Android] Android 13 / API level 33 → Android 14 / API level 34

불순분자들·2024년 7월 8일

Android

목록 보기
5/6

안드로이드 targetSDK & compileSDK 를 33 → 34 마이그레이션 정리

1. Reminder: Schedule exact alarms are denied by default

(번역)알림: 정확한 알람 일정은 기본적으로 거부됩니다.

[본문]
With the launch of Android 14, apps targeting Android 13 (API level 33) or
higher have new restrictions on using SCHEDULE_EXACT_ALARM.

If you had already upgraded your app to API level 33 before Android 14
then please go back to the Android 12L / API level 32 → Android 13 / API level 33 sequence and find this new upgrade step.

If you have already completed that migration step as part of the upgrade to API
level 33 then there is nothing extra to do as part of the upgrade to API level 34.  

For more information, see Schedule exact alarms are denied by default.
  • SCHEDULE_EXACT_ALARM 을 사용할 때 제한이 생겼습니다.
  • 정확한 예약 알림은 기본적으로 거부됨 상태라는 것을 의미합니다.
  • API Level 32 → 33 으로 업그레이드할 때 적용했다면 문제가 없습니다.

공식문서: https://developer.android.com/about/versions/14/changes/schedule-exact-alarms?hl=ko

2. Foreground service types are required

(번역) 포그라운드 서비스 유형은 필수 항목입니다.

[본문]
If your app targets Android 14, it must specify at least one foreground service type for each foreground service within your app.
You should choose a foreground service type that represents your app's use case.
The system expects foreground services that have a particular type to satisfy a particular use case.

Note: Android 14 introduces foreground service types for health and remote messaging use cases.
The system also reserves new types for short services, special use cases, and system exemptions.

If a use case in your app isn't associated with any of these types,
it's strongly recommended that you migrate your logic to use WorkManager
or user-initiated data transfer jobs.

Android 14 대상 앱의 요구사항

  • 각 포그라운드 서비스에 대해 적어도 하나의 포그라운드 서비스 유형 지정이 필수입니다.

새로운 포그라운드 서비스 유형

  • Android 14에서 도입된 건강 및 원격 메시징 사용 사례를 위한 포그라운드 서비스 유형
    짧은 서비스( 3분 이내로 유지 ), 특별한 사용 사례 및 시스템 예외를 위한 새로운 유형 예약이 생겼습니다.

사용 사례가 관련 유형과 맞지 않는 경우

  • WorkManager 또는 사용자가 시작한 데이터 전송 작업으로 로직 마이그레이션 권장합니다.

공식문서

3. OpenJDK 17 updates

Android 14의 주요 업데이트 중 하나로 최신 OpenJDK LTS 릴리스와의 기능 정렬을 위한 Android 핵심 라이브러리가 지속적으로 갱신되고 있습니다.

4. OpenJDK 17 updates

이번 라이브러리 업데이트는 앱 및 플랫폼 개발자를 위한 Java 17 언어 지원이며, 호환성에 영향을 미칠 수 있는 변경사항입니다.

  • 유효하지 않은 그룹 참조는 더 이상 허용되지 않습니다. 이것은 OpenJDK의 의미론(semantics)에 더욱 근접하게 따르기 위한 것입니다.

5. OpenJDK 17 updates

Matcher 클래스에서 IllegalArgumentException이 발생할 수 있는 새로운 경우를 볼 수 있습니다. 따라서 정규 표현식을 사용하는 앱 영역에 대해 테스트를 수행해야 합니다.

  • 테스트 중에 이 변경을 활성화 또는 비활성화하려면, 호환성 프레임워크 도구를 사용하여 DISALLOW_INVALID_GROUP_REFERENCE 플래그를 토글하세요.

6. OpenJDK 17 updates

일부 경우에는 java.lang.ClassValue 클래스를 추가하면 ProGuard를 사용하여 앱을 축소화, 난독화 및 최적화하려고 할 때 문제가 발생할 수 있습니다.

  • 앱이 java.lang.ClassValue 클래스가 포함되지 않은 이전 런타임 버전에서 개발되었다면, 이러한 최적화 과정에서 java.lang.ClassValue에서 파생된 클래스들의 computeValue 메서드가 제거될 수 있습니다.

7. Restrictions to implicit and pending intents

(번역): 암시적 및 보류 중인 인텐트에 대한 제한사항

  • 암시적 인텐트는 오직 export된 구성 요소에만 전달됩니다. 앱은 export되지 않은 구성 요소에 대해서는 명시적 인텐트를 사용하거나 해당 구성 요소를 export로 표시해야 합니다.
  • 앱이 컴포넌트나 패키지를 명시하지 않고 mutable한 펜딩 인텐트를 생성하면, 시스템에서는 이제 예외를 발생시킵니다.
<activity
    android:name=".AppActivity"
    android:exported="false">
    <intent-filter>
        <action android:name="com.example.action.APP_ACTION" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

만약 앱이 위의 인텐트 필터로 선언된 액티비티를 암시적 인텐트로 실행하려고 한다면, 다음과 같이 예외가 발생할 것입니다

// Android 14를 타겟으로 할 때 예외가 발생합니다.
context.startActivity(Intent("com.example.action.APP_ACTION"))

다음은 export 되지 않은 액티비티를 만드는 예제입니다.

// This makes the intent explicit.
val explicitIntent = Intent("com.example.action.APP_ACTION")
explicitIntent.apply {
    package = context.packageName
}
context.startActivity(explicitIntent)

8. Runtime-registered broadcasts receivers must specify export behavior

(번역): 런타임 등록 브로드캐스트 수신기는 내보내기 동작을 지정해야 합니다.

안드로이드 14를 타겟으로 하고 context-registered 리시버를 사용하는 앱과 서비스는 리시버가 기기의 다른 모든 앱에 내보내져야 하는지 여부를 나타내는 플래그를 지정해야 합니다

  • 각각 RECEIVER_EXPORTED 또는 RECEIVER_NOT_EXPORTED. 이 요구사항은 안드로이드 13에서 도입된 리시버 기능을 활용하여 앱을 보안 취약성으로부터 보호하는 데 도움이 됩니다.

시스템 브로드캐스트만 받는 리시버에 대한 예외

  • 만약 앱이 Context#registerReceiver 메서드(예: Context#registerReceiver())를 통해서 시스템 브로드캐스트만 받도록 리시버를 등록하는 경우, 리시버를 등록할 때 플래그를 지정하지 않아야 합니다.

9. Safer dynamic code loading

(번역): 더욱 안전한 동적 코드 로딩

안드로이드 14를 타겟으로 하고 동적 코드 로딩(Dynamic Code Loading, DCL)을 사용하는 경우, 모든 동적으로 로드된 파일은 읽기 전용으로 설정되어야 합니다. 그렇지 않으면 시스템에서 예외가 발생합니다.

가능하다면 동적 코드 로딩을 피하는 것이 좋습니다. 이는 코드 주입이나 코드 변조에 의해 앱이 손상될 위험을 크게 증가시키기 때문입니다.

동적 코드를 로드해야 하는 경우, 파일이 열리자마자 파일을 읽기 전용으로 설정하고, 콘텐츠가 기록되기 전에 다음 접근 방식을 사용하세요

val jar = File("DYNAMICALLY_LOADED_FILE.jar")
val os = FileOutputStream(jar)
os.use {
   // 경합 조건을 방지하기 위해 먼저 파일을 읽기 전용으로 설정
   jar.setReadOnly()
   // 그런 다음 실제 파일 내용을 작성
}
val cl = PathClassLoader(jar, parentClassLoader)

이미 존재하는 동적으로 로드된 파일 처리

  • 기존의 동적으로 로드된 파일에 대해 예외가 발생하는 것을 방지하려면, 해당 파일을 다시 로드하기 전에 삭제하고 새로 생성하는 것을 권장합니다. 파일을 새로 생성할 때, 파일을 쓰기 시점에 읽기 전용으로 설정하는 위의 지침을 따르세요.

  • 또는 기존 파일을 읽기 전용으로 다시 라벨링할 수도 있지만, 이 경우 파일의 무결성을 먼저 확인하는 것이 좋습니다(예: 신뢰할 수 있는 값에 대한 파일 서명을 확인). 이는 악의적인 행위로부터 앱을 보호하는 데 도움이 됩니다.

10. Additional restrictions on starting activities from the background

(번역): 백그라운드에서 활동 시작에 대한 추가 제한 사항

PendingIntent 사용 시 제한

  • 앱이 PendingIntent#send() 또는 유사한 메서드를 사용하여 PendingIntent를 보낼 때, 앱이 해당 PendingIntent를 시작할 수 있는 백그라운드 액티비티 시작 권한을 부여하려면 명시적으로 선택해야 합니다.
val pendingIntent = PendingIntent.getActivity(context, requestCode, intent, flags)
val options = ActivityOptions.makeBasic()
options.setPendingIntentBackgroundActivityStartMode(ActivityOptions.MODE_BACKGROUND_ACTIVITY_START_ALLOWED)
pendingIntent.send(null, 0, null, null, null, null, options.toBundle())

bindService 사용 시 제한

  • 보이는 앱이 bindService() 메서드를 사용하여 백그라운드에 있는 다른 앱의 서비스를 바인딩할 때, 해당 서비스에 백그라운드 액티비티 시작 권한을 부여하려면 명시적으로 선택해야 합니다.
  • 선택하려면 bindService() 메서드를 호출할 때 BIND_ALLOW_ACTIVITY_STARTS 플래그를 포함해야 합니다.
val intent = Intent(context, MyService::class.java)
val serviceConnection = object : ServiceConnection {
    override fun onServiceConnected(name: ComponentName, service: IBinder) {
        // 서비스 연결 시 작업
    }
    override fun onServiceDisconnected(name: ComponentName) {
        // 서비스 연결 해제 시 작업
    }
}
context.bindService(intent, serviceConnection, Context.BIND_ALLOW_ACTIVITY_STARTS)

11. Grant partial access to photos and videos

Android 14에서 사용자는 앱이 시각적 미디어 권한(READ_MEDIA_IMAGES 또는 READ_MEDIA_VIDEO)을 요청할 때 시각적 미디어 라이브러리(사진/비디오)에 대한 부분 접근 권한을 부여할 수 있습니다. 이 변경 사항을 지원하기 위해 아래의 세부 사항을 확인하세요.

새 권한 부여 옵션

  • 사진 및 비디오 선택: 사용자가 앱에 접근 권한을 부여할 특정 사진 및 비디오를 선택합니다. (Android 14에서 새로 도입)
  • 모두 허용: 기기의 모든 사진과 비디오에 대한 전체 라이브러리 접근 권한을 부여합니다.
    허용하지 않음: 접근 권한을 거부합니다.

시스템 동작

  • 사진 및 비디오 선택을 선택한 경우, 앱이 나중에 READ_MEDIA_IMAGES 또는 READ_MEDIA_VIDEO 권한을 다시 요청하면 시스템은 다른 대화 상자를 표시하여 전체 접근 권한 부여, 현재 선택 유지, 추가 사진 및 비디오 권한 부여 중 선택할 기회를 제공합니다.
  • 일정 시간이 지나면 시스템은 직접 시스템 선택기를 표시합니다.

새 권한

  • READ_MEDIA_VISUAL_USER_SELECTED: 사용자가 선택한 사진 및 비디오에 대한 부분적이고 임시 접근 권한을 제공합니다.

앱에서 변경 사항을 지원하는 방법

앱이 변경하지 않는 경우의 동작

  • READ_MEDIA_VISUAL_USER_SELECTED 권한을 선언하지 않으면 다음 동작이 발생합니다:
    READ_MEDIA_IMAGES 및 READ_MEDIA_VIDEO 권한은 앱 세션 동안 부여되며, 임시 접근 권한을 제공합니다.

  • 앱이 백그라운드로 이동하거나 사용자가 앱을 종료하면 시스템은 권한을 거부합니다.

  • 추가 사진 및 비디오 접근이 필요한 경우, READ_MEDIA_IMAGES 또는 READ_MEDIA_VIDEO 권한을 다시 요청해야 하며, 시스템은 사용자에게 사진 및 비디오를 선택하도록 다시 요청합니다.

  • 앱이 권한 모범 사례를 따르면 이 변경 사항은 앱에 문제를 일으키지 않습니다. 예를 들어, URI 접근이 유지된다고 가정하지 않거나, 시스템 권한 상태를 저장하거나, 권한 변경 후 표시되는 이미지를 새로고침하는 경우.

앱에서 동작을 제어하려면

  • READ_MEDIA_VISUAL_USER_SELECTED 권한을 선언하고 사용자가 시스템 권한 대화 상자에서 "사진 및 비디오 선택"을 선택한 경우 다음 동작이 발생합니다:

    • READ_MEDIA_IMAGES 및 READ_MEDIA_VIDEO 권한은 모두 거부됩니다.

    • READ_MEDIA_VISUAL_USER_SELECTED 권한이 부여되어 사용자의 사진 및 비디오에 대한 부분적이고 임시 접근 권한을 제공합니다.

    • 추가 사진 및 비디오 접근이 필요한 경우 READ_MEDIA_IMAGES 또는 READ_MEDIA_VIDEO 권한(또는 둘 다)을 다시 요청해야 합니다.

val jar = File("DYNAMICALLY_LOADED_FILE.jar")
val os = FileOutputStream(jar)
os.use {
   // 경합 조건을 방지하기 위해 먼저 파일을 읽기 전용으로 설정
   jar.setReadOnly()
   // 그런 다음 실제 파일 내용을 작성
}
val cl = PathClassLoader(jar, parentClassLoader)

중요: 사용자가 시스템 대화 상자를 다시 보게 되지 않도록, READ_MEDIA_IMAGES 또는 READ_MEDIA_VIDEO 권한을 다시 요청하기 전에 앱에 UI 요소를 추가하세요.

권장 사항: 여러 시스템 런타임 대화 상자를 방지하기 위해 READ_MEDIA_VISUAL_USER_SELECTED, ACCESS_MEDIA_LOCATION 및 "read media" 권한(READ_MEDIA_IMAGES, READ_MEDIA_VIDEO 또는 둘 다)을 한 번에 요청하세요.

추가 정보
부분 접근 권한 부여에 대한 자세한 내용은 Grant partial access to photos and videos 문서를 참조하세요.
공식 문서: https://developer.android.com/about/versions/14/changes/partial-photo-video-access?hl=ko

profile
불순분자들
장래희망 : 침대 위 녹아든 치즈
이전 포스트

[Android] 인앱 캡처는 허용하고 멀티태스크 화면 캡처는 허용하지 않는 방법

다음 포스트

[Android] Android 15 / API level 35 변경사항 한 눈에 살펴보기

0개의 댓글