# 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 테스트와 린트는 이번 커밋 검증에서 실행하지 않았다.