From 941dcc6fb41bf72f74f01cbdcf50a7aedaa9d34c Mon Sep 17 00:00:00 2001 From: klaus Date: Fri, 30 Oct 2026 20:44:41 +0900 Subject: [PATCH] =?UTF-8?q?docs(sdk36):=20=ED=98=B8=ED=99=98=EC=84=B1=20?= =?UTF-8?q?=EC=A0=90=EA=B2=80=EA=B3=BC=20=ED=9B=84=EC=86=8D=20=EA=B2=80?= =?UTF-8?q?=EC=A6=9D=20=EA=B2=B0=EA=B3=BC=EB=A5=BC=20=EA=B8=B0=EB=A1=9D?= =?UTF-8?q?=ED=95=9C=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/20261030_SDK_36_호환성_점검/plan-task.md | 136 ++++++++++++++++++ docs/20261030_SDK_36_호환성_점검/prd.md | 63 ++++++++ .../phase1-sdk36-compatibility-review.md | 123 ++++++++++++++++ 3 files changed, 322 insertions(+) create mode 100644 docs/20261030_SDK_36_호환성_점검/plan-task.md create mode 100644 docs/20261030_SDK_36_호환성_점검/prd.md create mode 100644 docs/20261030_SDK_36_호환성_점검/reviews/phase1-sdk36-compatibility-review.md diff --git a/docs/20261030_SDK_36_호환성_점검/plan-task.md b/docs/20261030_SDK_36_호환성_점검/plan-task.md new file mode 100644 index 00000000..5767dc08 --- /dev/null +++ b/docs/20261030_SDK_36_호환성_점검/plan-task.md @@ -0,0 +1,136 @@ +# SDK 36 세로 고정 유지 구현 계획 + +| 항목 | 내용 | +|---|---| +| 상태 | R1.1·R1.2 구현 완료 | +| 작성일 | 2026-10-30 | +| 요구사항 | [prd.md](prd.md), SDK36-001~006 | +| 현재 Phase | Phase 1 / 대화면 제한 호환성 설정 | + +## 목표·범위 + +기존 portrait 요청은 유지하고 application 직속 opt-out property만 추가한다. 수정 대상은 `app/src/main/AndroidManifest.xml`이다. 검토 기준은 `REV-P1-002`이며, 라이브 수명주기 자체와 별도 문제인 `REV-P1-001`은 수정하지 않는다. + +## 기술적 제약·실행 결정 + +- 단일 파일의 선언적 설정 변경이며 기존 작업 트리에서 순차 실행한다. 구현 에이전트 병렬 실행·새 worktree·커밋은 하지 않는다. +- 저장소 지정 PRD·계획을 실행 기록으로 사용하며 별도 ledger 사본은 만들지 않는다. +- 사용자 승인 범위는 AndroidManifest.xml 수정이며 BaseActivity·Activity별 방향 설정·SDK 값·의존성 변경은 금지한다. +- 신규 로직·레이아웃 변경이 없어 테스트 소스는 추가하지 않는다. 구성 계약은 동일 XML assertion의 RED→GREEN 및 실제 병합 결과로 검증한다. + +## Phase 1 + +**결과:** targetSdk 36 앱 전체에 대화면 제한 호환성 opt-out이 패키징된다. + +#### Task R1.1 기존 세로 고정 유지 설정 적용 + +**Goal `P1-R1`:** REV-P1-002의 기본 대화면 방향 제한 해제를 이번 범위에서 opt-out한다. + +- 시작 조건: SDK36-001~003 확정 및 사용자 레거시 파일 수정 승인. +- 대상: `app/src/main/AndroidManifest.xml`. +- 인터페이스: application 직속 `property`, name=`android.window.PROPERTY_COMPAT_ALLOW_RESTRICTED_RESIZABILITY`, value=`true`. +- 회귀 검증: XML 문법, property 개수·값·적용 범위, Debug 병합 Manifest, `assembleDebug`, 기존 portrait 요청과 SDK 36 보존. +- 완료 증거: 아래 체크박스와 검증 기록. 실제 기기에서 모든 회전을 차단했다고 주장하지 않는다. +- 범위 밖: 라이브 종료 처리 수정, SDK37 대응, Robolectric 호환성 수정. + +- [x] **RED:** application 직속의 지정 property가 true 값으로 정확히 한 개 있어야 한다는 xmllint XPath assertion을 정의한다. +- [x] **RED 확인:** 변경 전 assertion의 exit 1을 확인한다. +- [x] **GREEN:** AndroidManifest.xml에 지정 property 한 개만 추가한다. +- [x] **GREEN 확인:** 동일 assertion 및 XML 문법 검사를 통과한다. +- [x] **REFACTOR:** 불필요한 변경 없이 `assembleDebug`, 병합 Manifest 확인, diff 검사를 수행하고 결과를 기록한다. + +### Task R1.1 검증 기록 + +- 무엇을: application 직속 opt-out property 한 개만 추가했다. BaseActivity와 기존 SDK 36 설정은 유지했다. +- 왜: 사용자 승인에 따라 이번 범위에서 기존 세로 고정을 유지하기 위해 Android 16의 대화면 기본 정책을 opt-out한다. +- 어떻게: 소스 XML assertion은 변경 전 실패·변경 후 성공. xmllint 문법 검사와 Debug 병합 Manifest의 동일 assertion 성공. `assembleDebug tasks --all`은 54초에 BUILD SUCCESSFUL. +- 완료 범위: 선언·병합·패키징 검증 완료. 실제 기기 방향 고정 검증과 라이브 수명주기 수정은 포함하지 않는다. + +### 검증 명령 + +```bash +test "$(xmllint --xpath "count(/manifest/application/property[@*[local-name()='name']='android.window.PROPERTY_COMPAT_ALLOW_RESTRICTED_RESIZABILITY'][@*[local-name()='value']='true'])" app/src/main/AndroidManifest.xml)" = 1 +xmllint --noout app/src/main/AndroidManifest.xml +./gradlew :app:assembleDebug tasks --all --console=plain +``` + +병합 Manifest의 `app/build/intermediates/merged_manifests/debug/processDebugManifest/AndroidManifest.xml`에도 동일 XPath assertion을 적용한다. 실제 생성 위치가 다르면 Gradle 산출물에서 확인한 경로를 사용해 기록한다. + +#### Task R1.2 Robolectric 실행 SDK 복구 + +**Goal `P1-R2`:** REV-P1-001의 초기화 실패를 해결하면서 기존 SDK별 테스트 동작을 보존한다. + +- 시작 조건: 사용자 Robolectric 수정 요청, SDK36-004~006, 기존 실패 재현. +- 대상 파일: 신규 `app/src/test/resources/robolectric.properties`, 기존 PRD·계획·리뷰 기록. +- 수정 범위: 기본 `sdk=35` 지정. 명시 `@Config(sdk=[28])`는 그대로 우선한다. 앱 targetSdk36, 의존성, JVM17은 변경하지 않는다. +- 회귀 테스트: HomeMainFragmentSourceTest(SDK 생략), SharedPreferenceManagerTest(SDK28), 전체 `:app:testDebugUnitTest`. +- 완료 증거: RED 원인 확인 → 동일 focused GREEN → 전체 회귀·Debug 빌드 → 독립 검토와 기록. 무관한 기존 실패는 재현 근거와 함께 별도 기록한다. +- 범위 밖: Android16 로컬 런타임 지원 확대, 기존 unrelated 실패 수정, 앱 코드·세로 고정 설정 수정. + +- [x] **RED:** 기존 SDK 미지정 테스트를 회귀 테스트로 사용한다. 새 테스트 없이도 설정 제거 시 동일 실패를 포착한다. +- [x] **RED 확인:** `./gradlew :app:testDebugUnitTest --tests '*HomeMainFragmentSourceTest' --tests '*SharedPreferenceManagerTest' --console=plain`에서 홈 initializationError 1개와 SDK28 테스트 2개 성공 확인. +- [x] **GREEN:** 공통 테스트 resource의 `sdk=35`만 지정한다. +- [x] **GREEN 확인:** 같은 focused 테스트가 모든 assertion을 실행하고 통과하는지 확인한다. +- [x] **REFACTOR:** 불필요한 변경 없이 전체 Debug local suite·Debug APK·설정 보존을 확인하고 기록한다. +- [x] 독립 검토, 소유 임시 폴더 정리와 최종 결과 기록. + +#### 시나리오와 종료 조건 + +1. S1: 기본 SDK 테스트 초기화 오류 0, HomeMainFragmentSourceTest 모두 성공. 실제 Gradle 테스트 및 XML로 확인. +2. S2: 명시 SDK28 테스트 성공·override 보존. 기존 SharedPreferenceManagerTest와 Robolectric 실행 로그로 확인. +3. S3: 전체 Debug local suite·Debug 빌드 성공, 앱 target36·세로 opt-out 보존. 기존 테스트를 삭제·완화하지 않는다. + +위 결과·검토·임시 자원 정리 증거가 확보되고 실제 초기화 문제가 해결되면 즉시 종료한다. 기존 무관한 실패는 수정 범위를 넓히지 않고 근거와 차단 상태를 보고한다. + +#### Task R1.2 초기 검증 기록 + +- 2026-10-30: 수정 전 focused 실행 42초, 3개 결과 중 초기화 오류 1개. `Package targetSdkVersion=36 > maxSdkVersion=35` 재현. SharedPreferenceManagerTest 2개는 성공. +- 공통 properties 파일·별도 SDK selection 설정은 발견되지 않았다. 공식 설정 문서에서 root properties보다 클래스·메서드 @Config가 우선함을 확인했다. +- 기존 R1.1에서 제외했던 테스트 SDK 수정·전체 local 회귀 실행을 사용자 요청에 따라 이번 R1.2에 한해 포함한다. 앞선 완료 기록을 되돌리지 않는다. +- 2026-10-30 GREEN: 동일 focused 실행 성공(3분 22초). HomeMainFragmentSourceTest 5개와 SharedPreferenceManagerTest 2개 모두 성공. SDK28 선언은 변경하지 않았다. +- 2026-10-30 회귀: `./gradlew :app:testDebugUnitTest :app:assembleDebug --continue --console=plain` 성공(5분 56초). JUnit XML 224개 suite, 1,815개 test, failures=0, errors=0, skipped=0. +- 실제 구성 반영: `app/build/intermediates/java_res/debugUnitTest/processDebugUnitTestJavaRes/out/robolectric.properties`에 `sdk=35` 존재. 최종 APK aapt2에서 targetSdkVersion=36 및 portrait 호환성 property=true 유지 확인. +- 새 테스트를 추가하지 않은 이유: 기존 SDK 미지정 테스트가 설정 부재를 직접 재현하며, 기존 SDK 명시 테스트가 override 회귀를 검증한다. 테스트 본문·assertion·skip 설정은 전혀 변경하지 않았다. + +## Progress + +- 2026-10-30: 사용자 승인과 기존 코드 확인 후 PRD·계획 작성. 구현 전 property assertion 실행 예정. +- 2026-10-30: 변경 전 property 개수 0과 assertion의 `FAIL: application-level opt-out is missing (expected before change)`를 확인한 뒤 property를 추가했다. +- 2026-10-30: `P1-R1` 완료. 소스·병합 Manifest·최종 APK에서 application property=true를 확인했다. + +## Decision Log + +- 2026-10-30: 사용자 승인을 받은 application-level opt-out만 적용한다. 단일 구성 변경이므로 새 로직 unit test 대신 선언·병합 계약의 assertion으로 검증한다. + +## Verification Log + +실행 후 실제 결과를 누적한다. 앞선 리뷰의 Robolectric 실패와 린트 차단은 이번 수정의 성공 증거로 대체하지 않는다. + +### 2026-10-30 최종 확인 + +- `./gradlew :app:assembleDebug tasks --all --console=plain`: 성공, BUILD SUCCESSFUL in 54s. +- `xmllint --noout` 및 계획의 XPath assertion: 소스·`app/build/intermediates/merged_manifests/debug/processDebugManifest/AndroidManifest.xml` 모두 성공. +- Build Tools 36.0.0 `aapt2 dump xmltree app/build/outputs/apk/debug/app-debug.apk --file AndroidManifest.xml`: targetSdkVersion=36 및 application의 opt-out value=true 확인. +- `git diff --check`: 성공. 앱 코드 변경은 Manifest property 추가뿐이다. +- 독립 리뷰 에이전트는 제공 모델 `gpt-5.5`의 계정 미지원 오류로 실행 불가했다. 작성자가 적용 범위·property 이름·값·기존 설정 보존·제약 설명을 별도로 재검토했다. 독립 리뷰 성공으로 기록하지 않는다. +- XML/Markdown용 LSP 진단 도구는 세션에 제공되지 않았다. XML 문법 검사와 Android Manifest 병합·APK 빌드로 대체 검증했다. +- 실기기·계측 테스트, 전체 단위 테스트 및 린트는 재실행하지 않았다. 이번 변경과 별개인 기존 Robolectric 초기화 실패는 미수정 상태다. + +### 2026-10-30 Robolectric 후속 최종 확인 + +- `P1-R2`: REV-P1-001 초기화 실패 수정 완료. focused 7개, 전체 Debug 로컬 테스트 1,815개 성공(224 suite, 실패·오류·skip 0). +- `./gradlew :app:testDebugUnitTest :app:assembleDebug --continue --console=plain`: BUILD SUCCESSFUL in 5m 56s. +- 테스트 resource 출력에 sdk=35가 반영됨을 확인했고, 최종 APK는 targetSdkVersion=36과 portrait opt-out=true를 유지한다. +- `./gradlew tasks --all --console=plain`: 성공(2초), 문서의 테스트·빌드 Task 유효성 확인. +- 독립 gate reviewer: APPROVED, 차단 사항 없음. 기존 SDK 미지정 테스트 실행 복구, 명시 SDK28 override 보존, 전체 suite·빌드 및 범위 준수를 확인했다. +- 결과 보존: `app/build/reports/tests/testDebugUnitTest/index.html` 및 JUnit XML. 임시 실행 로그의 핵심 RED/GREEN 결과는 Task R1.2 검증 기록에 누적했다. +- 설정·문서 변경뿐이며 LSP 진단 도구는 제공되지 않았다. 실제 Gradle 설정 로딩, 테스트 resource 처리, 전체 테스트·빌드 및 diff 검사로 대체 검증했다. +- 앞선 R1.1 기록의 Robolectric 미수정 상태는 이 후속 기록으로 해소됐다. API36 런타임·실기기 UI·Release 테스트·전체 lint는 이번 후속 범위에서 실행하지 않았다. +- 정리 확인: 소유 실행 루트 `sdk36-robolectric.HEmOxH`의 열린 파일 없음 확인 후 임시 로그·notepad 삭제 및 빈 디렉터리 제거. `test ! -e` 성공과 `CLEANUP PASS` 확인. 공용 캐시·다른 작업의 프로세스는 변경하지 않았다. + +### 2026-10-30 커밋 전 재검증 + +- `./gradlew :app:testDebugUnitTest :app:assembleDebug --continue --console=plain`: BUILD SUCCESSFUL in 2m 23s. 로컬 테스트와 Debug APK 빌드 성공. +- `git diff --check`, 소스 Manifest의 `xmllint --noout` 및 application 직속 호환성 property의 개수·값 XPath assertion: 모두 성공. +- 사용자 커밋 요청에 따라 SDK 36·versionCode 263 및 호환성 설정, Robolectric 기본 SDK 설정, 작업 문서를 나누어 기록한다. +- 실기기·계측 테스트, Release 테스트와 린트는 이번 커밋 검증에서 실행하지 않았다. diff --git a/docs/20261030_SDK_36_호환성_점검/prd.md b/docs/20261030_SDK_36_호환성_점검/prd.md new file mode 100644 index 00000000..93613fa5 --- /dev/null +++ b/docs/20261030_SDK_36_호환성_점검/prd.md @@ -0,0 +1,63 @@ +# SDK 36 세로 고정 유지 PRD + +## 문서 정보 + +| 항목 | 내용 | +|---|---| +| 상태 | 세로 고정·Robolectric 후속 수정 완료 | +| 작성일 | 2026-10-30 | +| 대상 | SodaLive Android, compileSdk·targetSdk 36 | +| 결정권자 | 사용자 | +| 구현 계획 | [plan-task.md](plan-task.md) | +| 관련 리뷰 | [SDK 36 호환성 점검](reviews/phase1-sdk36-compatibility-review.md) | + +## 1. 목표와 배경 + +이번 범위에서는 기존 세로 고정을 유지한다. Android 16의 대화면 방향 제한 무시 정책에는 앱 전체 opt-out을 적용해 기존 portrait 요청이 유지되는 호환성 모드를 사용한다. + +## 2. 확정 요구사항 + +| ID | 요구사항 | 수용 기준 | +|---|---|---| +| SDK36-001 | 앱 전체에 대화면 제한 호환성 opt-out 적용 | application 직속 property `android.window.PROPERTY_COMPAT_ALLOW_RESTRICTED_RESIZABILITY=true`가 소스·Debug 병합 Manifest에 각각 한 개 존재 | +| SDK36-002 | 기존 세로 고정 및 SDK 36 설정 유지 | BaseActivity의 portrait 요청과 사용자가 수정한 compileSdk·targetSdk 36을 변경하지 않음 | +| SDK36-003 | 승인된 레거시 파일만 최소 수정 | 제품 코드 변경은 AndroidManifest.xml의 property 추가에 한정, Debug APK 빌드 성공 | + +## 3. 범위 밖 + +- Robolectric 버전·테스트 SDK 수정, 라이브 수명주기 리팩터링, 반응형 UI 전환. +- 모든 Activity에 새 portrait 선언 추가 또는 외부 SDK 화면의 기존 방향 정책 변경. +- 기기·에뮬레이터 UI 조작, 실제 방송, 전체 테스트·장시간 린트 재실행, 커밋·게시. + +## 4. 제약과 검증 + +- opt-out은 방향 요청 자체를 생성하지 않는다. 기존 portrait 요청을 유지하는 플랫폼 호환성 설정이다. +- targetSdk 37부터 opt-out은 적용되지 않는다. 데스크톱 창 모드·제조사·사용자 설정 등에 따라 고정이 무시될 수 있다. +- 회전 외의 구성 변경으로 인한 Activity 재생성을 모두 방지하거나 기존 라이브 종료 로직을 수정하는 작업이 아니다. +- XML assertion의 변경 전 실패·변경 후 성공, Debug 병합 Manifest 및 APK 빌드로 설정 반영을 검증한다. 실제 기기 고정 동작 검증과 구분한다. + +## 5. Decision Log + +| 날짜 | ID | 결정 | 근거 | +|---|---|---|---| +| 2026-10-30 | DEC-001 | 이번 범위는 반응형 전환 대신 기존 세로 고정 유지 | 사용자 요구 | +| 2026-10-30 | DEC-002 | AndroidManifest.xml application에 공식 opt-out 추가 | 제안한 최소 변경과 레거시 파일 수정에 대한 사용자 승인 | +| 2026-10-30 | DEC-003 | 기존 작업 폴더에서 후속 구현 기록 | 저장소 연속 작업 문서 규칙 | + +공식 근거: https://developer.android.com/about/versions/16/behavior-changes-16#adaptive-layouts + +## 6. 후속 범위 확정: Robolectric 실행 복구 + +2026-10-30 사용자 요청으로 기존 §3의 테스트 SDK 수정·전체 테스트 재실행 제외를 이번 후속 작업에서 해제한다. 앞선 세로 고정 완료 기록은 유지한다. + +| ID | 요구사항 | 수용 기준 | +|---|---|---| +| SDK36-004 | SDK 미지정 테스트의 실행 기본값을 기존 API 35로 보존 | Robolectric4.15.1·JVM17에서 HomeMainFragmentSourceTest가 초기화 오류 없이 통과 | +| SDK36-005 | 개별 테스트 SDK override 보존 | 명시 SDK28 SharedPreferenceManagerTest 등 기존 테스트가 그대로 통과 | +| SDK36-006 | 앱 설정과 테스트 의미 유지 | 앱 targetSdk36·portrait opt-out·기존 assertion 유지, 테스트 삭제·skip·완화 금지 | + +- 구현 범위: `app/src/test/resources/robolectric.properties`의 공통 테스트 SDK 지정. 앱 의존성·JVM 업그레이드는 불필요하므로 제외한다. +- 검증: 기존 실패 테스트를 RED로 재현한 뒤 focused·전체 Debug local unit test와 APK 빌드를 확인한다. 실제 Android16 실행 검증을 대체하지 않는다. +- 실패 분리: 전체 실행 중 원래 실패가 발견되면 기존 SDK 설정으로 재현해 이번 변경과의 인과관계를 구분한다. 무관한 제품 로직·테스트 수정은 하지 않는다. +- DEC-004 (2026-10-30, 확정): 사용자 요청에 따라 REV-P1-001도 이번 스코프에서 수정. 실행 기본 API35 보존은 기존 회귀 테스트 환경 유지이며, Android16 테스트 지원 확장과는 별도다. +- 공식 근거: https://robolectric.org/configuring/ , https://robolectric.org/compatibility_table/ diff --git a/docs/20261030_SDK_36_호환성_점검/reviews/phase1-sdk36-compatibility-review.md b/docs/20261030_SDK_36_호환성_점검/reviews/phase1-sdk36-compatibility-review.md new file mode 100644 index 00000000..2c898704 --- /dev/null +++ b/docs/20261030_SDK_36_호환성_점검/reviews/phase1-sdk36-compatibility-review.md @@ -0,0 +1,123 @@ +# 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](../plan-task.md)의 `P1-R1` / Task R1.1. 요구사항은 [prd.md](../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`, 처리된 테스트 resource `app/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 증거를 채택했다.