12 KiB
12 KiB
SDK 36 호환성 점검
1. 리뷰 정보
| 항목 | 내용 |
|---|---|
| 리뷰 대상 | Phase 1 / compileSdk·targetSdk 35 → 36 변경 영향 |
| 기준 | working tree의 app/build.gradle 두 SDK 값 변경 |
| 리뷰 일자 | 2026-10-30 |
| 리뷰어 | Sisyphus |
| 기준 문서 | AGENTS.md, docs/sample/sample-review.md, Android 16 공식 변경 문서 |
| 리뷰 상태 | 판정 완료, 수정 미실행 |
2. 목적과 범위
- 빌드 도구, 앱 코드의 Android 16 동작 변경 영향, 로컬 테스트 호환성과 네이티브 정렬을 확인한다.
- 읽기 전용 점검 요청이므로 앱·테스트·빌드 설정은 변경하지 않는다. 구현용 PRD·계획 문서는 만들지 않는다.
- 기기·에뮬레이터 조작, 실서버·실제 방송·결제 호출, 릴리스 패키징은 제외한다.
- TDD 예외 사유: 수정 없는 리뷰다. 대체 검증은 기존 테스트 실행, 소스 호출 경로 및 공식 문서 대조다.
3. 판정 기준
- High: 핵심 기능 회귀 위험 또는 기존 테스트 실행 불능.
- Medium: 특정 화면·기기 조건의 기능 문제.
- 확정: 실행 또는 코드·플랫폼 계약으로 확인. 후보: 실제 기기 영향 미재현. 보류: 환경 제약으로 검증 미완료.
4. 근거와 실행 결과
환경
- AGP 8.13.0, Gradle 8.14.3, Kotlin 2.2.20, Java/Kotlin toolchain 17.
- compileSdk 36, targetSdk 36, minSdk 23. AGP는 API 36 지원 범위다.
- Robolectric 4.15.1은 API 35까지 지원한다. API 36 실행은 Robolectric 4.16 이상 및 Java 21이 필요하다.
실행한 검증
| 명령·검증 | 결과 | 증거 |
|---|---|---|
./gradlew :app:assembleDebug :app:testDebugUnitTest :app:lintDebug :app:lintRelease --continue --console=plain |
실행 전 실패 | 기존 taskGraph 서명 검사에서 RELEASE_STORE_FILE·PASSWORD·KEY_ALIAS·KEY_PASSWORD 누락. 릴리스 린트의 의존 Task에도 서명 검사가 걸림 |
./gradlew :app:assembleDebug :app:testDebugUnitTest :app:lintDebug --continue --console=plain |
일부 완료 후 시간 초과 | assembleDebug 완료, 단위 테스트 컴파일·린트 단계에서 600초 제한 도달. 전체 테스트 통과로 판단하지 않음 |
./gradlew :app:lintDebug --console=plain |
보류 | 180초 내 미완료 |
./gradlew :app:testDebugUnitTest --tests '*HomeMainFragmentSourceTest' --console=plain |
실패 | 1개 initializationError. Package targetSdkVersion=36 > maxSdkVersion=35 |
./gradlew :app:assembleDebug :app:lintDebug --console=plain |
일부 완료 후 시간 초과 | assembleDebug UP-TO-DATE, 린트 분석 240초 내 미완료 |
./gradlew :app:assembleDebug tasks --all --console=plain |
성공 | BUILD SUCCESSFUL in 3s, assembleDebug UP-TO-DATE. 문서에 사용한 Gradle Task 존재 확인 |
Build Tools 36.0.0 zipalign -c -P 16 4 app/build/outputs/apk/debug/app-debug.apk |
성공 | exit 0 |
NDK llvm-readelf -lW로 Debug merged native libs의 arm64-v8a 14개 .so 확인 |
성공 | 모든 LOAD 세그먼트 Align이 0x4000(16KB) |
기존 lint-results-debug 보고서는 이번 실행 이전 파일임을 수정 시각으로 확인했다. 이번 SDK 36 린트 결과로 재사용하지 않았다. 네이티브 확인은 ARM64 ELF 정렬과 Debug APK ZIP 정렬에 한정하며, 다른 ABI·릴리스 AAB·16KB 기기 실행을 보증하지 않는다.
5. 발견 사항
| ID | 심각도 | 상태 | 제목 |
|---|---|---|---|
| REV-P1-001 | High | 확정 | SDK 미지정 Robolectric 테스트가 targetSdk 36 때문에 초기화 실패 |
| REV-P1-002 | High | 후보 | 대화면 회전으로 라이브 화면이 재생성되면 방 퇴장·음성 엔진 해제 경로 실행 |
REV-P1-001: Robolectric 테스트 초기화 실패
- 코드:
app/build.gradle:333은 Robolectric 4.15.1,:352는 JVM toolchain 17이다. - 테스트:
app/src/test/java/kr/co/vividnext/sodalive/v2/main/home/HomeMainFragmentSourceTest.kt:14의@Config는 SDK를 지정하지 않는다. - 재현: 위 focused 테스트 실행 시
DefaultSdkPicker.java:119에서Package targetSdkVersion=36 > maxSdkVersion=35오류가 발생한다. 테스트 본문 실행 전 실패다. - 증거:
app/build/test-results/testDebugUnitTest/TEST-kr.co.vividnext.sodalive.v2.main.home.HomeMainFragmentSourceTest.xml:5. - 영향: SDK를 명시하지 않는 기존 Robolectric 테스트를 현재 설정으로 실행할 수 없다. SDK 28 등으로 고정된 테스트가 모두 실패한다는 뜻은 아니다.
- 권장 조치: 기존 로직 회귀 검증만 필요하면 해당 테스트 SDK를 35 이하로 명시하는 최소 변경을 검토한다. Android 16 자체를 검증하려면 Robolectric 4.16 이상과 테스트 실행 JVM 21 구성을 함께 검토한다. 앱 bytecode target까지 21로 올릴 필요가 있다는 뜻은 아니다.
- 판정: 2026-10-30, 기존 테스트 실행으로 확정. 수정하지 않음.
REV-P1-002: 대화면 회전 시 라이브 종료 처리
- 플랫폼 조건: Android 16, targetSdk 36, smallest width 600dp 이상에서는 portrait 요청 등이 기본적으로 무시된다. 휴대전화의 일반적인 600dp 미만 화면에는 해당하지 않는다.
- 코드:
base/BaseActivity.kt:60은 모든 상속 화면에 portrait를 요청한다. Manifest의LiveRoomActivity선언(app/src/main/AndroidManifest.xml:185)에는 orientation/screenSize 재생성 처리가 없다. 제한적 크기 변경 호환성 opt-out도 선언하지 않았다. - 실제 호출 경로:
live/room/LiveRoomActivity.kt:454의onDestroy()는 구성 변경 여부를 구분하지 않고viewModel.quitRoom(roomId)를 호출한다. 성공 콜백은 번역 중지,SodaLiveService.stopService, Agora 해제,RtmClient.release()를 수행한다. - 추가 근거:
live/room/LiveRoomViewModel.kt:714의 quitRoom은 서버 퇴장 요청이며, 새 Activity는LiveRoomActivity.kt:393에서 Agora 초기화와 방 정보 조회를 다시 수행한다. - 영향: 태블릿·폴더블 내부 화면에서 회전/창 크기 변경으로 Activity가 재생성되면 의도하지 않은 퇴장, 음성 중단, 새 진입과 이전 종료 처리의 경합 위험이 있다. 단순 레이아웃 늘어짐보다 우선 검토해야 한다.
- 권장 조치: 세로 고정 요구 유지 여부를 먼저 결정한다. target 36의 임시 호환성 opt-out 또는 구성 변경과 실제 종료를 분리하는 수명주기 처리를 검토한다. 레거시 코드이므로 수정 전에 사용자 승인과 별도 계획이 필요하다.
- 판정: 2026-10-30, 플랫폼 계약과 코드 경로는 확인. 실제 방송 중단은 기기에서 재현하지 않았으므로 후보 유지.
6. 신규 문제로 판정하지 않은 항목
- 뒤로 가기: 앱 소스는
OnBackPressedDispatcher를 사용한다. 구식onBackPressed()override·KEYCODE_BACK 의존은 발견하지 못했다. 외부 SDK 내부 동작까지 보증하지 않는다. - Edge-to-edge: BaseActivity는
setDecorFitsSystemWindows(false)와 system bar/IME inset 처리를 한다. 폐지된windowOptOutEdgeToEdgeEnforcement의존은 발견하지 못했다. 화면별 렌더링은 미확인이다. - 타이머: VoiceMessageFragment의 fixed-rate 작업은 tick 누적이 아니라
mediaPlayer.currentPosition을 읽어 SeekBar를 갱신하므로 놓친 실행 횟수 재현에 의존하지 않는다. - elegantTextHeight 명시 override, 직접 JobScheduler/WorkManager 사용은 앱 소스에서 발견하지 못했다. 외부 SDK의 작업 스케줄링은 별도다.
- 오디오 포커스·기존 FGS 제한과 16KB 지원은 target 35/Android 15부터의 항목이므로 target 36 신규 회귀로 부풀리지 않는다. 로컬 네트워크 제한과 Safer Intents의 Android 16 opt-in도 자동 강제 대상으로 취급하지 않는다.
7. 후속 전환과 종료 판정
- 이번 요청은 점검뿐이므로 수정 Task·goal을 생성하거나 앱 코드를 변경하지 않았다.
- REV-P1-001의 테스트 SDK 정책 결정과 REV-P1-002의 대화면·방송 수명주기 검토가 필요하다.
- [blocked] 전체 테스트·Debug 린트: 시간 제한으로 미완료. 릴리스 린트: 기존 서명 설정 검증에 차단됨.
- 최종 결론: SDK 값 변경은 컴파일·Debug APK 생성 단계까지 진행되지만, 테스트 호환성 결함과 대화면 핵심 기능 위험이 있어 배포 안전을 확정할 수 없다.
8. 공식 참고 자료
- https://developer.android.com/about/versions/16/behavior-changes-16
- https://developer.android.com/about/versions/16/behavior-changes-all
- https://developer.android.com/develop/adaptive-apps/guides/app-orientation-aspect-ratio-resizability
- https://developer.android.com/build/releases/agp-8-13-0-release-notes
- https://robolectric.org/compatibility_table/
- https://developer.android.com/guide/practices/page-sizes
9. 후속 조치 검증: 세로 고정 유지 설정 — 2026-10-30
- 사용자 결정: 이번 범위에서 기존 세로 고정을 유지하며 AndroidManifest.xml 레거시 파일 직접 수정을 승인했다.
- 소유 Task: plan-task.md의
P1-R1/ Task R1.1. 요구사항은 prd.md의 SDK36-001~003이다. - 무엇을: application 직속
android.window.PROPERTY_COMPAT_ALLOW_RESTRICTED_RESIZABILITY=true를 추가했다. 라이브 Activity 및 BaseActivity는 변경하지 않았다. - 왜:
REV-P1-002의 대화면 기본 정책으로 인한 방향 제한 무시를 targetSdk 36 범위에서 opt-out한다. 모든 구성 변경에 대한 라이브 수명주기 문제를 해결하는 수정은 아니다. - 어떻게: 소스 XML assertion 변경 전 실패·변경 후 성공, 소스·병합 XML 검사 성공, Debug 빌드 성공(54초), aapt2로 최종 APK의 property=true와 targetSdkVersion=36 확인.
- 재검토: application 적용 범위·정확한 이름과 true 값·SDK와 portrait 요청 보존·제약 고지에 대해 작성자 자체 검토를 수행했다. 독립 리뷰 에이전트는 모델 계정 미지원으로 실행하지 못했다.
- 판정: 승인된 호환성 설정 적용과 패키징 검증 완료.
REV-P1-002의 실기기 재현 및 잔여 구성 변경 위험은 미검증으로 유지한다.REV-P1-001은 별도 미수정 항목이다. - 한계: targetSdk 37부터 opt-out 미지원. 데스크톱 창 모드·제조사·사용자 정책에 따라 방향 고정이 무시될 수 있다. 실기기 UI·방송·전체 테스트·린트는 이번 후속 변경에서 실행하지 않았다.
10. 후속 조치 검증: Robolectric 초기화 복구 — 2026-10-30
- 사용자 결정: REV-P1-001도 이번 작업에서 수정한다. 소유 Task는
P1-R2/ Task R1.2, 요구사항은 SDK36-004~006이다. - 수정:
app/src/test/resources/robolectric.properties에sdk=35를 지정했다. SDK를 생략한 테스트의 실행 플랫폼을 변경 전과 동일한 API35로 보존하고 명시된 @Config SDK는 유지한다. - RED: 기존 HomeMainFragmentSourceTest가
Package targetSdkVersion=36 > maxSdkVersion=35로 초기화 실패. 같은 실행의 SDK28 SharedPreferenceManagerTest는 2개 성공했다. - GREEN: 동일 focused 실행에서 홈 테스트 5개·SharedPreferenceManagerTest 2개 성공했다. 기존 테스트 파일·assertion·skip 설정 변경 없음.
- 통합 회귀:
./gradlew :app:testDebugUnitTest :app:assembleDebug --continue --console=plain성공(5분 56초). JUnit XML 집계 224 suite, 1,815 tests, failures=0, errors=0, skipped=0. - 증거:
app/build/reports/tests/testDebugUnitTest/index.html,app/build/test-results/testDebugUnitTest/TEST-*.xml, 처리된 테스트 resourceapp/build/intermediates/java_res/debugUnitTest/processDebugUnitTestJavaRes/out/robolectric.properties. - 앱 설정 보존: aapt2로 Debug APK의 targetSdkVersion=36과 application 호환성 opt-out=true 유지 확인. 앱 의존성·JVM17·기존 세로 고정 코드는 변경하지 않았다.
- 판정: REV-P1-001 수정 완료. 기존 SDK별 로컬 회귀 실행을 복구했으며 Android16(API36) 런타임 테스트 지원을 추가한 것은 아니다.
- 미실행: 실기기·에뮬레이터 UI, Release variant 테스트, 전체 lint. LSP 도구는 제공되지 않아 실제 Gradle의 설정 로딩·resource 처리·테스트·빌드 및 diff 검사로 확인했다.
- 독립 최종 gate 판정: APPROVED, 차단 사항 없음. reviewer가 실제 설정 파일·기존 테스트·RED/GREEN 로그·전체 JUnit XML과 HTML 요약을 대조해 S1~S3 충족 및 테스트 완화 없음 확인. 최종 APK는 부모 실행의 aapt2 증거를 채택했다.