12 KiB
SDK 36 세로 고정 유지 구현 계획
| 항목 | 내용 |
|---|---|
| 상태 | R1.1·R1.2 구현 완료 |
| 작성일 | 2026-10-30 |
| 요구사항 | 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 호환성 수정.
-
RED: application 직속의 지정 property가 true 값으로 정확히 한 개 있어야 한다는 xmllint XPath assertion을 정의한다.
-
RED 확인: 변경 전 assertion의 exit 1을 확인한다.
-
GREEN: AndroidManifest.xml에 지정 property 한 개만 추가한다.
-
GREEN 확인: 동일 assertion 및 XML 문법 검사를 통과한다.
-
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. - 완료 범위: 선언·병합·패키징 검증 완료. 실제 기기 방향 고정 검증과 라이브 수명주기 수정은 포함하지 않는다.
검증 명령
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 실패 수정, 앱 코드·세로 고정 설정 수정.
-
RED: 기존 SDK 미지정 테스트를 회귀 테스트로 사용한다. 새 테스트 없이도 설정 제거 시 동일 실패를 포착한다.
-
RED 확인:
./gradlew :app:testDebugUnitTest --tests '*HomeMainFragmentSourceTest' --tests '*SharedPreferenceManagerTest' --console=plain에서 홈 initializationError 1개와 SDK28 테스트 2개 성공 확인. -
GREEN: 공통 테스트 resource의
sdk=35만 지정한다. -
GREEN 확인: 같은 focused 테스트가 모든 assertion을 실행하고 통과하는지 확인한다.
-
REFACTOR: 불필요한 변경 없이 전체 Debug local suite·Debug APK·설정 보존을 확인하고 기록한다.
-
독립 검토, 소유 임시 폴더 정리와 최종 결과 기록.
시나리오와 종료 조건
- S1: 기본 SDK 테스트 초기화 오류 0, HomeMainFragmentSourceTest 모두 성공. 실제 Gradle 테스트 및 XML로 확인.
- S2: 명시 SDK28 테스트 성공·override 보존. 기존 SharedPreferenceManagerTest와 Robolectric 실행 로그로 확인.
- 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 테스트와 린트는 이번 커밋 검증에서 실행하지 않았다.