<?xml version="1.0" encoding="utf-8"?>
<feed xmlns="http://www.w3.org/2005/Atom">
  <title>Twinkle Log</title>
  <link href="https://log.twinklelabs.kr/" rel="alternate"/>
  <link href="https://log.twinklelabs.kr/feeds/all.atom.xml" rel="self"/>
  <id>https://log.twinklelabs.kr/</id>
  <updated>2026-11-14T07:40:00.000Z</updated>
  <subtitle>1인 개발자 twinkle과 AI가 함께 아이디어를 실험하고 제품을 만드는 기록입니다. 개발과 디자인에서 마주친 문제, 선택과 해결 과정을 담습니다.</subtitle>
  <entry>
    <title>Lighthouse 72점의 범인은 리다이렉트였고, 글꼴 개선은 제 맥에서만 빨랐습니다</title>
    <link href="https://log.twinklelabs.kr/silent-failures/lighthouse-four-sites.html" rel="alternate"/>
    <id>https://log.twinklelabs.kr/silent-failures/lighthouse-four-sites.html</id>
    <published>2026-11-14T07:40:00.000Z</published>
    <updated>2026-11-14T07:40:00.000Z</updated>
    <author><name>Heejeong Kim</name></author>
    <category term="개발 기록"/>
    <category term="lighthouse"/>
    <category term="성능"/>
    <category term="nextjs"/>
    <category term="astro"/>
    <category term="pwa"/>
    <category term="정적사이트"/>
    <summary type="html">소개·블로그·디자인·약관 사이트 넷을 Lighthouse로 쟀습니다. 가장 큰 손실은 이미지가 아니라 화면을 두 번 받게 하던 언어 리다이렉트였습니다. 글꼴을 직접 싣는 개선은 제 맥에서만 빨랐고, 시스템 글꼴을 빼고 다시 재자 오히려 느려서 되돌렸습니다.</summary>
    <content type="html">&lt;h2 id=&quot;들어가며&quot;&gt;들어가며&lt;/h2&gt;
&lt;p&gt;Twinkle AI Labs에는 주소로 여는 사이트가 넷 있습니다. 소개(&lt;code&gt;twinklelabs.kr&lt;/code&gt;), 블로그, 디자인 시스템 문서, 앱 약관을 모아 둔 Polaris입니다. 모두 정적으로 구워 Cloudflare에 올립니다. 서버가 없으니 느릴 이유도 없다고 생각했습니다.&lt;/p&gt;
&lt;p&gt;프로덕션에서 모바일 Lighthouse를 돌렸더니 이렇게 나왔습니다.&lt;/p&gt;
&lt;div class=&quot;table-wrap&quot;&gt;





























&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;사이트&lt;/th&gt;&lt;th&gt;성능&lt;/th&gt;&lt;th&gt;LCP&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;소개&lt;/td&gt;&lt;td&gt;72&lt;/td&gt;&lt;td&gt;12.5초&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;디자인&lt;/td&gt;&lt;td&gt;78&lt;/td&gt;&lt;td&gt;5.2초&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;블로그&lt;/td&gt;&lt;td&gt;77&lt;/td&gt;&lt;td&gt;5.0초&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Polaris&lt;/td&gt;&lt;td&gt;94&lt;/td&gt;&lt;td&gt;2.5초&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;&lt;/div&gt;
&lt;p&gt;소개 화면의 LCP가 12.5초였습니다. 정적 사이트에서 나올 숫자가 아니었습니다.&lt;/p&gt;
&lt;h2 id=&quot;화면을-두-번-받고-있었습니다&quot;&gt;화면을 두 번 받고 있었습니다&lt;/h2&gt;
&lt;p&gt;감점 항목 맨 위에 &lt;code&gt;redirects&lt;/code&gt;가 있었습니다. 소개 7.8초, 디자인 4.1초, 블로그 3.1초를 리다이렉트에 쓰고 있었습니다.&lt;/p&gt;
&lt;p&gt;세 사이트 모두 열한 언어를 지원합니다. 언어 없는 주소(&lt;code&gt;/&lt;/code&gt;)로 들어오면 마지막에 고른 언어의 주소(&lt;code&gt;/ko/&lt;/code&gt;)로 보내는 코드가 있었는데, 이렇게 생겼습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;tsx&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;useEffect&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#9ABDF5&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt;()&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt; =&gt;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt;  const&lt;/span&gt;&lt;span style=&quot;--shiki-light:#FE640B;--shiki-dark:#BB9AF7&quot;&gt; locale&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt; =&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#C0CAF5&quot;&gt; requested&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BB9AF7&quot;&gt; ??&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt; readPreferredLocale&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#9ABDF5&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BB9AF7&quot;&gt;??&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt; &quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt;ko&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#C0CAF5&quot;&gt;  window&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#7DCFFF&quot;&gt;location&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;replace&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#9ABDF5&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;localePath&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#9ABDF5&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#C0CAF5&quot;&gt;path&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#C0CAF5&quot;&gt; locale&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#9ABDF5&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#C0CAF5&quot;&gt; search&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt; +&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#C0CAF5&quot;&gt; hash&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#9ABDF5&quot;&gt;)&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt;}&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#9ABDF5&quot;&gt; [&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#7DCFFF&quot;&gt;path&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#9ABDF5&quot;&gt;])&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;code&gt;useEffect&lt;/code&gt;는 하이드레이션이 끝난 뒤에 돕니다. 그러니까 &lt;code&gt;/&lt;/code&gt;의 HTML과 CSS와 자바스크립트를 다 받고, 화면을 한 번 그리고, 그다음에 &lt;code&gt;/ko/&lt;/code&gt;로 가서 &lt;strong&gt;같은 화면을 처음부터 다시 받았습니다.&lt;/strong&gt; 그리고 &lt;code&gt;/&lt;/code&gt;는 이미 한국어 화면을 그리고 있었습니다. 기본 언어인 사람에게는 아무것도 바꾸지 않는 이동이었습니다.&lt;/p&gt;
&lt;p&gt;블로그는 Astro라 모양이 달랐지만 같은 병이었습니다. 레이아웃의 모듈 스크립트가 넘겼고, 모듈은 파싱이 끝난 뒤에 돕니다.&lt;/p&gt;
&lt;p&gt;고친 규칙은 두 줄입니다.&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;고른 언어가 한국어이거나 아직 고르지 않았고, &lt;code&gt;?lang=&lt;/code&gt;도 없으면 넘어가지 않고 그 자리에 섭니다.&lt;/li&gt;
&lt;li&gt;다른 언어를 골랐던 사람만 넘깁니다. 이때는 &lt;code&gt;&amp;#x3C;head&gt;&lt;/code&gt; 맨 앞의 작은 인라인 스크립트가, CSS도 기다리지 않고 넘깁니다.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;다른 언어를 고른 사람은 여전히 HTML 한 장을 버립니다. 그래도 전에는 화면 전체를 버렸습니다. 이것까지 없애려면 서버가 쿠키를 읽고 바로 넘겨야 하는데, 지금 구성에는 그 자리가 없습니다.&lt;/p&gt;
&lt;figure&gt;&lt;img src=&quot;/images/silent-failures/lighthouse-redirect-twice.webp&quot; alt=&quot;소개·디자인 사이트의 언어 리다이렉트를 다시 그린 그림. 고치기 전에는 / 를 다 받아 그린 뒤 useEffect가 /ko/로 넘겨 같은 화면을 처음부터 다시 받았고, 고친 뒤에는 한국어 방문자는 그 자리에 서고 다른 언어를 고른 사람만 head의 인라인 스크립트로 넘어간다.&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;figcaption aria-hidden=&quot;true&quot;&gt;소개·디자인 사이트의 언어 리다이렉트를 다시 그린 그림. 고치기 전에는 / 를 다 받아 그린 뒤 useEffect가 /ko/로 넘겨 같은 화면을 처음부터 다시 받았고, 고친 뒤에는 한국어 방문자는 그 자리에 서고 다른 언어를 고른 사람만 head의 인라인 스크립트로 넘어간다.&lt;/figcaption&gt;&lt;/figure&gt;
&lt;p&gt;canonical은 고칠 것이 없었습니다. 처음부터 &lt;code&gt;/&lt;/code&gt;의 대표 주소가 &lt;code&gt;/ko/&lt;/code&gt;를 가리키고 있었습니다.&lt;/p&gt;
&lt;h2 id=&quot;그림은-그려지는-크기의-두-배로&quot;&gt;그림은 그려지는 크기의 두 배로&lt;/h2&gt;
&lt;p&gt;리다이렉트 다음은 그림이었습니다.&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;소개 화면의 히어로 별&lt;/strong&gt;: 1254px짜리 PNG 851KB를 280px 칸에 그리고 있었습니다. 이것이 LCP 요소였습니다. 560px WebP로 구우니 42KB가 됐습니다. 알파는 그대로이고 색 오차는 평균 2.6/255라 나란히 놓고 봐도 갈리지 않습니다.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Polaris의 앱 아이콘 다섯&lt;/strong&gt;: 합쳐 1.4MB였는데, 화면에서는 64px 칸입니다. 128px WebP로 구우니 다섯이 합쳐 9KB가 됐습니다.&lt;/li&gt;
&lt;/ul&gt;
&lt;figure&gt;&lt;img src=&quot;/images/silent-failures/lighthouse-hero-star.webp&quot; alt=&quot;소개 화면 히어로 별의 고치기 전 원본 PNG(1254px · 851KB)와 고친 뒤 화면용 WebP(560px · 42KB)를 같은 280px 칸에 나란히 놓은 그림. 막대는 파일 크기의 비율이다.&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;figcaption aria-hidden=&quot;true&quot;&gt;소개 화면 히어로 별의 고치기 전 원본 PNG(1254px · 851KB)와 고친 뒤 화면용 WebP(560px · 42KB)를 같은 280px 칸에 나란히 놓은 그림. 막대는 파일 크기의 비율이다.&lt;/figcaption&gt;&lt;/figure&gt;
&lt;p&gt;원본 PNG는 지우지 않았습니다. 공유 카드를 굽는 쪽(Satori)이 WebP를 읽지 못하기 때문입니다. 대신 빌드가 원본에서 화면용 판을 굽게 했습니다. 손으로 한 번 구운 파일은 다음 동기화 때 조용히 사라집니다.&lt;/p&gt;
&lt;p&gt;캐시도 손봤습니다. 해시가 든 빌드 산출물(&lt;code&gt;/_next/static/*&lt;/code&gt;, &lt;code&gt;/_astro/*&lt;/code&gt;)은 1년 immutable로, 해시 없는 그림은 1주로 두었습니다. Cloudflare의 &lt;code&gt;_headers&lt;/code&gt;는 두 규칙이 같은 헤더를 주면 값을 쉼표로 이어 붙이기 때문에, 블록마다 &lt;code&gt;! Cache-Control&lt;/code&gt;로 먼저 떼고 다시 달았습니다.&lt;/p&gt;
&lt;h2 id=&quot;글꼴을-직접-싣자-fcp가-05초-줄었습니다&quot;&gt;글꼴을 직접 싣자 FCP가 0.5초 줄었습니다&lt;/h2&gt;
&lt;p&gt;리다이렉트와 그림을 고치고 나니 남은 가장 큰 덩어리는 렌더를 막는 CSS였습니다. 네 사이트 모두 Pretendard의 CSS를 jsDelivr에서 받습니다. 다른 서버라 연결을 새로 맺어야 하고, 그동안 첫 그림이 기다립니다.&lt;/p&gt;
&lt;p&gt;npm의 &lt;code&gt;pretendard&lt;/code&gt; 패키지에서 같은 판(1.3.9, variable dynamic-subset)을 번들에 실었습니다. &lt;code&gt;@font-face&lt;/code&gt; 92개의 이름·굵기 범위·&lt;code&gt;font-display&lt;/code&gt;·unicode-range가 CDN의 것과 같고, woff2 파일은 바이트까지 같았습니다. 1440px 화면을 전후로 찍어 견주니 다른 픽셀이 0개였습니다.&lt;/p&gt;
&lt;p&gt;로컬 Lighthouse에서 FCP가 블로그는 1.70초에서 1.21초로, 소개는 2.0초에서 1.7초로 줄었습니다. 소개와 블로그는 그대로 커밋했습니다.&lt;/p&gt;
&lt;h2 id=&quot;그-숫자는-제-맥에서만-참이었습니다&quot;&gt;그 숫자는 제 맥에서만 참이었습니다&lt;/h2&gt;
&lt;p&gt;약관 사이트에서 같은 일을 하던 에이전트가 이상한 점을 짚었습니다. 측정 기록에 &lt;strong&gt;웹 글꼴 요청이 한 장도 없었습니다.&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;이 맥에는 Pretendard가 시스템 글꼴로 깔려 있습니다. 그리고 네 사이트의 글꼴 순서는 이렇습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;css&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-dark:#F7768E&quot;&gt;font-family&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;: Pretendard&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; &quot;Pretendard Variable&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; -apple-system&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; …;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;맨 앞의 &lt;code&gt;Pretendard&lt;/code&gt;가 시스템에서 찾아지니, 브라우저는 웹 글꼴(&lt;code&gt;Pretendard Variable&lt;/code&gt;)을 받을 필요가 없었습니다. 전에도 후에도 글꼴을 한 장도 받지 않은 채로 쟀고, 그래서 남은 차이는 «CDN의 CSS를 받느냐, 우리 CSS에 들어 있느냐» 하나뿐이었습니다. 이득만 보이는 측정이었습니다.&lt;/p&gt;
&lt;figure&gt;&lt;img src=&quot;/images/silent-failures/lighthouse-font-requests.webp&quot; alt=&quot;2026-11-19 이 맥에서 소개 화면 /ko/ 를 열고 글꼴 요청을 센 결과. 배포된 그대로는 woff2 요청이 0건이고, 재현으로 CSS에서 Pretendard, 만 빼고 다시 열면 17건 · 464KB를 받는다.&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;figcaption aria-hidden=&quot;true&quot;&gt;2026-11-19 이 맥에서 소개 화면 /ko/ 를 열고 글꼴 요청을 센 결과. 배포된 그대로는 woff2 요청이 0건이고, 재현으로 CSS에서 Pretendard, 만 빼고 다시 열면 17건 · 464KB를 받는다.&lt;/figcaption&gt;&lt;/figure&gt;
&lt;p&gt;방문자 대부분의 기기에는 Pretendard가 없습니다. PageSpeed Insights를 돌리는 기계에도 없습니다. 그래서 구운 CSS 사본에서 글꼴 순서의 &lt;code&gt;Pretendard,&lt;/code&gt;만 뺀 시험판을 만들어 다시 쟀습니다.&lt;/p&gt;
&lt;div class=&quot;table-wrap&quot;&gt;





























&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;시스템 글꼴 없는 조건 (&lt;code&gt;/ko/&lt;/code&gt;)&lt;/th&gt;&lt;th&gt;성능&lt;/th&gt;&lt;th&gt;LCP&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;소개 — CDN 그대로&lt;/td&gt;&lt;td&gt;66–72&lt;/td&gt;&lt;td&gt;5.7–7.1초&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;소개 — 직접 싣기&lt;/td&gt;&lt;td&gt;63&lt;/td&gt;&lt;td&gt;7.9초&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;디자인 — 직접 싣기&lt;/td&gt;&lt;td&gt;70–71&lt;/td&gt;&lt;td&gt;5.3초&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;약관(일본어) — CDN 그대로 → 직접 싣기&lt;/td&gt;&lt;td&gt;98 → 71&lt;/td&gt;&lt;td&gt;2.3초 → 5.0초&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;&lt;/div&gt;
&lt;p&gt;직접 실으면 오히려 느렸습니다. 같은 출처에서 오는 글꼴은 첫 그림보다 먼저 출발하고, Lighthouse의 기본 측정(simulated)은 그렇게 먼저 출발한 글꼴 수백 KB를 첫 그림의 선행 조건으로 셈합니다. 일본어·중국어 약관은 받는 조각이 20개, 약 490KB라 가장 크게 떨어졌습니다.&lt;/p&gt;
&lt;p&gt;실제 4배 감속(devtools 방식)으로 재면 전후가 같았습니다. 그러니 실제 사용자에게 손해라고까지 단정할 수는 없습니다. 다만 이득이라는 증거도 없어졌고, PSI 점수는 확실히 떨어집니다. 네 사이트 모두 되돌렸습니다. 글꼴은 jsDelivr에 두고 preconnect만 남겼습니다.&lt;/p&gt;
&lt;p&gt;먼저 커밋했던 두 사이트의 되돌림 커밋에는 이유를 그대로 적었습니다. 다음에 누가 같은 개선을 떠올리면, 그 커밋이 «이미 해 봤고 이런 이유로 되돌렸다»를 말해 줄 것입니다.&lt;/p&gt;
&lt;h2 id=&quot;pwa도-붙였습니다&quot;&gt;PWA도 붙였습니다&lt;/h2&gt;
&lt;p&gt;네 사이트에 매니페스트와 서비스 워커를 붙였습니다. 라이브러리 없이 손으로 쓴 100줄 남짓한 워커입니다. 지킨 규칙은 하나입니다. &lt;strong&gt;온라인이면 서비스 워커가 없는 것과 같은 화면을 본다.&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;문서는 네트워크를 먼저 봅니다. 끊겼을 때만 캐시된 같은 쪽을, 그것도 없으면 캐시된 홈을 보여 줍니다.&lt;/li&gt;
&lt;li&gt;해시 든 빌드 산출물은 캐시를 먼저 봅니다. 이름이 바뀌지 않는 한 내용도 바뀌지 않기 때문입니다.&lt;/li&gt;
&lt;li&gt;분석 스크립트, 앱이 받아 가는 API, 다른 출처의 요청은 손대지 않고 그대로 보냅니다.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;약관 사이트에서 특히 이 규칙이 중요했습니다. 옛 판의 약관이 캐시에 붙들려 보이면 그것은 성능 문제가 아니라 사고입니다.&lt;/p&gt;
&lt;p&gt;오프라인 시험에도 함정이 있었습니다. Puppeteer의 &lt;code&gt;setOfflineMode&lt;/code&gt;는 페이지만 끊고 서비스 워커의 요청은 끊지 않습니다. 처음에는 워커가 몰래 망에서 받아 오는데도 «오프라인에서 열린다»고 통과했습니다. 그래서 시험 서버를 실제로 내렸다가 올리는 방식으로 바꿨고, 그렇게 끊은 상태에서 네 사이트 모두 한 번 본 쪽이 다시 열리는 것을 확인했습니다.&lt;/p&gt;
&lt;h2 id=&quot;남은-것&quot;&gt;남은 것&lt;/h2&gt;
&lt;p&gt;이 글의 «고친 뒤» 숫자는 전부 로컬에서 잰 값입니다. 로컬에는 우리 서버까지의 지연이 없어서, 프로덕션에서 가장 컸던 리다이렉트 비용이 잘 드러나지 않습니다. 배포한 뒤 프로덕션에서 다시 재야 실제 폭을 알 수 있습니다.&lt;/p&gt;
&lt;p&gt;디자인 시스템의 법에 걸려 고치지 않은 것도 있습니다. 다크 테마의 채운 보라(&lt;code&gt;#986CF4&lt;/code&gt;) 위 흰 글자는 3.63:1로, 14px 글자에 필요한 4.5:1에 못 미칩니다. 이 값은 한 사이트가 아니라 디자인 시스템이 정할 일이라 그대로 두었습니다.&lt;/p&gt;
&lt;h2 id=&quot;정리&quot;&gt;정리&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;정적 사이트의 가장 큰 손실은 이미지가 아니라 &lt;strong&gt;화면을 두 번 받게 하는 리다이렉트&lt;/strong&gt;였습니다. &lt;code&gt;useEffect&lt;/code&gt;에서 넘기는 리다이렉트는 사용자가 화면을 다 받은 뒤에 일어납니다.&lt;/li&gt;
&lt;li&gt;기본 언어인 사람에게 아무것도 바꾸지 않는 이동이라면, 이동하지 않는 것이 답입니다.&lt;/li&gt;
&lt;li&gt;측정하는 기계가 방문자와 다르면 측정도 다른 것을 잽니다. 제 맥에 깔린 글꼴 하나가 «이득만 있는 개선»을 만들어 냈습니다. 성능을 잴 때는 &lt;strong&gt;웹 글꼴 요청이 기록에 실제로 있는지&lt;/strong&gt;부터 봅니다.&lt;/li&gt;
&lt;/ul&gt;</content>
  </entry>
  <entry>
    <title>AdMob 배너가 화면 아래를 128dp나 차지하고 있었습니다</title>
    <link href="https://log.twinklelabs.kr/ax-engineering/admob-banner-height.html" rel="alternate"/>
    <id>https://log.twinklelabs.kr/ax-engineering/admob-banner-height.html</id>
    <published>2026-11-07T13:30:00.000Z</published>
    <updated>2026-11-07T13:30:00.000Z</updated>
    <author><name>Heejeong Kim</name></author>
    <category term="AX 엔지니어링"/>
    <category term="android"/>
    <category term="AdMob"/>
    <category term="광고"/>
    <category term="compose"/>
    <category term="deprecated"/>
    <summary type="html">큰 앵커드 적응형 배너가 폰에서 128dp를 차지하고 있었습니다. 일반 앵커드 배너는 deprecated라 돌아갈 수 없었습니다. deprecated 함수 없이 배너 높이를 60dp로 정한 방법과, 에뮬레이터에서 광고가 안 뜬 이유를 기록합니다.</summary>
    <content type="html">&lt;h2 id=&quot;들어가며&quot;&gt;들어가며&lt;/h2&gt;
&lt;p&gt;물타기 계산기를 에뮬레이터에 띄워 보다가 “광고 영역이 왜 이렇게 높아?”라는 말이 나왔습니다. 하단바 위의 빈 띠가 화면 아래를 크게 차지하고 있었습니다. 재 보니 약 128dp였습니다. 계산기 화면에서 결과 카드와 하단바 사이가 통째로 광고 자리였습니다.&lt;/p&gt;
&lt;p&gt;결론부터 쓰면, 배너 크기를 &lt;strong&gt;인라인 적응형에 높이 상한 60dp&lt;/strong&gt;로 바꿨습니다. deprecated 함수는 쓰지 않았습니다. 같은 문제가 있던 Pocket PDF에도 같은 규칙을 넣었습니다.&lt;/p&gt;
&lt;h2 id=&quot;왜-128dp였나&quot;&gt;왜 128dp였나&lt;/h2&gt;
&lt;p&gt;배너 크기는 이렇게 청하고 있었습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;val&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; size &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; AdSize.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;getLargeAnchoredAdaptiveBannerAdSize&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(context, widthDp)&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;“큰 앵커드 적응형” 배너입니다. 구글 문서에 따르면 이 배너는 스크롤하지 않는 화면을 위한 큰 형식이고, 높이가 &lt;strong&gt;50~150dp, 화면 높이의 20%까지&lt;/strong&gt; 갑니다. 높이는 SDK가 정합니다. 폭 411dp 폰에서 약 128dp가 나왔습니다.&lt;/p&gt;
&lt;p&gt;광고가 오면 화면이 밀리지 않도록 자리를 미리 그 높이만큼 잡아 둡니다. 그래서 광고가 오기 전에도 128dp짜리 빈 띠가 서 있었습니다.&lt;/p&gt;
&lt;h2 id=&quot;예전-크기로-돌아갈-수-없었던-이유&quot;&gt;예전 크기로 돌아갈 수 없었던 이유&lt;/h2&gt;
&lt;p&gt;이 앱은 9월 초까지 일반 앵커드 적응형을 썼습니다. 폰에서 약 60dp였습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt;// 2026-09-05 ~ 09-26&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;val&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; size &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; AdSize.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;getCurrentOrientationAnchoredAdaptiveBannerAdSize&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(context, widthDp)&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;그런데 SDK가 이 함수를 deprecated로 표시하면서 큰 쪽을 대신 가리켰습니다. deprecated 경고를 없애려고 큰 배너로 옮겼고, 그 대가로 화면 아래가 두 배 가까이 커졌습니다.&lt;/p&gt;
&lt;p&gt;앱이 쓰는 SDK(25.5.0)의 &lt;code&gt;AdSize&lt;/code&gt;를 직접 열어 보니 상황은 이랬습니다.&lt;/p&gt;
&lt;div class=&quot;table-wrap&quot;&gt;
































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;함수&lt;/th&gt;&lt;th&gt;상태&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;code&gt;getCurrentOrientationAnchoredAdaptiveBannerAdSize&lt;/code&gt;&lt;/td&gt;&lt;td&gt;deprecated&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code&gt;getPortraitAnchoredAdaptiveBannerAdSize&lt;/code&gt;&lt;/td&gt;&lt;td&gt;deprecated&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code&gt;getLandscapeAnchoredAdaptiveBannerAdSize&lt;/code&gt;&lt;/td&gt;&lt;td&gt;deprecated&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code&gt;getLargeAnchoredAdaptiveBannerAdSize&lt;/code&gt; (및 세로 · 가로 판)&lt;/td&gt;&lt;td&gt;사용 가능&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code&gt;getInlineAdaptiveBannerAdSize(width, maxHeight)&lt;/code&gt;&lt;/td&gt;&lt;td&gt;사용 가능&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code&gt;getCurrentOrientationInlineAdaptiveBannerAdSize&lt;/code&gt; (및 세로 · 가로 판)&lt;/td&gt;&lt;td&gt;사용 가능&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;&lt;/div&gt;
&lt;p&gt;일반 앵커드 셋은 모두 deprecated였습니다. deprecated 함수로 돌아가면 높이는 해결되지만, 경고를 다시 덮어야 하고 언젠가 그 함수가 사라지는 날 다시 정해야 합니다.&lt;/p&gt;
&lt;p&gt;같은 회사의 다른 앱인 Pocket PDF는 실제로 그렇게 하고 있었습니다. 큰 배너가 폴더블에서 140dp까지 커지자 일반 앵커드로 돌아가고, 경고는 &lt;code&gt;@Suppress(&quot;DEPRECATION&quot;)&lt;/code&gt;로 덮었습니다.&lt;/p&gt;
&lt;h2 id=&quot;높이를-우리가-정할-수-있는-길&quot;&gt;높이를 우리가 정할 수 있는 길&lt;/h2&gt;
&lt;p&gt;deprecated가 아닌 것 중 높이를 줄일 수 있는 후보는 둘이었습니다.&lt;/p&gt;
&lt;p&gt;**고정 크기 &lt;code&gt;AdSize.BANNER&lt;/code&gt;(320×50)**는 deprecated가 아닙니다. 하지만 폭이 320dp로 고정이라 넓은 폰에서는 양옆이 빕니다.&lt;/p&gt;
&lt;p&gt;**인라인 적응형 &lt;code&gt;getInlineAdaptiveBannerAdSize(width, maxHeight)&lt;/code&gt;**는 폭은 우리가 주고, 높이는 SDK가 &lt;strong&gt;우리가 준 상한 안에서&lt;/strong&gt; 고릅니다. 이름은 “인라인”이지만, 구글 문서는 스크롤하는 콘텐츠에서 인라인을 권할 뿐 고정 자리에 쓰지 말라고 하지는 않습니다.&lt;/p&gt;
&lt;p&gt;Pocket PDF의 예전 주석에는 인라인 적응형을 거른 이유가 적혀 있었습니다. “인라인 적응형은 최대 높이만 받고 실제 높이는 광고가 와야 알려 주므로 자리를 미리 잡을 수 없다.” 맞는 말이지만, &lt;strong&gt;상한 자체를 자리로 잡으면&lt;/strong&gt; 이 걱정은 없어집니다. 광고는 그 안에 서고, 더 낮게 오면 가운데에 섭니다. 어떤 높이가 와도 화면은 밀리지 않습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt;/** 배너 높이의 상한(dp) */&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt;private&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt; const&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt; val&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; BannerMaxHeightDp &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#FE640B;--shiki-dark:#FF9E64&quot;&gt; 60&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;class&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt; BannerAd&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(context: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;, widthDp: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;Int&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt;    /** 광고 자리의 높이 — 광고가 이보다 낮게 와도 자리는 그대로라 화면이 밀리지 않는다 */&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;    val&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; heightDp: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;Int&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt; =&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; BannerMaxHeightDp&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt;    private&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt; val&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; view &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt; AdView&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(context).&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;apply&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;        setAdSize&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(AdSize.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;getInlineAdaptiveBannerAdSize&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(widthDp, BannerMaxHeightDp))&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;        adUnitId &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; AdUnits.BANNER&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;Compose 쪽은 바뀐 것이 없습니다. 원래도 &lt;code&gt;heightDp&lt;/code&gt;만큼 자리를 잡고 그 안에 &lt;code&gt;AdView&lt;/code&gt;를 붙이고 있었습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;Box&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    modifier &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; Modifier&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;        .&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;fillMaxWidth&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;        .&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;height&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(banner.heightDp.dp),&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    contentAlignment &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; Alignment.Center,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;    AndroidView&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(factory &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; { &lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;FrameLayout&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(it) }, update &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; { banner.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;attachTo&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(it) })&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;60을 고른 이유는 예전 일반 앵커드 배너가 폰 세로에서 56~64dp였기 때문입니다. 표준 배너(50)보다 조금 여유를 둬서 SDK가 고를 칸을 남겼습니다.&lt;/p&gt;
&lt;figure&gt;&lt;img src=&quot;/images/ax-engineering/admob-banner-slot-heights.webp&quot; alt=&quot;축척을 맞춰 다시 그린 그림. 폭 411dp 폰에서 큰 앵커드 배너가 잡던 128dp 자리, 인라인 적응형에 상한 60dp를 준 자리, 그 60dp 자리에 더 낮은 광고가 와서 가운데에 선 모습을 나란히 놓았다.&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;figcaption aria-hidden=&quot;true&quot;&gt;축척을 맞춰 다시 그린 그림. 폭 411dp 폰에서 큰 앵커드 배너가 잡던 128dp 자리, 인라인 적응형에 상한 60dp를 준 자리, 그 60dp 자리에 더 낮은 광고가 와서 가운데에 선 모습을 나란히 놓았다.&lt;/figcaption&gt;&lt;/figure&gt;
&lt;p&gt;두 앱의 높이는 이렇게 바뀌었습니다.&lt;/p&gt;
&lt;div class=&quot;table-wrap&quot;&gt;



















&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;앱&lt;/th&gt;&lt;th&gt;전&lt;/th&gt;&lt;th&gt;후&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;물타기 계산기&lt;/td&gt;&lt;td&gt;큰 앵커드, 폰에서 약 128dp&lt;/td&gt;&lt;td&gt;60dp&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Pocket PDF&lt;/td&gt;&lt;td&gt;일반 앵커드(deprecated를 덮어 씀), 폰 56~64dp · 태블릿 90dp&lt;/td&gt;&lt;td&gt;60dp&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;&lt;/div&gt;
&lt;h2 id=&quot;에뮬레이터에서-광고가-안-떴던-이유&quot;&gt;에뮬레이터에서 광고가 안 떴던 이유&lt;/h2&gt;
&lt;p&gt;바꾼 뒤 에뮬레이터에서 확인하려 했는데 광고 칸이 계속 비어 있었습니다. 바꾸기 전 큰 배너도 비어 있었으니 크기 문제는 아니었습니다. 원인이 세 겹이었습니다.&lt;/p&gt;
&lt;h3 id=&quot;1-광고를-그리는-webview가-죽고-있었습니다&quot;&gt;1. 광고를 그리는 WebView가 죽고 있었습니다&lt;/h3&gt;
&lt;p&gt;로그에 이런 줄이 약 90초마다 찍혔습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;text&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span&gt;E chromium: [ERROR:aw_browser_terminator.cc(154)] Renderer process crash detected&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;배너는 WebView로 그려집니다. 에뮬레이터가 메모리 부족으로 소프트웨어 그래픽으로 떠 있었고, 다른 에뮬레이터도 함께 돌고 있었습니다.&lt;/p&gt;
&lt;h3 id=&quot;2-에뮬레이터가-dns를-풀지-못했습니다&quot;&gt;2. 에뮬레이터가 DNS를 풀지 못했습니다&lt;/h3&gt;
&lt;p&gt;앱을 다시 띄우니 WebView는 더 죽지 않았는데, 이번에는 광고 세 개가 30초 뒤 모두 실패했습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;text&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span&gt;I Ads : Ad failed to load : 0&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;IP로는 인터넷에 닿는데 이름을 못 풀고 있었습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;bash&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;adb&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt; shell&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt; ping&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#E0AF68&quot;&gt; -c&lt;/span&gt;&lt;span style=&quot;--shiki-light:#FE640B;--shiki-dark:#FF9E64&quot;&gt; 1&lt;/span&gt;&lt;span style=&quot;--shiki-light:#FE640B;--shiki-dark:#FF9E64&quot;&gt; 8.8.8.8&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt;                      # 성공&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;adb&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt; shell&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt; ping&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#E0AF68&quot;&gt; -c&lt;/span&gt;&lt;span style=&quot;--shiki-light:#FE640B;--shiki-dark:#FF9E64&quot;&gt; 1&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt; googleads.g.doubleclick.net&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt;  # unknown host&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;에뮬레이터 안에서 고치려 한 두 방법은 듣지 않았습니다. Private DNS를 &lt;code&gt;dns.google&lt;/code&gt;로 바꾸면, 그 이름을 푸는 데에도 고장 난 DNS가 필요합니다. 루트로 네트워크 DNS를 바꾸는 &lt;code&gt;ndc resolver&lt;/code&gt; 명령은 이 안드로이드 판에 없었습니다. 결국 에뮬레이터를 DNS 서버를 지정해 다시 띄웠습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;bash&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;emulator&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#E0AF68&quot;&gt; -avd&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt; twinkle_pixel&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#E0AF68&quot;&gt; -dns-server&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt; 8.8.8.8,8.8.4.4&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;3-다시-띄운-에뮬레이터에는-옛-빌드가-깔려-있었습니다&quot;&gt;3. 다시 띄운 에뮬레이터에는 옛 빌드가 깔려 있었습니다&lt;/h3&gt;
&lt;p&gt;드디어 테스트 광고가 떴는데 여전히 컸습니다. 에뮬레이터를 다시 띄우면서 디스크가 예전 상태로 돌아가, 바꾸기 전 빌드가 깔려 있었기 때문입니다. 지금 빌드를 다시 깔자 테스트 배너가 60dp 칸에 폭을 다 채워 섰습니다.&lt;/p&gt;
&lt;p&gt;에뮬레이터에서 광고가 안 뜨면 크기나 코드부터 의심하게 되는데, 이번에는 셋 다 코드 밖의 문제였습니다. 로그에서 &lt;code&gt;Ads&lt;/code&gt; 태그와 &lt;code&gt;chromium&lt;/code&gt; 태그를 같이 보는 습관이 도움이 됐습니다.&lt;/p&gt;
&lt;h2 id=&quot;남은-것&quot;&gt;남은 것&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;수익:&lt;/strong&gt; 큰 배너가 보통 수익이 더 높습니다. 출시 뒤 AdMob에서 채움률과 수익이 얼마나 달라지는지 봐야 합니다.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;실기기:&lt;/strong&gt; 에뮬레이터의 테스트 광고로만 확인했습니다. 실제 광고가 인라인 적응형 60dp 칸에 어떻게 서는지는 실기기와 출시 뒤에 봅니다.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;정리&quot;&gt;정리&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;큰 앵커드 적응형 배너는 높이를 SDK가 정하고, 폰에서도 128dp까지 커질 수 있습니다.&lt;/li&gt;
&lt;li&gt;일반 앵커드 적응형은 deprecated입니다. 높이를 우리가 정하면서 deprecated를 피하는 길은 인라인 적응형의 &lt;code&gt;maxHeight&lt;/code&gt;입니다.&lt;/li&gt;
&lt;li&gt;인라인 적응형은 실제 높이를 미리 알 수 없지만, 상한을 그대로 자리로 잡으면 화면이 밀리지 않습니다.&lt;/li&gt;
&lt;li&gt;에뮬레이터에서 광고가 비면 WebView 렌더러와 DNS부터 확인합니다.&lt;/li&gt;
&lt;/ul&gt;</content>
  </entry>
  <entry>
    <title>형제 앱의 부품으로 새 앱을 올리는 공식</title>
    <link href="https://log.twinklelabs.kr/ax-engineering/new-app-formula.html" rel="alternate"/>
    <id>https://log.twinklelabs.kr/ax-engineering/new-app-formula.html</id>
    <published>2026-10-28T13:10:00.000Z</published>
    <updated>2026-10-28T13:10:00.000Z</updated>
    <author><name>Heejeong Kim</name></author>
    <category term="AX 엔지니어링"/>
    <category term="AX"/>
    <category term="Android"/>
    <category term="CI/CD"/>
    <category term="AdMob"/>
    <category term="디자인 시스템"/>
    <category term="다국어"/>
    <category term="출시"/>
    <summary type="html">한 사람과 AI가 형제 앱의 디자인 컴포넌트, 광고·결제·평가·업데이트 문지기, 다국어 구조와 출시 파이프라인으로 APK 추출기를 만들었습니다. 첫 커밋 다음 날 밤 비공개 테스트 트랙에 올리기까지 고친 것들과, 다른 앱도 쓰게 된 스토어 이미지 엔진을 기록합니다.</summary>
    <content type="html">&lt;p&gt;2026년 10월 26일 밤 11시 10분에 APK 추출기의 첫 커밋을 남겼습니다. 다음 날 밤 9시 48분, &lt;code&gt;develop&lt;/code&gt;에서 &lt;code&gt;main&lt;/code&gt;으로 합친 코드를 푸시했습니다. GitHub Actions가 번들을 만들어 Google Play 내부 테스트 트랙에 올리고, 같은 번들을 비공개 테스트(&lt;code&gt;alpha&lt;/code&gt;)로 옮겼습니다.&lt;/p&gt;
&lt;p&gt;APK 추출기는 폰에 설치된 앱을 설치 파일로 꺼내 저장하거나 공유하는 앱입니다. Twinkle AI Labs에서는 제가 방향을 정하고 AI와 함께 제품을 만듭니다. 이번에는 Claude와 Codex가 형제 앱의 부품을 가져와 새 앱에 맞추고, 코드와 문구를 대조하며 작업했습니다. 한 사람과 AI가 첫 커밋 다음 날 밤에 비공개 테스트 트랙까지 올릴 수 있었던 과정을 적습니다.&lt;/p&gt;
&lt;h2 id=&quot;첫-커밋은-환율-계산기의-몸이었습니다&quot;&gt;첫 커밋은 환율 계산기의 몸이었습니다&lt;/h2&gt;
&lt;p&gt;첫 커밋 메시지에는 «환율 계산기의 몸 · 앱 읽기와 파일 이름의 셈»이라고 적었습니다. 디자인 토큰(&lt;code&gt;ui/theme&lt;/code&gt;), 공통 컴포넌트(&lt;code&gt;ui/components&lt;/code&gt;), 설정 화면의 줄, 약관 화면과 광고 배선을 환율 계산기에서 가져왔습니다. 옮긴 부품의 패키지 이름은 &lt;code&gt;kr.twinklelabs.apkextractor&lt;/code&gt;로 바꿨습니다. 앱 목록을 읽고 APK를 저장·공유하는 기능은 이 앱에 맞춰 구현했습니다.&lt;/p&gt;
&lt;p&gt;디자인 시스템 Aurora Ledger의 색, 반지름, 간격, 글자 크기는 토큰으로 정의되어 있습니다. 컴포넌트와 토큰을 함께 옮겼으므로 설정의 줄이나 버튼을 다시 디자인할 필요가 없었습니다. 앱 아이콘과 UI 아이콘도 루트의 공통 도구인 &lt;code&gt;brand/app-icon.mjs&lt;/code&gt;와 &lt;code&gt;brand/ui-icons.py&lt;/code&gt;로 만들었습니다.&lt;/p&gt;
&lt;h2 id=&quot;네-개의-문지기를-세-앱에서-가져왔습니다&quot;&gt;네 개의 문지기를 세 앱에서 가져왔습니다&lt;/h2&gt;
&lt;p&gt;27일 새벽에는 광고·결제·평가·업데이트를 붙였습니다. 요청은 각각 짧았습니다.&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;«추출 한 번 할 때마다 전면광고»&lt;/li&gt;
&lt;li&gt;«광고 제거 3900원 추가하자 형제앱처럼»&lt;/li&gt;
&lt;li&gt;«앱 추출할때마다 바로 평가기능 추가»&lt;/li&gt;
&lt;li&gt;«자동업데이트 기능도 넣어줘»&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;전면 광고의 &lt;code&gt;InterstitialGate&lt;/code&gt;는 Pocket PDF에서, 결제의 &lt;code&gt;BillingGate&lt;/code&gt;는 환율 계산기에서 가져왔습니다. 평가의 &lt;code&gt;ReviewGate&lt;/code&gt;와 인앱 업데이트의 &lt;code&gt;UpdateGate&lt;/code&gt;는 물타기 계산기를 바탕으로 했습니다. 이 파일들은 SDK를 호출할 시점과 조건을 맡는 문지기입니다. 출처와 변경 이유도 주석에 남겼습니다. &lt;code&gt;BillingGate.kt&lt;/code&gt;의 일부입니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt;/**&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt; * 광고 제거 결제의 문지기 — **환율 계산기의 것을 그대로 옮겼다** (2026-10-27, Founder «광고 제거 3900원 추가하자 형제앱처럼»).&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt; * 값은 여기 적지 않는다 — Play 콘솔의 상품 값(3,900원)을 스토어가 알려 주는 대로 보인다([priceText]).&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt; */&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;3,900원은 당시 콘솔에 정한 상품 가격이고, 표시할 값은 스토어에서 받아옵니다. 광고 제거를 샀는지 아직 읽지 못한 동안에는 배너도 보이지 않도록 했습니다. 이 판단은 나중에 &lt;code&gt;AdPlacement.kt&lt;/code&gt;의 순수 함수로 떼어 테스트했습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt;internal&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt; fun&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt; showsAdsOf&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(isAdsRemoved: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;Boolean&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;?, hasAdUnits: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;Boolean&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;, availability: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;ConsentGate&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;.Availability): &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;Boolean&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt; =&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    isAdsRemoved &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BB9AF7&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;--shiki-light:#FE640B;--shiki-dark:#FF9E64&quot;&gt; false&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BB9AF7&quot;&gt; &amp;#x26;&amp;#x26;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; hasAdUnits &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BB9AF7&quot;&gt;&amp;#x26;&amp;#x26;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; availability &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BB9AF7&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; ConsentGate.Availability.UNAVAILABLE&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;구매 여부를 모르는 &lt;code&gt;null&lt;/code&gt; 상태에서는 이 함수가 &lt;code&gt;false&lt;/code&gt;를 돌려줍니다.&lt;/p&gt;
&lt;p&gt;전면 광고는 저장이 끝났거나 공유할 파일이 준비된 뒤에 표시합니다. 미리 불러온 광고가 있고 앱이 앞에 떠 있을 때만 보여 주며, 광고를 기다리게 하지는 않습니다. 저장 토스트와 공유 창은 광고가 닫힌 뒤에 열립니다.&lt;/p&gt;
&lt;p&gt;평가를 요청하는 빈도는 바꿨습니다. 물타기 계산기에서는 다섯 번째 저장과 첫 공유에 요청하도록 제한했지만, 여기서는 추출마다 요청합니다. 실제로 평가 창을 보여 줄지는 Google의 할당량에 달려 있습니다. &lt;code&gt;ReviewGate&lt;/code&gt;는 저장 토스트가 뜬 뒤, 공유라면 공유 창에서 돌아온 뒤에 요청합니다.&lt;/p&gt;
&lt;p&gt;&lt;code&gt;UpdateGate&lt;/code&gt;는 내려받는 동안 앱을 계속 쓸 수 있는 유연한 업데이트를 기본으로 하고, 다운로드가 끝나면 재시작할지 묻습니다.&lt;/p&gt;
&lt;h2 id=&quot;약관과-열한-언어도-같은-벌입니다&quot;&gt;약관과 열한 언어도 같은 벌입니다&lt;/h2&gt;
&lt;p&gt;이용약관과 개인정보 처리방침은 참고한 앱의 EULA에서 백업 용도, 꺼낸 앱의 권리, 제3자 광고, 인앱 결제 환불, 면책 조항을 골라 각각 12조와 9절로 썼습니다. 정본은 약관 사이트 Polaris에 두고, 앱에는 사본을 넣었습니다. 약관 화면은 사본을 먼저 보여 준 뒤 정본을 받아 갱신하는 구조를 이어 썼습니다.&lt;/p&gt;
&lt;p&gt;다국어는 «다국어도 pocket pdf 처럼 세워줘»라는 요청으로 시작했습니다. Pocket PDF의 열한 언어 구성과 폴더 구조, 언어 선택 서랍, &lt;code&gt;Localized&lt;/code&gt;를 가져왔습니다. 앱 안에서 언어를 고르면 &lt;code&gt;LocalContext&lt;/code&gt;, &lt;code&gt;LocalConfiguration&lt;/code&gt;, &lt;code&gt;LocalResources&lt;/code&gt;를 함께 바꿔 화면에 바로 반영합니다. 번역문은 APK 추출기의 기능에 맞춰 새로 채웠습니다.&lt;/p&gt;
&lt;p&gt;한국어를 제외한 열 언어는 번역가 역할의 AI가 한 언어씩 맡았습니다. 언어마다 빠짐과 형식, 화면과 말투, 법적 충실성을 차례로 검토해 모두 서른 번 점검했습니다. &lt;code&gt;scripts/i18n-check.py&lt;/code&gt;는 빠진 항목과 자리 표시자, 복수형, 한글 잔재를 검사하고, AI 점검자는 원문과 번역문을 대조했습니다.&lt;/p&gt;
&lt;p&gt;이 과정에서 한국어 원본도 고쳤습니다. 영어, 독일어, 프랑스어, 이탈리아어, 포르투갈어 번역가가 «앱 n개»를 «Apps: 3» 같은 꼴로 옮겨 왔습니다. 원본이 &lt;code&gt;&amp;#x3C;string&gt;&lt;/code&gt;이라 단수와 복수를 나눌 자리가 없었습니다. 수가 붙는 여덟 항목을 &lt;code&gt;&amp;#x3C;plurals&gt;&lt;/code&gt;로 바꾸자 번역도 자연스러운 단수·복수 문장으로 쓸 수 있었습니다.&lt;/p&gt;
&lt;h2 id=&quot;가져온-부품에-테스트가-닿게&quot;&gt;가져온 부품에 테스트가 닿게&lt;/h2&gt;
&lt;p&gt;같은 날 새벽, «SOLID &amp;#x26; SRP 점검 개선 및 리팩토링 진행 50 사이클»을 맡겼습니다. 읽기 전용 점검에서 나온 66항목 중 50항목을 한 사이클에 한 커밋씩 고쳤습니다. 테스트는 180개에서 265개로 늘었고, 매 사이클 단위 테스트와 디버그 빌드를 통과시켰습니다.&lt;/p&gt;
&lt;p&gt;먼저 테스트가 없던 뷰모델과 저장소에 테스트를 붙였습니다. 이어 전면 광고·결제·업데이트·망 감시가 액티비티의 수명주기를 직접 듣도록 바꿨습니다. &lt;code&gt;InterstitialGate.kt&lt;/code&gt;의 주석에 이전 구조를 바꾼 이유가 남아 있습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt;/**&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt; * **제 수명은 스스로 듣는다** (2026-10-27) — [lifecycle] 이 끝나면 실어 둔 광고를 내려놓는다([close]).&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt; * ↩ 공개 `clear()` 였고 `MainActivity.onDestroy` 가 손으로 불렀다 (2026-10-27 까지) — 문지기 다섯이 «놓아 준다»를&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt; * `clear` · `stop` · `close` · `onDestroy` 네 동사로 부르고 있었다.&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt; */&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;이제 전면 광고 문지기는 &lt;code&gt;Lifecycle&lt;/code&gt;이 끝나는 알림을 받아 스스로 광고를 내려놓습니다. 액티비티에서 정리 함수를 하나씩 호출하던 코드도 걷었습니다.&lt;/p&gt;
&lt;h2 id=&quot;출시-파일도-형제-앱에서-가져왔습니다&quot;&gt;출시 파일도 형제 앱에서 가져왔습니다&lt;/h2&gt;
&lt;p&gt;&lt;code&gt;release.yml&lt;/code&gt;은 환율 계산기에서 왔고, 그쪽은 Pocket PDF에서 가져온 파일입니다. &lt;code&gt;main&lt;/code&gt;에 앱 코드를 푸시하면 GitHub Actions가 서명 파일을 Secrets에서 복원하고 테스트를 돌린 뒤, 번들을 내부 테스트 트랙에 올립니다. 이어 같은 번들을 &lt;code&gt;alpha&lt;/code&gt;로 옮깁니다.&lt;/p&gt;
&lt;p&gt;&lt;code&gt;versionCode&lt;/code&gt;는 빌드 스크립트의 &lt;code&gt;lastManualVersionCode&lt;/code&gt;에 GitHub Actions의 실행 번호를 더합니다. &lt;code&gt;android/app/build.gradle.kts&lt;/code&gt;에는 다음과 같이 적혀 있습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;val&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; lastManualVersionCode &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#FE640B;--shiki-dark:#FF9E64&quot;&gt; 1&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;versionCode &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; System.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;getenv&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt;&quot;GITHUB_RUN_NUMBER&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;)?.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;toIntOrNull&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    ?.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;plus&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(lastManualVersionCode) ?: lastManualVersionCode&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;versionName &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt; &quot;1.0.2&quot;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;워크플로도 &lt;code&gt;lastManualVersionCode&lt;/code&gt;를 이 파일에서 &lt;code&gt;grep&lt;/code&gt;으로 읽습니다. 기준값을 두 곳에서 관리하지 않으므로 출시 때 사람이 정하는 번호는 &lt;code&gt;versionName&lt;/code&gt;입니다.&lt;/p&gt;
&lt;p&gt;첫 번들 1.0.0(1)은 27일 로컬에서 만들어 내부 테스트 초안으로 올렸고, 같은 날 비공개 테스트 검토에 제출했습니다. 앱 등록과 AdMob 단위 발급, 데이터 보안과 콘텐츠 등급을 포함한 Play 선언 열 개는 브라우저를 연결한 Claude가 진행했습니다. 스토어 자리를 만드는 일은 자동 출시를 시작하기 전에 필요했습니다.&lt;/p&gt;
&lt;p&gt;그날 밤 1.0.1은 워크플로의 첫 실행으로 &lt;code&gt;versionCode&lt;/code&gt; 2가 됐습니다. 28일의 1.0.2는 두 번째 실행으로 3이 됐습니다. 두 번 모두 &lt;code&gt;develop&lt;/code&gt;에서 &lt;code&gt;main&lt;/code&gt;으로 &lt;code&gt;--no-ff&lt;/code&gt; 머지 후 푸시해 올렸고, 업로드할 때 콘솔을 열지는 않았습니다.&lt;/p&gt;
&lt;p&gt;1.0.1 실행은 마지막 번들 보관 단계에서 GitHub 아티팩트 저장 한도에 걸렸습니다. 내부 테스트 업로드와 &lt;code&gt;alpha&lt;/code&gt; 승격은 성공했지만 실행 전체는 실패로 표시됐습니다. 다음 날 보관 단계를 걷은 뒤 1.0.2 실행은 전부 통과했습니다. 다만 두 출시 모두 콘솔의 게시 개요와 검토 상태까지 확인한 기록은 없습니다. 여기서 말하는 비공개 테스트 업로드는 CI 로그의 &lt;code&gt;[completed]&lt;/code&gt;를 기준으로 합니다.&lt;/p&gt;
&lt;figure&gt;&lt;img src=&quot;/images/ax-engineering/apk-extractor-first-runs.webp&quot; alt=&quot;APK 추출기 release.yml의 첫 두 실행. 실행 1번(v1.0.1)은 internal 업로드와 alpha 승격을 마친 뒤 번들 보관 단계가 아티팩트 저장 한도에 걸려 실패로 끝났고, 보관 단계를 걷은 실행 2번(v1.0.2)은 모든 단계를 통과했다.&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;figcaption aria-hidden=&quot;true&quot;&gt;APK 추출기 release.yml의 첫 두 실행. 실행 1번(v1.0.1)은 internal 업로드와 alpha 승격을 마친 뒤 번들 보관 단계가 아티팩트 저장 한도에 걸려 실패로 끝났고, 보관 단계를 걷은 실행 2번(v1.0.2)은 모든 단계를 통과했다.&lt;/figcaption&gt;&lt;/figure&gt;
&lt;h2 id=&quot;복사한-뒤에야-드러난-것들&quot;&gt;복사한 뒤에야 드러난 것들&lt;/h2&gt;
&lt;p&gt;형제 앱에서 쓰던 부품이어도 새 앱에서 확인할 일은 남았습니다. 루트의 &lt;code&gt;admob-ids.sh&lt;/code&gt;와 &lt;code&gt;policy-bundle.sh&lt;/code&gt;부터 그랬습니다. 광고 단위 ID와 약관 사본을 검사하는 스크립트인데, 검사 대상 표에 APK 추출기가 없었습니다. 통과했다는 결과에 이 앱은 포함되지 않았습니다. 표에 추가하고 다시 검사했습니다.&lt;/p&gt;
&lt;p&gt;디버그 빌드에서는 보이지 않던 오류도 있었습니다. 광고 SDK가 의존하는 WorkManager 2.7.0은 Room 2.2.5를 쓰는데, 출시 빌드의 코드 축소 도구 R8이 &lt;code&gt;WorkDatabase_Impl&lt;/code&gt;을 지웠습니다. Room이 이름으로 찾는 클래스가 사라져 앱이 켜자마자 종료됐습니다. 디버그 빌드는 코드를 줄이지 않아 같은 오류가 나지 않았습니다.&lt;/p&gt;
&lt;p&gt;임시 서명한 출시 빌드를 에뮬레이터에서 실행해 문제를 찾고 고쳤습니다. 실제 광고 단위가 들어 있으므로 네트워크는 끈 상태였습니다. 1.0.1을 올리기 전에도 같은 방식으로 출시 빌드를 켜서 저장과 공유 창까지 확인했습니다.&lt;/p&gt;
&lt;p&gt;문서에도 고칠 곳이 있었습니다. 제품의 &lt;code&gt;CLAUDE.md&lt;/code&gt;와 매니페스트 주석은 네트워크를 쓰는 기능이 광고뿐이라고 적고 있었습니다. 스토어 등록정보 초안도 그 말을 따라 썼습니다. Codex에게 초안을 코드와 대조하게 했을 때 나온 열한 지적 중 하나가 이 문장이었습니다. 약관 정본을 받는 연결과 Play의 결제·평가·업데이트가 빠져 있었습니다. 문서를 고치고, 옛 문장은 되돌린 결정이라는 표시인 ↩와 함께 남겼습니다.&lt;/p&gt;
&lt;h2 id=&quot;스토어-이미지는-다음-앱의-부품이-됐습니다&quot;&gt;스토어 이미지는 다음 앱의 부품이 됐습니다&lt;/h2&gt;
&lt;p&gt;스토어 이미지를 만드는 도구는 이번 앱에서 새로 만들었습니다. Robolectric 테스트가 실제 Compose 화면을 1080×2400으로 찍으면, HTML 틀이 폰 몸체와 문구를 얹고 헤드리스 Chrome이 최종 PNG를 만듭니다. 한 언어당 폰 스크린샷 일곱 장과 그래픽 이미지 한 장입니다. 틀과 배치는 공통으로 쓰고, 원본 화면과 &lt;code&gt;copy.json&lt;/code&gt;의 문구를 언어마다 바꿉니다.&lt;/p&gt;
&lt;p&gt;처음에는 Codex에게 촬영부터 합성까지 맡겼습니다. 그러나 그 작업 환경에서는 Gradle의 잠금 파일 접근과 Chrome 실행이 막혀 이미지가 나오지 않았습니다. 그래서 «스크린샷 같은 건 너가 찍고 Codex 는 최종 이미지 뽑을 때만 시켜»라고 작업을 나눴습니다. Claude가 촬영과 최종 렌더링을 실행하고, Codex는 &lt;code&gt;frame.html&lt;/code&gt;과 &lt;code&gt;layout.json&lt;/code&gt;을 고친 뒤 결과 PNG를 보며 디자인을 다듬었습니다.&lt;/p&gt;
&lt;p&gt;디자인은 다섯 판을 거쳤습니다. 세 번째 판을 중간에 멈춘 뒤 제가 레퍼런스 다섯 장을 보여 줬습니다. 로고샵, Soundok, 당근마켓, 현대카드 웨더, houseapp이었습니다. 네 번째 판부터 첫 장의 보라 배경, 기울인 폰이 둘째 장으로 이어지는 구도, 강조 단어 아래의 형광펜이 들어갔습니다. 마지막 판에서는 기울인 폰이 흐려지는 문제와 문구 주변의 간격을 고쳤습니다.&lt;/p&gt;
&lt;figure&gt;&lt;img src=&quot;/images/ax-engineering/apk-extractor-store-images.webp&quot; alt=&quot;APK 추출기의 2026-10-27 마감 판 한국어 Play 이미지. 폰 스크린샷 일곱 장과 그래픽 이미지 한 장으로, 첫 장의 보라 판, 둘째 장으로 이어지는 기울인 폰, 강조 단어 아래 형광펜이 보인다.&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;figcaption aria-hidden=&quot;true&quot;&gt;APK 추출기의 2026-10-27 마감 판 한국어 Play 이미지. 폰 스크린샷 일곱 장과 그래픽 이미지 한 장으로, 첫 장의 보라 판, 둘째 장으로 이어지는 기울인 폰, 강조 단어 아래 형광펜이 보인다.&lt;/figcaption&gt;&lt;/figure&gt;
&lt;p&gt;당시 만든 이미지는 한국어와 영어 열여섯 장이며, 영어는 초안이었습니다. 나머지 아홉 언어의 이미지 문구는 아직 비어 있었습니다.&lt;/p&gt;
&lt;p&gt;28일에는 제가 «우리가 스토어 이미지 만든거 있잖아 다른 앱에도 똑같은 공식을 사용하자»고 했습니다. 엔진을 루트의 &lt;code&gt;brand/store/&lt;/code&gt;로 옮기고, 제품에는 경로와 촬영법을 적은 &lt;code&gt;product.json&lt;/code&gt;, 문구인 &lt;code&gt;copy.json&lt;/code&gt;, 구도인 &lt;code&gt;layout.json&lt;/code&gt;을 두었습니다. 같은 원본으로 APK 추출기의 열여섯 장을 다시 만들었더니 옮기기 전과 해시가 모두 같았습니다.&lt;/p&gt;
&lt;p&gt;물타기 계산기, Pocket PDF, 환율 계산기도 같은 날 이 엔진으로 이미지를 만들었습니다. 기록 시점에는 앱별 작업 브랜치의 &lt;code&gt;develop&lt;/code&gt; 머지가 남아 있었습니다. APK 추출기가 형제 앱의 부품을 받아 시작했다면, 이번에 만든 이미지 도구는 그 형제들이 함께 쓸 부품으로 남았습니다.&lt;/p&gt;
&lt;h2 id=&quot;사람이-한-일&quot;&gt;사람이 한 일&lt;/h2&gt;
&lt;p&gt;이틀 동안 제가 한 일은 결정을 말하는 것이었습니다. 전면 광고를 추출마다, 광고 제거 3,900원, 공유는 zip 하나로, 글자 배율은 1.0 고정, 레퍼런스 다섯 장. 그 말들은 커밋 메시지와 코드 주석에 «…» 안에 그대로 인용되어 있습니다.&lt;/p&gt;
&lt;p&gt;AI가 첫 커밋 다음 날 밤까지 앱을 조립할 수 있었던 것은 앞선 세 앱이 부품을 검증된 꼴로 두고 있었고, 부품마다 출처와 이유가 파일 머리에 적혀 있었고, 어긋남을 사람이 아니라 스크립트와 출시 빌드와 다른 AI의 검수가 세고 있었기 때문입니다. 이 범주에서는 그 일을 AX 엔지니어링이라고 부르고, 앱마다 무엇을 물려받고 무엇을 새로 세웠는지 적어 가려고 합니다.&lt;/p&gt;</content>
  </entry>
  <entry>
    <title>사진 길이를 줬는데 Media3가 트랙을 찾았다</title>
    <link href="https://log.twinklelabs.kr/android/media3-image-duration.html" rel="alternate"/>
    <id>https://log.twinklelabs.kr/android/media3-image-duration.html</id>
    <published>2026-10-21T15:20:00.000Z</published>
    <updated>2026-10-21T15:20:00.000Z</updated>
    <author><name>Heejeong Kim</name></author>
    <category term="안드로이드"/>
    <category term="android"/>
    <category term="검사"/>
    <category term="영상"/>
    <summary type="html">사진을 넣은 영상 내보내기가 Asset loader error로 멈췄습니다. EditedMediaItem의 길이 설정과 별개로 MediaItem에 이미지 표시 시간을 지정해야 했습니다.</summary>
    <content type="html">&lt;h2 id=&quot;들어가며&quot;&gt;들어가며&lt;/h2&gt;
&lt;p&gt;Phone Cleaner의 편집기에 사진을 넣고 내보냈더니 약 6초 뒤에 실패했습니다. 2026년 10월 15일의 기록입니다. 화면에는 “저장하지 못했어요”만 나왔습니다.&lt;/p&gt;
&lt;p&gt;사진을 몇 초 동안 보여줄지는 이미 지정하고 있었습니다. &lt;code&gt;EditedMediaItem.Builder&lt;/code&gt;에 &lt;code&gt;setDurationUs&lt;/code&gt;와 &lt;code&gt;setFrameRate&lt;/code&gt;를 넣은 상태였습니다.&lt;/p&gt;
&lt;h2 id=&quot;로그가-가리킨-입력-로더&quot;&gt;로그가 가리킨 입력 로더&lt;/h2&gt;
&lt;p&gt;&lt;code&gt;onError&lt;/code&gt;에서 예외를 로그로 남기자 &lt;code&gt;ExportException: Asset loader error&lt;/code&gt;와 함께 오디오나 비디오 트랙이 없다는 원인이 나왔습니다. 입력 이미지의 &lt;code&gt;MediaItem&lt;/code&gt;에 표시 시간을 지정하라는 안내도 있었습니다.&lt;/p&gt;
&lt;p&gt;사진에는 읽어 낼 영상 트랙이 없습니다. 당시 사용한 Media3 경로에서는 &lt;code&gt;MediaItem&lt;/code&gt;에 이미지 표시 시간이 없으면 사진을 이미지 로더로 넘기지 못했습니다. 편집 항목에 적은 전체 길이는 그 앞의 입력 처리 문제를 해결하지 못했습니다.&lt;/p&gt;
&lt;figure&gt;&lt;img src=&quot;/images/android/media3-image-input-path.webp&quot; alt=&quot;사진 입력이 내보내기에 들어가는 길. MediaItem에 이미지 표시 시간이 없으면 입력 로더가 사진을 이미지 로더로 넘기지 못해 Asset loader error로 끝나고, EditedMediaItem의 길이는 그 뒤 단계라 닿지 못한다. 고친 뒤에는 MediaItem에 MIME 타입과 setImageDurationMs를 준다. 아래 두 칸은 setDurationUs(마이크로초)와 setImageDurationMs(밀리초)의 단위 차이&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;figcaption aria-hidden=&quot;true&quot;&gt;사진 입력이 내보내기에 들어가는 길. MediaItem에 이미지 표시 시간이 없으면 입력 로더가 사진을 이미지 로더로 넘기지 못해 Asset loader error로 끝나고, EditedMediaItem의 길이는 그 뒤 단계라 닿지 못한다. 고친 뒤에는 MediaItem에 MIME 타입과 setImageDurationMs를 준다. 아래 두 칸은 setDurationUs(마이크로초)와 setImageDurationMs(밀리초)의 단위 차이&lt;/figcaption&gt;&lt;/figure&gt;
&lt;h2 id=&quot;mediaitem에-이미지-표시-시간-지정하기&quot;&gt;MediaItem에 이미지 표시 시간 지정하기&lt;/h2&gt;
&lt;p&gt;수정은 입력 항목을 만드는 쪽에 들어갔습니다. 흐름을 줄이면 이렇습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;val&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; mediaItem &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; MediaItem.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;Builder&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    .&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;setUri&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(uri)&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    .&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;setMimeType&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(mimeType)&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    .&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;setImageDurationMs&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(durationMs)&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    .&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;build&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;()&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;사진의 MIME 타입과 표시 시간을 &lt;code&gt;MediaItem&lt;/code&gt;에 명시했습니다. &lt;a href=&quot;https://developer.android.com/media/media3/transformer/transformations&quot;&gt;Media3 Transformer 문서&lt;/a&gt;도 이미지 입력의 표시 시간을 &lt;code&gt;MediaItem.Builder.setImageDurationMs&lt;/code&gt;로 지정하고, 프레임 속도는 &lt;code&gt;EditedMediaItem.Builder.setFrameRate&lt;/code&gt;로 설정하는 예를 제공합니다.&lt;/p&gt;
&lt;p&gt;여기에는 단위 차이도 있습니다. &lt;code&gt;setDurationUs&lt;/code&gt;는 마이크로초이고 &lt;code&gt;setImageDurationMs&lt;/code&gt;는 밀리초입니다. 기존 값을 같은 숫자로 옮기는 방식으로 고칠 수는 없었습니다.&lt;/p&gt;
&lt;h2 id=&quot;마치며&quot;&gt;마치며&lt;/h2&gt;
&lt;p&gt;화면에는 짧은 실패 문구를 두고, 로그에는 예외를 남기게 했습니다. “저장하지 못했어요”만으로는 파일을 쓰다가 실패했는지, 입력 사진을 읽기도 전에 실패했는지 알 수 없었습니다. 이번에는 입력을 여는 쪽이었습니다.&lt;/p&gt;
&lt;!-- 근거: vault/TIL/2026-10-15-Media3 recognises a photo only by imageDurationMs.md; Phone Cleaner data/VideoRepository.kt --&gt;</content>
  </entry>
  <entry>
    <title>달력에서 고른 날짜와 저장 시각을 섞었다</title>
    <link href="https://log.twinklelabs.kr/android/date-picker-utc.html" rel="alternate"/>
    <id>https://log.twinklelabs.kr/android/date-picker-utc.html</id>
    <published>2026-10-21T15:10:00.000Z</published>
    <updated>2026-10-21T15:10:00.000Z</updated>
    <author><name>Heejeong Kim</name></author>
    <category term="안드로이드"/>
    <category term="android"/>
    <category term="compose"/>
    <category term="검사"/>
    <summary type="html">이력 필터에 Material DatePicker를 붙이면서 UTC 자정을 기기의 날짜로 읽는 문제를 확인했습니다. 연월일을 옮겨 현지 자정을 만들고 필터 테스트에 시간대를 전달하도록 고쳤습니다.</summary>
    <content type="html">&lt;h2 id=&quot;들어가며&quot;&gt;들어가며&lt;/h2&gt;
&lt;p&gt;물타기 계산기의 이력에 날짜 필터를 넣었습니다. “이번 달”처럼 한 번에 고르는 기간과 시작·종료 날짜를 직접 고르는 기능을 함께 뒀습니다. 2026년 9월 3일에는 직접 그렸던 달력을 Material &lt;code&gt;DatePicker&lt;/code&gt;로 교체했습니다.&lt;/p&gt;
&lt;h2 id=&quot;utc-자정을-현지-시각으로-읽으면&quot;&gt;UTC 자정을 현지 시각으로 읽으면&lt;/h2&gt;
&lt;p&gt;달력에서 받은 값과 기록의 저장 시각은 모두 밀리초 단위의 &lt;code&gt;Long&lt;/code&gt;이었습니다. 타입은 같지만 의미는 달랐습니다. &lt;a href=&quot;https://developer.android.com/reference/kotlin/androidx/compose/material3/DatePickerState&quot;&gt;DatePickerState의 &lt;code&gt;selectedDateMillis&lt;/code&gt;&lt;/a&gt;는 선택한 날짜의 &lt;strong&gt;UTC 자정&lt;/strong&gt;을 나타냅니다.&lt;/p&gt;
&lt;p&gt;9월 1일을 고른 값을 현지 시각으로 바로 읽으면 다음처럼 됩니다. 시간대 차이를 보여주기 위한 예시입니다.&lt;/p&gt;
&lt;div class=&quot;table-wrap&quot;&gt;
















&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;읽는 시간대&lt;/th&gt;&lt;th&gt;UTC 9월 1일 00:00을 현지 시각으로 읽은 값&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;UTC+9&lt;/td&gt;&lt;td&gt;9월 1일 09:00&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;UTC−5&lt;/td&gt;&lt;td&gt;8월 31일 19:00&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;&lt;/div&gt;
&lt;p&gt;서울에서는 같은 날짜가 나왔습니다. UTC보다 느린 시간대에서는 전날이 됩니다. 이 값을 현지 하루의 시작으로 내리면, 사용자가 선택하지 않은 전날 기록까지 필터에 들어올 수 있었습니다.&lt;/p&gt;
&lt;figure&gt;&lt;img src=&quot;/images/android/date-picker-utc-midnight.webp&quot; alt=&quot;UTC 자정인 selectedDateMillis 하나를 세 시간대에서 읽은 그림. 서울에서는 9월 1일 09:00으로 같은 날짜지만, UTC−5에서는 8월 31일 19:00이 되고 그날의 시작으로 내리면 고르지 않은 전날이 된다. 초록 점선은 연월일을 옮겨 만든 현지 자정이다&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;figcaption aria-hidden=&quot;true&quot;&gt;UTC 자정인 selectedDateMillis 하나를 세 시간대에서 읽은 그림. 서울에서는 9월 1일 09:00으로 같은 날짜지만, UTC−5에서는 8월 31일 19:00이 되고 그날의 시작으로 내리면 고르지 않은 전날이 된다. 초록 점선은 연월일을 옮겨 만든 현지 자정이다&lt;/figcaption&gt;&lt;/figure&gt;
&lt;h2 id=&quot;연월일을-옮겨-현지-자정-만들기&quot;&gt;연월일을 옮겨 현지 자정 만들기&lt;/h2&gt;
&lt;p&gt;필요했던 것은 그 순간의 현지 시각이 아니었습니다. 사용자가 고른 연도·월·일이었습니다. UTC 달력에서 세 값을 꺼내고, 같은 숫자로 기기 시간대의 자정을 만들었습니다. 당시 작성한 함수의 핵심입니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;fun&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt; localDayOf&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    utcMidnight: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;Long&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    zone: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;TimeZone&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt; =&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; TimeZone.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;getDefault&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(),&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;): &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;Long&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;    val&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; utc &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; Calendar.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;getInstance&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(TimeZone.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;getTimeZone&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt;&quot;UTC&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;)).&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;apply&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;        timeInMillis &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; utcMidnight&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; Calendar.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;getInstance&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(zone).&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;apply&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;        clear&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt;        set&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(utc.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;get&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(Calendar.YEAR), utc.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;get&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(Calendar.MONTH), utc.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;get&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(Calendar.DAY_OF_MONTH))&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    }.timeInMillis&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;고른 날짜를 읽는 쪽에서 시간대를 지정할 수 있게 했고, 다음 날에는 기록을 거르는 &lt;code&gt;filterHistory&lt;/code&gt;도 시간대를 인자로 받도록 고쳤습니다. 개발 기기의 기본 시간대만으로 테스트하지 않기 위해서였습니다.&lt;/p&gt;
&lt;p&gt;테스트 기대값을 적을 때도 한 번 틀렸습니다. &lt;code&gt;Calendar.MONTH&lt;/code&gt;가 0부터 시작하는데 월을 숫자로 적었습니다. &lt;code&gt;Calendar.FEBRUARY&lt;/code&gt;처럼 이름이 있는 상수로 바꿨습니다.&lt;/p&gt;
&lt;h2 id=&quot;마치며&quot;&gt;마치며&lt;/h2&gt;
&lt;p&gt;당시 컴파일·단위 테스트·린트는 통과했습니다. 다만 Material 달력으로 교체한 뒤의 화면 확인은 그날 일지에 미완료로 남아 있습니다. 시간대 계산을 검사한 결과와 달력을 실제로 눌러 본 결과를 같은 완료 항목으로 묶지는 않았습니다.&lt;/p&gt;
&lt;!-- 근거: vault/products/Stock Calculator/journal/2026-09-03/History-Filter-Drawer.md; 2026-09-04-Stock Calculator.md; core/Days.kt --&gt;</content>
  </entry>
  <entry>
    <title>스키마 파일이 있는데 마이그레이션 테스트가 못 읽었다</title>
    <link href="https://log.twinklelabs.kr/android/room-migration-test-assets.html" rel="alternate"/>
    <id>https://log.twinklelabs.kr/android/room-migration-test-assets.html</id>
    <published>2026-10-21T15:00:00.000Z</published>
    <updated>2026-10-21T15:00:00.000Z</updated>
    <author><name>Heejeong Kim</name></author>
    <category term="안드로이드"/>
    <category term="android"/>
    <category term="room"/>
    <category term="검사"/>
    <summary type="html">Pocket PDF의 JVM 테스트에서 MigrationTestHelper가 스키마 에셋을 찾지 못했습니다. 이전 스키마로 DB를 직접 만들고 실제 마이그레이션과 Room의 최종 검증을 실행하도록 바꿨습니다.</summary>
    <content type="html">&lt;h2 id=&quot;들어가며&quot;&gt;들어가며&lt;/h2&gt;
&lt;p&gt;Pocket PDF에서 폴더를 없앤 뒤에도 옛 보관함 기록은 남아야 했습니다. 2026년 9월 3일, DB 버전 1에서 2로, 2에서 3으로 바뀌는 경로에 테스트를 붙였습니다.&lt;/p&gt;
&lt;h2 id=&quot;스키마가-테스트-에셋에-들어오지-않았습니다&quot;&gt;스키마가 테스트 에셋에 들어오지 않았습니다&lt;/h2&gt;
&lt;p&gt;저장소에는 세 버전의 스키마 JSON이 모두 있었습니다. &lt;code&gt;room-testing&lt;/code&gt; 의존성을 넣고 &lt;code&gt;MigrationTestHelper&lt;/code&gt;를 사용했습니다. 테스트 소스셋의 에셋 경로에도 스키마 폴더를 연결했습니다. 실행 결과는 &lt;code&gt;FileNotFoundException&lt;/code&gt;이었습니다.&lt;/p&gt;
&lt;p&gt;파일이 저장소에 있다는 것과 테스트 프로세스의 에셋으로 들어간다는 것은 달랐습니다. 당시 이 프로젝트의 AGP 9 설정에는 &lt;code&gt;mergeDebugUnitTestAssets&lt;/code&gt; 태스크가 없었습니다. Robolectric의 &lt;code&gt;test_config.properties&lt;/code&gt;를 보니 &lt;code&gt;android_merged_assets&lt;/code&gt;가 앱 본체의 에셋 결과를 가리켰습니다. 헬퍼가 읽는 &lt;code&gt;context.assets.open&lt;/code&gt;까지 테스트용 스키마가 도착하지 않았습니다.&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://developer.android.com/reference/androidx/room/testing/MigrationTestHelper&quot;&gt;MigrationTestHelper 문서&lt;/a&gt;는 내보낸 스키마를 테스트의 기반으로 사용한다고 설명합니다. 이번에 막힌 곳은 마이그레이션 SQL을 실행하는 단계보다 앞선 파일 전달 경로였습니다.&lt;/p&gt;
&lt;h2 id=&quot;옛-db를-만든-뒤-현재-room으로-열기&quot;&gt;옛 DB를 만든 뒤 현재 Room으로 열기&lt;/h2&gt;
&lt;p&gt;계측 테스트로 옮기는 방법도 있었지만, 이 앱에는 아직 그 기반이 없었습니다. 기존 JVM 테스트에서 검사할 수 있도록 이전 DB를 직접 만들기로 했습니다.&lt;/p&gt;
&lt;p&gt;버전 1의 테이블 생성문은 추측해서 쓰지 않았습니다. 내보낸 스키마의 &lt;code&gt;createSql&lt;/code&gt;을 그대로 테스트에 옮겼습니다. 여기에 옛 기록을 넣고 실제 &lt;code&gt;MIGRATION_1_2&lt;/code&gt;, &lt;code&gt;MIGRATION_2_3&lt;/code&gt;을 실행했습니다.&lt;/p&gt;
&lt;p&gt;당시에 추가한 검사는 네 개였습니다.&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;1에서 2로 바꿔도 기록이 남고 폴더 관련 구조가 생기는지&lt;/li&gt;
&lt;li&gt;2에서 3으로 바꾸면 폴더 구조가 없어지고 기록은 남는지&lt;/li&gt;
&lt;li&gt;버전 1 DB를 현재 Room으로 열어 두 마이그레이션을 거친 뒤 DAO로 읽을 수 있는지&lt;/li&gt;
&lt;li&gt;최신 버전의 DAO로 넣고, 읽고, 수정하고, 지울 수 있는지&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;세 번째 검사는 &lt;code&gt;Room.databaseBuilder&lt;/code&gt;에 마이그레이션 둘을 등록해서 실행했습니다. 이전 파일을 현재 Room으로 열면 최종 스키마를 기대 구조와 대조합니다. SQL을 실행했다는 사실뿐 아니라 결과를 Room이 받아들이는지도 확인했습니다.&lt;/p&gt;
&lt;figure&gt;&lt;img src=&quot;/images/android/room-migration-test-paths.webp&quot; alt=&quot;Pocket PDF 마이그레이션 테스트의 두 길. MigrationTestHelper 쪽은 테스트 에셋 병합 태스크가 없어 스키마가 테스트 프로세스에 닿지 못하고 FileNotFoundException으로 끝났다. 바꾼 길은 1.json의 createSql로 버전 1 DB를 만들고 두 마이그레이션을 실행한 뒤 현재 Room으로 열어 최종 스키마를 대조한다&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;figcaption aria-hidden=&quot;true&quot;&gt;Pocket PDF 마이그레이션 테스트의 두 길. MigrationTestHelper 쪽은 테스트 에셋 병합 태스크가 없어 스키마가 테스트 프로세스에 닿지 못하고 FileNotFoundException으로 끝났다. 바꾼 길은 1.json의 createSql로 버전 1 DB를 만들고 두 마이그레이션을 실행한 뒤 현재 Room으로 열어 최종 스키마를 대조한다&lt;/figcaption&gt;&lt;/figure&gt;
&lt;h2 id=&quot;마치며&quot;&gt;마치며&lt;/h2&gt;
&lt;p&gt;사용하지 않게 된 &lt;code&gt;room-testing&lt;/code&gt; 의존성과 에셋 설정은 제거했습니다. 대신 옛 스키마의 생성문을 테스트에 한 벌 보관하는 비용이 생겼습니다. 실제 기기에서의 검증을 대신한다고 보지는 않았습니다. 그날 추가한 것은 JVM에서 옛 기록의 이동과 최종 스키마를 반복해서 확인할 수 있는 경로였습니다.&lt;/p&gt;
&lt;!-- 근거: vault/products/Pocket PDF/journal/2026-09-03/Viewmodel-And-Migration-Tests.md; PocketPdfDatabaseMigrationTest.kt --&gt;</content>
  </entry>
  <entry>
    <title>제목의 자리는 있는데 글자가 없었다</title>
    <link href="https://log.twinklelabs.kr/design-system/empty-font-glyph.html" rel="alternate"/>
    <id>https://log.twinklelabs.kr/design-system/empty-font-glyph.html</id>
    <published>2026-10-21T15:00:00.000Z</published>
    <updated>2026-10-21T15:00:00.000Z</updated>
    <author><name>Heejeong Kim</name></author>
    <category term="디자인 시스템"/>
    <category term="폰트"/>
    <category term="css"/>
    <category term="다국어"/>
    <category term="검사"/>
    <summary type="html">일본어 제목이 빈칸으로 보였지만 DOM과 레이아웃은 정상이었습니다. 사용한 폰트에 폭만 있고 획이 없는 글자가 있어, 적용 문자 범위를 제한했습니다.</summary>
    <content type="html">&lt;h2 id=&quot;들어가며&quot;&gt;들어가며&lt;/h2&gt;
&lt;p&gt;이모티콘 캐릭터 소개 페이지를 일본어로 열었을 때 제목이 비었습니다. 2026년 9월 9일에 확인했습니다. DOM에는 &lt;code&gt;モングルション&lt;/code&gt;이 있었고, 제목 상자의 폭도 438px로 잡혔습니다. 투명도는 1이었고 색과 표시 속성에도 숨기는 설정은 없었습니다.&lt;/p&gt;
&lt;h2 id=&quot;폭만-있고-획이-없는-글리프&quot;&gt;폭만 있고 획이 없는 글리프&lt;/h2&gt;
&lt;p&gt;제목에 사용한 폰트는 Cafe24Ssurround였습니다. 뒤에 다른 폰트도 적어 뒀기 때문에 일본어를 지원하지 않으면 다음 폰트가 그릴 것으로 생각했습니다. 하지만 실제로는 공백이 남았습니다.&lt;/p&gt;
&lt;p&gt;캔버스에 &lt;code&gt;モ&lt;/code&gt; 한 글자를 그려 봤습니다. 이 폰트로 측정한 폭은 89px였지만 찍힌 픽셀은 없었습니다. 같은 검사에서 기본 sans-serif로 그리면 픽셀이 생겼습니다. 그날 페이지에서 쓰는 일본어 제목 88자를 검사했더니 83자가 비어 있었습니다.&lt;/p&gt;
&lt;figure&gt;&lt;img src=&quot;/images/design-system/empty-glyph-unicode-range.webp&quot; alt=&quot;재현: 같은 Cafe24Ssurround 파일을 지금 브라우저에서 다시 그린 것. 왼쪽은 범위를 정하기 전으로 일본어 제목의 자리만 있고 글자가 없다. 오른쪽은 unicode-range로 가나를 뺀 뒤 다음 글꼴이 그린 모습이다&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;figcaption aria-hidden=&quot;true&quot;&gt;재현: 같은 Cafe24Ssurround 파일을 지금 브라우저에서 다시 그린 것. 왼쪽은 범위를 정하기 전으로 일본어 제목의 자리만 있고 글자가 없다. 오른쪽은 unicode-range로 가나를 뺀 뒤 다음 글꼴이 그린 모습이다&lt;/figcaption&gt;&lt;/figure&gt;
&lt;p&gt;폰트에는 해당 문자를 가리키는 항목이 있었습니다. 글자 폭도 있었고요. 다만 획이 없었습니다. 브라우저 입장에서는 다음 폰트에서 찾아야 할 누락 문자로 처리되지 않았습니다. 그래서 레이아웃은 정상인데 읽을 글자가 없는 화면이 됐습니다.&lt;/p&gt;
&lt;h2 id=&quot;폰트-이름을-더-붙여서는-해결되지-않았습니다&quot;&gt;폰트 이름을 더 붙여서는 해결되지 않았습니다&lt;/h2&gt;
&lt;p&gt;&lt;code&gt;@font-face&lt;/code&gt;의 &lt;code&gt;unicode-range&lt;/code&gt;로 이 폰트가 맡는 문자를 제한했습니다. 일본어와 한자는 범위에서 빼고, 뒤의 둥근 고딕 계열 폰트가 맡게 했습니다. &lt;a href=&quot;https://www.w3.org/TR/css3-fonts/#unicode-range-desc&quot;&gt;CSS Fonts 명세&lt;/a&gt;에서 설명하는 유효 문자 범위는 &lt;code&gt;unicode-range&lt;/code&gt;와 폰트 문자 맵의 교집합입니다. 범위 밖으로 뺀 글자는 이 폰트의 빈 글리프에 잡히지 않습니다.&lt;/p&gt;
&lt;p&gt;그렇다고 한글 전체가 안전해진 것은 아니었습니다. 페이지에서 쓰던 한국어 117자와 영어 44자는 검사에서 그려졌지만, 드문 한글 200자를 따로 뽑았을 때는 148자가 비었습니다. &lt;code&gt;«&lt;/code&gt;, &lt;code&gt;»&lt;/code&gt;, &lt;code&gt;—&lt;/code&gt; 같은 문장부호에도 빈 글자가 있었습니다.&lt;/p&gt;
&lt;p&gt;적용 범위에서 일부 문장부호는 제외했지만 한글 범위는 넓게 남겼습니다. 따라서 이 수정은 당시 페이지의 일본어 제목을 복구한 것이고, 앞으로 입력할 모든 한글까지 보장하는 것은 아닙니다. 제목 문구를 바꾸면 그 문구를 다시 그려 봐야 합니다.&lt;/p&gt;
&lt;h2 id=&quot;마치며&quot;&gt;마치며&lt;/h2&gt;
&lt;p&gt;폰트 파일이 로드됐는지와 글자가 실제로 그려졌는지를 따로 보게 된 작업이었습니다. DOM의 글자와 상자 크기가 모두 남아 있어서, 캔버스에 그린 결과를 확인하기 전까지는 빈 글리프를 찾지 못했습니다.&lt;/p&gt;
&lt;!-- 근거: vault/TIL/2026-09-09-A font can own a glyph and still draw nothing.md; Emoticon Studio characters/src/styles.css --&gt;</content>
  </entry>
  <entry>
    <title>도구와 폴더를 줄여도 옛 기록은 남아야 했다</title>
    <link href="https://log.twinklelabs.kr/pocket-pdf/fewer-tools-preserved-records.html" rel="alternate"/>
    <id>https://log.twinklelabs.kr/pocket-pdf/fewer-tools-preserved-records.html</id>
    <published>2026-10-21T15:00:00.000Z</published>
    <updated>2026-10-21T15:00:00.000Z</updated>
    <author><name>Heejeong Kim</name></author>
    <category term="Pocket PDF"/>
    <category term="android"/>
    <category term="pocket-pdf"/>
    <category term="product"/>
    <category term="room"/>
    <summary type="html">Pocket PDF의 도구를 아홉 개에서 여섯 개로 줄이고 보관함 폴더를 없앴습니다. 기능을 지우면서도 기존 파일 기록을 읽을 수 있도록 타입과 DB 마이그레이션을 남겼습니다.</summary>
    <content type="html">&lt;h2 id=&quot;들어가며&quot;&gt;들어가며&lt;/h2&gt;
&lt;p&gt;2026년 8월 31일, Pocket PDF에서 문서 분석, 비밀 PDF 열기, 워터마크를 뺐습니다. 홈에는 문서 스캔, 병합, 분할, 이미지 PDF 변환, 전자 서명, 페이지 편집의 여섯 도구를 남겼습니다.&lt;/p&gt;
&lt;h2 id=&quot;아홉-도구에서-여섯-도구로&quot;&gt;아홉 도구에서 여섯 도구로&lt;/h2&gt;
&lt;p&gt;뺀 기능도 동작은 했습니다. 다만 문서 분석은 기기 지원 여부에 영향을 받았고, 비밀 PDF 열기는 암호를 이미 아는 경우에 쓰는 기능이었습니다. 워터마크는 아직 출시하지 않은 상태였습니다. 홈의 기능 수를 늘리는 대신 남은 문서 작업을 다듬기로 했습니다.&lt;/p&gt;
&lt;figure&gt;&lt;img src=&quot;/images/pocket-pdf/home-tools-before-after.webp&quot; alt=&quot;도구를 줄이기 전(8월 31일)과 뒤(9월 3일)의 홈. 왼쪽에는 «비밀 PDF 열기»와 잠긴 비즈니스 도구가 있고, 오른쪽에는 여섯 도구가 한 목록으로 선다&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;figcaption aria-hidden=&quot;true&quot;&gt;도구를 줄이기 전(8월 31일)과 뒤(9월 3일)의 홈. 왼쪽에는 «비밀 PDF 열기»와 잠긴 비즈니스 도구가 있고, 오른쪽에는 여섯 도구가 한 목록으로 선다&lt;/figcaption&gt;&lt;/figure&gt;
&lt;p&gt;화면과 ViewModel, 코어 처리, 테스트, 열한 언어의 문자열까지 정리했습니다. 그래도 지우지 않은 이름이 하나 있었습니다. &lt;code&gt;ActivityType.UNLOCK&lt;/code&gt;입니다.&lt;/p&gt;
&lt;h2 id=&quot;화면을-지워도-db에는-이름이-남습니다&quot;&gt;화면을 지워도 DB에는 이름이 남습니다&lt;/h2&gt;
&lt;p&gt;이 타입 이름은 Room에 문자열로 저장되어 있었습니다. v1.0.0을 쓰던 테스터의 기록에도 들어 있었습니다. 모르는 타입을 읽으면 변환 코드가 &lt;code&gt;null&lt;/code&gt;을 반환했기 때문에, enum 값을 함께 지우면 예전 기록이 목록에서 빠질 수 있었습니다.&lt;/p&gt;
&lt;p&gt;새로 암호 해제 작업을 시작하는 화면은 없애되, 예전에 만든 기록은 읽을 수 있도록 타입을 남겼습니다. 아직 배포한 적 없는 &lt;code&gt;WATERMARK&lt;/code&gt;는 같이 제거했습니다. 이름이 비슷한 기능이라도 저장된 기록의 유무가 달랐습니다.&lt;/p&gt;
&lt;h2 id=&quot;실제-파일을-옮기지-않던-폴더&quot;&gt;실제 파일을 옮기지 않던 폴더&lt;/h2&gt;
&lt;p&gt;다음 날에는 보관함의 폴더도 없앴습니다. 이 앱은 문서를 사용자가 고른 저장 위치에 저장했습니다. 앱 안의 폴더가 관리하던 것은 실제 파일이 아니라 그 파일을 가리키는 DB 행이었습니다. 앱 안에서 폴더를 옮겨도 기기의 파일 앱에서는 위치가 바뀌지 않았습니다.&lt;/p&gt;
&lt;p&gt;폴더 대신 날짜별로 기록을 묶었습니다. 날짜순으로 볼 때만 묶고, 이름순이나 크기순에서는 사용자가 고른 정렬을 그대로 보여줬습니다. 폴더 칸을 늘리던 보상형 광고도 함께 제거했습니다. 고화질 내보내기에 쓰는 보상형 광고는 남겼습니다.&lt;/p&gt;
&lt;figure&gt;&lt;img src=&quot;/images/pocket-pdf/library-folders-before-after.webp&quot; alt=&quot;폴더가 있던 보관함(8월 31일)과 날짜로 묶은 보관함(9월 3일). 왼쪽 첫 줄의 «잠금 해제» 기록이 지운 기능의 타입을 남겨 둔 이유다&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;figcaption aria-hidden=&quot;true&quot;&gt;폴더가 있던 보관함(8월 31일)과 날짜로 묶은 보관함(9월 3일). 왼쪽 첫 줄의 «잠금 해제» 기록이 지운 기능의 타입을 남겨 둔 이유다&lt;/figcaption&gt;&lt;/figure&gt;
&lt;h2 id=&quot;개발-기기에-있던-버전도-건너뛸-수-없었습니다&quot;&gt;개발 기기에 있던 버전도 건너뛸 수 없었습니다&lt;/h2&gt;
&lt;p&gt;폴더가 들어간 DB 버전 2는 정식으로 나가지 않았지만 개발 기기에는 있었습니다. 폴더를 없앴다고 버전을 1로 되돌리지는 않았습니다. 2에서 3으로 가는 마이그레이션을 만들었습니다.&lt;/p&gt;
&lt;p&gt;폴더 연결 열이 없는 새 테이블을 만들고 기존 기록을 옮긴 뒤, 폴더 테이블을 제거했습니다. 에뮬레이터에서는 버전 2가 있는 앱 위에 새 버전을 설치해 확인했습니다. &lt;code&gt;user_version&lt;/code&gt;은 3이 됐고 &lt;code&gt;folders&lt;/code&gt; 테이블은 없어졌으며, 넣어 둔 기록 한 건은 남았습니다.&lt;/p&gt;
&lt;h2 id=&quot;마치며&quot;&gt;마치며&lt;/h2&gt;
&lt;p&gt;당시 스토어 설명에는 아홉 도구라는 표현이 남아 있었고, 폴더 관련 설명도 추가 확인이 필요했습니다. 코드에서 기능을 없애는 것만으로 출시 준비가 끝난 날은 아니었습니다. 앱 안에서는 옛 기록을 보존하고, 앱 밖에서는 이제 없는 기능을 약속하지 않도록 문구를 맞추는 일이 이어졌습니다.&lt;/p&gt;
&lt;!-- 근거: vault/products/Pocket PDF/journal/2026-08-31/Tool-Pruning-Nine-To-Six.md; journal/2026-09-01/Folders-Removed.md --&gt;</content>
  </entry>
  <entry>
    <title>빌드는 실패했는데 커밋 도우미는 통과시켰습니다</title>
    <link href="https://log.twinklelabs.kr/silent-failures/build-pipeline-exit-code.html" rel="alternate"/>
    <id>https://log.twinklelabs.kr/silent-failures/build-pipeline-exit-code.html</id>
    <published>2026-10-21T15:00:00.000Z</published>
    <updated>2026-10-21T15:00:00.000Z</updated>
    <author><name>Heejeong Kim</name></author>
    <category term="개발 기록"/>
    <category term="자동화"/>
    <category term="검사"/>
    <category term="git"/>
    <summary type="html">빌드 로그를 grep으로 거른 뒤 마지막 명령의 종료값을 읽어 실패한 빌드를 통과시켰습니다. 변경을 되돌려 고치고, zsh의 pipestatus로 빌드 결과를 확인하는 방법을 정리했습니다.</summary>
    <content type="html">&lt;h2 id=&quot;들어가며&quot;&gt;들어가며&lt;/h2&gt;
&lt;p&gt;2026년 10월 15일, Phone Cleaner를 여러 단계로 나눠 리팩토링하고 있었습니다. 각 단계가 끝나면 검사와 빌드를 돌리고 커밋하는 도우미를 썼습니다. 일곱 번째 단계에서 빌드가 깨졌는데도 커밋이 만들어졌습니다.&lt;/p&gt;
&lt;h2 id=&quot;grep의-성공을-빌드-성공으로-읽었습니다&quot;&gt;grep의 성공을 빌드 성공으로 읽었습니다&lt;/h2&gt;
&lt;p&gt;도우미는 빌드를 실행한 뒤, 긴 출력을 줄이려고 뒤에 붙인 &lt;code&gt;grep&lt;/code&gt;의 종료값을 보고 있었습니다.&lt;/p&gt;
&lt;p&gt;별도 파이프 실패 처리가 없는 셸에서는 &lt;code&gt;a | b&lt;/code&gt; 전체의 종료값이 마지막 명령 &lt;code&gt;b&lt;/code&gt;의 결과를 따릅니다. 빌드가 실패해도 &lt;code&gt;grep&lt;/code&gt;이 찾는 줄을 발견하면 &lt;code&gt;grep&lt;/code&gt;은 성공할 수 있습니다. 오류 문장을 잘 찾아낸 결과가 빌드 성공처럼 전달된 셈입니다.&lt;/p&gt;
&lt;h2 id=&quot;gradle의-종료값을-직접-확인하기&quot;&gt;Gradle의 종료값을 직접 확인하기&lt;/h2&gt;
&lt;p&gt;깨진 변경은 되돌린 뒤 다시 고쳤습니다. 도우미가 확인해야 할 값도 일지에 남겼습니다. zsh에서는 &lt;a href=&quot;https://zsh.sourceforge.io/Doc/Release/Parameters.html&quot;&gt;공식 문서의 &lt;code&gt;pipestatus&lt;/code&gt;&lt;/a&gt;에 마지막 파이프라인의 각 명령 종료값이 들어 있습니다.&lt;/p&gt;
&lt;p&gt;아래는 그 검사 방식을 줄여 적은 zsh 예시입니다. 당시 명령을 그대로 복사한 것은 아닙니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;zsh&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;./gradlew&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt; assembleDebug&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt; 2&gt;&amp;#x26;1&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt; |&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt; tee&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt; build.log&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt; |&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt; grep&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#E0AF68&quot;&gt; -E&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt; '&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt;BUILD|error:&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt;'&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#C0CAF5&quot;&gt;build_status&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#89DDFF&quot;&gt;${&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#C0CAF5&quot;&gt;pipestatus&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#89DDFF&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;if&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt; ((&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#C0CAF5&quot;&gt; build_status&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt; !=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#FE640B;--shiki-dark:#FF9E64&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt; ))&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt; then&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#D20F39;--shiki-light-font-style:italic;--shiki-dark:#0DB9D7;--shiki-dark-font-style:inherit&quot;&gt;  exit&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt; &quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#C0CAF5&quot;&gt;$build_status&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;fi&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;첫 번째 명령인 Gradle의 종료값을 파이프라인 직후 저장합니다. 다른 명령을 실행한 뒤에는 &lt;code&gt;pipestatus&lt;/code&gt;가 바뀔 수 있으므로 먼저 보관해야 합니다. &lt;code&gt;tee&lt;/code&gt;는 전체 로그를 남기고 &lt;code&gt;grep&lt;/code&gt;은 화면에 보여줄 줄을 고를 뿐입니다.&lt;/p&gt;
&lt;figure&gt;&lt;img src=&quot;/images/silent-failures/pipestatus-repro.webp&quot; alt=&quot;재현: 종료값 1로 끝나는 가짜 빌드 스크립트를 grep에 파이프로 넘긴 zsh 실행 결과. 파이프 전체의 종료값은 grep의 0이고, 파이프라인 직후 pipestatus의 첫 칸을 저장하면 빌드의 1이 남는다.&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;figcaption aria-hidden=&quot;true&quot;&gt;재현: 종료값 1로 끝나는 가짜 빌드 스크립트를 grep에 파이프로 넘긴 zsh 실행 결과. 파이프 전체의 종료값은 grep의 0이고, 파이프라인 직후 pipestatus의 첫 칸을 저장하면 빌드의 1이 남는다.&lt;/figcaption&gt;&lt;/figure&gt;
&lt;h2 id=&quot;마치며&quot;&gt;마치며&lt;/h2&gt;
&lt;p&gt;그날의 기록에는 여러 변경이 한 커밋에 섞인 문제도 남아 있습니다. 다음 도우미에는 커밋할 파일을 한 단계의 변경으로 좁히고, 빌드 명령이 0을 반환했을 때만 커밋하도록 조건을 두기로 했습니다. 검사는 이미 돌고 있었는데 그 실패를 넘기는 곳에서 놓쳤습니다.&lt;/p&gt;
&lt;!-- 근거: vault/TIL/2026-10-15-A cycle is one commit.md --&gt;</content>
  </entry>
  <entry>
    <title>HTML을 배포했는데 브라우저에 소스가 나왔습니다</title>
    <link href="https://log.twinklelabs.kr/silent-failures/html-served-as-text.html" rel="alternate"/>
    <id>https://log.twinklelabs.kr/silent-failures/html-served-as-text.html</id>
    <published>2026-10-21T15:00:00.000Z</published>
    <updated>2026-10-21T15:00:00.000Z</updated>
    <author><name>Heejeong Kim</name></author>
    <category term="개발 기록"/>
    <category term="웹"/>
    <category term="배포"/>
    <category term="검사"/>
    <summary type="html">모바일 조회 화면을 Supabase에 올렸지만 HTML이 텍스트로 내려왔습니다. HEAD와 GET 응답의 차이를 확인하고 화면 호스팅을 Cloudflare Pages로 옮겼습니다.</summary>
    <content type="html">&lt;h2 id=&quot;들어가며&quot;&gt;들어가며&lt;/h2&gt;
&lt;p&gt;맥 밖에서도 이모티콘 작업 진행 상황을 보고 싶었습니다. 2026년 9월 3일에 휴대폰용 조회 화면을 만들었습니다. 생성이나 변환은 맥에서 하고, 이 화면에서는 로그인해서 시리즈와 원화만 보도록 했습니다.&lt;/p&gt;
&lt;h2 id=&quot;head와-get의-응답이-달랐습니다&quot;&gt;HEAD와 GET의 응답이 달랐습니다&lt;/h2&gt;
&lt;p&gt;처음에는 정적 파일 일곱 개로 시작했습니다. 데이터가 이미 Supabase에 있으니 HTML도 같은 곳에 두면 될 것 같았습니다. Storage에 올려 보고, Edge Function에서도 HTML 응답을 만들어 봤습니다. 브라우저에서는 페이지 대신 태그가 적힌 소스가 나왔습니다.&lt;/p&gt;
&lt;figure&gt;&lt;img src=&quot;/images/silent-failures/viewer-text-plain-vs-html.webp&quot; alt=&quot;재현: 2026-09-03 뷰어의 index.html을 로컬 서버에서 text/plain으로 내려보내면 브라우저가 소스를 글자 그대로 보여 주고(왼쪽), 같은 파일을 text/html로 내려보내면 로그인 화면이 선다(오른쪽). Supabase의 응답을 찍은 것은 아니다.&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;figcaption aria-hidden=&quot;true&quot;&gt;재현: 2026-09-03 뷰어의 index.html을 로컬 서버에서 text/plain으로 내려보내면 브라우저가 소스를 글자 그대로 보여 주고(왼쪽), 같은 파일을 text/html로 내려보내면 로그인 화면이 선다(오른쪽). Supabase의 응답을 찍은 것은 아니다.&lt;/figcaption&gt;&lt;/figure&gt;
&lt;p&gt;걸렸던 것은 응답을 확인하는 방법이었습니다. &lt;code&gt;curl -I&lt;/code&gt;로 헤더만 요청했을 때는 &lt;code&gt;text/html&lt;/code&gt;이 보였습니다. 그런데 실제로 본문을 받는 GET 요청에는 &lt;code&gt;text/plain&lt;/code&gt;이 붙었습니다. 브라우저가 받은 응답을 확인해야 했는데, 다른 요청의 헤더를 보고 HTML로 내려간다고 판단했습니다.&lt;/p&gt;
&lt;p&gt;지금의 &lt;a href=&quot;https://supabase.com/docs/guides/functions/http-methods&quot;&gt;Supabase HTTP 메서드 문서&lt;/a&gt;에도 Edge Functions의 HTML 응답은 지원하지 않으며, GET의 &lt;code&gt;text/html&lt;/code&gt;을 &lt;code&gt;text/plain&lt;/code&gt;으로 바꾼다고 명시되어 있습니다. 함수 안에서 지정한 헤더만으로 브라우저가 받을 형식을 보장할 수 없었습니다.&lt;/p&gt;
&lt;h2 id=&quot;화면을-옮기고-데이터는-그대로-뒀습니다&quot;&gt;화면을 옮기고 데이터는 그대로 뒀습니다&lt;/h2&gt;
&lt;p&gt;HTML은 Cloudflare Pages에 배포하고, 인증과 데이터 조회는 계속 Supabase를 사용하게 했습니다. 시험 삼아 만들었던 Storage 버킷과 함수는 걷었습니다. 배포 스크립트도 파일을 Storage에 올리는 역할에서, 웹 화면이 사용할 설정을 만드는 역할로 바뀌었습니다.&lt;/p&gt;
&lt;h2 id=&quot;마치며&quot;&gt;마치며&lt;/h2&gt;
&lt;p&gt;읽기 전용이라는 말도 범위를 나눠 기록했습니다. 화면에 쓰기 버튼이 없는 것과 데이터 접근 권한이 제한된 것은 별개입니다. 로그아웃 상태에서 조회했을 때 &lt;code&gt;200 []&lt;/code&gt;가 돌아오는 것은 확인했지만, 그것만으로 모든 권한 경로를 검증한 것은 아닙니다. 로그인 후 화면 확인도 당시에는 남아 있었습니다.&lt;/p&gt;
&lt;p&gt;이 작업에서 휴대폰으로 보고 싶었던 것은 원화와 진행 상태였습니다. 그 작은 화면을 띄우기 전에, 브라우저가 HTML을 받는지부터 다시 확인하게 됐습니다.&lt;/p&gt;
&lt;!-- 근거: vault/products/Emoticon Studio/journal/2026-09-03/Read-Only-Viewer.md --&gt;</content>
  </entry>
  <entry>
    <title>공유할 리포트는 따로 그렸다</title>
    <link href="https://log.twinklelabs.kr/stock-calculator/share-report-as-image.html" rel="alternate"/>
    <id>https://log.twinklelabs.kr/stock-calculator/share-report-as-image.html</id>
    <published>2026-10-21T15:00:00.000Z</published>
    <updated>2026-10-21T15:00:00.000Z</updated>
    <author><name>Heejeong Kim</name></author>
    <category term="물타기 계산기"/>
    <category term="android"/>
    <category term="compose"/>
    <category term="공유"/>
    <category term="출시기"/>
    <summary type="html">물타기 계산기의 리포트 공유를 텍스트에서 이미지로 바꿨습니다. 공유 전용 카드를 그리면서 기기 설정과 스크롤 위치를 분리하고, 긴 리포트와 숫자가 잘리는 문제를 고쳤습니다.</summary>
    <content type="html">&lt;h2 id=&quot;들어가며&quot;&gt;들어가며&lt;/h2&gt;
&lt;p&gt;물타기 계산기의 계산 결과는 처음에 텍스트로 공유했습니다. 2026년 8월 29일에는 이미지로 바꿨습니다. 메신저의 미리보기 안에서 결과를 볼 수 있게 하려는 선택이었습니다.&lt;/p&gt;
&lt;h2 id=&quot;화면-밖에-그린-공유-전용-카드&quot;&gt;화면 밖에 그린 공유 전용 카드&lt;/h2&gt;
&lt;p&gt;앱 화면을 그대로 찍지는 않았습니다. 뒤로 가기 화살표와 공유 버튼까지 보낼 필요는 없고, 스크롤을 어디에 두었는지에 따라 잘리는 내용도 달라집니다. 공유 전용 &lt;code&gt;ShareCard&lt;/code&gt;에 종목, 평단가 변화, 투입 금액, 본전까지 필요한 변화를 모았습니다.&lt;/p&gt;
&lt;figure&gt;&lt;img src=&quot;/images/stock-calculator/report-screen.webp&quot; alt=&quot;앱 안의 투자 리포트 화면(라이트·다크). 공유 카드는 이 화면을 찍지 않고 같은 내용을 화면 밖에 따로 그린다&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;figcaption aria-hidden=&quot;true&quot;&gt;앱 안의 투자 리포트 화면(라이트·다크). 공유 카드는 이 화면을 찍지 않고 같은 내용을 화면 밖에 따로 그린다&lt;/figcaption&gt;&lt;/figure&gt;
&lt;p&gt;화면에는 보이지 않는 카드를 한 장 그렸습니다. &lt;code&gt;drawWithContent&lt;/code&gt; 안에서 &lt;code&gt;GraphicsLayer.record&lt;/code&gt;로 그릴 내용을 기록하되 화면에 &lt;code&gt;drawContent()&lt;/code&gt;를 호출하지 않았습니다. 카드를 스크롤 영역 안에 넣으면 보이지 않아도 자리를 차지해서 화면을 밀었습니다. 그래서 화면 위에 겹치는 별도 영역으로 옮겼습니다.&lt;/p&gt;
&lt;p&gt;긴 리포트의 아래쪽이 화면 높이에 맞춰 잘리지 않도록 &lt;code&gt;wrapContentSize(unbounded)&lt;/code&gt;도 필요했습니다. 공유 그림은 화면 한 장보다 길 수 있었습니다.&lt;/p&gt;
&lt;h2 id=&quot;앱의-글자-크기와-이미지의-글자-크기&quot;&gt;앱의 글자 크기와 이미지의 글자 크기&lt;/h2&gt;
&lt;p&gt;공유 카드는 폭 1080px로 만들었습니다. 그리는 영역의 density를 3, fontScale을 1로 고정했습니다. 앱에서 읽는 화면은 사용자의 글자 설정을 따르고, 다른 사람에게 보내는 이미지의 배치만 일정하게 만들었습니다.&lt;/p&gt;
&lt;p&gt;그렇게 별도 카드를 만들고도 숫자가 한 번 잘렸습니다. 굵게 표시한 값이 &lt;code&gt;+161.85…&lt;/code&gt;처럼 나왔습니다. &lt;code&gt;TextAutoSize&lt;/code&gt;로 줄여 보고 &lt;code&gt;softWrap = false&lt;/code&gt;도 줬지만, 그 배치에서는 기대한 축소가 일어나지 않았습니다. 결국 숫자 칸을 64에서 88로 넓혔고, 동작하지 않던 자동 축소 설정은 제거했습니다.&lt;/p&gt;
&lt;h2 id=&quot;공유-파일과-앱으로-돌아올-주소&quot;&gt;공유 파일과 앱으로 돌아올 주소&lt;/h2&gt;
&lt;p&gt;완성한 파일은 캐시의 &lt;code&gt;share/&lt;/code&gt; 아래에 두고 FileProvider로 전달했습니다. 공유할 때마다 새 파일을 쌓지 않도록 같은 이름을 덮어썼습니다. 받는 앱이 읽을 수 있게 인텐트에 읽기 권한을 넣고, 공유 선택 창에도 같은 권한을 전달했습니다.&lt;/p&gt;
&lt;p&gt;카드 위에는 앱 아이콘과 이름, &lt;code&gt;twinklelabs.kr&lt;/code&gt;을 넣었습니다. 이날 기록에는 QR을 넣을지가 미정으로 남아 있는데, 이후 추가한 &lt;a href=&quot;/android/app-links-qr.html&quot;&gt;공유 QR과 App Links 작업&lt;/a&gt;은 별도 글에 적었습니다.&lt;/p&gt;
&lt;h2 id=&quot;마치며&quot;&gt;마치며&lt;/h2&gt;
&lt;p&gt;다크 테마로 만든 그림을 밝은 대화창에 보냈을 때의 대비는 당시 확인하지 못했습니다. 리포트를 이미지로 만드는 작업과, 그 이미지가 실제 대화창에서 읽기 좋은지는 확인할 화면이 달랐습니다.&lt;/p&gt;
&lt;!-- 근거: vault/products/Stock Calculator/journal/2026-08-29/Share-As-Image.md --&gt;</content>
  </entry>
  <entry>
    <title>스토어 설명을 앱이 하는 만큼으로</title>
    <link href="https://log.twinklelabs.kr/stock-calculator/aso-and-landing-page-independence.html" rel="alternate"/>
    <id>https://log.twinklelabs.kr/stock-calculator/aso-and-landing-page-independence.html</id>
    <published>2026-09-10T15:10:00.000Z</published>
    <updated>2026-09-10T15:10:00.000Z</updated>
    <author><name>Heejeong Kim</name></author>
    <category term="물타기 계산기"/>
    <category term="android"/>
    <category term="출시기"/>
    <category term="개인개발"/>
    <category term="product"/>
    <category term="aso"/>
    <category term="design-system"/>
    <summary type="html">소개 페이지를 손보고 스토어 설명에 주식·코인과 이미지 공유를 넣었습니다. 글자 수 검사를 통과한 문구에도 실제 앱과 다른 설명이 남아 있어, 11개 언어를 다시 검수했습니다.</summary>
    <content type="html">&lt;h2 id=&quot;들어가며&quot;&gt;들어가며&lt;/h2&gt;
&lt;p&gt;9월 11일, 웹의 물타기 계산기 소개 상태를 &lt;code&gt;testing&lt;/code&gt;에서 &lt;code&gt;live&lt;/code&gt;로 바꾸고 Play 스토어 링크를 열었습니다. 그에 맞춰 소개 페이지와 스토어 문구도 손봤습니다.&lt;/p&gt;
&lt;p&gt;코인과 해외 주식 계산, 이미지 공유를 설명에 넣고 11개 언어의 길이를 검사했습니다. 앱이 하는 일을 더 잘 소개하려던 수정이었는데, 화면과 나란히 읽으니 하지 않는 일까지 적어 놓은 문장이 보였습니다.&lt;/p&gt;
&lt;h2 id=&quot;제목과-짧은-설명에-담은-것&quot;&gt;제목과 짧은 설명에 담은 것&lt;/h2&gt;
&lt;p&gt;국내 주식만 계산할 수 있는 앱처럼 읽히지 않도록 제목에 코인을 추가했습니다. 짧은 설명에는 계산 결과를 이미지로 공유하는 기능을 넣었습니다. 첫 수정에서 바뀐 한국어 문구는 다음과 같습니다.&lt;/p&gt;
&lt;div class=&quot;table-wrap&quot;&gt;



















&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;항목&lt;/th&gt;&lt;th&gt;수정 전&lt;/th&gt;&lt;th&gt;수정 후&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;제목&lt;/td&gt;&lt;td&gt;물타기 계산기 : 평단가 계산&lt;/td&gt;&lt;td&gt;물타기 계산기 - 주식, 코인 평단가&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;짧은 설명&lt;/td&gt;&lt;td&gt;평단가·물타기·목표 평단가를 한 화면에서. 기록으로 남기고 종목별로 모아 보세요.&lt;/td&gt;&lt;td&gt;주식, 코인 물타기와 목표 평단가 역산을 한 화면에서. 투자 리포트를 이미지로 공유하세요.&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;&lt;/div&gt;
&lt;p&gt;Python 스크립트로 11개 로케일의 &lt;code&gt;title.txt&lt;/code&gt;, &lt;code&gt;short-description.txt&lt;/code&gt;, &lt;code&gt;full-description.txt&lt;/code&gt;를 수정했습니다. 긴 설명에는 가상화폐, 암호화폐, 해외 주식이라는 표현과 이미지 공유 기능을 더했습니다. 사용 범위를 검색에 쓰일 말로 적는 ASO(App Store Optimization) 작업이었습니다.&lt;/p&gt;
&lt;figure&gt;&lt;img src=&quot;/images/stock-calculator/play-listing.webp&quot; alt=&quot;지금의 Play 등록정보(한국어). 제목에 «주식·코인 평단가 계산기»가 들어가 있다&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;figcaption aria-hidden=&quot;true&quot;&gt;지금의 Play 등록정보(한국어). 제목에 «주식·코인 평단가 계산기»가 들어가 있다&lt;/figcaption&gt;&lt;/figure&gt;
&lt;h2 id=&quot;글자-수-검사가-잡지-못한-문장&quot;&gt;글자 수 검사가 잡지 못한 문장&lt;/h2&gt;
&lt;p&gt;첫 수정본은 글자 수 검사를 통과했습니다. 하지만 한국어 긴 설명에 쓴 “이미지로 저장하여”는 앱 동작과 달랐습니다. 앱의 리포트 공유는 시스템 공유 창을 여는 기능이었습니다. 파일을 저장하는 기능으로 소개할 수는 없어서 “이미지로 만들어 … 공유할 수 있습니다”로 바꿨습니다.&lt;/p&gt;
&lt;p&gt;“가상화폐(코인) 단위도 지원합니다”도 더 구체적으로 고쳤습니다.&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;종목마다 통화와 수량 단위(주·BTC·g)를 따로 정할 수 있습니다.&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;이 문장이 앱이 실제로 제공하는 설정을 설명합니다. 코인 지원이라는 말만으로는 통화와 수량 단위를 어떻게 다루는지 알기 어려웠습니다.&lt;/p&gt;
&lt;p&gt;다른 언어에서도 범위가 넓어진 표현을 걷었습니다. 광고와 정책 페이지에 인터넷이 필요한데 “100% 오프라인”이라고 쓴 문장, 계산 기록을 종목별로 묶을 뿐인데 “포트폴리오 관리”라고 소개한 문장이 있었습니다. 독일어는 앱이 &lt;code&gt;du&lt;/code&gt;로 말하는데 스토어 문구는 &lt;code&gt;Sie&lt;/code&gt;로 바뀌어, 앱의 말투에 맞춰 다시 썼습니다.&lt;/p&gt;
&lt;p&gt;제목 최대 30자, 짧은 설명 최대 80자라는 제한은 다음 검사로 확인했습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;plaintext&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span&gt;./gradlew testDebugUnitTest --tests &quot;*StoreListingTest*&quot;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;추가 검수 중 이탈리아어 짧은 설명이 81자로 늘어났을 때는 이 검사가 잡아줬습니다. ‘저장’이라고 잘못 쓴 문장은 길이가 맞아 통과했습니다.&lt;/p&gt;
&lt;h2 id=&quot;소개-페이지에는-별도-스타일을&quot;&gt;소개 페이지에는 별도 스타일을&lt;/h2&gt;
&lt;p&gt;&lt;code&gt;/app/stock-calculator&lt;/code&gt;는 Aurora Ledger의 공통 배경과 목록 스타일을 쓰고 있었습니다. 이번에는 &lt;code&gt;door.module.css&lt;/code&gt;에 Midnight/Glass 다크 테마를 따로 구성했습니다. 히어로 제목에 화면 폭에 맞춰 크기가 달라지는 &lt;code&gt;clamp&lt;/code&gt;를 적용하고, 뒤에 앱 색상의 후광을 넣었습니다. 기능 목록은 설명 영역을 나눌 수 있는 2단 카드로 바꿨습니다.&lt;/p&gt;
&lt;figure&gt;&lt;img src=&quot;/images/stock-calculator/landing-page.webp&quot; alt=&quot;지금의 소개 페이지 twinklelabs.kr/app/stock-calculator. 앱 정보 아래로 스토어와 같은 스크린샷이 선다&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;figcaption aria-hidden=&quot;true&quot;&gt;지금의 소개 페이지 twinklelabs.kr/app/stock-calculator. 앱 정보 아래로 스토어와 같은 스크린샷이 선다&lt;/figcaption&gt;&lt;/figure&gt;
&lt;p&gt;스크린샷 데이터도 &lt;code&gt;{ src, type: &quot;phone&quot; | &quot;wide&quot; }&lt;/code&gt; 형태로 나눠, 폰과 넓은 화면에 서로 다른 폭을 줄 수 있게 했습니다. 가로로 넘길 때 화면별로 멈추는 스냅 영역도 만들었습니다.&lt;/p&gt;
&lt;p&gt;&lt;code&gt;wide&lt;/code&gt; 항목에는 우선 폰의 &lt;code&gt;07-dark.png&lt;/code&gt;를 넣어 뒀습니다. 레이아웃만 준비한 상태였고, 실제 폴더블 다크 화면을 찍어 교체하는 일은 TODO로 남았습니다.&lt;/p&gt;
&lt;h2 id=&quot;마치며&quot;&gt;마치며&lt;/h2&gt;
&lt;p&gt;소개 문구는 앱에서 확인할 수 있는 동작에 맞췄습니다. 글자 수 제한을 지키는 검사와 실제 기능을 설명하는지 읽는 검수는 각각 필요했습니다.&lt;/p&gt;
&lt;p&gt;스토어 문구는 올린 뒤 다시 내려받았습니다. 11개 로케일의 제목·짧은 설명·긴 설명, 총 33개 텍스트가 저장소와 일치하는 데까지 확인했습니다.&lt;/p&gt;</content>
  </entry>
  <entry>
    <title>검색되는 PDF의 글자층에서 한글이 지워지고 있었습니다</title>
    <link href="https://log.twinklelabs.kr/pocket-pdf/searchable-pdf-ocr-layer.html" rel="alternate"/>
    <id>https://log.twinklelabs.kr/pocket-pdf/searchable-pdf-ocr-layer.html</id>
    <published>2026-09-02T13:10:00.000Z</published>
    <updated>2026-09-02T13:10:00.000Z</updated>
    <author><name>Heejeong Kim</name></author>
    <category term="Pocket PDF"/>
    <category term="android"/>
    <category term="pocket-pdf"/>
    <category term="OCR"/>
    <category term="PDF"/>
    <category term="폰트"/>
    <category term="Pretendard"/>
    <summary type="html">스캔과 이미지 변환이 따로 계산하던 OCR 글자층을 하나로 모으다가, 한글을 공백으로 바꾸는 조건을 찾았습니다. Pretendard를 PDFBox가 읽는 TrueType으로 바꿔 넣고, 생성한 PDF에서 한글 문장을 다시 읽었습니다.</summary>
    <content type="html">&lt;h2 id=&quot;들어가며&quot;&gt;들어가며&lt;/h2&gt;
&lt;p&gt;물타기 계산기를 Play 테스트 트랙에 올린 뒤 Pocket PDF를 만들기 시작했습니다. 카메라로 찍거나 불러온 문서를 PDF로 묶고, 사진 속 글자도 검색하고 복사할 수 있게 하는 앱입니다.&lt;/p&gt;
&lt;p&gt;검색되는 PDF는 사진 위에 OCR이 읽은 글자를 보이지 않게 얹어서 만듭니다. 사진은 그대로 보이고, PDF 안에는 선택하거나 검색할 문자열이 들어갑니다. 이 글자층을 스캔과 이미지 변환이 함께 쓰도록 옮기다가, 한국어 검색이 처음부터 되지 않았다는 것을 알게 됐습니다.&lt;/p&gt;
&lt;h2 id=&quot;두-경로의-좌표-계산을-하나로&quot;&gt;두 경로의 좌표 계산을 하나로&lt;/h2&gt;
&lt;p&gt;스캔본은 PDF 페이지를 가득 채웁니다. 이미지 변환에서는 사진을 여백 안에 가운데 배치합니다. 그림의 위치와 크기는 달라도, OCR이 읽은 글자를 그림의 같은 자리에 놓는 계산은 같습니다. 그런데 그 계산이 스캔 쪽 &lt;code&gt;SearchablePdfBuilder&lt;/code&gt; 안에만 있었습니다.&lt;/p&gt;
&lt;figure&gt;&lt;img src=&quot;/images/pocket-pdf/scan-and-image-paths.webp&quot; alt=&quot;글자층을 얹는 두 경로. 왼쪽은 문서 스캔으로 인식한 단락, 오른쪽은 «페이지 여백 추가»가 있는 이미지 → PDF 변환이다. 두 경로 모두 같은 InvisibleTextLayer를 쓴다&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;figcaption aria-hidden=&quot;true&quot;&gt;글자층을 얹는 두 경로. 왼쪽은 문서 스캔으로 인식한 단락, 오른쪽은 «페이지 여백 추가»가 있는 이미지 → PDF 변환이다. 두 경로 모두 같은 InvisibleTextLayer를 쓴다&lt;/figcaption&gt;&lt;/figure&gt;
&lt;p&gt;ML Kit에서 받은 문자열과 바운딩 박스는 이미지의 픽셀 좌표를 씁니다. 이를 PDF의 포인트 좌표로 바꾸고, 위에서부터 재는 이미지 좌표를 아래에서부터 재는 PDF 좌표에 맞춥니다. 이 계산을 &lt;code&gt;InvisibleTextLayer&lt;/code&gt;로 꺼냈습니다.&lt;/p&gt;
&lt;p&gt;이미지를 페이지 어디에 얼마나 크게 놓을지는 각 변환기가 정하고, &lt;code&gt;InvisibleTextLayer&lt;/code&gt;에는 그 위치와 크기만 넘깁니다. 글자는 &lt;code&gt;RenderingMode.NEITHER&lt;/code&gt;로 적어 화면에는 그리지 않습니다.&lt;/p&gt;
&lt;h2 id=&quot;옮기다-읽은-조건-하나&quot;&gt;옮기다 읽은 조건 하나&lt;/h2&gt;
&lt;p&gt;코드를 옮기면서 &lt;code&gt;sanitize&lt;/code&gt; 함수를 다시 읽다가 다음 조건을 발견했습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;ch.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;isLetterOrDigit&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BB9AF7&quot;&gt;||&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; ch.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;isWhitespace&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;-&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    sb.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;append&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;if&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; (ch.code &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BB9AF7&quot;&gt;&amp;#x3C;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#FE640B;--shiki-dark:#FF9E64&quot;&gt; 256&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;) ch &lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;else&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt; ' '&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;)&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;문자나 숫자를 처리하는 분기에서 코드값이 256 이상이면 공백을 넣고 있었습니다. 한글 음절은 U+AC00(44032)부터 시작합니다. 한국어 인식기가 한글을 읽어도, PDF에 넣기 전에 모두 공백이 되는 코드였습니다.&lt;/p&gt;
&lt;p&gt;원인은 폰트였습니다. 글자층에 쓰던 &lt;code&gt;PDType1Font.HELVETICA&lt;/code&gt;는 별도 파일 없이 쓸 수 있는 표준 폰트지만 한글을 담지 못합니다. 그 폰트가 처리하지 못하는 문자를 &lt;code&gt;sanitize&lt;/code&gt;가 지우고 있었습니다. 원본 사진이 그대로 보이니 눈으로 PDF를 읽을 때는 아무 문제가 없었고, 그래서 아무도 몰랐습니다.&lt;/p&gt;
&lt;p&gt;홈 화면은 «찍은 문서가 검색되는 깨끗한 새 문서로»라고 안내하고 있었습니다. 이 글자층으로는 그 안내대로 한국어 검색을 제공할 수 없었습니다.&lt;/p&gt;
&lt;h2 id=&quot;pretendard를-truetype으로-바꿔-넣기&quot;&gt;Pretendard를 TrueType으로 바꿔 넣기&lt;/h2&gt;
&lt;p&gt;조건만 고쳐서 한글을 남기면 끝나는 문제가 아니었습니다. 남긴 글자를 PDF에 적으려면 한글 글리프를 가진 폰트가 필요했습니다.&lt;/p&gt;
&lt;p&gt;앱은 이미 SIL Open Font License로 배포되는 Pretendard를 쓰고 있었습니다. 다만 저장소의 파일은 CFF 윤곽선을 담은 OTF였고, 당시 PDFBox의 &lt;code&gt;PDType0Font&lt;/code&gt;에 넣는 경로는 TrueType의 &lt;code&gt;glyf&lt;/code&gt;가 필요했습니다. &lt;code&gt;tools/bake-ocr-font.py&lt;/code&gt;에서 필요한 글자만 남긴 뒤 CFF 곡선을 TrueType 곡선으로 옮겼습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;python&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt;# tools/bake-ocr-font.py 중 윤곽선 변환 부분&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;pen &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-dark:#7AA2F7&quot;&gt; TTGlyphPen&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;--shiki-light:#FE640B;--shiki-dark:#FF9E64&quot;&gt;None&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#E64553;--shiki-light-font-style:italic;--shiki-dark:#A9B1D6;--shiki-dark-font-style:inherit&quot;&gt;glyph_set&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;--shiki-light:#E64553;--shiki-light-font-style:italic;--shiki-dark:#A9B1D6;--shiki-dark-font-style:inherit&quot;&gt;name&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-dark:#7AA2F7&quot;&gt;draw&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-dark:#7AA2F7&quot;&gt;    Cu2QuPen&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#C0CAF5&quot;&gt;pen&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#FF9E64&quot;&gt; CURVE_TOLERANCE&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;--shiki-light:#E64553;--shiki-light-font-style:italic;--shiki-dark:#E0AF68;--shiki-dark-font-style:inherit&quot;&gt; reverse_direction&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#FE640B;--shiki-dark:#FF9E64&quot;&gt;True&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#E64553;--shiki-light-font-style:italic;--shiki-dark:#A9B1D6;--shiki-dark-font-style:inherit&quot;&gt;glyphs&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;--shiki-light:#E64553;--shiki-light-font-style:italic;--shiki-dark:#A9B1D6;--shiki-dark-font-style:inherit&quot;&gt;name&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt; =&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; pen&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-dark:#7AA2F7&quot;&gt;glyph&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt;()&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;글자 범위는 앱이 쓰는 인식기(&lt;code&gt;KoreanTextRecognizerOptions&lt;/code&gt;)가 읽는 문자를 기준으로 정했습니다. 한글 음절 11,172자에 기본 라틴·라틴-1·라틴 확장-A, 통화 기호, 문장부호, 호환 자모, 전각 문자를 더해 11,721자, 2.14MB가 됐습니다. 일본어·중국어 문서를 지원하려면 글리프만 더해서는 안 되고 인식기도 추가해야 합니다.&lt;/p&gt;
&lt;h2 id=&quot;폰트와-문자-치환을-함께-바꿨습니다&quot;&gt;폰트와 문자 치환을 함께 바꿨습니다&lt;/h2&gt;
&lt;p&gt;&lt;code&gt;InvisibleTextLayer&lt;/code&gt;는 새 폰트를 문서마다 한 번 읽습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;fun&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt; loadFont&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(context: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;, document: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;PDDocument&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;): &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;PDFont&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt; =&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;    try&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;        context.assets.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;open&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(ASSET).&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;use&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;            PDType0Font.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;load&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(document, it, &lt;/span&gt;&lt;span style=&quot;--shiki-light:#FE640B;--shiki-dark:#FF9E64&quot;&gt;true&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    } &lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;catch&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; (_: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;Exception&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;        PDType1Font.HELVETICA&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;마지막 &lt;code&gt;true&lt;/code&gt;는 PDF에 사용한 글자만 포함하는 옵션입니다. 앱에 넣는 폰트는 2.14MB여도 문서마다 전체 파일을 복제하지는 않습니다.&lt;/p&gt;
&lt;p&gt;기존의 문자 치환은 표준 폰트로 돌아간 경우에만 실행하도록 묶었습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;val&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; latinOnly &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; font &lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;is&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; PDType1Font&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;val&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; sanitized &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt; if&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; (latinOnly) &lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;sanitizeToLatin&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(text) &lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;else&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; text.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;trim&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;()&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;새 폰트를 넣어도 이전 &lt;code&gt;sanitize&lt;/code&gt;를 그대로 부르면 한글은 다시 공백이 됩니다. 폰트를 바꾼 만큼 이 분기도 바꿔야 했습니다.&lt;/p&gt;
&lt;h2 id=&quot;생성한-pdf에서-문장을-다시-읽었습니다&quot;&gt;생성한 PDF에서 문장을 다시 읽었습니다&lt;/h2&gt;
&lt;p&gt;&lt;code&gt;pdfbox-android&lt;/code&gt;를 JVM에서 실행해 폰트 로딩, PDF 생성, 텍스트 추출을 확인했습니다. &lt;code&gt;android.util.Log&lt;/code&gt;는 스텁을 두고 CMap 자원은 클래스패스에 올렸습니다. 확인에 쓴 문장은 다음과 같습니다.&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;계약서 임대차 보증금 ₩1,850,000 café&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;생성한 PDF는 약 4KB였고, &lt;code&gt;/ToUnicode&lt;/code&gt; 매핑으로 되읽은 문장도 입력과 같았습니다. 한글뿐 아니라 원화 기호, 숫자, 악센트가 있는 라틴 문자까지 되찾았습니다.&lt;/p&gt;
&lt;h2 id=&quot;마치며&quot;&gt;마치며&lt;/h2&gt;
&lt;p&gt;두 경로를 하나로 모아 둔 덕분에 한글 처리도 한 곳에서 고칠 수 있었습니다. 각 변환기에는 페이지 안에서 사진의 자리를 정하는 일만 남았습니다.&lt;/p&gt;
&lt;p&gt;여기까지는 JVM에서 확인한 것입니다. 실제 기기로 한국어 영수증을 찍고 뷰어에서 검색하는 시험과, 폰트를 못 읽었을 때 Helvetica로 돌아가는 경로를 실제로 통과시키는 시험은 당시 후속 작업으로 남겼습니다.&lt;/p&gt;</content>
  </entry>
  <entry>
    <title>광고 위 여백을 만든 두 겹의 Scaffold</title>
    <link href="https://log.twinklelabs.kr/android/two-scaffolds-bug.html" rel="alternate"/>
    <id>https://log.twinklelabs.kr/android/two-scaffolds-bug.html</id>
    <published>2026-09-02T12:40:00.000Z</published>
    <updated>2026-09-02T12:40:00.000Z</updated>
    <author><name>Heejeong Kim</name></author>
    <category term="안드로이드"/>
    <category term="안드로이드"/>
    <category term="Compose"/>
    <category term="Scaffold"/>
    <category term="인셋"/>
    <category term="UI버그"/>
    <summary type="html">설정 화면의 마지막 줄과 광고 사이에 48dp가 비어 있었습니다. 안쪽 Scaffold의 중복 시스템 인셋을 끄자 의도한 여백 24dp만 남았습니다.</summary>
    <content type="html">&lt;h2 id=&quot;들어가며&quot;&gt;들어가며&lt;/h2&gt;
&lt;p&gt;Pocket PDF의 설정 화면을 끝까지 내려도 마지막 줄과 광고 사이에 빈 띠가 남았습니다. 간격은 48dp였습니다. 광고 높이가 잘못 잡힌 것인지 확인하려고 먼저 광고 컨테이너를 쟀습니다.&lt;/p&gt;
&lt;p&gt;Compose의 &lt;code&gt;Box&lt;/code&gt;, &lt;code&gt;AndroidView&lt;/code&gt; 안의 &lt;code&gt;FrameLayout&lt;/code&gt;, &lt;code&gt;AdView&lt;/code&gt;가 모두 &lt;code&gt;1078 × 168 px&lt;/code&gt;이었습니다. 세 뷰의 크기는 1픽셀도 다르지 않았습니다. 광고 뷰가 자리를 더 차지한 것은 아니었습니다.&lt;/p&gt;
&lt;h2 id=&quot;광고-위의-여백은-어디서-왔나&quot;&gt;광고 위의 여백은 어디서 왔나&lt;/h2&gt;
&lt;p&gt;홈·보관함·설정 화면은 &lt;code&gt;MainActivity&lt;/code&gt;의 &lt;code&gt;Scaffold&lt;/code&gt; 안에 있었습니다. 바깥 &lt;code&gt;Scaffold&lt;/code&gt;는 광고와 탭을 담은 하단 바, 시스템 인셋을 반영해 &lt;code&gt;paddingValues&lt;/code&gt;를 내려보냈습니다.&lt;/p&gt;
&lt;p&gt;안쪽 화면도 자체 &lt;code&gt;Scaffold&lt;/code&gt;를 사용했습니다. 그런데 바깥에서 받은 공간을 적용한 뒤에도 안쪽 &lt;code&gt;Scaffold&lt;/code&gt;가 기본 시스템 인셋을 다시 더하고 있었습니다. 설정 화면의 48dp는 의도한 여백 24dp에 하단 인셋 24dp가 겹친 값이었습니다.&lt;/p&gt;
&lt;p&gt;광고 안의 빈 공간은 별개였습니다. 당시 테스트 광고는 320 × 50 크기여서 64dp 높이의 광고 칸을 채우지 않았습니다. 그 안에 남은 11dp와, 설정의 마지막 줄 아래에 추가된 24dp를 구분해야 했습니다.&lt;/p&gt;
&lt;figure&gt;&lt;img src=&quot;/images/android/two-scaffolds-inset-gap.webp&quot; alt=&quot;재현: 설정 화면 맨 아래를 세로 간격만 dp에 비례하게 다시 그린 그림. 고치기 전에는 의도한 여백 24dp 위에 안쪽 Scaffold가 더한 하단 인셋 24dp가 겹쳐 48dp였고, 고친 뒤에는 24dp만 남는다. 광고 칸 64dp 안의 빈 자리는 별개다&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;figcaption aria-hidden=&quot;true&quot;&gt;재현: 설정 화면 맨 아래를 세로 간격만 dp에 비례하게 다시 그린 그림. 고치기 전에는 의도한 여백 24dp 위에 안쪽 Scaffold가 더한 하단 인셋 24dp가 겹쳐 48dp였고, 고친 뒤에는 24dp만 남는다. 광고 칸 64dp 안의 빈 자리는 별개다&lt;/figcaption&gt;&lt;/figure&gt;
&lt;h2 id=&quot;안쪽-scaffold의-시스템-인셋을-껐습니다&quot;&gt;안쪽 Scaffold의 시스템 인셋을 껐습니다&lt;/h2&gt;
&lt;p&gt;홈·보관함·설정의 &lt;code&gt;Scaffold&lt;/code&gt;에 다음 설정을 추가했습니다. 바깥에서 이미 처리한 시스템 인셋을 안쪽에서 다시 적용하지 않도록 한 것입니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;Scaffold&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt;    // topBar와 containerColor 등 기존 설정은 유지&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    contentWindowInsets &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt; WindowInsets&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;--shiki-light:#FE640B;--shiki-dark:#FF9E64&quot;&gt;0&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;--shiki-light:#FE640B;--shiki-dark:#FF9E64&quot;&gt;0&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;--shiki-light:#FE640B;--shiki-dark:#FF9E64&quot;&gt;0&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;--shiki-light:#FE640B;--shiki-dark:#FF9E64&quot;&gt;0&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;) { paddingValues &lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;-&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt;    // 화면 콘텐츠&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;각 화면의 상단 바는 그대로 두고 싶었으므로 안쪽 &lt;code&gt;Scaffold&lt;/code&gt;는 남겼습니다. 시스템 인셋만 바깥에서 한 번 처리하게 했습니다.&lt;/p&gt;
&lt;p&gt;수정한 뒤 에뮬레이터에서 설정 화면을 다시 쟀습니다. 마지막 줄과 광고 사이가 48dp에서 24dp로 줄었습니다. 남은 24dp는 화면에서 의도한 여백이어서 그대로 뒀습니다.&lt;/p&gt;
&lt;h2 id=&quot;빈-화면의-가운데-정렬도-따로-확인했습니다&quot;&gt;빈 화면의 가운데 정렬도 따로 확인했습니다&lt;/h2&gt;
&lt;p&gt;보관함의 빈 상태가 위로 치우친 데에도 중복 인셋이 영향을 주고 있었습니다. 다만 인셋을 고치는 것만으로 정렬 문제가 모두 끝나지는 않았습니다.&lt;/p&gt;
&lt;p&gt;보관함은 빈 상태를 &lt;code&gt;LazyColumn&lt;/code&gt;의 첫 항목으로 넣어 위에서부터 쌓고 있었습니다. 분할 화면은 세로 스크롤 안에서 &lt;code&gt;weight&lt;/code&gt;와 &lt;code&gt;Arrangement.Center&lt;/code&gt;로 가운데를 잡으려 했습니다. 스크롤 영역은 높이의 제약이 달라 같은 방식이 통하지 않았습니다.&lt;/p&gt;
&lt;p&gt;두 화면의 빈 상태를 목록·스크롤 밖으로 꺼내고, 남은 공간을 채우는 &lt;code&gt;Box&lt;/code&gt; 안에 가운데 정렬했습니다.&lt;/p&gt;
&lt;h2 id=&quot;마치며&quot;&gt;마치며&lt;/h2&gt;
&lt;p&gt;중복 인셋을 끄자 설정 화면의 간격은 48dp에서 의도한 24dp로 줄었습니다. 빈 상태의 정렬은 목록과 스크롤 밖에서 따로 고쳤습니다. 처음에 재 봤던 광고 뷰의 크기는 바꾸지 않았습니다.&lt;/p&gt;</content>
  </entry>
  <entry>
    <title>Gradle 액션의 캐시와 이용 조건을 확인하고 v5에 남았습니다</title>
    <link href="https://log.twinklelabs.kr/silent-failures/version-bump-terms.html" rel="alternate"/>
    <id>https://log.twinklelabs.kr/silent-failures/version-bump-terms.html</id>
    <published>2026-09-02T12:10:00.000Z</published>
    <updated>2026-09-02T12:10:00.000Z</updated>
    <author><name>Heejeong Kim</name></author>
    <category term="개발 기록"/>
    <category term="라이선스"/>
    <category term="의존성"/>
    <category term="GitHub Actions"/>
    <category term="보안"/>
    <category term="오픈소스"/>
    <summary type="html">setup-gradle v6의 기본 캐시는 별도 상용 구성요소를 사용했습니다. v5를 유지한 당시 판단과, v6.1에서 선택할 수 있는 MIT 기본 캐시를 구분해 적었습니다.</summary>
    <content type="html">&lt;h2 id=&quot;들어가며&quot;&gt;들어가며&lt;/h2&gt;
&lt;p&gt;두 앱의 &lt;code&gt;release.yml&lt;/code&gt;을 업데이트하면서 &lt;code&gt;gradle/actions/setup-gradle&lt;/code&gt;은 v5에 남겨뒀습니다. v6에서 기본으로 쓰는 캐시 구현과 이용 조건이 바뀌어 있었습니다.&lt;/p&gt;
&lt;h2 id=&quot;기본-캐시-구현이-달라졌습니다&quot;&gt;기본 캐시 구현이 달라졌습니다&lt;/h2&gt;
&lt;p&gt;검토한 v6 계열의 &lt;code&gt;action.yml&lt;/code&gt;에는 &lt;code&gt;cache-provider&lt;/code&gt; 입력이 있었고 기본값은 &lt;code&gt;enhanced&lt;/code&gt;였습니다. &lt;a href=&quot;https://github.com/gradle/actions/blob/v6.1.0/setup-gradle/action.yml&quot;&gt;v6.1.0의 입력 정의&lt;/a&gt;를 보면 선택지를 확인할 수 있습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;yaml&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-dark:#F7768E&quot;&gt;cache-provider&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-dark:#F7768E&quot;&gt;  default&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt; '&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt;enhanced&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt;'&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;code&gt;enhanced&lt;/code&gt;는 &lt;code&gt;gradle-actions-caching&lt;/code&gt;이라는 상용 구성요소를 사용합니다. &lt;code&gt;basic&lt;/code&gt;은 GitHub Actions 캐시를 이용하는 공개 구현입니다. 기존 워크플로에서 옵션을 더하지 않고 버전만 올리면 기본값을 사용하게 되므로, 어느 쪽을 쓸지 확인할 필요가 있었습니다.&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://github.com/gradle/actions/releases/tag/v6.0.0&quot;&gt;v6.0.0 릴리스 노트&lt;/a&gt;는 캐시 기능을 별도 구성요소로 분리했으며 해당 구성요소에 별도의 이용 조건이 적용된다고 설명합니다. 액션이 빌드와 호환되는지뿐 아니라, 기본 설정으로 무엇이 실행되는지도 달라진 것입니다.&lt;/p&gt;
&lt;h2 id=&quot;v6에는-mit-캐시를-고르는-방법도-있습니다&quot;&gt;v6에는 MIT 캐시를 고르는 방법도 있습니다&lt;/h2&gt;
&lt;p&gt;처음 기록을 남길 때는 v6.0 릴리스 요약의 ‘업그레이드하면 이용약관을 받아들인다’는 설명을 보고 보수적으로 판단했습니다. 다만 v6을 쓰는 모든 경우에 같은 조건이 적용되는 것은 아니어서, 이 부분은 구분해서 적어 둡니다.&lt;/p&gt;
&lt;figure&gt;&lt;img src=&quot;/images/silent-failures/setup-gradle-v5-diff.webp&quot; alt=&quot;2026-08-27 물타기 계산기 release.yml에서 setup-gradle을 v4에서 v5로 올린 커밋. v6 앞에서 멈춘 이유를 당시의 보수적인 판단 그대로 주석에 남겼다.&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;figcaption aria-hidden=&quot;true&quot;&gt;2026-08-27 물타기 계산기 release.yml에서 setup-gradle을 v4에서 v5로 올린 커밋. v6 앞에서 멈춘 이유를 당시의 보수적인 판단 그대로 주석에 남겼다.&lt;/figcaption&gt;&lt;/figure&gt;
&lt;p&gt;&lt;a href=&quot;https://github.com/gradle/actions/blob/v6.1.0/DISTRIBUTION.md&quot;&gt;v6.1.0 배포 문서&lt;/a&gt;는 액션 본체와 Basic Caching은 MIT이고, Enhanced Caching은 별도 라이선스라고 구분합니다. 독점 구성요소와 그 이용 조건을 선택하지 않으려면 다음 설정을 사용할 수 있다고 명시합니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;yaml&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-dark:#F7768E&quot;&gt; uses&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt; gradle/actions/setup-gradle@v6&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-dark:#F7768E&quot;&gt;  with&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-dark:#F7768E&quot;&gt;    cache-provider&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt; basic&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;이 설정에서는 상용 캐시 구성요소를 불러오거나 사용하지 않습니다. 따라서 v5 유지는 가능한 선택 중 하나였고, v6의 기본 캐시를 사용하는 방법도 검토 대상에 남습니다.&lt;/p&gt;
&lt;h2 id=&quot;마치며&quot;&gt;마치며&lt;/h2&gt;
&lt;p&gt;당시 CI는 약 13분이 걸렸고, 빌드 시간이 당장 해결해야 할 문제는 아니었습니다. v6을 적용해 성능 차이를 측정하지도 않았습니다. 약관과 기본값을 살펴본 뒤, 확인하지 않은 속도 개선을 위해 실행 환경을 바꾸기보다는 두 앱의 &lt;code&gt;setup-gradle&lt;/code&gt;을 v5.x에 두기로 했습니다.&lt;/p&gt;
&lt;figure&gt;&lt;img src=&quot;/images/silent-failures/setup-gradle-run17-steps.webp&quot; alt=&quot;판올림 뒤 처음 돈 물타기 계산기 release.yml 실행 17번(2026-08-27)의 단계별 시간. setup-gradle@v5로 돌았고 전체 13분 19초가 걸렸다.&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;figcaption aria-hidden=&quot;true&quot;&gt;판올림 뒤 처음 돈 물타기 계산기 release.yml 실행 17번(2026-08-27)의 단계별 시간. setup-gradle@v5로 돌았고 전체 13분 19초가 걸렸다.&lt;/figcaption&gt;&lt;/figure&gt;
&lt;p&gt;v6의 &lt;code&gt;basic&lt;/code&gt; 설정은 다음 업데이트에서 검토할 선택지로 남았습니다.&lt;/p&gt;</content>
  </entry>
  <entry>
    <title>앱 아이콘의 검은 모서리와 크기를 맞추기까지</title>
    <link href="https://log.twinklelabs.kr/android/app-icon-baking.html" rel="alternate"/>
    <id>https://log.twinklelabs.kr/android/app-icon-baking.html</id>
    <published>2026-09-02T11:30:00.000Z</published>
    <updated>2026-09-02T11:30:00.000Z</updated>
    <author><name>Heejeong Kim</name></author>
    <category term="안드로이드"/>
    <category term="앱 아이콘"/>
    <category term="적응형 아이콘"/>
    <category term="런처"/>
    <category term="디자인"/>
    <category term="Android"/>
    <summary type="html">둥근 타일 이미지를 적응형 아이콘으로 옮기며 검은 모서리, 배경 이음매, 크기 문제를 겪었습니다. 가장자리 픽셀을 복제하고 그림 크기를 측정하는 방식으로 바꿔 변환 스크립트를 저장소에 남겼습니다.</summary>
    <content type="html">&lt;h2 id=&quot;들어가며&quot;&gt;들어가며&lt;/h2&gt;
&lt;p&gt;앱 아이콘 원본은 검정 배경 위에 보라색 둥근 타일을 얹은 PNG였습니다. 그대로 안드로이드 런처에 넣자 타일 모서리에 검은 부분이 남았습니다. 검은 부분을 잘라 내면 그림이 커졌고, 배경을 다시 만들면 이음매가 보였습니다. 모서리를 정리한 뒤에도 아이콘 크기를 다시 맞춰야 했습니다.&lt;/p&gt;
&lt;h2 id=&quot;원본에도-둥근-모서리가-있었습니다&quot;&gt;원본에도 둥근 모서리가 있었습니다&lt;/h2&gt;
&lt;p&gt;안드로이드 8부터 사용하는 적응형 아이콘은 108dp 크기의 앞면과 뒷면으로 이루어집니다. 앱은 두 이미지를 제공하고, 런처는 원이나 스퀴클, 둥근 사각형 등 기기에 맞는 마스크를 씌웁니다.&lt;/p&gt;
&lt;p&gt;108dp 중 마스크가 남기는 가운데 영역은 72dp입니다. 바깥쪽은 패럴랙스 같은 효과에 쓰이는 여유 공간이라 잘릴 수 있습니다. 받은 원본은 이미 모서리가 둥글게 처리되어 있었으므로, 런처의 마스크와 원본의 모양을 함께 고려해야 했습니다.&lt;/p&gt;
&lt;h2 id=&quot;잘라낸-만큼-그림이-커졌습니다&quot;&gt;잘라낸 만큼 그림이 커졌습니다&lt;/h2&gt;
&lt;p&gt;원본의 검은 구석을 그대로 두면 런처 마스크와 타일의 둥근 모서리가 겹쳤습니다. 두 경계 사이에는 검은 초승달 모양이 남았습니다.&lt;/p&gt;
&lt;p&gt;처음에는 사방을 타일 반지름만큼 잘라냈습니다. 검은 구석은 없어졌지만 남은 이미지를 다시 전체 크기로 늘리면서 그림까지 확대됐습니다. 사방에서 6.5%를 자르면 그림은 약 15% 커집니다. 원래 안전 구역에 들어 있던 부분이 바깥으로 밀려났습니다.&lt;/p&gt;
&lt;h2 id=&quot;원본의-모서리와-그라데이션을-재현하려던-시도&quot;&gt;원본의 모서리와 그라데이션을 재현하려던 시도&lt;/h2&gt;
&lt;p&gt;두 번째로는 원본을 둥근 사각형으로 자르고 그 아래에 배경 그라데이션을 깔았습니다. 그러나 원본의 모서리는 원호로 만든 둥근 사각형과 달랐습니다.&lt;/p&gt;
&lt;p&gt;실제 픽셀을 재니 맨 윗줄(y=0)의 검은 구간은 80px이었습니다. 원호라면 y=40에서 검은 구간이 11px로 줄어야 하는데, 원본에서는 17px이었습니다. 원본은 원호보다 바깥으로 부푼 스퀴클(squircle) 형태였고, 두 곡선 사이에 검은 부분이 남았습니다.&lt;/p&gt;
&lt;figure&gt;&lt;img src=&quot;/images/android/app-icon-corner-measure.webp&quot; alt=&quot;받은 원본 PNG의 왼쪽 위 구석을 7배로 키우고 잰 값을 겹친 그림. 맨 윗줄의 검은 구간은 80px이고, y=40에서는 반지름 80px 원호라면 11px이어야 할 검은 구간이 실제로는 17px이다&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;figcaption aria-hidden=&quot;true&quot;&gt;받은 원본 PNG의 왼쪽 위 구석을 7배로 키우고 잰 값을 겹친 그림. 맨 윗줄의 검은 구간은 80px이고, y=40에서는 반지름 80px 원호라면 11px이어야 할 검은 구간이 실제로는 17px이다&lt;/figcaption&gt;&lt;/figure&gt;
&lt;p&gt;배경색도 예상과 달랐습니다. 단순한 세로 그라데이션으로 생각했지만 위쪽 한가운데는 &lt;code&gt;#AE7CEA&lt;/code&gt;, 왼쪽 위 구석은 &lt;code&gt;#9968E7&lt;/code&gt;이었습니다. 새로 깐 배경이 구석에서 더 밝아 타일 경계가 윤곽선처럼 드러났습니다.&lt;/p&gt;
&lt;h2 id=&quot;잘라-낸-자리에-가장자리-픽셀-복제하기&quot;&gt;잘라 낸 자리에 가장자리 픽셀 복제하기&lt;/h2&gt;
&lt;p&gt;모서리의 곡선과 배경색을 재현하는 대신, 사방을 반지름+2px만큼 잘라내고 그만큼 가장자리 픽셀을 복제해 채웠습니다. 이미지 도구의 &lt;code&gt;extendWith: &quot;copy&quot;&lt;/code&gt;를 사용했습니다.&lt;/p&gt;
&lt;p&gt;잘라낸 이미지를 확대하지 않으므로 그림의 위치와 크기는 유지됩니다. 채우는 색도 원본 가장자리에서 가져오므로 별도의 배경색을 추정할 필요가 없어졌습니다. 이 방식으로 검은 모서리와 배경의 이음매를 처리했습니다.&lt;/p&gt;
&lt;figure&gt;&lt;img src=&quot;/images/android/app-icon-edge-copy.webp&quot; alt=&quot;받은 원본(왼쪽)과, 사방을 반지름+2px만큼 걷어 내고 가장자리 픽셀을 복제해 메운 512px 아이콘(오른쪽). 검은 구석만 사라지고 그림의 자리와 크기는 같다&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;figcaption aria-hidden=&quot;true&quot;&gt;받은 원본(왼쪽)과, 사방을 반지름+2px만큼 걷어 내고 가장자리 픽셀을 복제해 메운 512px 아이콘(오른쪽). 검은 구석만 사라지고 그림의 자리와 크기는 같다&lt;/figcaption&gt;&lt;/figure&gt;
&lt;h2 id=&quot;38dp는-작고-66dp는-컸습니다&quot;&gt;38dp는 작고, 66dp는 컸습니다&lt;/h2&gt;
&lt;p&gt;모서리를 정리한 뒤에는 타일을 72dp로 줄였습니다. 108dp 중 보이는 영역에 타일 전체를 넣으려는 선택이었습니다. 하지만 원본에서 그림이 차지하는 비율은 53%였으므로 실제 그림은 38dp에 불과했습니다. 런처에서는 다른 아이콘보다 작고 흐릿하게 보였습니다.&lt;/p&gt;
&lt;p&gt;다음에는 그림의 밝은 화소가 차지하는 최대 반지름을 쟀습니다. 어떤 마스크에서도 남는 지름 66dp 원, 즉 키라인 원에 맞춰 타일 크기를 역산했습니다.&lt;/p&gt;
&lt;p&gt;66dp에 맞추니 이번에는 너무 컸습니다. 잘리지는 않았지만 그림이 마스크 가장자리에 닿았고, 옆 아이콘보다 부풀어 보였습니다.&lt;/p&gt;
&lt;p&gt;최종 그림 크기는 54dp로 정했습니다. 108dp 판의 절반이며, 보이는 72dp 원 안에서는 사방에 9dp가 남습니다. 처음의 38dp보다 크게 보이면서도 가장자리에 여백을 둘 수 있었습니다.&lt;/p&gt;
&lt;figure&gt;&lt;img src=&quot;/images/android/app-icon-keyline-sizes.webp&quot; alt=&quot;재현: 같은 원본을 그림 지름 38dp, 66dp, 54dp로 맞춰 72dp 원형 마스크 안에 놓은 모습. 38dp는 작고, 66dp는 키라인 원에 닿고, 54dp는 사방에 9dp가 남는다&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;figcaption aria-hidden=&quot;true&quot;&gt;재현: 같은 원본을 그림 지름 38dp, 66dp, 54dp로 맞춰 72dp 원형 마스크 안에 놓은 모습. 38dp는 작고, 66dp는 키라인 원에 닿고, 54dp는 사방에 9dp가 남는다&lt;/figcaption&gt;&lt;/figure&gt;
&lt;h2 id=&quot;원본이-바뀌어도-다시-만들-수-있게&quot;&gt;원본이 바뀌어도 다시 만들 수 있게&lt;/h2&gt;
&lt;p&gt;원본이 바뀌면 이 크기 조정을 다시 해야 합니다. 변환 과정은 다음 명령으로 실행할 수 있게 남겼습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;plaintext&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span&gt;node brand/app-icon.mjs&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;이 명령은 원본의 맨 윗줄에서 검은 구간을 세어 반지름을 다시 구합니다. 뒷면 색도 정해 둔 브랜드색 대신 원본 로고의 끝 색을 측정해 사용합니다. 앞면이 불투명하면 뒷면은 런처가 앞면을 움직일 때 드러나므로, 그때 보이는 색을 원본과 맞췄습니다.&lt;/p&gt;
&lt;h2 id=&quot;마치며&quot;&gt;마치며&lt;/h2&gt;
&lt;p&gt;사실 처음 작업한 날의 스크립트는 저장하지 못했습니다. 나중에 리소스 주석이 가리키는 파일을 찾다가 없다는 걸 알았습니다. 이번에는 결과 이미지와 함께 스크립트도 저장소에 넣었습니다.&lt;/p&gt;</content>
  </entry>
  <entry>
    <title>공유 QR을 스토어 주소에서 App Links로 바꾸기</title>
    <link href="https://log.twinklelabs.kr/android/app-links-qr.html" rel="alternate"/>
    <id>https://log.twinklelabs.kr/android/app-links-qr.html</id>
    <published>2026-09-02T10:00:00.000Z</published>
    <updated>2026-09-02T10:00:00.000Z</updated>
    <author><name>Heejeong Kim</name></author>
    <category term="안드로이드"/>
    <category term="딥링크"/>
    <category term="App Links"/>
    <category term="QR"/>
    <category term="공유"/>
    <category term="Android"/>
    <summary type="html">공유 QR에 스토어 주소가 들어 있어 앱을 설치한 사람도 스토어를 거쳐야 했습니다. QR을 자체 도메인으로 바꾸고 앱의 경로 선언, 도메인 검증, 웹의 스토어 이동을 연결했습니다.</summary>
    <content type="html">&lt;h2 id=&quot;들어가며&quot;&gt;들어가며&lt;/h2&gt;
&lt;p&gt;물타기 계산기를 이미 설치한 기기에서 공유 그림의 QR을 찍었는데 Play 스토어가 열렸습니다. 앱에 들어가려면 ‘열기’를 한 번 더 눌러야 했습니다. QR에 스토어 주소를 직접 넣어 둔 탓이었습니다.&lt;/p&gt;
&lt;p&gt;앱이 있으면 바로 열고, 없으면 웹을 거쳐 스토어로 보내도록 바꿨습니다. QR 주소뿐 아니라 앱의 매니페스트와 도메인의 검증 파일도 함께 준비해야 했습니다.&lt;/p&gt;
&lt;h2 id=&quot;설치-여부와-관계없이-열리는-주소&quot;&gt;설치 여부와 관계없이 열리는 주소&lt;/h2&gt;
&lt;p&gt;&lt;code&gt;mycalc://open&lt;/code&gt; 같은 커스텀 스킴도 생각할 수 있지만, 앱이 없는 기기에서는 열 곳이 없습니다. 공유 그림은 앱을 설치하지 않은 사람도 보므로 HTTPS 주소를 쓰는 App Links로 연결했습니다.&lt;/p&gt;
&lt;p&gt;QR에는 &lt;code&gt;https://twinklelabs.kr/app/stock-calculator&lt;/code&gt;를 넣었습니다. 앱이 받을 주소를 매니페스트에 선언하고, 그 앱이 우리 도메인의 링크를 받아도 되는지 도메인 쪽에서 검증하게 했습니다.&lt;/p&gt;
&lt;figure&gt;&lt;img src=&quot;/images/android/app-links-qr-flow.webp&quot; alt=&quot;공유 그림의 QR이 담은 주소 하나가 기기에 따라 갈리는 길. 앱이 있으면 설치 때 assetlinks.json 검증을 거쳐 앱이 바로 열리고, 없으면 웹 페이지가 열려 utm_source=share를 붙여 Play 스토어로 보낸다&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;figcaption aria-hidden=&quot;true&quot;&gt;공유 그림의 QR이 담은 주소 하나가 기기에 따라 갈리는 길. 앱이 있으면 설치 때 assetlinks.json 검증을 거쳐 앱이 바로 열리고, 없으면 웹 페이지가 열려 utm_source=share를 붙여 Play 스토어로 보낸다&lt;/figcaption&gt;&lt;/figure&gt;
&lt;h2 id=&quot;앱이-받을-호스트와-경로&quot;&gt;앱이 받을 호스트와 경로&lt;/h2&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;xml&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BA3C97&quot;&gt;&amp;#x3C;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-dark:#F7768E&quot;&gt;intent-filter&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-dark:#BB9AF7&quot;&gt; android&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-dark:#BB9AF7&quot;&gt;autoVerify&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#DE5971&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt;true&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BA3C97&quot;&gt;&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BA3C97&quot;&gt;    &amp;#x3C;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-dark:#F7768E&quot;&gt;action&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-dark:#BB9AF7&quot;&gt; android&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-dark:#BB9AF7&quot;&gt;name&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#DE5971&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt;android.intent.action.VIEW&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BA3C97&quot;&gt; /&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BA3C97&quot;&gt;    &amp;#x3C;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-dark:#F7768E&quot;&gt;category&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-dark:#BB9AF7&quot;&gt; android&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-dark:#BB9AF7&quot;&gt;name&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#DE5971&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt;android.intent.category.DEFAULT&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BA3C97&quot;&gt; /&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BA3C97&quot;&gt;    &amp;#x3C;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-dark:#F7768E&quot;&gt;category&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-dark:#BB9AF7&quot;&gt; android&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-dark:#BB9AF7&quot;&gt;name&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#DE5971&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt;android.intent.category.BROWSABLE&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BA3C97&quot;&gt; /&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BA3C97&quot;&gt;    &amp;#x3C;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-dark:#F7768E&quot;&gt;data&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-dark:#BB9AF7&quot;&gt;        android&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-dark:#BB9AF7&quot;&gt;scheme&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#DE5971&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt;https&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-dark:#BB9AF7&quot;&gt;        android&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-dark:#BB9AF7&quot;&gt;host&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#DE5971&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt;twinklelabs.kr&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-dark:#BB9AF7&quot;&gt;        android&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-dark:#BB9AF7&quot;&gt;pathPrefix&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#DE5971&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt;/app/stock-calculator&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BA3C97&quot;&gt; /&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BA3C97&quot;&gt;&amp;#x3C;/&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-dark:#F7768E&quot;&gt;intent-filter&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BA3C97&quot;&gt;&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;code&gt;autoVerify=&quot;true&quot;&lt;/code&gt;를 지정하면 OS가 설치 시점에 도메인의 검증 정보를 확인합니다. 검증이 통과해야 해당 주소를 앱으로 연결할 수 있습니다.&lt;/p&gt;
&lt;p&gt;주소 범위는 &lt;code&gt;pathPrefix&lt;/code&gt;로 &lt;code&gt;/app/stock-calculator&lt;/code&gt;에 한정했습니다. 도메인만 지정하면 같은 호스트의 다른 웹 페이지까지 앱이 받게 됩니다. 앱으로 연결할 페이지와 웹에서 읽을 페이지를 구분해야 했습니다.&lt;/p&gt;
&lt;h2 id=&quot;도메인이-확인해-줄-앱-서명-키&quot;&gt;도메인이 확인해 줄 앱 서명 키&lt;/h2&gt;
&lt;p&gt;검증 파일은 도메인 루트의 정해진 주소에 둡니다. 사용한 주소는 &lt;code&gt;https://twinklelabs.kr/.well-known/assetlinks.json&lt;/code&gt;입니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;json&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt;[{&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;  &quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-dark:#7AA2F7&quot;&gt;relation&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt; [&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt;delegate_permission/common.handle_all_urls&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;  &quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-dark:#7AA2F7&quot;&gt;target&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-dark:#0DB9D7&quot;&gt;namespace&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt; &quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt;android_app&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-dark:#0DB9D7&quot;&gt;package_name&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt; &quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt;kr.twinklelabs.stockcalculator&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-dark:#0DB9D7&quot;&gt;sha256_cert_fingerprints&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt; [&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt;8E:CB:…:03&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt;]&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt;  }&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt;}]&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;이 파일은 패키지 이름과 서명 인증서 지문으로 연결할 앱을 특정합니다. 이때 업로드 키와 앱 서명 키를 구분해야 했습니다.&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;업로드 키는 개발자가 번들을 올릴 때 사용하는 키입니다.&lt;/li&gt;
&lt;li&gt;앱 서명 키는 Play가 사용자에게 배포할 APK에 사용하는 키입니다.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Play 앱 서명을 사용하면 사용자 기기의 APK는 앱 서명 키로 서명됩니다. 따라서 &lt;code&gt;assetlinks.json&lt;/code&gt;에도 이 지문이 필요합니다. Play Console의 ‘앱 무결성 → 앱 서명’에서 제공하는 assetlinks 스니펫을 확인했습니다. 업로드 키로 서명한 사이드로드 빌드도 연결하려면 그 지문을 배열에 함께 넣을 수 있습니다.&lt;/p&gt;
&lt;h2 id=&quot;앱이-없을-때는-웹에서-스토어로&quot;&gt;앱이 없을 때는 웹에서 스토어로&lt;/h2&gt;
&lt;p&gt;&lt;code&gt;https://twinklelabs.kr/app/stock-calculator&lt;/code&gt;는 브라우저에서도 열리는 페이지여야 합니다. 앱이 없는 기기에서는 이 페이지가 요청을 받습니다.&lt;/p&gt;
&lt;p&gt;페이지는 스토어로 이동시키면서 &lt;code&gt;utm_source=share&lt;/code&gt; 같은 유입 경로 값을 붙입니다. QR에는 짧은 주소만 담고, 스토어로 전달할 집계 정보는 웹에서 덧붙이도록 나눴습니다.&lt;/p&gt;
&lt;figure&gt;&lt;img src=&quot;/images/android/app-links-web-fallback.webp&quot; alt=&quot;앱이 없는 기기에서 QR 주소를 열면 받는 웹 페이지의 지금 모습(2026-11 캡처). «Google Play에서 설치» 링크에는 referrer로 utm_source=share가 붙어 있다&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;figcaption aria-hidden=&quot;true&quot;&gt;앱이 없는 기기에서 QR 주소를 열면 받는 웹 페이지의 지금 모습(2026-11 캡처). «Google Play에서 설치» 링크에는 referrer로 utm_source=share가 붙어 있다&lt;/figcaption&gt;&lt;/figure&gt;
&lt;h2 id=&quot;계산-결과를-url에서-뺀-이유&quot;&gt;계산 결과를 URL에서 뺀 이유&lt;/h2&gt;
&lt;p&gt;처음 주소는 &lt;code&gt;/stock-calculator/app&lt;/code&gt;이었습니다. 같은 날 Pocket PDF의 &lt;code&gt;/app/pocket-pdf&lt;/code&gt;와 형식을 맞추면서 &lt;code&gt;/app/stock-calculator&lt;/code&gt;로 옮겼습니다.&lt;/p&gt;
&lt;p&gt;링크에는 앱으로 들어오는 데 필요한 주소만 남겼습니다. 처음에는 계산 값을 쿼리에 넣고 받는 기기에서 리포트를 다시 구성하는 화면까지 만들었지만 제거했습니다. 공유 그림 구석의 작은 QR은 한 칸 4px, 주소 약 106바이트라는 크기 제약이 있었습니다. 종목 이름을 포함한 링크는 그 범위에 들어가지 않았습니다.&lt;/p&gt;
&lt;p&gt;계산 결과는 이미 공유 그림에 표시되어 있습니다. 리포트를 링크에 다시 담기보다 QR이 안정적으로 읽히는 쪽을 선택했습니다. 주소의 역할이 바뀌었으므로 이름도 &lt;code&gt;share_store_url&lt;/code&gt;에서 &lt;code&gt;share_app_url&lt;/code&gt;로 바꿨습니다.&lt;/p&gt;
&lt;h2 id=&quot;마치며&quot;&gt;마치며&lt;/h2&gt;
&lt;p&gt;앱 코드를 머지한 것만으로는 검증이 끝나지 않습니다. &lt;code&gt;.well-known/assetlinks.json&lt;/code&gt;이 실제 도메인에서 제공되어야 설치 시점 검증이 통과합니다. 당시 웹은 main에 푸시할 때 배포되므로, 웹 배포 전에는 앱 코드가 준비되어 있어도 링크가 브라우저로 열렸습니다.&lt;/p&gt;
&lt;p&gt;기기에서 검증 상태는 다음 명령으로 확인합니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;bash&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;adb&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt; shell&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt; pm&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt; get-app-links&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt; kr.twinklelabs.stockcalculator&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;이 결과의 &lt;code&gt;verified&lt;/code&gt;가 앱 코드와 도메인 설정이 실제로 연결됐는지 확인할 기준입니다.&lt;/p&gt;</content>
  </entry>
  <entry>
    <title>로컬 업로드와 CI가 다른 버전 코드를 썼습니다</title>
    <link href="https://log.twinklelabs.kr/silent-failures/two-counters-one-number.html" rel="alternate"/>
    <id>https://log.twinklelabs.kr/silent-failures/two-counters-one-number.html</id>
    <published>2026-08-26T02:20:00.000Z</published>
    <updated>2026-08-26T02:20:00.000Z</updated>
    <author><name>Heejeong Kim</name></author>
    <category term="개발 기록"/>
    <category term="출시"/>
    <category term="자동화"/>
    <category term="CI"/>
    <category term="버전"/>
    <summary type="html">물타기 계산기 출시 중 버전 코드를 8 → 14 → 20으로 올려야 했습니다. 로컬과 CI의 계산 차이를 찾고, 실제 번들과 다른 숫자를 출력하던 로그도 고쳤습니다.</summary>
    <content type="html">&lt;h2 id=&quot;들어가며&quot;&gt;들어가며&lt;/h2&gt;
&lt;p&gt;물타기 계산기 v1.0.5를 출시하던 새벽에 번호를 올리는 커밋이 세 개 생겼습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;plaintext&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span&gt;0948ce4  chore: release v1.0.5&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;088c36b  fix: bump version code to 14 due to previous versions&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;6358847  fix: bump version code to 20 to surpass CI generated codes&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;Play 콘솔이 이미 쓴 번호라며 번들을 거절할 때마다 8 → 14 → 20으로 올렸습니다. 어디까지 사용했는지 모른 채 번호부터 바꾼 셈입니다. 낮에 다시 살펴보니 로컬과 CI의 계산식이 달랐습니다.&lt;/p&gt;
&lt;h2 id=&quot;ci에서-더하던-값이-로컬에는-없었습니다&quot;&gt;CI에서 더하던 값이 로컬에는 없었습니다&lt;/h2&gt;
&lt;p&gt;앱의 &lt;code&gt;versionCode&lt;/code&gt; 계산은 다음과 같았습니다. 상수 &lt;code&gt;20&lt;/code&gt;은 그날 여러 차례 번호를 올린 뒤의 값입니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;val&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; lastManualVersionCode &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#FE640B;--shiki-dark:#FF9E64&quot;&gt; 20&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;versionCode &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; System.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;getenv&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt;&quot;GITHUB_RUN_NUMBER&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;)?.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;toIntOrNull&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    ?.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;plus&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(lastManualVersionCode) ?: lastManualVersionCode&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;GitHub Actions에서는 실행 번호인 &lt;code&gt;GITHUB_RUN_NUMBER&lt;/code&gt;를 상수에 더합니다. 로컬에는 이 환경 변수가 없으므로 상수만 사용합니다.&lt;/p&gt;
&lt;p&gt;그날 새벽에는 &lt;code&gt;main&lt;/code&gt;을 통한 CI 대신 로컬에서 &lt;code&gt;publishReleaseBundle&lt;/code&gt;을 실행했습니다. CI가 이미 8부터 19까지 사용한 상태에서 로컬은 8을 제시했습니다. 같은 앱을 올리는 두 경로가 마지막으로 사용한 번호를 공유하지 못한 것입니다.&lt;/p&gt;
&lt;figure&gt;&lt;img src=&quot;/images/silent-failures/version-code-two-counters.webp&quot; alt=&quot;CI와 로컬이 versionCode를 따로 센 모습을 다시 그린 그림. CI가 실행 번호에 7을 더해 8부터 19까지 쓴 뒤, 상수만 쓰는 로컬 업로드는 8과 14에서 거절되고 20에서 올라갔다. 이후 CI 실행 13번은 13 + 20 = 33이 됐다.&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;figcaption aria-hidden=&quot;true&quot;&gt;CI와 로컬이 versionCode를 따로 센 모습을 다시 그린 그림. CI가 실행 번호에 7을 더해 8부터 19까지 쓴 뒤, 상수만 쓰는 로컬 업로드는 8과 14에서 거절되고 20에서 올라갔다. 이후 CI 실행 13번은 13 + 20 = 33이 됐다.&lt;/figcaption&gt;&lt;/figure&gt;
&lt;p&gt;당시에는 계산식을 유지하고 출시를 &lt;code&gt;main&lt;/code&gt;의 CI로 통일했습니다. 로컬 업로드까지 쓰려면 양쪽에서 사용한 번호를 맞추는 절차가 더 필요했습니다.&lt;/p&gt;
&lt;h2 id=&quot;로그는-실제-번들보다-13-작은-숫자를-출력했습니다&quot;&gt;로그는 실제 번들보다 13 작은 숫자를 출력했습니다&lt;/h2&gt;
&lt;p&gt;마지막 번호를 확인하는 데 쓸 로그도 맞지 않았습니다. 워크플로에는 다음 줄이 남아 있었습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;yaml&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-dark:#F7768E&quot;&gt; name&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt; Play 에 올리기&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-dark:#F7768E&quot;&gt;  run&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt; |&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt;    echo &quot;track=$TRACK versionCode=$((GITHUB_RUN_NUMBER + 7))&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt;    ./gradlew publishReleaseBundle --track &quot;$TRACK&quot;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;Gradle의 상수는 20으로 바뀌었는데 로그에는 7이 남아 있었습니다. 번들은 Gradle 설정으로 만들었으므로 업로드에 쓰는 번호는 CI 계산대로였지만, 로그에 출력한 숫자는 13만큼 작았습니다.&lt;/p&gt;
&lt;p&gt;로그용 상수를 따로 관리하지 않고 &lt;code&gt;build.gradle.kts&lt;/code&gt;에서 읽도록 고쳤습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;yaml&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-dark:#F7768E&quot;&gt;run&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt; |&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt;  LAST_MANUAL=$(grep -oE 'val lastManualVersionCode *= *[0-9]+' app/build.gradle.kts | grep -oE '[0-9]+$')&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt;  test -n &quot;$LAST_MANUAL&quot; || { echo &quot;lastManualVersionCode 를 못 읽었다&quot;; exit 1; }&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt;  echo &quot;track=$TRACK versionCode=$((GITHUB_RUN_NUMBER + LAST_MANUAL))&quot;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;값을 못 읽었을 때 0처럼 계산하지 않도록 빈 값이면 종료하게 했습니다. 다만 이 코드는 Gradle 파일의 선언 형식을 읽습니다. 선언을 바꿀 때는 이쪽도 확인해야 합니다.&lt;/p&gt;
&lt;figure&gt;&lt;img src=&quot;/images/silent-failures/version-code-run13-log.webp&quot; alt=&quot;고친 워크플로가 처음 돈 GitHub Actions 실행 13번(v1.0.6)의 «Play 에 올리기» 로그. build.gradle.kts에서 20을 읽어 versionCode=33을 찍었고, 실제로 올라간 번들도 33이었다.&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;figcaption aria-hidden=&quot;true&quot;&gt;고친 워크플로가 처음 돈 GitHub Actions 실행 13번(v1.0.6)의 «Play 에 올리기» 로그. build.gradle.kts에서 20을 읽어 versionCode=33을 찍었고, 실제로 올라간 번들도 33이었다.&lt;/figcaption&gt;&lt;/figure&gt;
&lt;h2 id=&quot;버전-이름도-그대로-내보낼-뻔했습니다&quot;&gt;버전 이름도 그대로 내보낼 뻔했습니다&lt;/h2&gt;
&lt;p&gt;&lt;code&gt;versionCode&lt;/code&gt;와 별도로 사용자가 보는 &lt;code&gt;versionName&lt;/code&gt;도 확인했습니다. 1.0.5에는 컴포넌트를 분리하는 과정에서 여백, 배지, 애니메이션 키, 미리보기가 빠진 회귀 넷이 있었습니다. 이를 고친 뒤에도 이름은 1.0.5로 남아 있었습니다.&lt;/p&gt;
&lt;p&gt;CI가 새 코드를 계산해 주더라도, 동작이 다른 두 빌드를 같은 이름으로 내보내면 테스터가 말하는 ‘1.0.5’가 어느 빌드인지 알기 어렵습니다. 수정 버전은 1.0.6으로 출시하고 태그와 출시 기록을 함께 남겼습니다.&lt;/p&gt;
&lt;h2 id=&quot;마치며&quot;&gt;마치며&lt;/h2&gt;
&lt;p&gt;버전을 정하는 절차를 따로 두고 업로드만 실행하면서 빠뜨린 일이었습니다. 이후 출시 작업에는 버전 이름, 태그, 출시 기록도 함께 넣었습니다.&lt;/p&gt;</content>
  </entry>
  <entry>
    <title>블로그의 canonical은 404였고 공유 카드는 0장이었습니다</title>
    <link href="https://log.twinklelabs.kr/silent-failures/seo-head-lies.html" rel="alternate"/>
    <id>https://log.twinklelabs.kr/silent-failures/seo-head-lies.html</id>
    <published>2026-08-24T03:40:00.000Z</published>
    <updated>2026-08-24T03:40:00.000Z</updated>
    <author><name>Heejeong Kim</name></author>
    <category term="개발 기록"/>
    <category term="seo"/>
    <category term="astro"/>
    <category term="nextjs"/>
    <category term="정적사이트"/>
    <category term="자동화"/>
    <summary type="html">SEO를 점검하다 실제 페이지와 다른 canonical 주소, 한글을 한자로 판정하는 정규식을 찾았습니다. 주소와 문자 범위를 고치고 생성된 HTML과 이미지 파일을 대조했습니다.</summary>
    <content type="html">&lt;h2 id=&quot;들어가며&quot;&gt;들어가며&lt;/h2&gt;
&lt;p&gt;블로그에 글별 공유 카드를 만들던 날, 빌드가 끝난 &lt;code&gt;dist/og/&lt;/code&gt; 폴더에 파일이 하나뿐이었습니다. 글별 이미지는 하나도 생성되지 않았습니다. HTML은 만들어졌고 빌드도 성공한 상태였습니다.&lt;/p&gt;
&lt;p&gt;HTML의 canonical도 글이 열리는 주소와 달랐습니다. 본문 화면은 멀쩡한데, 공유 이미지와 대표 주소가 둘 다 잘못돼 있었습니다.&lt;/p&gt;
&lt;h2 id=&quot;canonical에-html이-빠졌습니다&quot;&gt;canonical에 .html이 빠졌습니다&lt;/h2&gt;
&lt;p&gt;이 블로그는 Pelican을 쓰던 때의 URL을 유지합니다. 글과 일부 목록 페이지는 다음처럼 &lt;code&gt;.html&lt;/code&gt;로 끝납니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;plaintext&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span&gt;/android/aapt-string-newline.html&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;/archives.html&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;공통 레이아웃에서는 &lt;code&gt;Astro.url.pathname&lt;/code&gt;으로 canonical을 만들고 있었습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;ts&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt;const&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#BB9AF7&quot;&gt; canonical&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt; =&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-weight:bold;--shiki-dark:#89DDFF;--shiki-dark-font-weight:inherit&quot;&gt; new&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt; URL&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#9ABDF5&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#C0CAF5&quot;&gt;Astro&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#C0CAF5&quot;&gt;url&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#7DCFFF&quot;&gt;pathname&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;--shiki-light:#FE640B;--shiki-dark:#0DB9D7&quot;&gt; SITE&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#7DCFFF&quot;&gt;url&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#9ABDF5&quot;&gt;)&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#7DCFFF&quot;&gt;href&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;당시 생성 결과에서는 두 주소가 이렇게 달랐습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;plaintext&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span&gt;실제 주소   /android/aapt-string-newline.html&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;pathname   /android/aapt-string-newline/&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;뒤의 주소에는 GitHub Pages가 제공할 파일이 없었습니다. 독자는 &lt;code&gt;.html&lt;/code&gt; 주소에서 글을 읽을 수 있지만, HTML에 적힌 대표 URL은 404로 연결되는 상태였습니다.&lt;/p&gt;
&lt;p&gt;공통 레이아웃에 &lt;code&gt;path&lt;/code&gt;를 받는 속성을 추가했습니다. 글 페이지는 &lt;code&gt;postUrl(post)&lt;/code&gt;를 쓰고, 목록 페이지는 실제 경로를 전달하게 했습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;astro&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BA3C97&quot;&gt;&amp;#x3C;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#EA76CB;--shiki-dark:#0DB9D7&quot;&gt;Base&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-dark:#BB9AF7&quot;&gt; path&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#7DCFFF&quot;&gt;{&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;postUrl&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#9ABDF5&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#C0CAF5&quot;&gt;post&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#9ABDF5&quot;&gt;)&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#7DCFFF&quot;&gt;}&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BA3C97&quot;&gt;&gt;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt;      &amp;#x3C;!-- /android/foo.html --&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BA3C97&quot;&gt;&amp;#x3C;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#EA76CB;--shiki-dark:#0DB9D7&quot;&gt;Base&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-dark:#BB9AF7&quot;&gt; path&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt;/archives.html&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BA3C97&quot;&gt;&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;이렇게 만들어진 canonical이 실제 파일 경로와 일치하는지 결과 HTML에서 확인했습니다.&lt;/p&gt;
&lt;figure&gt;&lt;img src=&quot;/images/silent-failures/seo-canonical-curl.webp&quot; alt=&quot;2026-11-19 배포된 블로그에 curl을 실행한 결과. canonical은 .html 주소를, og:image는 .png 파일을 가리키고 둘 다 200을 돌려준다. pathname 꼴의 슬래시 주소는 지금도 404다.&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;figcaption aria-hidden=&quot;true&quot;&gt;2026-11-19 배포된 블로그에 curl을 실행한 결과. canonical은 .html 주소를, og:image는 .png 파일을 가리키고 둘 다 200을 돌려준다. pathname 꼴의 슬래시 주소는 지금도 404다.&lt;/figcaption&gt;&lt;/figure&gt;
&lt;h2 id=&quot;한자를-거르려다가-한글-제목도-제외했습니다&quot;&gt;한자를 거르려다가 한글 제목도 제외했습니다&lt;/h2&gt;
&lt;p&gt;공유 카드에는 저장소의 Pretendard를 사용했습니다. 사용하던 폰트로 표시할 수 없는 한자가 제목에 있으면 글별 카드 생성을 건너뛰도록 했습니다. 이때 작성한 정규식이 문제였습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;ts&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt;const&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#BB9AF7&quot;&gt; HAN&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt; =&lt;/span&gt;&lt;span style=&quot;--shiki-light:#EA76CB;--shiki-dark:#89DDFF&quot;&gt; /&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-dark:#E0AF68&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DC8A78;--shiki-dark:#E0AF68&quot;&gt;㐀-䶿一-鿿豈-﫿&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-dark:#E0AF68&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;--shiki-light:#EA76CB;--shiki-dark:#89DDFF&quot;&gt;/&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;마지막 범위의 시작 문자 &lt;code&gt;豈&lt;/code&gt;를 호환 한자 블록의 첫 글자인 U+F900으로 알고 적었습니다. 실제로 이 문자의 코드포인트는 U+8C48이었습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;plaintext&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span&gt;의도한 범위   U+F900 – U+FAFF&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;실제 범위     U+8C48 – U+FAFF&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;한글 음절     U+AC00 – U+D7A3&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;실제 범위 안에는 한글 음절이 전부 들어 있었습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;js&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#FE640B;--shiki-dark:#0DB9D7&quot;&gt;HAN&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;test&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#9ABDF5&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt;'&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt;안드로이드를 만들며 배운 것&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt;'&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#9ABDF5&quot;&gt;)&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt;  // → true&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;이 범위에 걸린 한글 제목을 전부 건너뛰고 있었습니다. 이미지를 만들다가 실패한 게 아니어서 생성 오류도 없었습니다. 빌드 로그에는 HTML 68장을 만들었다고 나왔습니다.&lt;/p&gt;
&lt;p&gt;문자 범위를 코드포인트로 고쳤습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;ts&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt;const&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#BB9AF7&quot;&gt; HAN&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt; =&lt;/span&gt;&lt;span style=&quot;--shiki-light:#EA76CB;--shiki-dark:#89DDFF&quot;&gt; /&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-dark:#E0AF68&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;--shiki-light:#FE640B;--shiki-dark:#9ECE6A&quot;&gt;\u3400&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DC8A78;--shiki-dark:#E0AF68&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;--shiki-light:#FE640B;--shiki-dark:#9ECE6A&quot;&gt;\u4DBF\u4E00&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DC8A78;--shiki-dark:#E0AF68&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;--shiki-light:#FE640B;--shiki-dark:#9ECE6A&quot;&gt;\u9FFF\uF900&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DC8A78;--shiki-dark:#E0AF68&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;--shiki-light:#FE640B;--shiki-dark:#9ECE6A&quot;&gt;\uFAFF&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-dark:#E0AF68&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;--shiki-light:#EA76CB;--shiki-dark:#89DDFF&quot;&gt;/&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;수정 뒤에는 글별 이미지가 생성됐습니다. HTML의 &lt;code&gt;og:image&lt;/code&gt;가 가리키는 파일이 실제로 있는지도 canonical과 함께 대조했습니다.&lt;/p&gt;
&lt;h2 id=&quot;같은-날-공유-카드에서-더-고친-부분&quot;&gt;같은 날 공유 카드에서 더 고친 부분&lt;/h2&gt;
&lt;p&gt;홈, 디자인 시스템, 약관 보관소도 함께 점검하고 있었습니다. Next.js로 만든 사이트에서는 레이아웃에 적은 이미지 설정이 페이지의 &lt;code&gt;openGraph&lt;/code&gt;에 의해 사라졌습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;ts&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt;// layout.tsx&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#7DCFFF&quot;&gt;export&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt; const&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#BB9AF7&quot;&gt; metadata&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt; =&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt; {&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#73DACA&quot;&gt; openGraph&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt; {&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#73DACA&quot;&gt; images&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#9ABDF5&quot;&gt; [&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-light-font-weight:inherit;--shiki-dark:#F7768E;--shiki-dark-font-weight:bold&quot;&gt;...&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#9ABDF5&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#73DACA&quot;&gt; siteName&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-light-font-weight:inherit;--shiki-dark:#F7768E;--shiki-dark-font-weight:bold&quot;&gt; ...&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt; }&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt; }&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt;// page.tsx&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#7DCFFF&quot;&gt;export&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt; const&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#BB9AF7&quot;&gt; metadata&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt; =&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt; {&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#73DACA&quot;&gt; openGraph&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt; {&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#73DACA&quot;&gt; title&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt; '&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt;...&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt;'&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt; }&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt; }&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;페이지에서 제목만 바꾸려 했지만, 이 설정은 &lt;code&gt;openGraph&lt;/code&gt; 객체를 필드별로 합치지 않았습니다. &lt;code&gt;shareCard()&lt;/code&gt;가 이미지와 사이트 이름을 포함한 객체를 만들고, 페이지에서는 제목·설명·주소를 전달하는 방식으로 모았습니다.&lt;/p&gt;
&lt;p&gt;satori로 그린 카드의 작은 머리말에는 &lt;code&gt;letterSpacing: 2&lt;/code&gt;를 주었다가 공백 하나가 사라졌습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;plaintext&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span&gt;넣은 글자   안드로이드를 만들며 배운 것&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;그려진 글자  안드로이드를만들며 배운 것&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;그 부분의 자간 설정을 제거해 낱말이 붙지 않게 했습니다.&lt;/p&gt;
&lt;figure&gt;&lt;img src=&quot;/images/silent-failures/seo-blog-share-card.webp&quot; alt=&quot;지금 블로그가 굽는 글별 공유 카드. 한글 제목의 글에도 카드가 만들어지고, 머리말 «안드로이드를 만들며 배운 것»의 띄어쓰기도 붙지 않았다.&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;figcaption aria-hidden=&quot;true&quot;&gt;지금 블로그가 굽는 글별 공유 카드. 한글 제목의 글에도 카드가 만들어지고, 머리말 «안드로이드를 만들며 배운 것»의 띄어쓰기도 붙지 않았다.&lt;/figcaption&gt;&lt;/figure&gt;
&lt;p&gt;Next.js 정적 내보내기에서는 &lt;code&gt;opengraph-image&lt;/code&gt; 규약으로 만든 파일에 확장자가 없었습니다. GitHub Pages에서 이미지로 제공할 주소를 분명히 하기 위해 &lt;code&gt;.png&lt;/code&gt; 경로를 가진 라우트로 바꿨습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;plaintext&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span&gt;src/app/og.png/route.tsx  →  out/og.png&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;메타데이터도 이 주소로 바꿨습니다.&lt;/p&gt;
&lt;figure&gt;&lt;img src=&quot;/images/silent-failures/seo-next-og-png.webp&quot; alt=&quot;소개 화면과 디자인 시스템 문서가 지금 og.png 주소로 내보내는 공유 이미지 두 장.&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;figcaption aria-hidden=&quot;true&quot;&gt;소개 화면과 디자인 시스템 문서가 지금 og.png 주소로 내보내는 공유 이미지 두 장.&lt;/figcaption&gt;&lt;/figure&gt;
&lt;h2 id=&quot;마치며&quot;&gt;마치며&lt;/h2&gt;
&lt;p&gt;마지막에는 각 사이트에서 생성한 HTML을 열어 canonical과 공유 이미지가 실제 파일을 가리키는지 대조했습니다. 빌드는 처음에도 통과했으므로, 이번에는 생성됐다는 로그에 더해 결과 파일과 그 파일을 가리키는 주소까지 확인했습니다.&lt;/p&gt;</content>
  </entry>
  <entry>
    <title>MainActivity의 생명주기 처리를 Compose로 옮기기</title>
    <link href="https://log.twinklelabs.kr/android/main-activity-lifecycle-compose.html" rel="alternate"/>
    <id>https://log.twinklelabs.kr/android/main-activity-lifecycle-compose.html</id>
    <published>2026-08-23T18:40:00.000Z</published>
    <updated>2026-08-23T18:40:00.000Z</updated>
    <author><name>Heejeong Kim</name></author>
    <category term="안드로이드"/>
    <category term="android"/>
    <category term="compose"/>
    <category term="lifecycle"/>
    <category term="구조"/>
    <category term="리팩토링"/>
    <summary type="html">MainActivity에서 결제와 인앱 업데이트의 생명주기를 직접 처리하고 있었습니다. AppLifecycleManager로 관찰 코드를 옮겨 등록과 해제를 함께 두고, 콜백이 최신 게이트를 참조하도록 정리했습니다.</summary>
    <content type="html">&lt;h2 id=&quot;들어가며&quot;&gt;들어가며&lt;/h2&gt;
&lt;p&gt;결제와 인앱 업데이트를 붙이면서 &lt;code&gt;MainActivity&lt;/code&gt;에 생명주기 처리가 쌓였습니다. 업데이트 재개는 &lt;code&gt;onResume&lt;/code&gt;, 업데이트와 결제 자원 정리는 &lt;code&gt;onDestroy&lt;/code&gt;에 있었습니다.&lt;/p&gt;
&lt;h2 id=&quot;activity에-나뉘어-있던-생명주기-처리&quot;&gt;Activity에 나뉘어 있던 생명주기 처리&lt;/h2&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt;override&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt; fun&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt; onResume&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#D20F39;--shiki-dark:#F7768E&quot;&gt;    super&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;onResume&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    updateGate.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;onResume&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt;override&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt; fun&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt; onDestroy&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    updateGate.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;onDestroy&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; (::&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;billing&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;.isInitialized) billing.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;close&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#D20F39;--shiki-dark:#F7768E&quot;&gt;    super&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;onDestroy&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;결제나 업데이트 연결을 손볼 때마다 두 콜백을 오가야 했습니다. 화면은 Compose로 구성하고 있었으니, 이 연결도 별도 컴포저블로 옮겨 보기로 했습니다.&lt;/p&gt;
&lt;h2 id=&quot;applifecyclemanager에-모은-생명주기-연결&quot;&gt;AppLifecycleManager에 모은 생명주기 연결&lt;/h2&gt;
&lt;p&gt;&lt;code&gt;AppLifecycleManager&lt;/code&gt;에서 현재 &lt;code&gt;LifecycleOwner&lt;/code&gt;를 얻고, &lt;code&gt;DisposableEffect&lt;/code&gt; 안에서 관찰자를 등록하도록 했습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;@Composable&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;fun&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt; AppLifecycleManager&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    updateGate: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;UpdateGate&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    billingGate: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;BillingGate&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;    val&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; lifecycleOwner &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; LocalLifecycleOwner.current&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;    val&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; currentUpdateGate &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt; rememberUpdatedState&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(updateGate)&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;    val&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; currentBillingGate &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt; rememberUpdatedState&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(billingGate)&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;    DisposableEffect&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(lifecycleOwner) {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;        val&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; observer &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt; LifecycleEventObserver&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; { _, event &lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;-&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;            when&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; (event) {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;                Lifecycle.Event.ON_RESUME &lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;-&gt;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;                    currentUpdateGate.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt;value&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;onResume&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;                }&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;                Lifecycle.Event.ON_DESTROY &lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;-&gt;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;                    currentUpdateGate.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt;value&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;onDestroy&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;                    currentBillingGate.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt;value&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;close&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;                }&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;                else&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt; -&gt;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; {}&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;            }&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;        lifecycleOwner.lifecycle.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;addObserver&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(observer)&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;        onDispose&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;            lifecycleOwner.lifecycle.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;removeObserver&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(observer)&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;code&gt;ON_RESUME&lt;/code&gt;에서는 업데이트 확인을 이어가고, &lt;code&gt;ON_DESTROY&lt;/code&gt;에서는 게이트를 정리합니다. 관찰자를 등록하고 해제하는 코드도 같은 블록에서 읽을 수 있습니다.&lt;/p&gt;
&lt;p&gt;다만 &lt;code&gt;onDispose&lt;/code&gt;가 게이트까지 닫는 것은 아닙니다. 여기서는 관찰자만 제거합니다. 게이트 정리는 관찰 중 받은 &lt;code&gt;ON_DESTROY&lt;/code&gt;에 달려 있으므로, 두 동작을 같은 것으로 읽으면 안 됩니다.&lt;/p&gt;
&lt;figure&gt;&lt;img src=&quot;/images/android/app-lifecycle-manager-events.webp&quot; alt=&quot;AppLifecycleManager가 받는 사건을 순서대로 그린 그림. 컴포지션에 들어올 때 관찰자를 등록하고, ON_RESUME에서 업데이트 확인을 이어 가고, ON_DESTROY에서 게이트를 정리한다. onDispose는 관찰자만 걷고 게이트는 닫지 않는다&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;figcaption aria-hidden=&quot;true&quot;&gt;AppLifecycleManager가 받는 사건을 순서대로 그린 그림. 컴포지션에 들어올 때 관찰자를 등록하고, ON_RESUME에서 업데이트 확인을 이어 가고, ON_DESTROY에서 게이트를 정리한다. onDispose는 관찰자만 걷고 게이트는 닫지 않는다&lt;/figcaption&gt;&lt;/figure&gt;
&lt;h2 id=&quot;콜백이-처음의-게이트를-계속-참조하지-않도록&quot;&gt;콜백이 처음의 게이트를 계속 참조하지 않도록&lt;/h2&gt;
&lt;p&gt;게이트는 &lt;code&gt;rememberUpdatedState&lt;/code&gt;로 감쌌습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;val&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; currentUpdateGate &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt; rememberUpdatedState&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(updateGate)&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;code&gt;DisposableEffect&lt;/code&gt;의 키는 &lt;code&gt;lifecycleOwner&lt;/code&gt;입니다. 이 키가 같으면 &lt;code&gt;updateGate&lt;/code&gt; 인스턴스가 바뀌어도 효과가 다시 실행되지 않습니다. 콜백이 &lt;code&gt;updateGate&lt;/code&gt;를 직접 참조하면 처음 만들어졌을 때의 값을 계속 사용할 수 있습니다.&lt;/p&gt;
&lt;p&gt;&lt;code&gt;rememberUpdatedState&lt;/code&gt;를 사용하면 콜백은 &lt;code&gt;.value&lt;/code&gt;에서 최신 게이트를 읽습니다. 게이트 값이 바뀌었다는 이유만으로 생명주기 관찰자를 제거하고 다시 등록할 필요가 없어집니다.&lt;/p&gt;
&lt;h2 id=&quot;마치며&quot;&gt;마치며&lt;/h2&gt;
&lt;p&gt;생명주기 연결을 옮긴 뒤 &lt;code&gt;MainActivity&lt;/code&gt;의 &lt;code&gt;onResume&lt;/code&gt;과 &lt;code&gt;onDestroy&lt;/code&gt; 오버라이드를 제거했습니다. &lt;code&gt;setContent&lt;/code&gt; 안에서는 다음처럼 호출합니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;setContent&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;    AppLifecycleManager&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(updateGate, billing)&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt;    // …&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;이제 결제와 업데이트의 생명주기 연결은 &lt;code&gt;AppLifecycleManager&lt;/code&gt;에서 고칩니다.&lt;/p&gt;</content>
  </entry>
  <entry>
    <title>열세 개 콜백을 CalculatorAction으로 묶기</title>
    <link href="https://log.twinklelabs.kr/android/calculator-action-mvi.html" rel="alternate"/>
    <id>https://log.twinklelabs.kr/android/calculator-action-mvi.html</id>
    <published>2026-08-23T18:00:00.000Z</published>
    <updated>2026-08-23T18:00:00.000Z</updated>
    <author><name>Heejeong Kim</name></author>
    <category term="안드로이드"/>
    <category term="android"/>
    <category term="compose"/>
    <category term="mvi"/>
    <category term="구조"/>
    <category term="리팩토링"/>
    <summary type="html">계산기 화면에 행동을 추가할 때마다 화면 함수, 호출부, ViewModel 연결을 함께 고쳐야 했습니다. 열세 개 콜백을 sealed interface 기반 액션으로 묶고 AppShell의 라우팅도 분리했습니다.</summary>
    <content type="html">&lt;h2 id=&quot;들어가며&quot;&gt;들어가며&lt;/h2&gt;
&lt;p&gt;&lt;code&gt;CalculatorScreen&lt;/code&gt;에 버튼 동작을 하나 추가할 때마다 화면 함수의 인자, 호출부, ViewModel 연결을 함께 고쳤습니다. 모드 변경, 입력, 붙여넣기, 저장을 각각 람다로 받다 보니 콜백이 열세 개까지 늘었습니다.&lt;/p&gt;
&lt;h2 id=&quot;화면-함수에-늘어선-콜백&quot;&gt;화면 함수에 늘어선 콜백&lt;/h2&gt;
&lt;p&gt;기존 화면 함수는 다음과 같았습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;@Composable&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;fun&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt; CalculatorScreen&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    state: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;CalcState&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    onMode: (&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;CalcKind&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;) -&gt; &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;Unit&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    onBuyInput: (&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;BuyInput&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;) -&gt; &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;Unit&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    onFocus: (&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;Slot&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;) -&gt; &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;Unit&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    onPaste: (&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;Slot&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;) -&gt; &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;Unit&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    onKey: (&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;KeypadKey&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;) -&gt; &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;Unit&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    onCloseKeypad: () &lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;-&gt;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; Unit,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    onPickStock: () &lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;-&gt;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; Unit,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    onSave: (&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;Long&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;) -&gt; &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;Unit&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    onReset: () &lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;-&gt;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; Unit,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt;    // … 열세 개까지 갔습니다&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;)&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;화면 밖에서 상태를 처리하는 방식은 유지하고 싶었습니다. 불편한 건 행동 하나를 추가할 때마다 위 목록과 호출부를 함께 늘리는 일이었습니다.&lt;/p&gt;
&lt;h2 id=&quot;calculatoraction과-onaction&quot;&gt;CalculatorAction과 onAction&lt;/h2&gt;
&lt;p&gt;MVI(Model-View-Intent)의 아이디어를 가져와 계산기에서 발생하는 행동을 &lt;code&gt;CalculatorAction&lt;/code&gt;에 모았습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt;/**&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt; * 계산기 화면에서 발생하는 모든 사용자 행동을 하나로 묶는다.&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt; */&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt;sealed&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt; interface&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt; CalculatorAction&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt;    data&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt; class&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt; ChangeMode&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;val&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; mode: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;CalcKind&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;) : &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;CalculatorAction&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt;    data&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt; class&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt; ChangeBuyInput&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;val&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; input: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;BuyInput&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;) : &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;CalculatorAction&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt;    data&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt; class&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt; Focus&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;val&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; slot: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;Slot&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;) : &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;CalculatorAction&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt;    data&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt; class&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt; Paste&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;val&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; slot: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;Slot&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;val&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; text: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;) : &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;CalculatorAction&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt;    data&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt; class&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt; KeyPressed&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;val&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; key: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;KeypadKey&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;) : &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;CalculatorAction&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt;    data&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt; object&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt; CloseKeypad&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; : &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;CalculatorAction&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt;    data&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt; object&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt; PickStock&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; : &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;CalculatorAction&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt;    data&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt; class&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt; Save&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;val&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; now: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;Long&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;) : &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;CalculatorAction&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt;    data&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt; object&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt; Reset&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; : &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;CalculatorAction&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;화면에서는 행동과 필요한 값을 &lt;code&gt;onAction&lt;/code&gt;으로 넘깁니다. 처리는 ViewModel에서 합니다.&lt;/p&gt;
&lt;figure&gt;&lt;img src=&quot;/images/android/calculator-actions-on-screen.webp&quot; alt=&quot;물타기 계산기의 실제 화면(2026-08-23) 위에 각 자리에서 나오는 CalculatorAction을 표시한 그림. 종목 칩은 PickStock, 모드 전환은 ChangeMode, 입력 칸은 Focus·Paste, 매수 수량 전환은 ChangeBuyInput, 초기화와 기록 저장은 Reset과 Save(now), 키패드는 KeyPressed, 서랍 바깥을 누르면 CloseKeypad다&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;figcaption aria-hidden=&quot;true&quot;&gt;물타기 계산기의 실제 화면(2026-08-23) 위에 각 자리에서 나오는 CalculatorAction을 표시한 그림. 종목 칩은 PickStock, 모드 전환은 ChangeMode, 입력 칸은 Focus·Paste, 매수 수량 전환은 ChangeBuyInput, 초기화와 기록 저장은 Reset과 Save(now), 키패드는 KeyPressed, 서랍 바깥을 누르면 CloseKeypad다&lt;/figcaption&gt;&lt;/figure&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;@Composable&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;fun&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt; CalculatorScreen&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    state: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;CalcState&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    result: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;CalcResult&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    errors: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;Map&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;&amp;#x3C;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;Slot&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;InputError&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    stocks: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;List&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;&amp;#x3C;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;Stock&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    onAction: (&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;CalculatorAction&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;) -&gt; &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;Unit&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;,   &lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt;// 열세 개가 하나로&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    modifier: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;Modifier&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt; =&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; Modifier,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;)&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;ViewModel에서 공개하던 행동 처리 함수도 하나의 진입점으로 모았습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;fun&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt; onAction&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(action: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;CalculatorAction&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;    when&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; (action) {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;        is&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; CalculatorAction.ChangeMode &lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;-&gt;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; _calc.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;update&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; { … }&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;        is&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; CalculatorAction.ChangeBuyInput &lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;-&gt;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; _calc.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;update&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; { … }&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt;        // …&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;code&gt;sealed interface&lt;/code&gt;의 모든 경우를 &lt;code&gt;when&lt;/code&gt;에서 처리하므로 액션을 추가하고 처리를 빠뜨리면 컴파일러가 알려 줍니다. 새로운 행동에도 처리 코드는 필요하지만, 화면 함수와 호출부에 콜백 인자를 하나씩 더 연결하는 일은 없어졌습니다.&lt;/p&gt;
&lt;h2 id=&quot;save에-시각을-담은-이유&quot;&gt;Save에 시각을 담은 이유&lt;/h2&gt;
&lt;p&gt;저장 행동은 &lt;code&gt;data object&lt;/code&gt; 대신 &lt;code&gt;data class Save(val now: Long)&lt;/code&gt;로 만들었습니다. 화면이 저장 시각을 전달하면 ViewModel은 그 값을 사용합니다.&lt;/p&gt;
&lt;p&gt;ViewModel 안에서 &lt;code&gt;System.currentTimeMillis()&lt;/code&gt;를 부르면 테스트할 때마다 저장 시각이 달라집니다. 밖에서 받게 해 두면 테스트에서는 정해 둔 시각을 넣을 수 있습니다.&lt;/p&gt;
&lt;h2 id=&quot;연결-코드를-찾을-파일도-나눴습니다&quot;&gt;연결 코드를 찾을 파일도 나눴습니다&lt;/h2&gt;
&lt;p&gt;같은 날 600줄 가까이 된 &lt;code&gt;AppShell.kt&lt;/code&gt;도 정리했습니다. 이 파일에는 바텀바·시트·확인창을 구성하는 코드와 화면 경로·전환 애니메이션을 정하는 코드가 함께 있었습니다.&lt;/p&gt;
&lt;p&gt;라우팅은 &lt;code&gt;ui/navigation/AppNavigation.kt&lt;/code&gt;로 옮기고 &lt;code&gt;NavGraphBuilder&lt;/code&gt;의 확장 함수로 만들었습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt;internal&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt; fun&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt; NavGraphBuilder&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;appGraph&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt;    data&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;AppData&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    calcViewModel: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;CalculatorViewModel&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    shell: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;ShellState&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    navController: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;NavController&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    activity: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;Activity&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;?,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt;    // …&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;)&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h2 id=&quot;마치며&quot;&gt;마치며&lt;/h2&gt;
&lt;p&gt;계산기 화면의 열세 개 콜백은 &lt;code&gt;CalculatorAction&lt;/code&gt;을 받는 진입점 하나로 모았습니다. 저장 시각처럼 행동에 필요한 값은 액션에 담고, 화면 밖에서 처리하는 구조는 유지했습니다.&lt;/p&gt;
&lt;p&gt;분리 후 &lt;code&gt;AppShell.kt&lt;/code&gt;는 486줄, &lt;code&gt;AppNavigation.kt&lt;/code&gt;는 171줄이 됐습니다. 코드 양이 크게 줄지는 않았습니다. 그래도 화면 연결을 고칠 때는 &lt;code&gt;AppNavigation.kt&lt;/code&gt;를 열면 됐고, 공통 시트와 바텀바는 &lt;code&gt;AppShell.kt&lt;/code&gt;에 남았습니다.&lt;/p&gt;</content>
  </entry>
  <entry>
    <title>Room과 DataStore를 AppRepository로 묶기</title>
    <link href="https://log.twinklelabs.kr/android/app-repository-ssot.html" rel="alternate"/>
    <id>https://log.twinklelabs.kr/android/app-repository-ssot.html</id>
    <published>2026-08-23T17:00:00.000Z</published>
    <updated>2026-08-23T17:00:00.000Z</updated>
    <author><name>Heejeong Kim</name></author>
    <category term="안드로이드"/>
    <category term="android"/>
    <category term="architecture"/>
    <category term="mvvm"/>
    <category term="room"/>
    <category term="datastore"/>
    <summary type="html">목록은 Room에, 설정은 DataStore에 저장하면서 화면이 두 저장 방식을 알 필요는 없었습니다. AppRepository가 상태를 합쳐 전달하도록 정리하고, 기존 키와 JSON 마이그레이션의 호환성을 확인했습니다.</summary>
    <content type="html">&lt;h2 id=&quot;들어가며&quot;&gt;들어가며&lt;/h2&gt;
&lt;p&gt;종목과 계산 이력을 JSON에서 Room으로 옮겼습니다. 테마·언어·통화·광고 제거 여부는 DataStore에 남아 있으니 저장소가 둘이 됐습니다. 화면마다 두 저장소를 구독하게 할지, 한곳에서 합쳐 전달할지 정해야 했습니다.&lt;/p&gt;
&lt;h2 id=&quot;화면이-받을-appdata를-한곳에서-조립하기&quot;&gt;화면이 받을 AppData를 한곳에서 조립하기&lt;/h2&gt;
&lt;p&gt;이 앱은 서버 없이 기기 안에 기록을 보관합니다. 처음에는 모든 데이터를 JSON 한 덩어리로 저장했습니다. 이 구조에서는 기록 하나를 지워도 전체를 다시 써야 했고, 목록의 특정 항목만 수정하기 어려웠습니다. 목록을 Room으로 옮긴 이유입니다.&lt;/p&gt;
&lt;p&gt;이미 JSON에서 Room으로 한 차례 옮긴 뒤라, 다음에 저장 방식을 바꾸면서 화면까지 고치는 일은 줄이고 싶었습니다. Room과 DataStore를 각각 구독하는 코드는 화면 밖에 뒀습니다.&lt;/p&gt;
&lt;p&gt;&lt;code&gt;AppRepository&lt;/code&gt;가 두 저장소를 받아 하나의 &lt;code&gt;AppData&lt;/code&gt; 흐름으로 제공하도록 했습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;@Singleton&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;class&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt; AppRepository&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt; @Inject&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt; constructor&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt;    private&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt; val&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; store: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;DataStore&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;&amp;#x3C;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;Preferences&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt;    private&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt; val&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; database: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;AppDatabase&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt;    /** Room 의 목록과 DataStore 의 설정을 한 덩이로 합쳐 내보낸다 */&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;    val&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt; data&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;Flow&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;&amp;#x3C;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;AppData&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;&gt; &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt; combine&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;        database.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;stockDao&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;getAllStocks&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(),&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;        database.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;historyDao&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;getAllRecords&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(),&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;        store.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt;data&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    ) { stockEntities, recordEntities, preferences &lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;-&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt;        // … 하나의 AppData 로 조립합니다&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;저장소는 &lt;code&gt;Flow&amp;#x3C;AppData&gt;&lt;/code&gt;를 내보내고, &lt;code&gt;MainViewModel&lt;/code&gt;은 이를 &lt;code&gt;stateIn&lt;/code&gt;으로 바꿔 화면에 제공합니다. 실제 연결은 다음과 같습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;val&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt; data&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;StateFlow&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;&amp;#x3C;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;AppData&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;?&gt; &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; repository.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt;data&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    .&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;stateIn&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(viewModelScope, SharingStarted.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;WhileSubscribed&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;--shiki-light:#FE640B;--shiki-dark:#FF9E64&quot;&gt;5_000&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;), &lt;/span&gt;&lt;span style=&quot;--shiki-light:#D20F39;--shiki-dark:#FF9E64&quot;&gt;null&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;)&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;화면은 이 상태를 구독합니다. 종목이 Room에 있고 설정이 DataStore에 있다는 구분은 저장소 안에 남습니다.&lt;/p&gt;
&lt;p&gt;&lt;code&gt;combine&lt;/code&gt;은 종목 목록, 이력 목록, 설정 중 하나가 바뀌면 새 &lt;code&gt;AppData&lt;/code&gt;를 내보냅니다. 이전에는 설정이 바뀔 때 관련 화면을 갱신하는 연결을 따로 관리했는데, 이제 종목을 지우든 테마를 바꾸든 화면은 이 흐름에서 변경을 받습니다.&lt;/p&gt;
&lt;figure&gt;&lt;img src=&quot;/images/android/app-repository-data-flow.webp&quot; alt=&quot;Room의 종목·계산 이력과 DataStore의 설정을 AppRepository가 combine으로 묶어 하나의 AppData 흐름으로 내보내고, MainViewModel이 stateIn으로 바꿔 화면에 건네는 흐름. 화면은 viewModel.deleteRecord(id)처럼 행동만 보낸다&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;figcaption aria-hidden=&quot;true&quot;&gt;Room의 종목·계산 이력과 DataStore의 설정을 AppRepository가 combine으로 묶어 하나의 AppData 흐름으로 내보내고, MainViewModel이 stateIn으로 바꿔 화면에 건네는 흐름. 화면은 viewModel.deleteRecord(id)처럼 행동만 보낸다&lt;/figcaption&gt;&lt;/figure&gt;
&lt;h2 id=&quot;상수-이름과-저장된-키는-구분했습니다&quot;&gt;상수 이름과 저장된 키는 구분했습니다&lt;/h2&gt;
&lt;p&gt;DataStore에는 다음 키가 있습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt;private&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt; val&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; PROMO_UNLOCKED &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt; booleanPreferencesKey&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt;&quot;dev_unlocked&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;)&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;화면에서 사용하는 말이 바뀌면서 상수 이름은 &lt;code&gt;PROMO_UNLOCKED&lt;/code&gt;가 됐지만, 저장된 키는 &lt;code&gt;dev_unlocked&lt;/code&gt;를 유지했습니다. 키 문자열까지 바꾸면 기존 기기에 저장된 값을 새 이름으로 찾을 수 없습니다. 이미 활성화한 설정이 업데이트 후 꺼진 것처럼 보일 수 있습니다.&lt;/p&gt;
&lt;p&gt;JSON 파서에도 호환성을 위한 옵션이 있습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt;private&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt; val&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; json &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt; Json&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    ignoreUnknownKeys &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#FE640B;--shiki-dark:#FF9E64&quot;&gt; true&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt; // 현재 모델이 모르는 JSON 필드는 건너뛴다&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    encodeDefaults &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#FE640B;--shiki-dark:#FF9E64&quot;&gt; true&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;code&gt;ignoreUnknownKeys&lt;/code&gt;는 읽는 JSON에 현재 모델이 모르는 필드가 있을 때 그 필드를 건너뛰게 합니다. 저장본에 필드가 더 있다는 이유만으로 읽기에 실패하지 않도록 둔 설정입니다.&lt;/p&gt;
&lt;h2 id=&quot;마이그레이션을-다시-실행할-경우도-고려했습니다&quot;&gt;마이그레이션을 다시 실행할 경우도 고려했습니다&lt;/h2&gt;
&lt;p&gt;기존 JSON을 Room으로 옮기는 함수는 다음과 같은 형태입니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt;suspend&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt; fun&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt; migrateDataStoreToRoomIfNeeded&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;    val&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; legacyJson &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; store.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt;data&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;first&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;()[APP_DATA] ?: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;return&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;    val&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; legacy &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt; runCatching&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; { json.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;decodeFromString&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;&amp;#x3C;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;AppData&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;&gt;(legacyJson) }.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;getOrNull&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;() ?: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;return&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt;    // 이미 Room 에 무언가 있으면 덮지 않는다 — 두 번 불려도 기록이 겹치지 않는다&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    …&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;앱이 중간에 종료되어 다음 실행에서 다시 호출될 수 있으므로, 이미 Room에 데이터가 있으면 덮어쓰지 않도록 했습니다. 재호출 때문에 같은 기록이 중복되지 않게 하려는 처리입니다.&lt;/p&gt;
&lt;p&gt;기존 JSON을 읽지 못하면 &lt;code&gt;runCatching { … }.getOrNull() ?: return&lt;/code&gt;에서 마이그레이션을 중단합니다. 앱을 종료시키기보다 옮기지 않는 쪽을 택했고, 원래 JSON은 그대로 남겨 뒀습니다. 읽기에 실패한 저장본까지 복구하는 처리는 이 함수가 맡지 않습니다.&lt;/p&gt;
&lt;h2 id=&quot;마치며&quot;&gt;마치며&lt;/h2&gt;
&lt;p&gt;&lt;a href=&quot;/android/hilt-navigation-cleanup.html&quot;&gt;앞 글&lt;/a&gt;에서 &lt;code&gt;AppViewModel&lt;/code&gt;을 나눈 다섯 ViewModel은 모두 &lt;code&gt;AppRepository&lt;/code&gt;를 사용합니다. 화면에서는 다음처럼 행동만 전달합니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;viewModel.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;deleteRecord&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(id)&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;어디에서 지울지, 실패하면 어떻게 처리할지는 화면 밖에서 정합니다.&lt;/p&gt;</content>
  </entry>
  <entry>
    <title>Aurora Ledger에서 바꾼 색과 강조의 기준</title>
    <link href="https://log.twinklelabs.kr/design-system/aurora-ledger.html" rel="alternate"/>
    <id>https://log.twinklelabs.kr/design-system/aurora-ledger.html</id>
    <published>2026-08-23T16:00:00.000Z</published>
    <updated>2026-08-23T16:00:00.000Z</updated>
    <author><name>Heejeong Kim</name></author>
    <category term="디자인 시스템"/>
    <category term="design-system"/>
    <category term="브랜딩"/>
    <category term="토큰"/>
    <summary type="html">물타기 계산기 목업에서 시작한 디자인을 웹과 앱의 공통 기준으로 옮겼습니다. 중성색, 등락색, 그라데이션을 다시 정한 이유와 공통 토큰의 범위를 살펴봅니다.</summary>
    <content type="html">&lt;h2 id=&quot;들어가며&quot;&gt;들어가며&lt;/h2&gt;
&lt;p&gt;물타기 계산기의 목업에서 쓰던 색과 크기를 다른 웹사이트와 앱에도 적용하기 시작했습니다. 이름은 Aurora Ledger입니다. 8월 9일 목업을 다시 만든 커밋에는 보라색 스킨을 가리키는 주석이 들어 있습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;css&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt;/* Visual refresh · Aurora Ledger */&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;8월 24일에는 홈, 디자인 시스템 사이트, 블로그, 약관 사이트와 물타기 계산기에 이 기준을 적용하고 있었습니다. 처음 고른 색을 그대로 옮긴 것은 아닙니다. 배경을 회색으로 바꿨다가 되돌렸고, 숫자에 넣었던 그라데이션도 다른 자리로 옮겼습니다.&lt;/p&gt;
&lt;figure&gt;&lt;img src=&quot;/images/design-system/design-site.webp&quot; alt=&quot;지금의 디자인 시스템 사이트 design.twinklelabs.kr. Aurora Ledger의 색·글자·간격을 한곳에서 보여 준다&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;figcaption aria-hidden=&quot;true&quot;&gt;지금의 디자인 시스템 사이트 design.twinklelabs.kr. Aurora Ledger의 색·글자·간격을 한곳에서 보여 준다&lt;/figcaption&gt;&lt;/figure&gt;
&lt;h2 id=&quot;배경과-버튼에-같은-역할을-맡기지-않기&quot;&gt;배경과 버튼에 같은 역할을 맡기지 않기&lt;/h2&gt;
&lt;p&gt;중성색에서 보라 기운을 없애 순수 회색으로 바꿔 본 적이 있습니다. 하지만 기존 화면의 인상이 너무 옅어져, 당시에는 채도가 낮은 남보라 계열로 되돌렸습니다. 배경에는 낮은 채도를 쓰고, 채도가 높은 보라는 주요 동작과 초점을 표시하는 데 남겼습니다.&lt;/p&gt;
&lt;p&gt;그라데이션은 적용 위치를 바꿨습니다. 처음에는 큰 숫자에 쓰고 ‘다음’ 버튼에는 쓰지 않았는데, 숫자가 장식처럼 보였습니다. 계산 결과는 accent 단색으로 읽게 하고, 그라데이션은 키패드의 ‘다음/완료’와 빈 화면의 시작 버튼에 사용했습니다.&lt;/p&gt;
&lt;div class=&quot;table-wrap&quot;&gt;





























&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;요소&lt;/th&gt;&lt;th&gt;정한 표현&lt;/th&gt;&lt;th&gt;판단한 이유&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;큰 결과 숫자&lt;/td&gt;&lt;td&gt;accent 단색&lt;/td&gt;&lt;td&gt;계산값 자체가 잘 읽혀야 함&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;키패드의 다음/완료&lt;/td&gt;&lt;td&gt;그라데이션&lt;/td&gt;&lt;td&gt;이어서 누를 동작을 표시&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;빈 상태의 시작 버튼&lt;/td&gt;&lt;td&gt;그라데이션&lt;/td&gt;&lt;td&gt;처음 할 일을 표시&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;전폭 저장 버튼&lt;/td&gt;&lt;td&gt;primary 단색&lt;/td&gt;&lt;td&gt;크기로 이미 충분히 드러남&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;&lt;/div&gt;
&lt;p&gt;한 화면에서 그라데이션을 쓰는 면은 하나로 제한했습니다. 저장 버튼까지 같은 효과를 더하면 어느 동작을 먼저 해야 하는지 분산된다고 판단했습니다.&lt;/p&gt;
&lt;figure&gt;&lt;img src=&quot;/images/design-system/aurora-app-screens.webp&quot; alt=&quot;8월 23일의 물타기 계산기. 큰 결과 숫자는 accent 단색, 내림은 파랑 ▼, 저장 버튼은 primary 단색이고, 그라데이션은 키패드의 «다음»에만 선다&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;figcaption aria-hidden=&quot;true&quot;&gt;8월 23일의 물타기 계산기. 큰 결과 숫자는 accent 단색, 내림은 파랑 ▼, 저장 버튼은 primary 단색이고, 그라데이션은 키패드의 «다음»에만 선다&lt;/figcaption&gt;&lt;/figure&gt;
&lt;h2 id=&quot;오름과-내림까지-보라로-표시해-보니&quot;&gt;오름과 내림까지 보라로 표시해 보니&lt;/h2&gt;
&lt;p&gt;오름과 내림을 모두 보라로 표시한 적도 있습니다. 색이 매번 바뀌는 대신 같은 색으로 결과를 보여주려던 선택이었습니다. 하지만 한 화면에서 오르내리는 값이 하나라면 방향을 바로 구분하는 쪽이 더 유용했습니다.&lt;/p&gt;
&lt;p&gt;한국 시장에서 익숙한 오름 빨강, 내림 파랑으로 돌아갔습니다. 색만으로 뜻을 전달하지 않도록 ▲▼와 ‘낮아졌어요’ 같은 문구는 함께 뒀습니다.&lt;/p&gt;
&lt;p&gt;오름에 쓰는 빨강과 삭제 경고의 빨강은 토큰을 나눴습니다. 등락 표시를 바꾼다고 삭제 버튼까지 달라지면 곤란했습니다.&lt;/p&gt;
&lt;h2 id=&quot;화면은-색의-용도를-참조한다&quot;&gt;화면은 색의 용도를 참조한다&lt;/h2&gt;
&lt;p&gt;웹의 색 토큰은 원색과 용도를 나타내는 이름으로 나눴습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;text&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span&gt;원색: --aurora-*&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;용도: --bg, --text, --accent …&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;화면에서는 &lt;code&gt;#7040D9&lt;/code&gt; 같은 색상값 대신 &lt;code&gt;--accent&lt;/code&gt;를 사용합니다. 화면에 직접 적은 색상값은 테마를 바꿔도 그대로 남지만, 용도별 토큰은 라이트·다크 정의에 맞춰 바뀝니다.&lt;/p&gt;
&lt;p&gt;색 외의 공통 값도 단계별로 정리했습니다. 아래는 8월 24일 기준입니다.&lt;/p&gt;
&lt;div class=&quot;table-wrap&quot;&gt;


































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;구분&lt;/th&gt;&lt;th&gt;값&lt;/th&gt;&lt;th&gt;쓰임&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;불투명도&lt;/td&gt;&lt;td&gt;.88 · .70 · .50 · .35 · .20 · .08&lt;/td&gt;&lt;td&gt;&lt;code&gt;strong&lt;/code&gt;, &lt;code&gt;soft&lt;/code&gt;, &lt;code&gt;half&lt;/code&gt;, &lt;code&gt;ring&lt;/code&gt;, &lt;code&gt;tint&lt;/code&gt;, &lt;code&gt;wash&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;간격&lt;/td&gt;&lt;td&gt;2 · 4 · 6 · 8 · 12 · 16 · 20 · 24 · 32 · 40 · 48&lt;/td&gt;&lt;td&gt;8pt 기준에 작은 간격을 더한 단계&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;기본 글자 크기&lt;/td&gt;&lt;td&gt;11 · 12 · 14 · 16 · 20 · 24 · 28 · 32 · 36 · 40&lt;/td&gt;&lt;td&gt;본문, 이름표, 제목, 숫자&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;모서리&lt;/td&gt;&lt;td&gt;11 · 14 · 18 · 24&lt;/td&gt;&lt;td&gt;입력칸, 안쪽 패널·키, 카드, 시트·모달&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;움직임 시간&lt;/td&gt;&lt;td&gt;150ms · 250ms · 350ms&lt;/td&gt;&lt;td&gt;&lt;code&gt;fast&lt;/code&gt;, &lt;code&gt;base&lt;/code&gt;, &lt;code&gt;slow&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;&lt;/div&gt;
&lt;p&gt;옅은 배경은 같은 비율로 보이지 않아 라이트 8%, 다크 12%로 나눴습니다. 글자 크기 48·60·72는 첫 화면의 히어로와 큰 숫자에만 쓰고, 굵기는 포함한 폰트에 맞춰 400·500·600·700을 사용했습니다. 550·650처럼 따로 포함하지 않은 굵기는 지정하지 않았습니다. 알약 모양의 반지름 999는 배지와 버튼에 사용했습니다.&lt;/p&gt;
&lt;p&gt;움직임 곡선은 들어오거나 이동할 때 &lt;code&gt;cubic-bezier(.25, 1, .5, 1)&lt;/code&gt;, 나갈 때 &lt;code&gt;cubic-bezier(.4, 0, 1, 1)&lt;/code&gt;로 나눴습니다. 이름도 동작의 쓰임으로 구분했습니다. CSS의 &lt;code&gt;ease-out&lt;/code&gt;은 감속을 뜻하므로 화면에서 ‘나가는 동작’과 혼동하지 않으려는 선택입니다.&lt;/p&gt;
&lt;h2 id=&quot;마치며&quot;&gt;마치며&lt;/h2&gt;
&lt;p&gt;웹에서는 CSS 변수, 앱에서는 Kotlin 토큰으로 이 값을 구현했습니다. 공통 기준을 정했어도 코드가 하나가 된 것은 아닙니다. 한쪽에서 값을 바꿀 때 다른 쪽에도 반영해야 합니다.&lt;/p&gt;
&lt;p&gt;공통 단계에 없는 치수도 있습니다. 아이콘 단계는 &lt;code&gt;12 · 16 · 20 · 26&lt;/code&gt;으로 두고, 특정 배지에 필요한 24.dp는 그 컴포넌트의 상수로 남겼습니다.&lt;/p&gt;
&lt;p&gt;이름을 처음 붙인 이유는 기록에 없었습니다. 8월 23일에 돌아보며 Aurora는 보라 그라데이션과 별하늘 장식, Ledger는 종목과 숫자를 읽는 화면에 연결해 해석했습니다. ‘Shine by Yourself — 스스로 빛난다’라는 모토와도 어울렸습니다. 음악 프로젝트에도 Aurora라는 이름이 있어서 디자인 시스템은 전체 이름으로 부르고, 앱 식별자는 &lt;code&gt;TwinkleTheme&lt;/code&gt;처럼 &lt;code&gt;Twinkle*&lt;/code&gt;로 맞췄습니다.&lt;/p&gt;</content>
  </entry>
  <entry>
    <title>Hilt·ViewModel·Navigation을 정리한 하루</title>
    <link href="https://log.twinklelabs.kr/android/hilt-navigation-cleanup.html" rel="alternate"/>
    <id>https://log.twinklelabs.kr/android/hilt-navigation-cleanup.html</id>
    <published>2026-08-23T13:30:00.000Z</published>
    <updated>2026-08-23T13:30:00.000Z</updated>
    <author><name>Heejeong Kim</name></author>
    <category term="안드로이드"/>
    <category term="android"/>
    <category term="compose"/>
    <category term="hilt"/>
    <category term="navigation"/>
    <category term="리팩토링"/>
    <summary type="html">테스트 트랙에 올린 앱의 의존성 주입과 화면 전환을 정리했습니다. Hilt를 도입하고 AppViewModel을 다섯 역할로 나눴으며, Navigation으로 기존 전환 연출을 옮겼습니다.</summary>
    <content type="html">&lt;h2 id=&quot;들어가며&quot;&gt;들어가며&lt;/h2&gt;
&lt;p&gt;앱을 테스트 트랙에 올린 뒤에도 기능을 하나 추가하려면 &lt;code&gt;AppViewModel&lt;/code&gt;과 앱 구성 코드를 함께 열어야 했습니다. 계산과 이력, 설정이 한 ViewModel에 있었고, 필요한 객체를 만드는 일과 화면을 연결하는 일도 직접 관리하고 있었습니다.&lt;/p&gt;
&lt;p&gt;2026-08-23에는 이 연결을 정리하는 데 하루를 썼습니다. 객체 생성은 Hilt에, 화면 경로는 Navigation에 맡기고 ViewModel은 업무별로 나눴습니다.&lt;/p&gt;
&lt;h2 id=&quot;객체-생성과-전달을-hilt에-맡기기&quot;&gt;객체 생성과 전달을 Hilt에 맡기기&lt;/h2&gt;
&lt;p&gt;처음에는 &lt;code&gt;AppRepository&lt;/code&gt;와 &lt;code&gt;AppViewModel&lt;/code&gt;을 직접 생성해 필요한 곳에 넘겼습니다. 의존성이 셋 정도일 때는 단순했지만, Room DB와 DataStore가 들어오고 화면이 늘면서 생성 순서와 전달 경로도 길어졌습니다.&lt;/p&gt;
&lt;p&gt;&lt;code&gt;DatabaseModule&lt;/code&gt;에서 Room DB와 DataStore를 싱글톤으로 제공하고, 나머지는 생성자 주입으로 바꿨습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;@HiltViewModel&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;class&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt; CalculatorViewModel&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt; @Inject&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt; constructor&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt;    private&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt; val&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; repository: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;StockRepository&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;) : &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;ViewModel&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;()&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;클래스가 무엇을 필요로 하는지 생성자에서 확인할 수 있게 됐습니다. 이전처럼 객체를 만드는 위치까지 찾아가 의존성을 확인할 필요가 줄었습니다.&lt;/p&gt;
&lt;h2 id=&quot;계산이력설정종목앱-구성으로-나눈-viewmodel&quot;&gt;계산·이력·설정·종목·앱 구성으로 나눈 ViewModel&lt;/h2&gt;
&lt;p&gt;&lt;code&gt;AppViewModel&lt;/code&gt;은 계산, 이력, 설정, 종목 관리를 함께 맡고 있었습니다. 이를 다섯 ViewModel로 나눴습니다.&lt;/p&gt;
&lt;div class=&quot;table-wrap&quot;&gt;




























&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;ViewModel&lt;/th&gt;&lt;th&gt;맡는 것&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;code&gt;CalculatorViewModel&lt;/code&gt;&lt;/td&gt;&lt;td&gt;계산&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code&gt;HistoryViewModel&lt;/code&gt;&lt;/td&gt;&lt;td&gt;이력&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code&gt;SettingsViewModel&lt;/code&gt;&lt;/td&gt;&lt;td&gt;설정&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code&gt;StockViewModel&lt;/code&gt;&lt;/td&gt;&lt;td&gt;종목 관리&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code&gt;MainViewModel&lt;/code&gt;&lt;/td&gt;&lt;td&gt;앱 공통 상태&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;&lt;/div&gt;
&lt;p&gt;화면마다 하나씩 만들지는 않았습니다. 계산과 이력처럼 다루는 일을 기준으로 나눴습니다.&lt;/p&gt;
&lt;p&gt;ViewModel 안에 있던 상태 &lt;code&gt;data class&lt;/code&gt;도 &lt;code&gt;CalculatorState.kt&lt;/code&gt;로 옮겼습니다. 다른 코드가 상태 타입을 쓰기 위해 특정 ViewModel을 참조하지 않도록 하기 위해서입니다.&lt;/p&gt;
&lt;h2 id=&quot;화면-경로와-보조-ui-상태-분리&quot;&gt;화면 경로와 보조 UI 상태 분리&lt;/h2&gt;
&lt;p&gt;기존에는 &lt;code&gt;ShellState&lt;/code&gt;가 현재 화면과 뒤로 돌아갈 화면을 직접 관리했습니다. 이 부분을 Navigation으로 옮기고, &lt;code&gt;Routes.kt&lt;/code&gt;에 직렬화 가능한 경로 타입을 뒀습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;@Serializable&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt; data&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt; object&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt; Calculator&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;@Serializable&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt; data&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt; class&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt; StockDetail&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;val&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; stockId: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;Long&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;navController.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;navigate&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;StockDetail&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(stockId &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#FE640B;--shiki-dark:#FF9E64&quot;&gt; 3&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;))&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;문자열을 조립하는 대신 객체를 경로로 전달하므로, 경로 인자의 타입을 컴파일할 때 확인할 수 있습니다.&lt;/p&gt;
&lt;h3 id=&quot;화면-깊이에-따른-전환-방향&quot;&gt;화면 깊이에 따른 전환 방향&lt;/h3&gt;
&lt;p&gt;&lt;code&gt;AnimatedContent&lt;/code&gt;로 만든 기존 연출은 화면마다 정한 깊이(depth)를 비교했습니다. 더 깊은 화면으로 갈 때는 왼쪽에서, 얕은 화면으로 갈 때는 오른쪽에서 들어오도록 했습니다.&lt;/p&gt;
&lt;p&gt;&lt;code&gt;NavHost&lt;/code&gt;에서도 출발 화면과 도착 화면의 깊이를 비교하도록 옮겼습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;enterTransition &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;    val&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; from &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; initialState.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;toRoute&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;&amp;#x3C;…&gt;().depth&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;    val&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; to &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; targetState.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;toRoute&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;&amp;#x3C;…&gt;().depth&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;    slideIn&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(direction &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt; if&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; (to &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BB9AF7&quot;&gt;&gt;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; from) Left &lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;else&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; Right)&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;이렇게 출발지와 도착지의 깊이를 비교해서 기존 전환 방향을 유지했습니다.&lt;/p&gt;
&lt;h3 id=&quot;shellstate에-남긴-다이얼로그와-필터&quot;&gt;ShellState에 남긴 다이얼로그와 필터&lt;/h3&gt;
&lt;p&gt;다이얼로그, 오버레이, 필터는 화면 경로와 별개로 관리할 곳이 필요했습니다. 따라서 &lt;code&gt;ShellState&lt;/code&gt;를 없애지 않고 내비게이션 상태만 &lt;code&gt;NavController&lt;/code&gt;로 옮겼습니다. 남은 보조 UI 상태는 계속 &lt;code&gt;ShellState&lt;/code&gt;가 맡습니다.&lt;/p&gt;
&lt;figure&gt;&lt;img src=&quot;/images/android/navigation-route-depth.webp&quot; alt=&quot;Routes.kt에 둔 경로와 깊이. 깊이 0은 계산·이력·설정, 깊이 1은 종목 관리·오픈소스 라이선스·개인정보 처리방침·이용약관, 깊이 2는 라이선스 본문이다. 화면 경로는 NavController가, 다이얼로그·오버레이·필터는 ShellState가 맡는다&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;figcaption aria-hidden=&quot;true&quot;&gt;Routes.kt에 둔 경로와 깊이. 깊이 0은 계산·이력·설정, 깊이 1은 종목 관리·오픈소스 라이선스·개인정보 처리방침·이용약관, 깊이 2는 라이선스 본문이다. 화면 경로는 NavController가, 다이얼로그·오버레이·필터는 ShellState가 맡는다&lt;/figcaption&gt;&lt;/figure&gt;
&lt;h2 id=&quot;함께-정리한-설정&quot;&gt;함께 정리한 설정&lt;/h2&gt;
&lt;p&gt;Compose로 구성된 앱에서 사용하지 않는 호환성 계층을 줄이기 위해 &lt;code&gt;AppCompatActivity&lt;/code&gt;를 &lt;code&gt;ComponentActivity&lt;/code&gt;로 바꿨습니다. Compose 테마와 역할이 겹치던 &lt;code&gt;AppCompatDelegate&lt;/code&gt;, &lt;code&gt;UiModeManager&lt;/code&gt;의 수동 테마 설정도 제거했습니다.&lt;/p&gt;
&lt;p&gt;린트에서 확인한 항목도 함께 수정했습니다. &lt;code&gt;TypographyQuotes&lt;/code&gt;가 지적한 프랑스어·이탈리아어의 일반 아포스트로피(&lt;code&gt;'&lt;/code&gt;)는 스마트 아포스트로피(&lt;code&gt;’&lt;/code&gt;)로 교체했습니다. &lt;code&gt;ObsoleteSdkInt&lt;/code&gt;가 가리키던, 더 이상 도달하지 않는 SDK 버전 분기도 정리했습니다.&lt;/p&gt;
&lt;p&gt;&lt;code&gt;targetSdk&lt;/code&gt;는 37로 올렸습니다. 대상 SDK를 올리면 동작이 달라지는 부분이 있으므로, 출시 직전에 묶어 처리하기보다 구조를 정리하는 날 함께 확인했습니다.&lt;/p&gt;
&lt;h2 id=&quot;마치며&quot;&gt;마치며&lt;/h2&gt;
&lt;p&gt;이날 ViewModel을 나누기는 했지만 비즈니스 로직의 단위 테스트까지 붙이지는 못했습니다. 딥링크는 필요할 때 추가하기로 했습니다. 런처 아이콘이 영역을 가득 채운다는 &lt;code&gt;IconLauncherShape&lt;/code&gt; 경고도 아직 남아 있었습니다.&lt;/p&gt;</content>
  </entry>
  <entry>
    <title>입력 검증 결과를 ValidInputs로 전달하기</title>
    <link href="https://log.twinklelabs.kr/android/validate-once-type-carries-proof.html" rel="alternate"/>
    <id>https://log.twinklelabs.kr/android/validate-once-type-carries-proof.html</id>
    <published>2026-08-23T12:20:00.000Z</published>
    <updated>2026-08-23T12:20:00.000Z</updated>
    <author><name>Heejeong Kim</name></author>
    <category term="안드로이드"/>
    <category term="android"/>
    <category term="kotlin"/>
    <category term="구조"/>
    <category term="타입"/>
    <summary type="html">단가 0이 오류 없이 계산에서 빠지고 목표 평단가 칸은 검증을 건너뛰었습니다. 검증 결과를 유효·미완성·오류로 나누고, 계산 함수가 ValidInputs만 받도록 바꿨습니다.</summary>
    <content type="html">&lt;h2 id=&quot;들어가며&quot;&gt;들어가며&lt;/h2&gt;
&lt;p&gt;단가에 &lt;code&gt;0&lt;/code&gt;을 넣었는데 오류도 계산 결과도 나오지 않았습니다. 같은 날 목표 평단가 칸에서도 문제를 찾았습니다. 여기에 &lt;code&gt;0&lt;/code&gt;을 넣으면 잘못된 이유를 안내했습니다.&lt;/p&gt;
&lt;p&gt;두 버그를 고치고 보니 계산 함수 안에도 비슷한 검사가 남아 있었습니다. 한쪽 조건만 고쳤다가 다시 어긋날 수 있는 구조였습니다.&lt;/p&gt;
&lt;h2 id=&quot;검증과-계산이-0을-다르게-처리했습니다&quot;&gt;검증과 계산이 0을 다르게 처리했습니다&lt;/h2&gt;
&lt;p&gt;단가를 판정하는 코드가 두 곳에 있었습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt;// 검증하는 쪽&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;fun&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt; validatePrice&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(price: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;Double&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;?): &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;? &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; (price &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BB9AF7&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#D20F39;--shiki-dark:#FF9E64&quot;&gt; null&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BB9AF7&quot;&gt; &amp;#x26;&amp;#x26;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; price &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BB9AF7&quot;&gt;&amp;#x3C;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#FE640B;--shiki-dark:#FF9E64&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;) Error.Negative &lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;else&lt;/span&gt;&lt;span style=&quot;--shiki-light:#D20F39;--shiki-dark:#FF9E64&quot;&gt; null&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt;// 계산하는 쪽&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;val&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; isValid &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; price &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BB9AF7&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#D20F39;--shiki-dark:#FF9E64&quot;&gt; null&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BB9AF7&quot;&gt; &amp;#x26;&amp;#x26;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; price &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BB9AF7&quot;&gt;&gt;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#FE640B;--shiki-dark:#FF9E64&quot;&gt; 0&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;검증은 &lt;code&gt;0&lt;/code&gt;을 음수가 아니라고 통과시켰습니다. 계산은 &lt;code&gt;0&lt;/code&gt;이 양수가 아니라는 이유로 실행하지 않았습니다. 이 조건 차이 때문에 화면에는 오류도 계산 결과도 나타나지 않았습니다.&lt;/p&gt;
&lt;h2 id=&quot;검증에서-빠진-목표-평단가&quot;&gt;검증에서 빠진 목표 평단가&lt;/h2&gt;
&lt;p&gt;검사 함수는 입력칸 넷을 받았고, 마지막 인자의 이름은 &lt;code&gt;BUY_QUANTITY&lt;/code&gt;였습니다. 목표 평단가 모드에는 ‘살 수량’이 없으므로 이 자리에 &lt;code&gt;null&lt;/code&gt;을 넘겼습니다.&lt;/p&gt;
&lt;p&gt;하지만 그 모드의 네 번째 칸에는 목표 평단가가 있었습니다. 특정 모드의 의미로 붙인 이름 때문에 다른 모드에서 그 칸을 검증해야 한다는 점을 놓쳤습니다. 위치는 &lt;code&gt;FOURTH&lt;/code&gt;, 해당 입력의 의미는 &lt;code&gt;InputKind&lt;/code&gt;로 구분할 필요가 있었습니다.&lt;/p&gt;
&lt;figure&gt;&lt;img src=&quot;/images/android/validate-once-fourth-slot.webp&quot; alt=&quot;물타기 계산기의 실제 화면(2026-08-23). 물타기 모드에서 네 번째 칸은 매수 수량이고, 목표 평단가 모드에서는 같은 자리가 목표 평단가다&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;figcaption aria-hidden=&quot;true&quot;&gt;물타기 계산기의 실제 화면(2026-08-23). 물타기 모드에서 네 번째 칸은 매수 수량이고, 목표 평단가 모드에서는 같은 자리가 목표 평단가다&lt;/figcaption&gt;&lt;/figure&gt;
&lt;h2 id=&quot;계산-함수가-다시-검사하던-이유&quot;&gt;계산 함수가 다시 검사하던 이유&lt;/h2&gt;
&lt;p&gt;단가 조건을 맞추고 목표 평단가를 검증에 전달하니 두 증상은 해결됐습니다. 그러나 계산 함수는 여전히 nullable 숫자를 받으며 다시 유효성을 확인했습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;fun&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt; calculate&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(price: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;Double&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;?, quantity: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;Double&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;?, &lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt;/* … */&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;): &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;Result&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;? {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;    val&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; isValid &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; price &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BB9AF7&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#D20F39;--shiki-dark:#FF9E64&quot;&gt; null&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BB9AF7&quot;&gt; &amp;#x26;&amp;#x26;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; price &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BB9AF7&quot;&gt;&gt;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#FE640B;--shiki-dark:#FF9E64&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BB9AF7&quot;&gt; &amp;#x26;&amp;#x26;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt; /* … */&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt;   // ← 또 셉니다&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BB9AF7&quot;&gt;!&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;isValid) &lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;return&lt;/span&gt;&lt;span style=&quot;--shiki-light:#D20F39;--shiki-dark:#FF9E64&quot;&gt; null&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt;    // …&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;code&gt;Double?&lt;/code&gt;이라는 타입만으로는 호출 전에 검증했는지 알 수 없습니다. 계산 함수가 스스로 입력을 확인하려다 보니 검증 규칙이 다시 생겼습니다. 두 조건을 같은 값으로 고치는 것만으로는 중복을 없앨 수 없었습니다.&lt;/p&gt;
&lt;h2 id=&quot;판정-결과를-계산-함수에-전달하기&quot;&gt;판정 결과를 계산 함수에 전달하기&lt;/h2&gt;
&lt;p&gt;검증 결과를 세 가지로 나누고, 계산 함수는 유효한 입력을 담는 &lt;code&gt;ValidInputs&lt;/code&gt;만 받도록 했습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt;sealed&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt; interface&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt; Validation&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt;    data&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt; class&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt; Valid&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;val&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; inputs: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;ValidInputs&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;) : &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;Validation&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt;    data&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt; object&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt; Incomplete&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; : &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;Validation&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt;    data&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt; class&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt; Invalid&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;val&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; kind: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;InputKind&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;val&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; reason: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;Reason&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;) : &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;Validation&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;fun&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt; validateInputs&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(raw: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;RawInputs&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;): &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;Validation&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt;// 계산 함수는 ValidInputs 만 받습니다&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;fun&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt; calculate&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(inputs: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;ValidInputs&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;): &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;Result&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;code&gt;validateInputs&lt;/code&gt;가 판정한 결과를 계산과 오류 표시에 함께 사용합니다. 유효한 경우에는 &lt;code&gt;ValidInputs&lt;/code&gt;를 계산 함수에 넘기고, 오류인 경우에는 &lt;code&gt;InputKind&lt;/code&gt;와 &lt;code&gt;Reason&lt;/code&gt;으로 문구를 만듭니다.&lt;/p&gt;
&lt;p&gt;계산 쪽에서 같은 규칙을 다시 적던 코드는 제거했습니다. 이제 &lt;code&gt;RawInputs&lt;/code&gt;나 &lt;code&gt;Double?&lt;/code&gt;을 그대로 넘길 수 없고, &lt;code&gt;ValidInputs&lt;/code&gt;를 전달해야 합니다. 검증 규칙을 고칠 곳은 &lt;code&gt;validateInputs&lt;/code&gt;에 남았습니다.&lt;/p&gt;
&lt;h2 id=&quot;미완성-입력과-오류를-구분했습니다&quot;&gt;미완성 입력과 오류를 구분했습니다&lt;/h2&gt;
&lt;p&gt;기존의 &lt;code&gt;null&lt;/code&gt; 결과는 아직 입력을 마치지 않은 경우와 잘못된 값을 넣은 경우를 함께 표현했습니다. 화면은 둘을 구분할 정보가 없어 잘못된 이유를 표시하기도 했습니다.&lt;/p&gt;
&lt;p&gt;입력이 덜 된 경우에는 &lt;code&gt;Incomplete&lt;/code&gt;, 잘못 넣은 경우에는 &lt;code&gt;Invalid&lt;/code&gt;를 받아 화면에서도 다르게 처리했습니다.&lt;/p&gt;
&lt;h2 id=&quot;마치며&quot;&gt;마치며&lt;/h2&gt;
&lt;p&gt;입력하는 동안 보여 주는 ‘≈ n주’ 힌트는 전체 검증 전에 계산됩니다. &lt;code&gt;0&lt;/code&gt;처럼 아직 유효한 계산 입력이 아닌 값도 받아야 하므로 &lt;code&gt;ValidInputs&lt;/code&gt;만 요구할 수 없었습니다.&lt;/p&gt;
&lt;p&gt;그래서 힌트 쪽 검사는 남겼습니다. 나중에 중복이라고 지우지 않도록 KDoc에 호출 시점과 이유를 적었습니다.&lt;/p&gt;</content>
  </entry>
  <entry>
    <title>없는 로케일 때문에 스토어 이미지 업로드가 취소됐습니다</title>
    <link href="https://log.twinklelabs.kr/silent-failures/atomic-edit-says-nothing.html" rel="alternate"/>
    <id>https://log.twinklelabs.kr/silent-failures/atomic-edit-says-nothing.html</id>
    <published>2026-08-23T11:10:00.000Z</published>
    <updated>2026-08-23T11:10:00.000Z</updated>
    <author><name>Heejeong Kim</name></author>
    <category term="개발 기록"/>
    <category term="play-store"/>
    <category term="출시"/>
    <category term="gradle"/>
    <category term="자동화"/>
    <summary type="html">Gradle Play Publisher가 없는 로케일의 이미지 조회에서 실패하면서 기존 로케일의 변경도 반영되지 않았습니다. 로케일을 먼저 만든 뒤 이미지를 올리고 sha1을 비교했습니다.</summary>
    <content type="html">&lt;h2 id=&quot;들어가며&quot;&gt;들어가며&lt;/h2&gt;
&lt;p&gt;물타기 계산기의 구글 플레이 등록정보를 올렸는데, 며칠이 지나도 스토어 이미지가 바뀌지 않았습니다. 실행했던 명령은 Gradle Play Publisher(GPP)의 &lt;code&gt;publishReleaseListing&lt;/code&gt;이었습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;bash&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;./gradlew&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt; publishReleaseListing&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;다시 로그를 보니 마지막에 &lt;code&gt;FAILED&lt;/code&gt;가 있었습니다. 새로 추가한 언어의 이미지 목록을 읽다가 실패한 명령을, 실행했다는 것만 기억하고 있었습니다.&lt;/p&gt;
&lt;h2 id=&quot;fr-fr의-오류로-ko-kr-변경도-반영되지-않았습니다&quot;&gt;fr-FR의 오류로 ko-KR 변경도 반영되지 않았습니다&lt;/h2&gt;
&lt;p&gt;당시 사용한 GPP 4.1.1은 등록정보 텍스트와 이미지를 하나의 편집(edit)에 넣었습니다. Play API는 편집을 열고 변경을 넣은 뒤 커밋해야 반영되는 구조입니다.&lt;/p&gt;
&lt;p&gt;새 언어를 추가하면서 여러 로케일에 &lt;code&gt;graphics/&lt;/code&gt; 폴더를 만들었습니다. 그중에는 스토어에 아직 등록정보가 없는 로케일도 있었습니다. GPP는 이미지를 올리기 전에 현재 이미지 목록을 GET으로 읽는데, 이 요청이 없는 로케일에서 404로 실패했습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;plaintext&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span&gt;Listing for language 'fr-FR' not found&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;편집 전체가 커밋되지 않아 이미 있던 ko-KR의 이미지 변경도 반영되지 않았습니다. 오류가 난 fr-FR만 다시 올리면 되는 상황이 아니었습니다.&lt;/p&gt;
&lt;figure&gt;&lt;img src=&quot;/images/silent-failures/atomic-edit-listing-images.webp&quot; alt=&quot;2026-08-23 저장소에 있던 물타기 계산기의 스토어 이미지. 위는 이미 스토어에 등록정보가 있던 ko-KR 다섯 장, 아래는 아직 등록정보가 없던 fr-FR 다섯 장이다. fr-FR 조회가 404로 실패하자 같은 편집에 든 ko-KR 이미지도 반영되지 않았다.&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;figcaption aria-hidden=&quot;true&quot;&gt;2026-08-23 저장소에 있던 물타기 계산기의 스토어 이미지. 위는 이미 스토어에 등록정보가 있던 ko-KR 다섯 장, 아래는 아직 등록정보가 없던 fr-FR 다섯 장이다. fr-FR 조회가 404로 실패하자 같은 편집에 든 ko-KR 이미지도 반영되지 않았다.&lt;/figcaption&gt;&lt;/figure&gt;
&lt;h2 id=&quot;로케일과-이미지를-나눠-올렸습니다&quot;&gt;로케일과 이미지를 나눠 올렸습니다&lt;/h2&gt;
&lt;p&gt;스토어에 없는 로케일은 두 차례에 나눠 처리했습니다.&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;새 로케일의 &lt;code&gt;graphics/&lt;/code&gt;를 잠시 치우고 등록정보를 올려 로케일을 만듭니다.&lt;/li&gt;
&lt;li&gt;&lt;code&gt;graphics/&lt;/code&gt;를 원래 자리로 되돌리고 다시 실행해 이미지를 올립니다.&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;저장소의 최종 파일 배치는 그대로 두고, 업로드 순서만 나눈 것입니다.&lt;/p&gt;
&lt;figure&gt;&lt;img src=&quot;/images/silent-failures/atomic-edit-two-runs.webp&quot; alt=&quot;한 편집에 모든 로케일을 넣어 올렸을 때와 두 번에 나눠 올렸을 때를 다시 그린 그림. 앞쪽은 fr-FR의 404로 편집 전체가 커밋되지 않고, 뒤쪽은 로케일을 먼저 만든 뒤 이미지를 올리고 임시 편집의 sha1로 확인한다.&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;figcaption aria-hidden=&quot;true&quot;&gt;한 편집에 모든 로케일을 넣어 올렸을 때와 두 번에 나눠 올렸을 때를 다시 그린 그림. 앞쪽은 fr-FR의 404로 편집 전체가 커밋되지 않고, 뒤쪽은 로케일을 먼저 만든 뒤 이미지를 올리고 임시 편집의 sha1로 확인한다.&lt;/figcaption&gt;&lt;/figure&gt;
&lt;p&gt;REST 요청으로 로케일만 먼저 만드는 방법도 시도했습니다. 이때는 &lt;code&gt;edits:validate&lt;/code&gt;가 200을 반환했지만 &lt;code&gt;edits:commit&lt;/code&gt;은 HTML 404를 반환했습니다. 이 시도로는 완료하지 못했고, 커밋은 GPP에 맡겼습니다.&lt;/p&gt;
&lt;h2 id=&quot;이미지-파일은-api-응답과-대조했습니다&quot;&gt;이미지 파일은 API 응답과 대조했습니다&lt;/h2&gt;
&lt;p&gt;콘솔 화면만으로는 검토 중인 이미지와 반영된 이미지를 구분하기 어려웠습니다. 임시 편집을 열어 이미지 목록을 읽고, 응답의 &lt;code&gt;sha1&lt;/code&gt;을 로컬 파일의 해시와 비교했습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;bash&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;shasum&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt; fastlane/metadata/android/ko-KR/images/phoneScreenshots/&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#F7768E&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt;.png&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;해시가 같으면 API가 반환한 목록에 로컬과 같은 이미지 파일이 있는지 확인할 수 있습니다. 조회를 마친 임시 편집은 삭제했습니다. 이 편집에는 변경을 넣거나 커밋하지 않았습니다.&lt;/p&gt;
&lt;h2 id=&quot;마치며&quot;&gt;마치며&lt;/h2&gt;
&lt;p&gt;로케일을 먼저 만든 뒤 이미지를 올리는 순서로 처리했습니다. 다시 올린 뒤에는 명령의 종료 결과를 읽고, 이미지 목록의 해시까지 비교했습니다. 원래 준비한 파일이 업로드 목록에 들어갔는지를 그때 확인했습니다.&lt;/p&gt;</content>
  </entry>
  <entry>
    <title>light-dark() 하나로 두 테마를 적으며 만난 세 가지</title>
    <link href="https://log.twinklelabs.kr/design-system/light-dark-one-copy.html" rel="alternate"/>
    <id>https://log.twinklelabs.kr/design-system/light-dark-one-copy.html</id>
    <published>2026-08-22T13:00:00.000Z</published>
    <updated>2026-08-22T13:00:00.000Z</updated>
    <author><name>Heejeong Kim</name></author>
    <category term="디자인 시스템"/>
    <category term="css"/>
    <category term="design-system"/>
    <category term="다크모드"/>
    <category term="color-mix"/>
    <category term="light-dark"/>
    <summary type="html">테마 블록마다 따로 적은 색 때문에 옛 브랜드색이 되살아났습니다. light-dark()로 두 테마의 색을 한곳에 모은 뒤, 퍼센트 자리에 넣어 배경이 사라진 일과 빌드가 함수를 변수로 바꿔 테마 전환이 멈춘 일을 차례로 겪었습니다.</summary>
    <content type="html">&lt;h2 id=&quot;들어가며&quot;&gt;들어가며&lt;/h2&gt;
&lt;p&gt;물타기 계산기의 디자인 목업에서 브랜드색을 확인하다가 주석과 값이 다른 줄을 발견했습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;css&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt;/* Aurora 는 #7040D9 */&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;--brand: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;#&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#FF5370&quot;&gt;6F3DE0&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;설명에 적힌 색은 새 보라였지만, 화면을 그리는 값은 옛 보라였습니다. 이 일을 계기로 라이트와 다크의 색을 &lt;code&gt;light-dark()&lt;/code&gt; 한 줄에 모았습니다. 그 뒤 다른 두 화면에서 같은 함수 때문에 한 번씩 더 걸렸습니다. 세 번을 차례로 적습니다.&lt;/p&gt;
&lt;h2 id=&quot;하나--같은-색을-고칠-곳이-다섯-군데였다&quot;&gt;하나 — 같은 색을 고칠 곳이 다섯 군데였다&lt;/h2&gt;
&lt;p&gt;목업에는 시스템 설정과 사용자의 선택에 따라 적용되는 색 정의가 각각 있었습니다.&lt;/p&gt;
&lt;div class=&quot;table-wrap&quot;&gt;




























&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;위치&lt;/th&gt;&lt;th&gt;적용되는 경우&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;code&gt;:root&lt;/code&gt;&lt;/td&gt;&lt;td&gt;기본 라이트 테마&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code&gt;@media (prefers-color-scheme: dark)&lt;/code&gt;&lt;/td&gt;&lt;td&gt;시스템이 다크일 때&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code&gt;[data-theme=&quot;dark&quot;]&lt;/code&gt;&lt;/td&gt;&lt;td&gt;사용자가 다크를 고를 때&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code&gt;[data-theme=&quot;light&quot;]&lt;/code&gt;&lt;/td&gt;&lt;td&gt;사용자가 라이트를 고를 때&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code&gt;.phone&lt;/code&gt; 스킨 3개&lt;/td&gt;&lt;td&gt;목업 안의 휴대전화 화면&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;&lt;/div&gt;
&lt;p&gt;이 중 한 곳에 &lt;code&gt;#6F3DE0&lt;/code&gt;이 남아 뒤에서 새 색을 덮고 있었습니다. 같은 라이트 화면이라도 시스템 기본으로 들어왔는지 사용자가 직접 골랐는지에 따라 다른 블록을 읽었습니다.&lt;/p&gt;
&lt;p&gt;&lt;code&gt;light-dark()&lt;/code&gt;에 첫 번째로 라이트 색, 두 번째로 다크 색을 넣었습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;css&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#E0AF68&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BB9AF7&quot;&gt;root&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-dark:#7AA2F7&quot;&gt;  color-scheme&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#FF9E64&quot;&gt; light&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#FF9E64&quot;&gt; dark&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-dark:#C0CAF5&quot;&gt;  --token-bg&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#BB9AF7&quot;&gt;      light-dark(&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9AA5CE&quot;&gt;#&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#9AA5CE&quot;&gt;F8F6FC&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9AA5CE&quot;&gt; #&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#9AA5CE&quot;&gt;110D19&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#9ABDF5&quot;&gt;)&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-dark:#C0CAF5&quot;&gt;  --token-text&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#BB9AF7&quot;&gt;    light-dark(&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9AA5CE&quot;&gt;#&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#9AA5CE&quot;&gt;21182D&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9AA5CE&quot;&gt; #&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#9AA5CE&quot;&gt;FAF7FF&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#9ABDF5&quot;&gt;)&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-dark:#C0CAF5&quot;&gt;  --token-primary&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#BB9AF7&quot;&gt; light-dark(&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9AA5CE&quot;&gt;#&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#9AA5CE&quot;&gt;7040D9&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9AA5CE&quot;&gt; #&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#9AA5CE&quot;&gt;986CF4&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#9ABDF5&quot;&gt;)&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#E0AF68&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BB9AF7&quot;&gt;root&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-dark:#BB9AF7&quot;&gt;data-theme&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt;dark&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt;  {&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-dark:#7AA2F7&quot;&gt; color-scheme&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#FF9E64&quot;&gt; dark&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt; }&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#E0AF68&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BB9AF7&quot;&gt;root&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-dark:#BB9AF7&quot;&gt;data-theme&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt;light&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt; {&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-dark:#7AA2F7&quot;&gt; color-scheme&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#FF9E64&quot;&gt; light&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt; }&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;어느 값을 쓸지는 요소에 적용된 &lt;code&gt;color-scheme&lt;/code&gt;이 정합니다. 수동 선택이 없으면 시스템 설정을, &lt;code&gt;data-theme&lt;/code&gt;이 있으면 그 선택을 따릅니다. 색을 고칠 때는 두 값을 한 줄에서 함께 봅니다. 화면에서 짧은 이름이 필요하면 값을 옮겨 적지 않고 &lt;code&gt;--bg: var(--token-bg)&lt;/code&gt;처럼 가리키게 했습니다.&lt;/p&gt;
&lt;p&gt;&lt;code&gt;color-scheme&lt;/code&gt;은 &lt;code&gt;body&lt;/code&gt;가 아니라 &lt;code&gt;:root&lt;/code&gt;에 둡니다. 이 속성은 색상 함수 외에도 브라우저가 그리는 스크롤바와 폼 컨트롤에 영향을 주고, 루트에 선언해야 페이지 캔버스와 뷰포트 스크롤바까지 따라옵니다(&lt;a href=&quot;https://www.w3.org/TR/css-color-adjust-1/#color-scheme-effect&quot;&gt;CSS Color Adjustment 명세&lt;/a&gt;). 작업 당시 확인한 지원 시작 버전은 Chrome 123, Safari 17.5, Firefox 120이었습니다.&lt;/p&gt;
&lt;h2 id=&quot;둘--퍼센트-자리에-넣었더니-배경이-사라졌다&quot;&gt;둘 — 퍼센트 자리에 넣었더니 배경이 사라졌다&lt;/h2&gt;
&lt;p&gt;2026년 9월 2일, Emoticon Studio 목업에서 배지와 카드의 옅은 배경이 보이지 않았습니다. 토큰은 이렇게 적혀 있었습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;css&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;--wash: color-mix(in srgb&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; var(--text) light-dark(8%&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; 12%), transparent);&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;라이트에서는 글자색을 8%, 다크에서는 12% 섞으려 했습니다. 테마에 따라 비율만 바뀌니 그 자리에 &lt;code&gt;light-dark()&lt;/code&gt;를 넣은 것입니다.&lt;/p&gt;
&lt;p&gt;하지만 색상 값에 쓰는 &lt;code&gt;light-dark()&lt;/code&gt;는 &lt;strong&gt;두 색 중 하나를&lt;/strong&gt; 고르는 함수입니다(&lt;a href=&quot;https://www.w3.org/TR/css-color-5/#light-dark&quot;&gt;CSS Color 5&lt;/a&gt;). &lt;code&gt;8%&lt;/code&gt;와 &lt;code&gt;12%&lt;/code&gt;는 색이 아니므로 인자도, 결과를 쓸 자리도 맞지 않았습니다. &lt;code&gt;--wash&lt;/code&gt;라는 변수는 있어도 배경색으로 해석할 수 없는 값이 됐습니다.&lt;/p&gt;
&lt;p&gt;비율을 고르는 대신 색을 먼저 만들고 그 둘 중에서 골랐습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;css&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;--wash: light-dark(&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;  color-mix(in srgb&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; var(--text) 8%, transparent),&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;  color-mix(in srgb&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; var(--text) 12%, transparent)&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;);&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;변수 이름이 있다고 끝이 아니었습니다. 개발자 도구의 Computed에서 실제 &lt;code&gt;background-color&lt;/code&gt;까지 봐야 잡히는 문제였습니다.&lt;/p&gt;
&lt;figure&gt;&lt;img src=&quot;/images/design-system/light-dark-wash-before-after.webp&quot; alt=&quot;재현: 같은 두 토큰을 Chrome에서 다시 그린 것. 위는 퍼센트 자리에 light-dark()를 넣은 토큰으로 배지와 카드의 옅은 면이 사라지고, 아래는 색 두 개를 만든 뒤 고른 토큰이다&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;figcaption aria-hidden=&quot;true&quot;&gt;재현: 같은 두 토큰을 Chrome에서 다시 그린 것. 위는 퍼센트 자리에 light-dark()를 넣은 토큰으로 배지와 카드의 옅은 면이 사라지고, 아래는 색 두 개를 만든 뒤 고른 토큰이다&lt;/figcaption&gt;&lt;/figure&gt;
&lt;h2 id=&quot;셋--color-scheme을-바꿔도-배경이-그대로였다&quot;&gt;셋 — color-scheme을 바꿔도 배경이 그대로였다&lt;/h2&gt;
&lt;p&gt;이틀 뒤, 이모티콘 작업 조회 화면에서 밝은 테마를 골랐는데 배경은 어두운 채였습니다. 스크롤바와 폼만 바뀌었습니다. 스크립트는 테마를 고르면 루트의 &lt;code&gt;style.colorScheme&lt;/code&gt;을 바꾸고 있었고, 토큰은 위의 방식대로 적혀 있었습니다. 소스만 보면 맞았습니다.&lt;/p&gt;
&lt;p&gt;빌드 결과를 열었더니 &lt;code&gt;light-dark()&lt;/code&gt;가 하나도 없었습니다. 이 프로젝트의 Vite 8 빌드에서 Lightning CSS가 함수를 변수로 바꿔 놓았습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;css&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;--bg: var(--lightningcss-light&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt; #&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-dark:#FC7B7B&quot;&gt;f8f8f8&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;      var(--lightningcss-dark&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt; #&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#FF5370&quot;&gt;100d18&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;);&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;출력된 CSS에서 이 변수를 바꾸는 조건은 시스템 테마 미디어 쿼리와 &lt;code&gt;:root[data-theme=…]&lt;/code&gt; 선택자였습니다. 자바스크립트가 &lt;code&gt;color-scheme&lt;/code&gt;만 바꿔서는 그 선택자가 새로 걸리지 않았습니다. &lt;a href=&quot;https://lightningcss.dev/transpilation.html&quot;&gt;Lightning CSS 문서&lt;/a&gt;는 대상 브라우저가 &lt;code&gt;light-dark()&lt;/code&gt;를 지원하지 않을 때 이렇게 변수 폴백으로 바꾼다고 설명합니다.&lt;/p&gt;
&lt;p&gt;토큰을 다시 두 벌로 나눌 필요는 없었습니다. 테마 선택을 CSS에 전달하는 방식만 &lt;code&gt;data-theme&lt;/code&gt;으로 맞췄습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;ts&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;if&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#9ABDF5&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#C0CAF5&quot;&gt;next&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BB9AF7&quot;&gt; ===&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt; '&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt;system&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt;'&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#9ABDF5&quot;&gt;)&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;  delete&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#C0CAF5&quot;&gt; document&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#C0CAF5&quot;&gt;documentElement&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#C0CAF5&quot;&gt;dataset&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#7DCFFF&quot;&gt;theme&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt;}&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt; else&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#C0CAF5&quot;&gt;  document&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#C0CAF5&quot;&gt;documentElement&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#C0CAF5&quot;&gt;dataset&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#7DCFFF&quot;&gt;theme&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt; =&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#C0CAF5&quot;&gt; next&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;시스템 설정을 따를 때는 속성을 지웁니다. 시스템 모드를 그 순간의 밝음·어두움으로 바꿔 저장하면 이후 운영체제의 테마 변경을 따라가지 못하기 때문입니다.&lt;/p&gt;
&lt;h2 id=&quot;마치며&quot;&gt;마치며&lt;/h2&gt;
&lt;p&gt;세 번 모두 소스에는 문제가 없어 보였습니다. 첫째는 뒤에서 덮는 블록이, 둘째는 함수가 받는 값의 종류가, 셋째는 빌드가 바꿔 놓은 출력이 원인이었습니다. 그 뒤로 테마 색을 고치면 소스가 아니라 브라우저가 계산한 값과 빌드 결과를 먼저 엽니다.&lt;/p&gt;</content>
  </entry>
  <entry>
    <title>strings.xml의 줄바꿈이 공백으로 바뀐 이유</title>
    <link href="https://log.twinklelabs.kr/android/aapt-string-newline.html" rel="alternate"/>
    <id>https://log.twinklelabs.kr/android/aapt-string-newline.html</id>
    <published>2026-08-22T12:10:00.000Z</published>
    <updated>2026-08-22T12:10:00.000Z</updated>
    <author><name>Heejeong Kim</name></author>
    <category term="안드로이드"/>
    <category term="android"/>
    <category term="i18n"/>
    <category term="strings"/>
    <summary type="html">strings.xml에 두 줄로 적은 안내가 화면에서는 한 문장으로 붙었습니다. 네 문자열과 열한 언어를 수정하고, 실제 줄바꿈이 들어간 자원을 찾는 검사를 추가했습니다.</summary>
    <content type="html">&lt;h2 id=&quot;들어가며&quot;&gt;들어가며&lt;/h2&gt;
&lt;p&gt;설정 화면에서 안내 문장 두 개가 붙어 보였습니다.&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;선택 안 해도 계산 가능 나중에 이력에서 변경&lt;/p&gt;
&lt;/blockquote&gt;
&lt;h2 id=&quot;xml에-적어-둔-두-줄&quot;&gt;XML에 적어 둔 두 줄&lt;/h2&gt;
&lt;p&gt;&lt;code&gt;strings.xml&lt;/code&gt;에는 두 줄로 적혀 있었습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;xml&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BA3C97&quot;&gt;&amp;#x3C;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-dark:#F7768E&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-dark:#BB9AF7&quot;&gt; name&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#DE5971&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt;stock_optional_hint&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BA3C97&quot;&gt;&gt;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;선택 안 해도 계산 가능&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;나중에 이력에서 변경&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BA3C97&quot;&gt;&amp;#x3C;/&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-dark:#F7768E&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BA3C97&quot;&gt;&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;종목 선택은 나중에 해도 된다는 두 안내였습니다. 마침표 없이 짧게 끝나는 문구라 줄이 합쳐지자 어디서 끊어 읽어야 할지 알기 어려웠습니다.&lt;/p&gt;
&lt;h2 id=&quot;자원-파일의-줄바꿈과-화면의-줄바꿈&quot;&gt;자원 파일의 줄바꿈과 화면의 줄바꿈&lt;/h2&gt;
&lt;p&gt;안드로이드 자원 컴파일러 aapt는 문자열 자원 안에서 이어지는 공백을 하나로 접습니다. XML의 들여쓰기나 줄바꿈이 그대로 화면에 나오는 것을 막는 처리입니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;xml&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt;&amp;#x3C;!-- 적은 것 --&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BA3C97&quot;&gt;&amp;#x3C;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-dark:#F7768E&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-dark:#BB9AF7&quot;&gt; name&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#DE5971&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt;a&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BA3C97&quot;&gt;&gt;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;첫 줄&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;둘째 줄&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BA3C97&quot;&gt;&amp;#x3C;/&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-dark:#F7768E&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BA3C97&quot;&gt;&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt;&amp;#x3C;!-- 화면에 나오는 것 --&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;첫 줄 둘째 줄&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;파일에서 엔터를 누른 자리가 화면에서도 줄바꿈이 될 거라고 여길 수 있지만, 여기서는 공백으로 합쳐집니다. 화면의 줄바꿈은 &lt;code&gt;\n&lt;/code&gt;으로 적어야 합니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;xml&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BA3C97&quot;&gt;&amp;#x3C;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-dark:#F7768E&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-dark:#BB9AF7&quot;&gt; name&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#DE5971&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt;a&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BA3C97&quot;&gt;&gt;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;첫 줄\n둘째 줄&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BA3C97&quot;&gt;&amp;#x3C;/&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-dark:#F7768E&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BA3C97&quot;&gt;&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h2 id=&quot;같은-방식으로-작성한-네-문자열&quot;&gt;같은 방식으로 작성한 네 문자열&lt;/h2&gt;
&lt;p&gt;문자열을 더 찾아보니 같은 방식으로 적은 안내가 넷이었습니다. 그중 둘은 각 문장에 마침표가 있어 줄이 붙어도 읽을 수 있었습니다. 처음 눈에 띈 것은 마침표 없이 끝나는 두 문구였습니다.&lt;/p&gt;
&lt;p&gt;열한 언어의 번역 파일에도 같은 줄바꿈이 들어 있었습니다. 파일에서는 모두 두 줄이었지만 컴파일하면 한 줄이 됐습니다. 빌드와 린트에서는 오류가 나지 않았습니다.&lt;/p&gt;
&lt;figure&gt;&lt;img src=&quot;/images/android/aapt-newline-eleven-locales.webp&quot; alt=&quot;고치기 전 열한 언어의 번역 파일에 적혀 있던 같은 안내. 파일에서는 모두 두 줄이었고, 컴파일하면 줄바꿈이 공백 하나가 되어 «선택 안 해도 계산 가능 나중에 이력에서 변경»처럼 한 줄로 이어졌다&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;figcaption aria-hidden=&quot;true&quot;&gt;고치기 전 열한 언어의 번역 파일에 적혀 있던 같은 안내. 파일에서는 모두 두 줄이었고, 컴파일하면 줄바꿈이 공백 하나가 되어 «선택 안 해도 계산 가능 나중에 이력에서 변경»처럼 한 줄로 이어졌다&lt;/figcaption&gt;&lt;/figure&gt;
&lt;h2 id=&quot;실제-줄바꿈을-잡는-검사&quot;&gt;실제 줄바꿈을 잡는 검사&lt;/h2&gt;
&lt;p&gt;번역 완성도 검사인 &lt;code&gt;TranslationCompletenessTest&lt;/code&gt;에 문자열 내부의 실제 줄바꿈을 찾는 규칙을 추가했습니다. &lt;code&gt;\n&lt;/code&gt;으로 적은 줄바꿈은 허용하고, 파일에서 직접 줄을 나눈 경우를 잡도록 했습니다.&lt;/p&gt;
&lt;p&gt;검사를 만든 뒤 일부러 두 줄짜리 문자열을 넣어 봤습니다. 그 문자열에서 실패하는 것을 확인하고 임시 문자열을 지웠습니다.&lt;/p&gt;
&lt;h2 id=&quot;마치며&quot;&gt;마치며&lt;/h2&gt;
&lt;p&gt;문자열 안의 실제 줄바꿈을 &lt;code&gt;\n&lt;/code&gt;으로 바꾸고, 같은 형태가 다시 들어오면 검사에서 찾도록 했습니다.&lt;/p&gt;
&lt;p&gt;마침표 때문에 그럭저럭 읽히던 나머지 두 문자열도 고쳤습니다. 다음 안내를 작성할 때 그대로 따라 쓸 예를 남기고 싶지는 않았습니다.&lt;/p&gt;</content>
  </entry>
  <entry>
    <title>비워 둔 Typography 슬롯에 들어간 기본 글꼴</title>
    <link href="https://log.twinklelabs.kr/android/material3-typography-slots.html" rel="alternate"/>
    <id>https://log.twinklelabs.kr/android/material3-typography-slots.html</id>
    <published>2026-08-22T11:10:00.000Z</published>
    <updated>2026-08-22T11:10:00.000Z</updated>
    <author><name>Heejeong Kim</name></author>
    <category term="안드로이드"/>
    <category term="android"/>
    <category term="compose"/>
    <category term="design-system"/>
    <category term="typography"/>
    <summary type="html">Material3의 Typography 슬롯 열다섯 중 넷을 정의하지 않았더니 화면 일부에 기본 글꼴이 적용됐습니다. 모든 슬롯을 Pretendard로 채우고, 슬롯 수와 디자인의 글자 크기 단계를 구분했습니다.</summary>
    <content type="html">&lt;h2 id=&quot;들어가며&quot;&gt;들어가며&lt;/h2&gt;
&lt;p&gt;물타기 계산기의 제목은 Pretendard인데, 같은 화면의 숫자는 다른 글꼴로 보였습니다. 결과 카드의 3열 대시보드와 키패드 판독값, 숫자 키에서 차이가 났습니다.&lt;/p&gt;
&lt;p&gt;글꼴 설정을 보니 &lt;code&gt;displaySmall&lt;/code&gt;, &lt;code&gt;headlineSmall&lt;/code&gt;, &lt;code&gt;bodySmall&lt;/code&gt;, &lt;code&gt;titleSmall&lt;/code&gt; 네 슬롯을 생략한 상태였습니다. 목업 문서에는 쓰지 않는 슬롯이라고 적어 뒀지만, 실제 화면에서는 네 슬롯을 모두 사용하고 있었습니다.&lt;/p&gt;
&lt;figure&gt;&lt;img src=&quot;/images/android/typography-slots-keypad.webp&quot; alt=&quot;물타기 계산기의 키패드가 열린 화면(2026-08-23, 슬롯을 채운 뒤). 결과 카드의 3열 대시보드는 bodySmall·titleSmall, 키패드 판독값은 displaySmall, 숫자 키는 headlineSmall 슬롯이다. 채우기 전에는 이 네 자리가 Roboto로 그려졌다&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;figcaption aria-hidden=&quot;true&quot;&gt;물타기 계산기의 키패드가 열린 화면(2026-08-23, 슬롯을 채운 뒤). 결과 카드의 3열 대시보드는 bodySmall·titleSmall, 키패드 판독값은 displaySmall, 숫자 키는 headlineSmall 슬롯이다. 채우기 전에는 이 네 자리가 Roboto로 그려졌다&lt;/figcaption&gt;&lt;/figure&gt;
&lt;h2 id=&quot;생략한-네-슬롯의-기본값&quot;&gt;생략한 네 슬롯의 기본값&lt;/h2&gt;
&lt;p&gt;Material3의 &lt;code&gt;Typography&lt;/code&gt;에는 열다섯 슬롯이 있습니다. 당시에는 열하나만 정의하고 넷은 생략했습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt;// 이렇게 적으면 &quot;넷은 없다&quot;가 아닙니다&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;val&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; TwinkleTypography &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt; Typography&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    displayLarge &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt; TextStyle&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(fontFamily &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; Pretendard, &lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt;/* … */&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    displayMedium &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt; TextStyle&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(fontFamily &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; Pretendard, &lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt;/* … */&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt;    // displaySmall — 안 쓰니까 뺐습니다&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    headlineLarge &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt; TextStyle&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(fontFamily &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; Pretendard, &lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt;/* … */&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    headlineMedium &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt; TextStyle&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(fontFamily &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; Pretendard, &lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt;/* … */&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt;    // headlineSmall — 안 쓰니까 뺐습니다&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt;    // …&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;)&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;code&gt;Typography()&lt;/code&gt;의 매개변수는 기본 &lt;code&gt;TextStyle&lt;/code&gt;을 가집니다. 인자를 넘기지 않으면 슬롯이 없어지는 대신 Material의 기본값을 사용합니다. 그 결과 생략한 슬롯에는 Pretendard 대신 기본 글꼴인 Roboto가 적용됐습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;displaySmall &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt; /* Material 이 알아서 채웁니다 — Roboto 로 */&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h2 id=&quot;한글보다-숫자에서-드러난-차이&quot;&gt;한글보다 숫자에서 드러난 차이&lt;/h2&gt;
&lt;p&gt;Roboto와 Pretendard는 모두 산세리프입니다. Roboto에 없는 한글은 시스템 한글 글꼴로 대체되므로, 한글만 보면서 글꼴 차이를 알아채기 어려웠습니다. 숫자와 라틴 문자를 표시하는 대시보드와 키패드에서 차이가 드러났습니다.&lt;/p&gt;
&lt;figure&gt;&lt;img src=&quot;/images/android/typography-roboto-vs-pretendard.webp&quot; alt=&quot;재현: 같은 크기와 굵기에서 글꼴만 바꿔 다시 그린 3열 대시보드, 키패드 판독값, 숫자 키. 위는 Roboto(한글은 대체 글꼴), 아래는 Pretendard다. 한글은 비슷해 보이고 숫자와 ₩ 기호의 모양이 다르다&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;figcaption aria-hidden=&quot;true&quot;&gt;재현: 같은 크기와 굵기에서 글꼴만 바꿔 다시 그린 3열 대시보드, 키패드 판독값, 숫자 키. 위는 Roboto(한글은 대체 글꼴), 아래는 Pretendard다. 한글은 비슷해 보이고 숫자와 ₩ 기호의 모양이 다르다&lt;/figcaption&gt;&lt;/figure&gt;
&lt;h2 id=&quot;글꼴은-열다섯-슬롯에-크기는-기존-열-단계로&quot;&gt;글꼴은 열다섯 슬롯에, 크기는 기존 열 단계로&lt;/h2&gt;
&lt;p&gt;네 슬롯에도 Pretendard를 지정했습니다. 쓰지 않는다고 적어 둔 문서보다 실제 화면 호출부를 먼저 확인했어야 했습니다.&lt;/p&gt;
&lt;p&gt;슬롯이 열다섯이라고 글자 크기도 열다섯 종류를 만들 필요는 없습니다. 디자인에서 정한 크기는 열 단계였습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;plaintext&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span&gt;11 · 12 · 14 · 16 · 20 · 24 · 28 · 32 · 36 · 40&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;키패드의 숫자 키와 이력의 결과 숫자는 모두 24를 쓰고 굵기로 구분합니다. 이런 식으로 여러 슬롯에 같은 크기를 배정해, 크기는 기존 열 단계를 유지했습니다.&lt;/p&gt;
&lt;h2 id=&quot;마치며&quot;&gt;마치며&lt;/h2&gt;
&lt;p&gt;비워 둔 네 슬롯을 채워 화면에서 쓰는 글꼴을 맞췄습니다. 열다섯 슬롯마다 새로운 크기를 만들지는 않았습니다. 글꼴을 빠짐없이 지정하는 일과 디자인의 크기 단계를 정하는 일을 나눠 처리했습니다.&lt;/p&gt;</content>
  </entry>
  <entry>
    <title>업로드는 성공했고 스크린샷 55장은 빠졌다</title>
    <link href="https://log.twinklelabs.kr/stock-calculator/first-app-play-store.html" rel="alternate"/>
    <id>https://log.twinklelabs.kr/stock-calculator/first-app-play-store.html</id>
    <published>2026-08-22T02:30:00.000Z</published>
    <updated>2026-08-22T02:30:00.000Z</updated>
    <author><name>Heejeong Kim</name></author>
    <category term="물타기 계산기"/>
    <category term="android"/>
    <category term="play-store"/>
    <category term="출시기"/>
    <category term="gradle"/>
    <category term="개인개발"/>
    <summary type="html">11개 언어의 스토어 자료를 준비했지만 실제로 올라간 것은 기존 한국어 등록정보뿐이었습니다. 잘못된 폴더 경로를 발견하고, 서명·권한·업로드 결과를 각각 확인한 기록입니다.</summary>
    <content type="html">&lt;h2 id=&quot;들어가며&quot;&gt;들어가며&lt;/h2&gt;
&lt;p&gt;11개 언어에 스크린샷을 5장씩 준비했습니다. 모두 55장이었습니다. 빌드와 업로드도 성공했는데, Play 콘솔에 올라간 것은 스크린샷 3장과 옛 문구가 담긴 한국어 등록정보뿐이었습니다.&lt;/p&gt;
&lt;p&gt;이 글을 쓰면서 등록정보 폴더가 잘못됐다는 것을 발견했습니다. 파일은 &lt;code&gt;app/play/&lt;/code&gt;에 만들어 뒀는데, Gradle Play Publisher가 읽는 곳은 &lt;code&gt;app/src/main/play/&lt;/code&gt;였습니다. 준비한 55장은 업로드 대상에 들어가지도 않았습니다.&lt;/p&gt;
&lt;p&gt;광고와 결제를 붙인 뒤 업로드를 준비하는 데 이틀을 썼습니다. 서명, 버전 번호, 서비스 계정 권한을 정하고 등록정보를 만드는 과정이었습니다. 2026년 8월 22일인 지금은 테스트 트랙까지 올린 상태입니다.&lt;/p&gt;
&lt;h2 id=&quot;스토어에-올릴-자료부터&quot;&gt;스토어에 올릴 자료부터&lt;/h2&gt;
&lt;p&gt;제목, 짧은 설명, 긴 설명과 함께 512×512 아이콘, 1024×500 피처 그래픽을 준비했습니다. 스크린샷 55장은 에뮬레이터에서 자동으로 찍었습니다.&lt;/p&gt;
&lt;figure&gt;&lt;img src=&quot;/images/stock-calculator/feature-graphic.webp&quot; alt=&quot;스토어에 올린 1024×500 피처 그래픽&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;figcaption aria-hidden=&quot;true&quot;&gt;스토어에 올린 1024×500 피처 그래픽&lt;/figcaption&gt;&lt;/figure&gt;
&lt;p&gt;좌표를 고정해 누르면 언어별 글자 길이에 따라 버튼이 밀릴 수 있었습니다. 그래서 &lt;code&gt;uiautomator&lt;/code&gt;로 요소를 찾아 조작하게 했습니다. 독일어에서도 같은 기능의 화면을 찍기 위한 방식이었습니다.&lt;/p&gt;
&lt;figure&gt;&lt;img src=&quot;/images/stock-calculator/english-screenshots.webp&quot; alt=&quot;uiautomator로 다시 찍은 영어 스크린샷 다섯 장(8월 23일). 계산, 목표 평단가, 키패드, 계산 이력, 다크 테마&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;figcaption aria-hidden=&quot;true&quot;&gt;uiautomator로 다시 찍은 영어 스크린샷 다섯 장(8월 23일). 계산, 목표 평단가, 키패드, 계산 이력, 다크 테마&lt;/figcaption&gt;&lt;/figure&gt;
&lt;p&gt;개인정보 처리방침은 웹에 게시하고, Play의 데이터 보안 양식도 작성했습니다. 계산 기록을 서버로 보내지 않더라도 광고 SDK가 처리하는 데이터는 별도로 확인해야 했습니다. 광고 포함 여부, 타겟 연령층, 콘텐츠 등급도 앱 콘텐츠 설문에 적었습니다.&lt;/p&gt;
&lt;p&gt;설정 화면에는 Pretendard의 SIL OFL 1.1 고지와, 투자 자문을 제공하지 않는 금융 계산 도구라는 설명을 넣었습니다. 둘 다 배포 전에 빠지지 않도록 테스트에 포함했습니다.&lt;/p&gt;
&lt;h2 id=&quot;내가-보관할-키는-업로드-키&quot;&gt;내가 보관할 키는 업로드 키&lt;/h2&gt;
&lt;p&gt;Play 앱 서명을 사용해 최종 앱 서명 키는 구글에 맡겼습니다. 직접 보관할 것은 번들을 올릴 권한을 확인하는 업로드 키였습니다.&lt;/p&gt;
&lt;p&gt;직접 최종 서명 키를 관리하다 잃으면 같은 앱을 업데이트할 수 없습니다. 업로드 키는 분실하더라도 콘솔에서 재설정을 요청할 수 있습니다. 재설정에 며칠이 걸리는 것으로 확인했으므로, 요청 절차에 의존하지 않도록 별도 백업도 필요했습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;val&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; keystoreProperties &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; rootProject.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;file&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt;&quot;keystore.properties&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;if&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; (keystoreProperties.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;exists&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;()) {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;    val&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; props &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt; Properties&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;apply&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; { keystoreProperties.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;inputStream&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;use&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; { &lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;load&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(it) } }&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;    signingConfigs&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;        create&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt;&quot;release&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;            storeFile &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; rootProject.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;file&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(props.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;getProperty&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt;&quot;storeFile&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;))&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;            storePassword &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; props.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;getProperty&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt;&quot;storePassword&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;            …&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;키와 비밀번호는 git에 넣지 않았습니다. &lt;code&gt;keystore.properties&lt;/code&gt;가 없는 기계나 CI에서는 서명 없이 빌드하고, 서명에 필요한 값은 해당 환경에 따로 제공하도록 했습니다.&lt;/p&gt;
&lt;h2 id=&quot;되돌릴-수-있는-번호와-없는-번호&quot;&gt;되돌릴 수 있는 번호와 없는 번호&lt;/h2&gt;
&lt;p&gt;시험 삼아 처음 올린 번들에서 &lt;code&gt;versionCode = 1&lt;/code&gt;을 사용했습니다. 그 번호를 다시 쓸 수 없어 다음 업로드는 2부터 시작했습니다.&lt;/p&gt;
&lt;div class=&quot;table-wrap&quot;&gt;



















&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;항목&lt;/th&gt;&lt;th&gt;역할&lt;/th&gt;&lt;th&gt;이후 업로드에서 변경할 때&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;code&gt;versionCode&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Play가 구분하는 정수&lt;/td&gt;&lt;td&gt;한 번 사용한 번호를 다시 쓸 수 없음&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code&gt;versionName&lt;/code&gt;&lt;/td&gt;&lt;td&gt;사용자에게 보이는 버전 문자열&lt;/td&gt;&lt;td&gt;이전 표시 버전으로 되돌릴 수 있음&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;&lt;/div&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt;// versionCode 1은 예전 번들이 Play 콘솔에 먹었습니다 — 콘솔은 한 번 본 코드를 다시 받지 않아요&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;versionCode &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#FE640B;--shiki-dark:#FF9E64&quot;&gt; 6&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;versionName &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt; &quot;1.0.0&quot;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;테스트 트랙에 세 번 올리는 동안 &lt;code&gt;versionName&lt;/code&gt;은 1.0에서 1.3까지 바뀌었습니다. 공개판은 아직 내지 않았으므로 표시 버전을 1.0.0으로 되돌렸습니다. &lt;code&gt;versionCode&lt;/code&gt;는 계속 증가시켰습니다.&lt;/p&gt;
&lt;p&gt;타겟 API도 올렸습니다. 당시에는 2026-08-31을 마감으로 잡고 API 36을 요구 수준으로 준비했습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;plaintext&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span&gt;Chore: targetSdk 를 36 으로 올린다 — Play 마감 2026-08-31&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;code&gt;targetSdk&lt;/code&gt; 변경에 따라 권한이나 백그라운드 제한 같은 동작도 달라질 수 있어서, 번호만 바꾸고 끝낼 수는 없었습니다. 출시 직전에 한꺼번에 확인하기에는 부담이 있었습니다.&lt;/p&gt;
&lt;h2 id=&quot;키를-다시-만들어도-해결되지-않은-오류&quot;&gt;키를 다시 만들어도 해결되지 않은 오류&lt;/h2&gt;
&lt;p&gt;Gradle Play Publisher로 번들과 등록정보를 올리게 했습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;plaintext&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span&gt;./gradlew publishReleaseBundle                       # 내부 테스트&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;./gradlew publishReleaseBundle --track production     # 프로덕션&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;./gradlew publishReleaseListing                       # 등록정보·스크린샷&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;Google Cloud에서 서비스 계정 키를 만들고 Play 콘솔에서 권한을 줬습니다. 여기서 두 오류를 만났습니다.&lt;/p&gt;
&lt;p&gt;&lt;code&gt;accessNotConfigured&lt;/code&gt;는 Cloud 프로젝트에서 Google Play Android Developer API를 켜지 않아 발생했습니다. 당시 이 API를 켜는 데 별도 비용은 없었고 1분 정도면 됐지만, 원인을 찾는 데 30분이 걸렸습니다.&lt;/p&gt;
&lt;p&gt;&lt;code&gt;The caller does not have permission&lt;/code&gt;은 Play 콘솔의 ‘사용자 및 권한’에서 서비스 계정에 앱 접근과 출시 권한을 주어 해결했습니다. Cloud IAM 역할을 바꾸는 것으로는 해결되지 않았습니다.&lt;/p&gt;
&lt;p&gt;처음에는 둘 다 키 문제라고 보고 키를 여러 번 다시 만들었습니다. 실제로 확인할 곳은 API 활성화와 Play 콘솔 권한이었습니다.&lt;/p&gt;
&lt;h2 id=&quot;업로드할-파일과-올릴-트랙을-확인하기&quot;&gt;업로드할 파일과 올릴 트랙을 확인하기&lt;/h2&gt;
&lt;p&gt;권한 문제를 해결하고 업로드가 성공한 뒤에도, 맨 앞의 스크린샷 누락은 남았습니다. 플러그인이 어느 폴더에서 파일을 모으는지까지 확인해야 했습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;plaintext&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span&gt;./gradlew generateReleasePlayResources&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;# → app/build/generated/gpp/release/play/ 아래에 실제로 올라갈 것이 모입니다&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;여기서 준비한 로케일과 스크린샷이 실제 업로드 대상에 들어갔는지 볼 수 있습니다. 원본 폴더만 확인하고 넘어간 부분이었습니다.&lt;/p&gt;
&lt;p&gt;기본 업로드 트랙은 내부 테스트로 뒀습니다. 당시 내부 테스트는 최대 100명을 대상으로 하고 심사 대기가 거의 없어 개발 중 사용하기 좋았습니다. 지정한 테스터에게 배포하는 비공개 테스트, 누구나 참여할 수 있는 공개 테스트, 전체 공개인 프로덕션과 구분했습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;play&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    track.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;set&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt;&quot;internal&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    defaultToAppBundles.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;set&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;--shiki-light:#FE640B;--shiki-dark:#FF9E64&quot;&gt;true&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    releaseStatus.&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;set&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(ReleaseStatus.COMPLETED)&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;프로덕션으로 올릴 때만 &lt;code&gt;--track production&lt;/code&gt;을 명시합니다. 기본 명령에는 내부 테스트를 남겼습니다.&lt;/p&gt;
&lt;h2 id=&quot;마치며&quot;&gt;마치며&lt;/h2&gt;
&lt;p&gt;앱을 만드는 데 열흘, 업로드 준비에 이틀이 걸렸습니다. 그 뒤 이 글을 쓰다가 스크린샷 경로가 잘못됐다는 걸 알았습니다. 앱 내부에서 겪은 문제들은 &lt;a href=&quot;/category/android/&quot;&gt;안드로이드를 만들며 배운 것&lt;/a&gt;에 따로 남겼습니다.&lt;/p&gt;</content>
  </entry>
  <entry>
    <title>광고를 보여줘도 되는 순간</title>
    <link href="https://log.twinklelabs.kr/stock-calculator/first-app-admob.html" rel="alternate"/>
    <id>https://log.twinklelabs.kr/stock-calculator/first-app-admob.html</id>
    <published>2026-08-22T02:00:00.000Z</published>
    <updated>2026-08-22T02:00:00.000Z</updated>
    <author><name>Heejeong Kim</name></author>
    <category term="물타기 계산기"/>
    <category term="android"/>
    <category term="admob"/>
    <category term="출시기"/>
    <category term="수익화"/>
    <category term="billing"/>
    <summary type="html">계산기에 배너·전면·보상형 광고를 넣으며 동의, 구매, 저장 완료 상태에 따라 요청을 나눴습니다. 에뮬레이터에서 광고가 비어 있던 원인은 DNS였습니다.</summary>
    <content type="html">&lt;h2 id=&quot;들어가며&quot;&gt;들어가며&lt;/h2&gt;
&lt;p&gt;물타기 계산기에 광고를 넣으면서 먼저 자리를 정했습니다. 배너는 바텀바 위, 전면 광고는 계산을 저장한 뒤 세 번에 한 번, 보상형 광고는 무료 종목 3개를 넘겨 만들 때 보여주기로 했습니다.&lt;/p&gt;
&lt;p&gt;자리를 정하고 나니 광고를 요청할 조건이 남았습니다. 동의가 끝났는지, 광고 제거 상품을 샀는지, 계산은 저장됐는지 확인해야 했습니다. 2026년 8월 테스트 트랙을 준비하며 광고를 붙이는 데 하루를 썼습니다.&lt;/p&gt;
&lt;h2 id=&quot;id-두-개부터-구분하기&quot;&gt;ID 두 개부터 구분하기&lt;/h2&gt;
&lt;p&gt;AdMob 콘솔에서는 앱과 광고 단위를 따로 만듭니다.&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;앱 ID (&lt;code&gt;ca-app-pub-…~…&lt;/code&gt;): 앱마다 하나이며 매니페스트에 넣습니다.&lt;/li&gt;
&lt;li&gt;광고 단위 ID (&lt;code&gt;ca-app-pub-…/…&lt;/code&gt;): 배너·전면·보상형처럼 광고 자리마다 만들고 코드에서 사용합니다.&lt;/li&gt;
&lt;/ul&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;xml&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BA3C97&quot;&gt;&amp;#x3C;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-dark:#F7768E&quot;&gt;meta-data&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-dark:#BB9AF7&quot;&gt;    android&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-dark:#BB9AF7&quot;&gt;name&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#DE5971&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt;com.google.android.gms.ads.APPLICATION_ID&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-dark:#BB9AF7&quot;&gt;    android&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-dark:#BB9AF7&quot;&gt;value&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#DE5971&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt;ca-app-pub-…~…&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#89DDFF&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BA3C97&quot;&gt; /&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;앱 ID가 없거나 잘못되면 SDK가 예외를 발생시켜 앱이 시작하자마자 종료됐습니다. 처음에는 광고 설정과 앱 실행 실패를 연결하지 못했습니다. ID 안의 물결(&lt;code&gt;~&lt;/code&gt;)과 빗금(&lt;code&gt;/&lt;/code&gt;)을 구분하는 데서 시작했습니다.&lt;/p&gt;
&lt;p&gt;광고 형식도 맞아야 했습니다. 콘솔의 ‘보상형’과 ‘보상형 전면(베타)’을 혼동해 코드와 다르게 만들었을 때는 SDK가 로드를 거절했습니다. 에러 메시지만 보고는 원인을 바로 찾지 못했습니다.&lt;/p&gt;
&lt;p&gt;테스트 광고와 실제 광고를 매번 손으로 바꾸지 않도록 빌드에서 선택하게 했습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;object&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt; AdUnits&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt;    private&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt; const&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt; val&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; TEST_BANNER &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt; &quot;ca-app-pub-3940256099942544/9214589741&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;    val&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; BANNER &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt; if&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; (BuildConfig.DEBUG) TEST_BANNER&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;                 else&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt; &quot;ca-app-pub-…/…&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt;   // 실제 단위&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;디버그에는 구글 공식 테스트 단위를, 릴리스에는 실제 단위를 사용합니다. 매니페스트의 앱 ID는 양쪽 모두 실제 ID입니다. 당시 구글 안내에 따라 이 조합을 썼습니다. 테스트 ID로 출시하면 수익이 나지 않고, 개발 중 실제 광고를 반복해서 누르는 것도 무효 트래픽 문제를 만들 수 있어서 빌드 설정에 맡겼습니다.&lt;/p&gt;
&lt;h2 id=&quot;동의와-구매-상태를-먼저&quot;&gt;동의와 구매 상태를 먼저&lt;/h2&gt;
&lt;p&gt;당시 EEA·영국·스위스에 광고를 제공할 때는 인증된 동의 플랫폼(CMP)이 필요했습니다. 구글의 UMP(User Messaging Platform) SDK를 붙여 필요한 동의 절차가 끝나기 전에는 광고를 요청하지 않도록 했습니다.&lt;/p&gt;
&lt;p&gt;모든 사용자에게 폼을 띄우지는 않습니다. UMP가 동의 필요 여부를 판단하고, 한국 사용자에게 동의가 불필요하다고 응답하면 폼 없이 다음 단계로 넘어갑니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;object&lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt; ConsentGate&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;    var&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; canRequestAds &lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt;by&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt; mutableStateOf&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;--shiki-light:#FE640B;--shiki-dark:#FF9E64&quot;&gt;false&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt;        private&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-light-font-style:inherit;--shiki-dark:#9D7CD8;--shiki-dark-font-style:italic&quot;&gt; set&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    …&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;배너, 전면, 보상형 모두 요청 전에 이 값을 봅니다. 동의를 다시 선택할 수 있어야 하는 지역에는 설정의 ‘광고 개인정보 선택’을 보여주고, 필요 없는 경우에는 숨겼습니다.&lt;/p&gt;
&lt;p&gt;광고 제거용으로는 Play Billing의 비소모성 상품 하나를 등록했습니다. 앱 시작 시 같은 구글 계정의 구매 상태를 조회하므로, 재설치 뒤에도 별도의 복원 버튼 없이 광고를 제거할 수 있습니다. 소유 상태를 조회하면서 미확인 구매도 처리했습니다. 구매를 확인(acknowledge)하지 않으면 3일 뒤 자동 환불되는 조건이 있었기 때문입니다.&lt;/p&gt;
&lt;p&gt;구매를 확인한 뒤에는 광고뿐 아니라 광고 제거 구매 항목도 숨겼습니다. 이미 산 상품을 다시 살 수 있는 것처럼 보일 필요가 없었습니다.&lt;/p&gt;
&lt;figure&gt;&lt;img src=&quot;/images/stock-calculator/test-banner-remove-ads.webp&quot; alt=&quot;왼쪽은 디버그 빌드의 계산 화면 아래 붙은 구글 테스트 배너(영어), 오른쪽은 설정의 «광고 제거» 줄(다크). 배너 자리는 로드 전에도 높이를 비워 둔다&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;figcaption aria-hidden=&quot;true&quot;&gt;왼쪽은 디버그 빌드의 계산 화면 아래 붙은 구글 테스트 배너(영어), 오른쪽은 설정의 «광고 제거» 줄(다크). 배너 자리는 로드 전에도 높이를 비워 둔다&lt;/figcaption&gt;&lt;/figure&gt;
&lt;h2 id=&quot;계산하는-중에는-기다리지-않도록&quot;&gt;계산하는 중에는 기다리지 않도록&lt;/h2&gt;
&lt;p&gt;배너는 로드 전에 높이를 비워뒀습니다. 광고가 도착하면서 화면이 밀리면 사용자가 누르려던 버튼 자리에 광고가 올 수 있습니다. 키패드가 올라와 숫자를 입력하는 동안에는 배너를 숨겼습니다.&lt;/p&gt;
&lt;p&gt;전면 광고는 저장을 끝냈고, 광고도 미리 로드된 경우에만 보여줬습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;fun&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt; onSaved&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(activity: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#DF8E1D;--shiki-light-font-style:italic;--shiki-dark:#C0CAF5;--shiki-dark-font-style:inherit&quot;&gt;Activity&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    saves &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;+=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#FE640B;--shiki-dark:#FF9E64&quot;&gt; 1&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; (saves &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;%&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; everyN &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BB9AF7&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#FE640B;--shiki-dark:#FF9E64&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;) { &lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;preload&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(activity); &lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;return&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; }&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;    val&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; ad &lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; loaded ?: &lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;run&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; { &lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;preload&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(activity); &lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#BB9AF7&quot;&gt;return&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt; }   &lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt;// 준비 안 됐으면 그냥 보냅니다&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;    …&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;광고가 준비되지 않았다면 다음 로드를 요청하고 저장 흐름은 끝냅니다. 광고를 받느라 저장 완료를 늦추지 않으려는 순서입니다.&lt;/p&gt;
&lt;p&gt;배너 객체의 수명도 바꿨습니다. 처음에는 컴포저블 안에서 &lt;code&gt;AdView&lt;/code&gt;를 만들었는데, 키패드를 여닫을 때마다 객체가 파괴되고 새 광고를 요청했습니다. 그 과정에서 배너가 비는 현상을 봤습니다. 잦은 요청이 광고 채움에 영향을 줄 가능성도 고려해, 배너를 한 번 만든 뒤 앱이 실행되는 동안 재사용하도록 했습니다.&lt;/p&gt;
&lt;h2 id=&quot;광고-자리만-보였던-반나절&quot;&gt;광고 자리만 보였던 반나절&lt;/h2&gt;
&lt;p&gt;에뮬레이터에서는 배너 공간이 생겨도 광고가 계속 비어 있었습니다. 로그에 남은 내용은 다음과 같았습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;plaintext&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span&gt;Unable to resolve host … No address associated with hostname&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;Ad failed to load : 0&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;기본 설정으로 실행한 에뮬레이터가 &lt;code&gt;googleads.g.doubleclick.net&lt;/code&gt;을 해석하지 못하고 있었습니다. 원인을 찾는 데 반나절이 걸렸습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;plaintext&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span&gt;emulator -avd &amp;#x3C;이름&gt; -dns-server 8.8.8.8,1.1.1.1&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;DNS를 지정해 다시 실행하자 테스트 광고가 표시됐습니다. 광고 자리와 ID는 그대로 둔 채로였습니다.&lt;/p&gt;
&lt;h2 id=&quot;마치며&quot;&gt;마치며&lt;/h2&gt;
&lt;p&gt;광고 요청에는 동의와 구매 상태를 반영했고, 전면 광고는 저장이 끝난 뒤 준비된 경우에만 보여주게 했습니다. 광고를 기다리느라 계산이나 저장 흐름이 멈추지 않도록 순서를 정했습니다.&lt;/p&gt;</content>
  </entry>
  <entry>
    <title>HTML 목업에서 앱으로 넘어간 시점</title>
    <link href="https://log.twinklelabs.kr/stock-calculator/first-app-design-cycle.html" rel="alternate"/>
    <id>https://log.twinklelabs.kr/stock-calculator/first-app-design-cycle.html</id>
    <published>2026-08-22T01:30:00.000Z</published>
    <updated>2026-08-22T01:30:00.000Z</updated>
    <author><name>Heejeong Kim</name></author>
    <category term="물타기 계산기"/>
    <category term="android"/>
    <category term="출시기"/>
    <category term="design-system"/>
    <category term="개인개발"/>
    <summary type="html">HTML 목업과 안드로이드 앱을 함께 고치다가, 실제 기기의 줄바꿈과 자판 동작은 목업으로 확인할 수 없다는 한계를 만났습니다. 8월 22일에 동기화를 끝낸 이유입니다.</summary>
    <content type="html">&lt;h2 id=&quot;들어가며&quot;&gt;들어가며&lt;/h2&gt;
&lt;p&gt;8월 22일, 앱의 안내 시트에서 ‘그대로입니다’가 ‘그대로입니 / 다’로 끊겼습니다. HTML 목업에는 &lt;code&gt;keep-all&lt;/code&gt;이 있어 멀쩡하게 보이던 문구였습니다. 앱에는 그에 맞는 처리가 없었습니다.&lt;/p&gt;
&lt;p&gt;그동안은 HTML 목업에서 화면을 고르고 앱으로 옮긴 뒤, 둘이 달라지면 다시 맞췄습니다. 그런데 목업에서 멀쩡한 문구가 기기에서는 잘렸습니다. 이날을 끝으로 두 화면을 똑같이 유지하는 일을 멈췄습니다.&lt;/p&gt;
&lt;h2 id=&quot;처음에는-브라우저가-빨랐습니다&quot;&gt;처음에는 브라우저가 빨랐습니다&lt;/h2&gt;
&lt;p&gt;첫 커밋에는 앱과 목업이 함께 들어 있습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;plaintext&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span&gt;Initial commit: add stock calculator app and design mockup&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;plaintext&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span&gt;stock-calculator/&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;├── design/    ← 화면 설계 + 디자인 토큰 (mockup.html)&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;└── app/       ← 안드로이드 소스&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;code&gt;design/mockup.html&lt;/code&gt; 한 장에 계산기, 이력, 설정, 시트, 확인창, 키패드 서랍을 넣었습니다. 앱이 없을 때는 Compose를 다시 빌드하기보다 브라우저를 새로고침하며 배치를 고르는 편이 빨랐습니다.&lt;/p&gt;
&lt;figure&gt;&lt;img src=&quot;/images/stock-calculator/mockup-vs-app.webp&quot; alt=&quot;8월 22일의 HTML 목업(왼쪽, 다크 테마)과 하루 전 기기에서 찍은 앱(오른쪽). 같은 계산 화면이지만 입력칸의 묶음, 결과의 차례, 키패드가 아직 달랐다&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;figcaption aria-hidden=&quot;true&quot;&gt;8월 22일의 HTML 목업(왼쪽, 다크 테마)과 하루 전 기기에서 찍은 앱(오른쪽). 같은 계산 화면이지만 입력칸의 묶음, 결과의 차례, 키패드가 아직 달랐다&lt;/figcaption&gt;&lt;/figure&gt;
&lt;p&gt;Figma 대신 HTML을 쓴 이유도 여기에 있습니다. 화면을 보는 데서 그치지 않고 시트와 키패드를 직접 열고 닫을 수 있었습니다. 색, 간격, 모서리와 움직임은 &lt;code&gt;:root&lt;/code&gt;의 CSS 변수로 정했습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;css&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#E0AF68&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#BB9AF7&quot;&gt;root&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-dark:#C0CAF5&quot;&gt;  --s1&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;--shiki-light:#FE640B;--shiki-dark:#FF9E64&quot;&gt; 8&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#F7768E&quot;&gt;px&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-dark:#C0CAF5&quot;&gt;   --s1h&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;--shiki-light:#FE640B;--shiki-dark:#FF9E64&quot;&gt; 12&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#F7768E&quot;&gt;px&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-dark:#C0CAF5&quot;&gt;  --s2&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;--shiki-light:#FE640B;--shiki-dark:#FF9E64&quot;&gt; 16&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#F7768E&quot;&gt;px&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-dark:#C0CAF5&quot;&gt;  --radius-card&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;--shiki-light:#FE640B;--shiki-dark:#FF9E64&quot;&gt; 18&lt;/span&gt;&lt;span style=&quot;--shiki-light:#8839EF;--shiki-dark:#F7768E&quot;&gt;px&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-dark:#C0CAF5&quot;&gt;  --ease&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#0DB9D7;--shiki-dark-font-style:inherit&quot;&gt; cubic-bezier&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;--shiki-light:#FE640B;--shiki-dark:#FF9E64&quot;&gt;.25&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;--shiki-light:#FE640B;--shiki-dark:#FF9E64&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;--shiki-light:#FE640B;--shiki-dark:#FF9E64&quot;&gt;.5&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;--shiki-light:#FE640B;--shiki-dark:#FF9E64&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt;)&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-dark:#C0CAF5&quot;&gt;  --exit&lt;/span&gt;&lt;span style=&quot;--shiki-light:#179299;--shiki-dark:#89DDFF&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#0DB9D7;--shiki-dark-font-style:inherit&quot;&gt; cubic-bezier&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;--shiki-light:#FE640B;--shiki-dark:#FF9E64&quot;&gt;.4&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;--shiki-light:#FE640B;--shiki-dark:#FF9E64&quot;&gt;0&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;--shiki-light:#FE640B;--shiki-dark:#FF9E64&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;--shiki-light:#FE640B;--shiki-dark:#FF9E64&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt;)&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#89DDFF&quot;&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#9ABDF5&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;앱의 토큰 표도 이 값을 기준으로 만들었습니다. 이후 &lt;a href=&quot;/design-system/aurora-ledger.html&quot;&gt;Aurora Ledger&lt;/a&gt;의 출발점이 된 값들입니다. 시트가 올라오는 속도나 키패드가 닫히는 느낌은 정지 화면보다 직접 조작할 때 판단하기 쉬웠습니다.&lt;/p&gt;
&lt;p&gt;브라우저에서는 화면 폭 때문에 혼동한 적도 있습니다. 헤드리스 브라우저에 &lt;code&gt;--window-size=390&lt;/code&gt;을 줬는데, 캡처만 390px로 잘리고 레이아웃은 489px로 그려졌습니다. 잘린 오른쪽을 가로 스크롤 문제로 오인할 뻔했습니다. 이후에는 폭을 고정한 iframe 안에서 &lt;code&gt;scrollWidth&lt;/code&gt;와 &lt;code&gt;clientWidth&lt;/code&gt;를 비교했습니다.&lt;/p&gt;
&lt;h2 id=&quot;두-화면을-함께-고치던-날들&quot;&gt;두 화면을 함께 고치던 날들&lt;/h2&gt;
&lt;p&gt;처음에는 목업에서 색과 간격을 바꿔 보고 앱에 옮겼습니다. 앱에서 새 차이를 발견하면 다시 목업에 반영했습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;plaintext&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span&gt;Design: 목업 키패드 서랍·이력 머리줄 2단·길게 누름 시트 영수증 구조를 앱과 한 벌로 정렬&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;2주 중 마지막 사흘은 디자인을 정리하는 데 대부분을 썼습니다. 같은 부분을 네 번 수정한 흔적도 있습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;plaintext&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span&gt;Design: 연보라 걷어내기 — sunken을 primarySoft와 갈라놓고…&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;Design: sunken을 #F5F4F8로 한 칸 더 밝게&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;Design: 홈 세그먼트 트랙을 흰 면(surface)으로&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;Design: 바탕 위에 서는 것들을 흰 면으로&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;연보라를 제거하니 파인 면이 회색으로 보였고, 밝히자 세그먼트 트랙과 구분하기 어려워졌습니다. 주변 색을 함께 보며 고쳐야 했습니다.&lt;/p&gt;
&lt;p&gt;키패드 바깥을 누르면 닫히는 동작도 세 번 바꿨습니다. 투명한 입력 영역을 위에 덮었다가 아래에 두었고, 마지막에는 다른 요소가 처리하지 않은 탭을 받도록 했습니다.&lt;/p&gt;
&lt;p&gt;돌아간 길을 잊지 않으려고 기록도 나눴습니다. 저장소 루트에는 브랜드와 엔지니어링 기준을, &lt;code&gt;CHANGELOG.md&lt;/code&gt;에는 변경 사항을, 기록용 금고에는 판단의 이유를 남겼습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;plaintext&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span&gt;- 되돌림: 통화 기호를 «원» 접미사로 시작했다가 ₩ 접두사로&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;  — 일곱 언어가 생긴 순간 «원»은 한국어를 읽는 사람에게만 통하는 그림이 된다&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;- 되돌림: 이름 입력 시트의 자동 포커스&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;  — 얼굴 피커와 함께 서면서 자판이 시트를 가린 채 튀어서&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;연보라를 제거하려는 시도는 두 번 있었습니다. 두 번째에는 이 기록을 읽고 앞서 왜 되돌렸는지 확인한 뒤 멈췄습니다.&lt;/p&gt;
&lt;h2 id=&quot;언어가-늘어나자-앱에서-볼-것이-늘었습니다&quot;&gt;언어가 늘어나자 앱에서 볼 것이 늘었습니다&lt;/h2&gt;
&lt;p&gt;8월 18일에 영어를, 8월 22일에 아홉 개 언어를 추가했습니다. 한국어 화면과 문구를 먼저 정리하고 열한 개 언어로 늘려, 문구가 바뀔 때마다 번역을 모두 다시 고치는 일을 줄였습니다.&lt;/p&gt;
&lt;p&gt;문자열과 서식을 리소스에 두는 규칙은 처음부터 지켰습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-light-font-style:italic;--shiki-dark:#51597D;--shiki-dark-font-style:italic&quot;&gt;// 이렇게 쓰는 순간 그 화면은 한국어 전용이 됩니다&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;--shiki-light:#1E66F5;--shiki-light-font-style:italic;--shiki-dark:#7AA2F7;--shiki-dark-font-style:inherit&quot;&gt;Text&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#7DCFFF&quot;&gt;${&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt;amount&lt;/span&gt;&lt;span style=&quot;--shiki-light:#7C7F93;--shiki-dark:#7DCFFF&quot;&gt;}&lt;/span&gt;&lt;span style=&quot;--shiki-light:#40A02B;--shiki-dark:#9ECE6A&quot;&gt;원&quot;&lt;/span&gt;&lt;span style=&quot;--shiki-light:#4C4F69;--shiki-dark:#A9B1D6&quot;&gt;)&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;이 코드처럼 단위를 붙이면 번역에서 바꿀 수 없습니다. 날짜 서식, &lt;code&gt;%1$s주&lt;/code&gt; 같은 단위, 통화 이름 옆의 괄호까지 리소스에 뒀습니다. 일본어와 중국어에서 쓰는 전각 괄호（）와 앞 공백도 &lt;code&gt;&quot; (&quot; + symbol + &quot;)&quot;&lt;/code&gt;처럼 코드로 조합하면 조정하기 어렵습니다.&lt;/p&gt;
&lt;p&gt;문구는 리소스에서 바꿀 수 있어도, 글자가 들어갈 공간은 앱에서 확인해야 했습니다. 언어별 길이, 자판이 시트를 가리는 범위, 기기의 스크롤 관성과 길게 누름, 시스템 글꼴 크기에 따른 배치는 HTML만으로 판단하기 어려웠습니다. 똑같이 재현하려면 목업에도 별도 구현이 필요했습니다.&lt;/p&gt;
&lt;h2 id=&quot;마치며&quot;&gt;마치며&lt;/h2&gt;
&lt;p&gt;8월 22일의 마지막 동기화 커밋입니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;plaintext&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span&gt;Design: 목업 시트 동기화 마무리 — 확인창 부제·선택지 두 줄, 종목 삭제/이력 삭제 문구를 앱과 한 벌로&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;‘그대로입니다’가 잘리는 것을 본 뒤에는 앱을 기준으로 확인하고 수정하기로 했습니다. 두 구현을 맞추는 수고에 비해 목업에서 얻는 정보가 줄어들고 있었습니다. &lt;a href=&quot;/design-system/light-dark-one-copy.html&quot;&gt;색 표가 여러 벌로 갈라졌던 작업&lt;/a&gt;에서도 같은 값을 따로 관리하는 부담을 겪었습니다.&lt;/p&gt;
&lt;p&gt;목업 파일은 초기 화면과 토큰을 확인할 수 있도록 저장소에 남겼습니다. 이제 수정할 화면은 앱 쪽입니다.&lt;/p&gt;</content>
  </entry>
  <entry>
    <title>물타기 계산기에서 빼기로 한 것들</title>
    <link href="https://log.twinklelabs.kr/stock-calculator/first-app-what-i-built.html" rel="alternate"/>
    <id>https://log.twinklelabs.kr/stock-calculator/first-app-what-i-built.html</id>
    <published>2026-08-22T01:00:00.000Z</published>
    <updated>2026-08-22T01:00:00.000Z</updated>
    <author><name>Heejeong Kim</name></author>
    <category term="물타기 계산기"/>
    <category term="android"/>
    <category term="출시기"/>
    <category term="개인개발"/>
    <category term="product"/>
    <summary type="html">반복하던 평단가 계산을 앱으로 만들었습니다. 시세 연동, 보유 자산 관리, 서버를 제외하고 첫 커밋에서 Play 테스트 트랙 업로드까지 12일 동안 작업한 기록입니다.</summary>
    <content type="html">&lt;h2 id=&quot;들어가며&quot;&gt;들어가며&lt;/h2&gt;
&lt;p&gt;보유 주식의 가격이 내려가면 추가로 몇 주를 살지 계산하곤 했습니다. 72,500원에 20주를 샀고, 58,000원에 15주를 더 산다면 새 평단가는 이렇게 나옵니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;plaintext&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span&gt;(72,500 × 20 + 58,000 × 15) ÷ 35 = 66,285.71…&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;일반 계산기로는 곱셈 두 번, 덧셈, 나눗셈을 합니다. 목표 평단가를 66,000원으로 먼저 정하면 이번에는 필요한 수량을 역산해야 했습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;plaintext&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span&gt;x = q₁(p₁ − t) / (t − p₂)&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;이 계산을 할 때마다 숫자를 다시 넣는 게 번거로웠습니다. 그래서 첫 안드로이드 앱으로 물타기 계산기를 만들었습니다. 추가 매수 뒤의 평단가를 구하고, 목표 평단가를 넣으면 필요한 수량을 역산하게 했습니다.&lt;/p&gt;
&lt;h2 id=&quot;계산-기록과-계좌-현황-사이&quot;&gt;계산 기록과 계좌 현황 사이&lt;/h2&gt;
&lt;p&gt;계산 결과는 저장하고 종목별로 모아볼 수 있게 했습니다. 삼성전자에 계산 두 건, 카카오에 한 건을 남기는 식입니다. 여기에 라이트·다크 모드와 열한 개 언어를 더했습니다.&lt;/p&gt;
&lt;p&gt;여기서 시세 연동이나 보유 자산 관리까지 넣을지 고민했습니다. 2주 안에 만들어 보려던 앱이라 범위를 정해야 했습니다. 빼기로 한 기능은 README에도 적어 뒀습니다.&lt;/p&gt;
&lt;h3 id=&quot;시세는-직접-입력&quot;&gt;시세는 직접 입력&lt;/h3&gt;
&lt;p&gt;현재가를 자동으로 가져오면 입력은 줄어듭니다. 하지만 당시에는 계속 바뀌는 시세를 무료로 안정적으로 받아올 방법을 찾지 못했습니다.&lt;/p&gt;
&lt;p&gt;사용자가 넣어둔 가격을 현재 시세처럼 보여줄 수도 없었습니다. 입력한 뒤 시장 가격이 바뀌면 앱이 계산한 수익률과 실제 수익률은 달라집니다. 시세를 제공하기 시작하면 실시간 갱신과 알림까지 고려해야 했고, 2주 안에 만들려던 범위를 벗어났습니다. 계산에 쓸 가격은 사용자가 직접 입력하도록 남겼습니다.&lt;/p&gt;
&lt;h3 id=&quot;종목은-기록을-묶는-이름표&quot;&gt;종목은 기록을 묶는 이름표&lt;/h3&gt;
&lt;p&gt;증권사 계좌에 연결하지 않으므로, 앱은 사용자가 실제로 매수했는지 모릅니다. 추가 매수를 가정한 계산을 계좌 현황처럼 보여주면 의미가 달라집니다.&lt;/p&gt;
&lt;p&gt;그래서 종목 정보에는 이름, 아이콘, 목록 순서만 저장했습니다. 보유 수량과 평단가를 관리하는 기능은 넣지 않았고, 이력 화면에도 다음 문구를 붙였습니다.&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;실제 매매가 아닌 계산 기록입니다&lt;/p&gt;
&lt;/blockquote&gt;
&lt;figure&gt;&lt;img src=&quot;/images/stock-calculator/first-app-home-history.webp&quot; alt=&quot;8월 21일 테스트 트랙에 올린 화면. 왼쪽은 계산, 오른쪽은 저장한 계산 이력이고 이력 위에 «실제 매수 내역이 아니라 계산해본 기록»이라고 적었다&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;figcaption aria-hidden=&quot;true&quot;&gt;8월 21일 테스트 트랙에 올린 화면. 왼쪽은 계산, 오른쪽은 저장한 계산 이력이고 이력 위에 «실제 매수 내역이 아니라 계산해본 기록»이라고 적었다&lt;/figcaption&gt;&lt;/figure&gt;
&lt;h3 id=&quot;서버와-계정-없이&quot;&gt;서버와 계정 없이&lt;/h3&gt;
&lt;p&gt;계정, 로그인, 기기 간 동기화도 제외했습니다. 계산 기록은 기기 안에만 둡니다.&lt;/p&gt;
&lt;p&gt;기기를 바꿀 때 기록을 가져오는 기능은 포기했습니다. 대신 서버에 계산 데이터를 보관하고 관리하는 일은 맡지 않아도 됐습니다. 개인정보 처리방침에도 기록을 기기 안에 두는 구조를 설명했습니다.&lt;/p&gt;
&lt;h2 id=&quot;12일-뒤-테스트-트랙에-올리기까지&quot;&gt;12일 뒤 테스트 트랙에 올리기까지&lt;/h2&gt;
&lt;p&gt;첫 커밋은 8월 9일, Play 테스트 트랙 업로드는 8월 21일이었습니다.&lt;/p&gt;
&lt;pre class=&quot;astro-code astro-code-themes catppuccin-latte tokyo-night&quot; style=&quot;--shiki-light:#4c4f69;--shiki-dark:#a9b1d6;--shiki-light-bg:#eff1f5;--shiki-dark-bg:#1a1b26; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;txt&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span&gt;2026-08-09  Initial commit: add stock calculator app and design mockup&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;2026-08-21  Play 테스트 트랙 게시&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;계산 기능 외에 AdMob과 결제를 붙였고, 서명 키와 스토어 등록정보를 처음 준비했습니다. 커밋 로그에는 다음 일정이 남아 있습니다.&lt;/p&gt;
&lt;div class=&quot;table-wrap&quot;&gt;
































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;날짜&lt;/th&gt;&lt;th&gt;한 일&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;8/9&lt;/td&gt;&lt;td&gt;첫 커밋 — HTML 목업과 앱 뼈대, 디자인 시스템 이식&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;8/18&lt;/td&gt;&lt;td&gt;광고·개인정보 처리방침·브랜드 아이콘·영어·스플래시&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;8/20&lt;/td&gt;&lt;td&gt;계산 로직 분리, Room 마이그레이션, 키패드 개선&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;8/21&lt;/td&gt;&lt;td&gt;UMP 동의 · 실제 AdMob 3종 · 업로드 키 서명 · 광고 제거 결제&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;8/21&lt;/td&gt;&lt;td&gt;Play 비공개 테스트 트랙 게시&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;8/22&lt;/td&gt;&lt;td&gt;아이콘 16종, 디자인 정리, 통화 아홉 · 언어 열하나&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;&lt;/div&gt;
&lt;h2 id=&quot;마치며&quot;&gt;마치며&lt;/h2&gt;
&lt;p&gt;앞의 열흘은 주로 앱을 만들고, 마지막 이틀은 업로드를 준비했습니다. 계산 화면 외에도 서명 키, 광고 단위, 결제 상품, 스크린샷과 정책 설문을 챙겨야 했습니다. 이 글을 쓰는 8월 22일에는 아직 테스트 트랙에 있습니다.&lt;/p&gt;
&lt;p&gt;당시 작업은 네 편에 나눠 적었습니다. 이 글에서는 기능 범위를, &lt;a href=&quot;/stock-calculator/first-app-design-cycle.html&quot;&gt;2편에서는 HTML 목업과 앱을 함께 고친 과정&lt;/a&gt;을 다룹니다. 광고와 동의 흐름은 3편, 스토어 업로드 준비는 4편에 이어집니다.&lt;/p&gt;</content>
  </entry>
</feed>
