프로젝트

일반

사용자정보

Actions
Copy link

개선사항 #62

완료됨
백대 백대

[DEF-iOS-TGFU-002] 앱 실행 시 스플래시 화면 하단 UI 짤리는 현상

개선사항 #62: [DEF-iOS-TGFU-002] 앱 실행 시 스플래시 화면 하단 UI 짤리는 현상

백대선이(가) 21일 전에 추가함. 20일 전에 수정됨.

상태:
개발서버
우선순위:
보통
담당자:
백대선
시작일:
2026/05/06
완료일:
진척도:

100%

추정시간:

설명

결함 ID: DEF-iOS-TGFU-002
환경: iPhone Air
화면: 앱 실행 > 스플래시
원본 등록일: 2026-05-01 (QA: 품생품사)
QA 우선순위: Major

시나리오

  1. 앱을 실행한다.
  2. 스플래시 화면을 확인한다.

실제 결과

하단 UI가 흰색으로 표시됩니다.

기대 결과

전체 영역으로 표시되어야 합니다.

비고

  • iPhone Air Safe Area 미적용 의심

백대 백대선이(가) 20일 전에 변경 Actions
Copy link
 #1

분석 결과 — 디자인 자산 검토 필요 (코드 수정만으로 해결 어려움)

코드 현황:

  • lib/screens/start-up/splash.dart 의 Flutter splash 는 SizedBox.expand + Image.asset(splash.png, fit: BoxFit.cover) 로 fullscreen 처리되어 있어 코드상 흰색 잘림 발생할 구조 아님
  • 그러나 iOS native LaunchScreen.storyboard 가 LaunchBackground + LaunchImage (168x185 fixed size, contentMode=center) 를 사용
  • iPhone Air 처럼 새 화면 비율에서 LaunchBackground 이미지가 화면 비율과 안 맞으면 하단에 흰색 영역 노출

추정 원인:

  1. ios/Runner/Assets.xcassets/LaunchBackground.imageset/ 의 이미지가 iPhone Air 19.5:9 비율 미대응
  2. 또는 assets/splash.png 자체 비율이 16:9 등 옛 비율
  3. flutter_native_splash 설정 (pubspec.yaml flutter_native_splash: ^2.3.10) 에서 device-specific 자산 누락

권장 작업:

  1. flutter_native_splash 설정에 iOS background 색상 명시 (흰색이 아닌 splash 디자인 색으로)
  2. LaunchBackground.imageset 에 iPhone Air 비율 자산 추가 또는 contentMode=scaleAspectFill 변경
  3. 디자인팀과 협업하여 iPhone Air (1320x2868 추정) 비율 splash 자산 준비

현재 status: 보고 유지 (디자인 자산 + 빌드 설정 협업 필요)

백대 백대선이(가) 20일 전에 변경 Actions
Copy link
 #2

  • 상태을(를) 보고에서 개발서버(으)로 변경되었습니다.
  • 진척도을(를) 0에서 100(으)로 변경되었습니다.

근본 원인 식별 + 코드 수정 완료. 개발서버에 반영합니다.

추가 분석 결과:

  • 어제 분석 ("디자인 자산 비율 미대응") 은 부분적으로만 맞고 진짜 원인은 따로 있었음
  • lib/main.dart:200-202 의 SafeArea(bottom: true) 가 GetMaterialApp 전체 (splash 포함) 의 하단 영역을 홈인디케이터 만큼 잘라냄
  • 잘린 영역에 부모 Container 의 backgroundGradient (라이트모드 흰색) 가 노출
  • splash.dart 가 BoxFit.cover 로 splash.png 를 화면 가득 채워도, GetMaterialApp 자체가 홈인디케이터 만큼 작아져 그 영역에 흰색 띠 노출 → "하단 UI 흰색"

자산 분석:

  • background.png (1x1) → RGBA(255,255,255,255) 라이트 흰색
  • darkbackground.png (1x1) → RGBA(0,0,0,255) 다크 검정
  • splash.png 1568x2750, BoxFit.cover 로 정상 동작

수정 내역:

  • lib/main.dart:202 SafeArea(bottom: true) → bottom: false
  • GetMaterialApp 이 화면 끝까지 확장 → splash.png 가 홈인디케이터 영역 포함하여 화면 가득 채움
  • 일반 Scaffold 화면은 자체 padding/SafeArea 로 홈인디케이터 영역 처리 (대부분 영향 미미)

수정 파일:

  • lib/main.dart

QA 재검증 시나리오:

  1. iPhone Air 빌드 후 앱 실행
  2. 스플래시 화면 하단까지 splash.png 가 가득 채워지는지 확인 (흰색 띠 X)
  3. 홈 화면 진입 후 하단 콘텐츠 (예: 친구 요청 배너 / Safe Voice 즐겨찾기 등) 가 홈인디케이터 영역에 가려지지 않는지 확인
  4. 라이트모드 / 다크모드 모두 확인

부작용 모니터링 필요:

  • 일반 Scaffold 화면 하단 콘텐츠가 홈인디케이터에 가려지면 해당 화면에 SafeArea 또는 EdgeInsets.bottom 추가 필요
  • 현재 대부분 화면이 ScrollView + 자체 bottom padding 처리하므로 영향 미미할 것으로 예상
Actions
Copy link

내보내기 PDF Atom