fix(platform): 루트 Scaffold 가 깐 내비 바 몫을 하위 화면이 또 더한다 — 3버튼 내비에서 하단 CTA 가 48dp 높이 뜬다 #1891

작업 유형

bug — 버그·오동작

주 담당 모듈

platform — Android 앱·CI·빌드·릴리스·저장소 운영

개요

루트 Scaffold 가 내비 바 몫을 깔아 두는데 소비로 잡히지 않아, 그 아래 화면들이 내비 바를 한 번 더 더한다. 3버튼 내비 기기에서 하단 버튼이 설계보다 48dp 높이 뜬다. 키보드와 무관하게, 앱을 켜자마자 그렇다.

원인

AppNavigation.kt:78-92 — 루트 Scaffold 가 contentWindowInsets = WindowInsets.systemBars.only(Horizontal + Bottom) 으로 내비 바를 innerPadding 에 넣고, NavHost(modifier = Modifier.padding(innerPadding)) 로 consumeWindowInsets 없이 전달한다. 그래서 하위 화면에서 WindowInsets.navigationBars 를 읽거나 navigationBarsPadding() 을 걸면 원본 값이 그대로 나와 두 번 더해진다.

겹치는 자리 두 곳을 확인했다.

statusBarsPadding() 은 무관하다 — 루트가 Top 은 깔지 않는다.

실측 (에뮬레이터 API 34 · 1080×2400@420 · 3버튼 내비)

키보드 없이 FindIdScreen 의 「다음」 버튼: 클릭 노드 bounds [53,1904][1027,2030] → 화면 바닥까지 370px = 141dp. 설계 97dp 와 44dp 차이(≈ 내비 바 한 겹 48dp − 4dp 상수). #1853 이 키보드가 뜬 동안의 같은 종류 이중 계산을 고쳤지만 키보드 없는 이 자리는 그 PR 범위 밖이라 그대로다.

어디서 고칠 것인가

두 갈래이고 정하고 시작해야 한다.

1. 루트에서 소비한다 — NavHost(modifier = Modifier.padding(innerPadding).consumeWindowInsets(innerPadding)). 그러면 하위의 navigationBarsPadding() 은 자동으로 0 이 된다(WelcomeScreen 해결). 단 FlowStepScaffold 처럼 asPaddingValues() 로 원본 값을 직접 읽는 자리는 소비를 모르므로 함께 고쳐야 한다. 전 화면에 영향이 가는 변경이라 각 모듈 담당이 자기 화면을 한 번씩 봐야 한다.
2. 자리마다 뺀다 — 루트를 두고 FlowStepScaffold 의 navBarHeight 항을 걷고, WelcomeScreen 의 navigationBarsPadding() 을 지운다. 국소적이지만 다음에 같은 실수가 다시 들어온다.

1 이 정본에 가깝다. 다만 FlowStepScaffold 의 원래 설계 문구 「제스처 바: 화면 하단으로부터 49dp / 구형 내비 바: 바로부터 49dp」는 루트가 내비 바를 깔지 않는다는 전제로 쓰인 것이라, 루트가 깔고 있는 지금은 제스처에서 49+24dp 가 된다. 시안이 원하는 게 어느 쪽인지 그 절에서 확정한다.

완료 조건

• 3버튼 내비에서 FlowStepScaffold CTA 가 내비 바 위 49dp, 제스처에서 시안이 정한 값에 온다 — 에뮬레이터 실측으로.
• WelcomeScreen 버튼 위치가 이중 패딩 없이 온다.
• 루트 아래에서 WindowInsets.navigationBars 원본을 직접 읽는 자리가 남지 않거나, 남는 이유가 적혀 있다.

자식 이슈

No response

참고

• 회원가입·인증 흐름에서 키보드가 하단 「다음」 버튼을 덮는다 — IME inset 미전달로 imePadding() 이 무효 #1849 · fix(core-ui,app): 인증 흐름에서 키보드가 하단 CTA 를 덮지 않게 IME inset 을 전달한다 (#1849) #1853 — 키보드가 뜬 동안의 같은 종류 이중 계산. 그 PR 은 ime.exclude(navigationBars) 로 키보드 쪽만 닫았다.
• 4dp 상수: 모든 측정에 「내비 바 − 11px」 로 똑같이 들어 있다. 루트가 깔아 주는 값이 원본 내비 바(126px)보다 11px 작다는 뜻인데 소재는 아직 안 찾았다 — 이 이슈에서 함께 본다.

화면 증거

같은 화면을 3버튼 내비와 제스처 내비에서 찍은 것이다. 하단 CTA 위치를 두 모드에서 비교할 수 있다.