fix: 안드로이드 스플래시 로고 저해상도 노출 수정 (RN 오버레이 전환)

[ychany]

작업 내용

안드로이드에서 스플래시 로고 모서리가 각지고 뭉개져 보이는 문제를 수정했어요.

원인

• 이미지 파일은 정상 (APK 내 밀도별 PNG 전부 라운딩 온전 — 픽셀 분석 확인)
• Android 12+ 시스템 스플래시가 로고를 저해상도 아이콘으로 래스터 후 확대하면서 곡선이 깨짐
• 우리 앱은 preventAutoHideAsync 로 이 시스템 스플래시를 웹뷰 로드 완료까지 유지해서 저품질 로고가 수 초 노출됨 (iOS 는 스토리보드 방식이라 정상)

수정

1. SplashOverlay 신설 — 스플래시와 동일한 화면(배경 + 로고 200dp)을 RN 이 고해상도로 렌더
2. 시스템 스플래시 조기 숨김 — 첫 렌더 직후 hideAsync(), 이후 RN 오버레이가 웹뷰 첫 로드 완료(또는 실패·15초 타임아웃)까지 표시
3. 안드로이드 시스템 스플래시 로고 제거 — 저품질로 나올 수밖에 없는 부팅 첫 ~1초는 배경색만 표시 (android.image = 투명 PNG, iOS 는 기존 유지)

결과

iOS:      [로고(스토리보드)] → [로고(RN)] → 웹   ← 화면상 변화 없음
Android:  [파란 배경 ~1초]   → [로고(RN)] → 웹   ← 각진 로고 완전 제거

• 스플래시 총 노출 시간·종료 조건은 기존과 동일

검증

• 안드로이드 에뮬레이터: 첫 ~1초 배경색만 → 선명한 로고 → 웹 진입 (프레임 캡처 확인)
• 로고 곡률 픽셀 측정 — 수정 후 화면 렌더가 원본 PNG 와 일치
• iOS 시뮬레이터: 콜드 스타트 스플래시 끊김 없는지 (expo → RN 전환 티 안 나는지)
• 웹뷰 로드 실패 시 15초 타임아웃 해제 동작 (기존 유지)

안드로이드

연관 이슈

closes #351

Summary by CodeRabbit

• 새로운 기능

  • Android 전용 스플래시 설정을 추가했습니다(빈 이미지, 크기, 배경 및 다크 배경).
  • 고정 배경과 로고를 중앙에 표시하는 스플래시 오버레이 컴포넌트를 도입했습니다.

• 개선 사항

  • 네이티브 스플래시 종료 시점을 렌더 커밋 직후로 조정해 전환이 더 매끄럽게 개선됐습니다.
  • 웹 콘텐츠 준비 전에는 오버레이를 유지하고, 로드 완료/실패 또는 타임아웃에 맞춰 오버레이를 해제합니다.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
piki	Ready	Preview, Comment	Jul 17, 2026 11:59am

[github-actions]

Discord 스레드 연동용 메타데이터입니다. discord-pr-bot 워크플로가 자동 생성하며, 수정·삭제하면 PR 과 Discord 알림 연동이 끊깁니다.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 95da9fe2-16c1-4a77-b5f9-34e7a0ab869b

📥 Commits

Reviewing files that changed from the base of the PR and between 3308bce and a553ad9.

📒 Files selected for processing (1)

• apps/app/hooks/useSplashScreenController.tsx

---

📝 Walkthrough

Walkthrough

Android 시스템 스플래시의 로고를 빈 이미지로 대체하고 RN 오버레이에서 고해상도 로고를 표시하도록 변경했습니다. 시스템 스플래시는 첫 렌더 직후 숨기며, 웹뷰 로드 완료·실패·타임아웃 시 RN 오버레이를 종료합니다.

Changes

스플래시 렌더링 흐름

Layer / File(s)	Summary
Android 설정 및 RN 오버레이 apps/app/app.json, apps/app/components/SplashOverlay.tsx	Android 스플래시에 빈 이미지와 배경색을 지정하고, RN 오버레이에서 배경과 splash-icon.png를 중앙에 표시합니다.
스플래시 생명주기 연결 apps/app/hooks/useSplashScreenController.tsx, apps/app/app/index.tsx	첫 렌더 직후 네이티브 스플래시를 숨기고, 웹뷰 이벤트 또는 타임아웃에 따라 RN 오버레이를 조건부로 종료합니다.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Sequence Diagram(s)

sequenceDiagram
  participant App
  participant SplashScreenControllerProvider
  participant SystemSplash
  participant SplashOverlay
  participant WebView
  App->>SplashScreenControllerProvider: 첫 렌더 커밋
  SplashScreenControllerProvider->>SystemSplash: hideAsync()
  App->>SplashOverlay: 오버레이 표시
  WebView-->>App: 로드 완료·실패 또는 타임아웃
  App->>SplashScreenControllerProvider: hideSplashOverlay()
  SplashScreenControllerProvider-->>SplashOverlay: 표시 중지

Loading

Suggested reviewers: soyeong0115, kanghaeun

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	제목이 안드로이드 스플래시 저해상도 문제를 RN 오버레이로 수정한다는 핵심 변경을 잘 요약합니다.
Linked Issues check	✅ Passed	변경 사항이 RN SplashOverlay 추가, 시스템 스플래시 조기 숨김, 투명 Android 스플래시 이미지 적용 등 #351 요구사항과 일치합니다.
Out of Scope Changes check	✅ Passed	요구사항과 무관한 변경은 보이지 않으며, 모두 스플래시 전환과 Android 표시 품질 개선 범위 안입니다.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch fix/351-splash-android-quality

Warning

There were issues while running some tools. Please review the errors and either fix the tool's configuration or disable the tool if it's a critical failure.

🔧 ESLint

If the error stems from missing dependencies, add them to the package.json file. For unrecoverable errors (e.g., due to private dependencies), disable the tool in the CodeRabbit configuration.

ESLint install timed out. The project may have too many dependencies for the sandbox.

---

_{Comment @coderabbitai help to get the list of available commands.}

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@apps/app/hooks/useSplashScreenController.tsx`:
- Around line 40-42: In the useEffect callback within useSplashScreenController,
handle rejected promises from SplashScreen.hideAsync by attaching a catch
handler while preserving the existing fire-and-forget behavior and empty
dependency array.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 21eeb18b-39ab-4f41-b047-343f78a8c096

📥 Commits

Reviewing files that changed from the base of the PR and between cf6718d and b6cd661.

⛔ Files ignored due to path filters (1)

• apps/app/assets/images/splash-android-blank.png is excluded by !**/*.png

📒 Files selected for processing (4)

• apps/app/app.json
• apps/app/app/index.tsx
• apps/app/components/SplashOverlay.tsx
• apps/app/hooks/useSplashScreenController.tsx