Files
sodalive-android/docs/20261030_SDK_36_호환성_점검/prd.md
T

4.4 KiB

SDK 36 세로 고정 유지 PRD

문서 정보

항목 내용
상태 세로 고정·Robolectric 후속 수정 완료
작성일 2026-10-30
대상 SodaLive Android, compileSdk·targetSdk 36
결정권자 사용자
구현 계획 plan-task.md
관련 리뷰 SDK 36 호환성 점검

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/