64 lines
4.4 KiB
Markdown
64 lines
4.4 KiB
Markdown
# 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/
|