The tree carried uncommitted work from several areas (web push, mobile screens, admin charts, test-hygiene cleanup, CI and map docs). It is landed as one commit so the release pipeline can start from a clean tree; the desktop transcript-correction behaviour shipped in the previous commit and is unchanged here.
7.3 KiB
태블릿(대화면) 레이아웃 실기 감사 — 2026-11-05
질문: 타블렛에서 앱 레이아웃이 괜찮은가? 답: 기능은 동작하지만 대화면 대응이 없다. 모든 화면이 "넓어진 휴대폰" 한 열이다.
1. 접속 경로 (실제로 어떻게 붙었는지)
| 시도 | 결과 |
|---|---|
100.117.18.16:33455 (제시된 주소) |
ECONNREFUSED — Tailscale 로 호스트는 살아 있으나 해당 포트에 리스너가 없다. |
adb connect 100.117.18.16:33455 |
실패 (10061). 무선 디버깅 포트는 재시작마다 바뀐다. |
adb mdns services |
adb-R54Y9036G4A @ 192.168.0.17:36769 = tab-s11-ultra. 현재 포트는 36769. |
adb connect 100.117.18.16:36769 / 192.168.0.17:36769 |
실패 — 이 PC 와 페어링되어 있지 않다(무선 디버깅 페어링 코드 필요). |
adb pair 100.117.18.16:44865 113625 |
성공 → 이후 adb connect 100.117.18.16:40479 (port 는 페어링 직후 mDNS _adb-tls-connect 값). |
| 페어링된 실기기 | SM-X930 (Galaxy Tab S11 Ultra) — 1848×2960, density override 320 → 924dp, 기본 가로 모드. |
| 보조 기기 | SM-F956N (Galaxy Z Fold6) — device_state state 3 로 펼침(825dp) 재현에도 사용. |
실기기 재현 (Tab S11 Ultra):
ADB="$LOCALAPPDATA/Android/Sdk/platform-tools/adb.exe"
"$ADB" pair 100.117.18.16:44865 <6자리 페어링 코드>
"$ADB" mdns services # _adb-tls-connect 포트 확인 후
"$ADB" connect 100.117.18.16:40479
"$ADB" -s 100.117.18.16:40479 install -r apps/mobile-rn/android/app/build/outputs/apk/e2e/app-e2e.apk
"$ADB" -s 100.117.18.16:40479 shell am start -W -n com.d3ro.voice/.MainActivity
"$ADB" -s 100.117.18.16:40479 exec-out screencap -p > tab.png
재현 방법 (페어링 없이, 실기기 변경 최소): Fold6 은 device_state 오버라이드로 "펼친(OPENED)" 상태를
시뮬레이션할 수 있다. 실제 화면을 접었다 펴지 않아도 inner display 크기(1856×2160 @ density 360 ≈ 825dp 폭)가
적용되어 태블릿 판정에 쓸 수 있다.
ADB="$LOCALAPPDATA/Android/Sdk/platform-tools/adb.exe"
S="<adb serial>"
"$ADB" -s "$S" shell cmd device_state state 3 # OPENED (inner display)
"$ADB" -s "$S" shell am start -W -n com.d3ro.voice/.MainActivity
"$ADB" -s "$S" shell dumpsys SurfaceFlinger --display-id # 캡처할 display id 확인
"$ADB" -s "$S" exec-out screencap -p -d <displayId> > shot.png
"$ADB" -s "$S" shell cmd device_state state 0 # 원상복구 (CLOSED)
캡처는
test-results/tablet-2026-11-05/(gitignored, 커밋 안 됨). 스크린샷에 실제 기록 데이터가 찍혀 있어 개인정보 보호를 위해 저장소에 넣지 않는다.
측정 조건: 물리 1856×2160, density override 360 → 약 825dp 폭. Material large(≥600dp)·태블릿 판정 구간에 들어간다.
실기기(Tab S11 Ultra 924dp 가로) 결과 — Fold6 시뮬레이션과 동일한 결론이 더 뚜렷하게 재현됐다.
| 화면 | 실측 |
|---|---|
| 온보딩/튜토리얼 1/5 | 본문 텍스트 노드 폭 2880px(900dp) — 한 줄이 화면 전체를 가로지른다. 카드 2개도 full-width. |
| Login | Google 버튼·이메일·비밀번호·로그인 버튼 모두 2880px(900dp) 폭. 태블릿에서 폼 최대 폭(400~480dp) 부재. |
| Recorder | START RECORDING / IMPORT AUDIO FILE 버튼이 2880px(900dp) full-width. 오류 배너도 full-width. |
| Home (가로) | home-record-* 행이 40..2920px, See all 이 우측 끝(2824..2920). 한 행이 900dp. |
| Records (가로) | 동일. 배지(17 W)·Star/Delete 가 우측 끝, 제목/본문과 800dp 이상 떨어짐. |
| Meetings (가로) | 카드 full-width + 카드마다 큰 세로 여백. 목록 4번째 카드가 화면 아래로 잘림(스크롤 필요). |
| More (가로) | 라벨 ↔ chevron 사이 ≈800dp 공백. Voice actions 아래 항목은 광고 슬롯 뒤로 스크롤해야 보임. |
| 세로(portrait) | 폰과 같은 1열 구성. 924dp 폭이라 여전히 줄 길고 카드가 넓다. |
광고 슬롯 실측: free-tier-ad-slot = 0,1472 - 2960,1654 (전체 폭, 높이 182px ≈ 91dp), 탭 바는
1656..1752. 슬롯은 탭 바 위에 정상 배치되어 있고 콘텐츠는 그 위에서 끝난다(가림 아님).
다만 슬롯이 91dp 를 차지하므로 작은 화면에서 목록 가용 높이가 줄어든다.
성능 관찰: Records 탭 첫 진입이 실기기에서 5~10초 빈 스피너였다(이후 20건 표시). 레이아웃 문제는 아니지만 대화면에서 빈 화면이 크게 보이므로 체감이 나쁘다.
2. 판정 (스크린별, Fold6 825dp 시뮬레이션)
| 화면 | 관찰 | 판정 |
|---|---|---|
| Home | 한 열, 폭 전체 사용. 본문 줄 길이 과다(한글/영문 혼합 전사문 1줄 100자+). 광고 배너가 콘텐츠 하단 위로 자리 이동. | ⚠ 넓어진 휴대폰 |
| Records | 동일. 카드 우측 badge(17 W)·Star/Delete 가 화면 끝(≈800dp)에 몰려 시선 이동 거리 큼. | ⚠ |
| Meetings | 카드 full-width + 카드마다 불필요한 세로 여백. 2열 그리드 후보. | ⚠ |
| More | 9개 항목이 full-width, 라벨과 chevron 사이 ≈700dp 공백. 2열 그리드 후보. | ⚠ |
| Dictionary | 카드 1장이 폭 전체. Edit/Delete 버튼이 각각 화면 절반 폭(≈400dp) — 모바일 버튼 크기가 아님. | ⚠ |
| Commands | 4개 카드 세로 스택. "Activate" 버튼이 카드 좌측에 작게 붙어 균형 붕괴. | ⚠ |
| Templates | "Select" 버튼이 full-width(≈800dp) — 클릭 타깃이 과대. | ⚠ |
공통 원인:
- 화면 레벨 콘텐츠 최대 폭/그리드가 없다.
useWindowDimensions·breakpoint·numColumns사용처가 0건. (maxWidth는 모달·입력 필드에만 존재.) supportsTablet: true는 iOS manifest 에만 있고 레이아웃 계획은 없다(docs/v3/00-mobile-master-plan.md:688).- 적응형 배너(
ANCHORED_ADAPTIVE_BANNER, slotminHeight: 50)가 로드 후 728×90 → 468×60 으로 바뀌며 탭 바 높이가 변한다. 콘텐츠가 가려지진 않지만(끝까지 스크롤 확인) 초기 레이아웃 시프트가 있다.
3. 개선 제안 (우선순위)
- 공용 콘텐츠 컬럼:
packages/ui-native에useContentWidth()(예:Math.min(windowWidth, 720))와ContentColumn을 추가하고 탭 화면 7곳에 적용. 가장 값싸고 회귀 위험이 낮다. - 2열 그리드:
≥600dp에서 More/Meetings/Commands/Templates 를FlatList numColumns={2}로. (More 는 섹션 헤더가 있어 섹션별 그리드 또는flexWrap카드.) - 버튼 폭 제한: full-width 버튼은
maxWidth: 320(모바일 버튼 규격)로 제한. - 배너 시프트 제거: slot 높이를 광고 실측 높이로 고정하거나, 로드 전
minHeight를 90 으로 예약. - 실기기 회귀 방지: Maestro 플로우에
open/closed2회 실행을 추가하고, 대화면 스크린샷을 증거로 남긴다.
4. 재현/검증 명령 (수동)
# 대화면 시뮬레이션 후
"$ADB" -s "$S" shell cmd device_state state 3
"$ADB" -s "$S" shell cmd device_state state 0 # 반드시 원복
자동화로 만들 경우 device_state 오버라이드는 실기기 설정을 바꾸므로 CI 에 넣지 않고,
로컬 릴리스 전 점검(Maestro open/closed 2회)으로 둔다.