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.
115 lines
7.3 KiB
Markdown
115 lines
7.3 KiB
Markdown
# 태블릿(대화면) 레이아웃 실기 감사 — 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)**:
|
||
|
||
```bash
|
||
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 폭)가
|
||
적용되어 태블릿 판정에 쓸 수 있다.
|
||
|
||
```bash
|
||
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) — 클릭 타깃이 과대. | ⚠ |
|
||
|
||
공통 원인:
|
||
1. **화면 레벨 콘텐츠 최대 폭/그리드가 없다.** `useWindowDimensions`·breakpoint·`numColumns` 사용처가 0건.
|
||
(`maxWidth` 는 모달·입력 필드에만 존재.)
|
||
2. `supportsTablet: true` 는 iOS manifest 에만 있고 레이아웃 계획은 없다(`docs/v3/00-mobile-master-plan.md:688`).
|
||
3. 적응형 배너(`ANCHORED_ADAPTIVE_BANNER`, slot `minHeight: 50`)가 로드 후 728×90 → 468×60 으로 바뀌며
|
||
탭 바 높이가 변한다. 콘텐츠가 가려지진 않지만(끝까지 스크롤 확인) **초기 레이아웃 시프트**가 있다.
|
||
|
||
---
|
||
|
||
## 3. 개선 제안 (우선순위)
|
||
|
||
1. **공용 콘텐츠 컬럼**: `packages/ui-native` 에 `useContentWidth()`(예: `Math.min(windowWidth, 720)`)와
|
||
`ContentColumn` 을 추가하고 탭 화면 7곳에 적용. 가장 값싸고 회귀 위험이 낮다.
|
||
2. **2열 그리드**: `≥600dp` 에서 More/Meetings/Commands/Templates 를 `FlatList numColumns={2}` 로.
|
||
(More 는 섹션 헤더가 있어 섹션별 그리드 또는 `flexWrap` 카드.)
|
||
3. **버튼 폭 제한**: full-width 버튼은 `maxWidth: 320`(모바일 버튼 규격)로 제한.
|
||
4. **배너 시프트 제거**: slot 높이를 광고 실측 높이로 고정하거나, 로드 전 `minHeight` 를 90 으로 예약.
|
||
5. **실기기 회귀 방지**: Maestro 플로우에 `open`/`closed` 2회 실행을 추가하고, 대화면 스크린샷을 증거로 남긴다.
|
||
|
||
---
|
||
|
||
## 4. 재현/검증 명령 (수동)
|
||
|
||
```bash
|
||
# 대화면 시뮬레이션 후
|
||
"$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회)으로 둔다.
|