<?xml version="1.0" encoding="utf-8"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="ko">
  <title>mingyu</title>
  <link rel="alternate" type="text/html" href="https://debugyu.pages.dev/"/>
  <link rel="self" type="application/atom+xml" href="https://debugyu.pages.dev/feed.xml"/>
  <id>https://debugyu.pages.dev/</id>
  <updated>2026-11-15T00:00:00+09:00</updated>
  <author><name>MinGyu Son</name></author>
  <entry>
    <title>Wear OS 위치 정보: FLP와 WHS를 시점별로 나눠 쓰기</title>
    <link rel="alternate" type="text/html" href="https://debugyu.pages.dev/posts/wear-os-location-flp-whs/"/>
    <id>https://debugyu.pages.dev/posts/wear-os-location-flp-whs/</id>
    <published>2026-04-29T00:00:00+09:00</published>
    <updated>2026-11-15T00:00:00+09:00</updated>
    <category term="Android"/>
    <category term="Wear OS"/>
    <category term="Location"/>
    <category term="Health Services"/>
    <category term="FLP"/>
    <summary>Wear OS에서 위치를 얻는 두 경로인 통합 위치 정보 제공자(FLP)와 Wear 건강 관리 서비스(WHS)의 차이와, 운동 앱에서 둘을 시점별로 나눠 쓰는 방법을 정리했어요.</summary>
    <content type="html" xml:base="https://debugyu.pages.dev/">&lt;div&gt;&lt;p&gt;시계는 배터리가 작아서 위치를 어떻게 받느냐가 배터리 지속 시간에 바로 영향을 줘요. Wear OS에서 위치를 얻는 경로는 두 가지예요. 통합 위치 정보 제공자(Fused Location Provider, FLP)와 Wear 건강 관리 서비스(Health Services, WHS)예요. 두 API는 서로 다른 시점을 맡는 관계에 가까워요. 이 글에서는 두 API의 차이를 보고 운동 앱에서 둘을 시점별로 나눠 쓰는 방법을 정리해요.&lt;/p&gt;&lt;p&gt;코드는 health-services-client 1.1.0, play-services-location 21.4.0 기준이에요. 모두 Wear OS 6(API 36) 에뮬레이터에서 실행해 확인했어요.&lt;/p&gt;&lt;h2 id=&quot;1-flp와-whs의-역할&quot;&gt;1. FLP와 WHS의 역할&lt;/h2&gt;&lt;p&gt;공식 문서는 쓰임새를 이렇게 나눠요.&lt;/p&gt;&lt;div class=&quot;table-scroll&quot; tabindex=&quot;0&quot; role=&quot;group&quot; aria-label=&quot;표: 항목, FLP, WHS&quot;&gt;&lt;table data-columns=&quot;3&quot;&gt;&lt;thead&gt;&lt;tr&gt;&lt;th scope=&quot;col&quot;&gt;항목&lt;/th&gt;&lt;th scope=&quot;col&quot;&gt;FLP&lt;/th&gt;&lt;th scope=&quot;col&quot;&gt;WHS&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;제공&lt;/td&gt;&lt;td&gt;Google Play 서비스의 &lt;code&gt;FusedLocationProviderClient&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Wear OS의 Health Services(&lt;code&gt;ExerciseClient&lt;/code&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;시계의 GPS 또는 연결된 휴대전화&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;&lt;/div&gt;&lt;p&gt;공식 문서는 운동 추적에는 전력 효율이 더 높은 WHS를 쓰라고 권해요. 운동 중 화면이 꺼지면 WHS는 같은 주기로 측정하면서 데이터를 모아 두었다가 덜 자주 보내요. 메인 프로세서를 자주 깨우지 않으려는 거예요. 사용자가 화면을 보면 모아 둔 데이터를 바로 보내요.&lt;/p&gt;&lt;p&gt;FLP는 휴대전화의 위치를 쓸 수도 있어요. GPS가 없는 시계는 휴대전화 위치에 기대므로 연결이 끊기면 위치를 받지 못해요. 계속 위치가 필요한 앱이라면 &lt;code&gt;PackageManager.FEATURE_LOCATION_GPS&lt;/code&gt;로 시계에 GPS가 있는지 확인하고 연결이 끊기면 사용자에게 알려야 해요.&lt;/p&gt;&lt;h2 id=&quot;2-flp로-첫-위치-빨리-보여-주기&quot;&gt;2. FLP로 첫 위치 빨리 보여 주기&lt;/h2&gt;&lt;p&gt;운동 준비 화면에 들어오면 지도에 시작점부터 보여 주고 싶어요. WHS가 GPS를 잡는 데는 몇 초가 걸리니, 그동안 FLP로 위치를 먼저 얻어 둬요.&lt;/p&gt;&lt;div class=&quot;code-block&quot;&gt;&lt;pre translate=&quot;no&quot; tabindex=&quot;0&quot; role=&quot;group&quot; aria-label=&quot;kotlin 코드&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;tok-keyword&quot;&gt;private&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;val&lt;/span&gt; fusedLocationClient &lt;span class=&quot;tok-keyword&quot;&gt;by&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;lazy&lt;/span&gt; { &lt;span class=&quot;tok-type&quot;&gt;LocationServices&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;getFusedLocationProviderClient&lt;/span&gt;(&lt;span class=&quot;tok-keyword&quot;&gt;this&lt;/span&gt;) }
&lt;span class=&quot;tok-keyword&quot;&gt;private&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;val&lt;/span&gt; cancellationTokenSource = &lt;span class=&quot;tok-function&quot;&gt;CancellationTokenSource&lt;/span&gt;()
&lt;span class=&quot;tok-keyword&quot;&gt;private&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;var&lt;/span&gt; hasCurrentLocation = &lt;span class=&quot;tok-keyword&quot;&gt;false&lt;/span&gt;

&lt;span class=&quot;tok-keyword&quot;&gt;private&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;fun&lt;/span&gt; &lt;span class=&quot;tok-function&quot;&gt;showStartPoint&lt;/span&gt;() {
    fusedLocationClient&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;lastLocation&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;addOnSuccessListener { cached&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;Location&lt;/span&gt;? -&amp;gt;
        &lt;span class=&quot;tok-keyword&quot;&gt;if&lt;/span&gt; (cached != &lt;span class=&quot;tok-keyword&quot;&gt;null&lt;/span&gt; &amp;amp;&amp;amp; !hasCurrentLocation) &lt;span class=&quot;tok-function&quot;&gt;moveMapTo&lt;/span&gt;(cached)
    }
    fusedLocationClient&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;getCurrentLocation&lt;/span&gt;(
        &lt;span class=&quot;tok-type&quot;&gt;Priority&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-type&quot;&gt;PRIORITY_HIGH_ACCURACY&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt;
        cancellationTokenSource&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;token&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt;
    )&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;addOnSuccessListener { location&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;Location&lt;/span&gt;? -&amp;gt;
        &lt;span class=&quot;tok-keyword&quot;&gt;if&lt;/span&gt; (location != &lt;span class=&quot;tok-keyword&quot;&gt;null&lt;/span&gt;) {
            hasCurrentLocation = &lt;span class=&quot;tok-keyword&quot;&gt;true&lt;/span&gt;
            &lt;span class=&quot;tok-function&quot;&gt;moveMapTo&lt;/span&gt;(location)
        }
    }
}

&lt;span class=&quot;tok-keyword&quot;&gt;override&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;fun&lt;/span&gt; &lt;span class=&quot;tok-function&quot;&gt;onDestroy&lt;/span&gt;() {
    cancellationTokenSource&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;cancel&lt;/span&gt;()
    &lt;span class=&quot;tok-keyword&quot;&gt;super&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;onDestroy&lt;/span&gt;()
}&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;두 함수는 하는 일이 달라요. &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;lastLocation&lt;/code&gt;은&lt;/span&gt; 캐시된 마지막 위치를 바로 돌려주고 캐시가 없으면 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;null&lt;/code&gt;이에요&lt;/span&gt;. &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;getCurrentLocation&lt;/code&gt;은&lt;/span&gt; 충분히 최근에 측정한 위치가 있으면 그것을 돌려주고 없으면 새로 측정해요. 시간 안에 위치를 얻지 못하면 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;null&lt;/code&gt;이&lt;/span&gt; 와요. 에뮬레이터에서 돌려 보면 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;lastLocation&lt;/code&gt;은&lt;/span&gt; 0.3초 안에 돌아왔고(처음 실행할 때는 캐시가 없어서 &lt;code&gt;null&lt;/code&gt;), &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;getCurrentLocation&lt;/code&gt;은&lt;/span&gt; 4초 가까이 걸렸어요. 그래서 캐시 값으로 먼저 보여 주고 새 위치가 오면 바꿔요. 두 요청은 동시에 보내므로, 캐시 값이 새 위치보다 늦게 와도 덮어쓰지 않게 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;hasCurrentLocation&lt;/code&gt;으로&lt;/span&gt; 막았어요.&lt;/p&gt;&lt;p&gt;&lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;CancellationTokenSource&lt;/code&gt;는&lt;/span&gt; 화면을 떠날 때 아직 끝나지 않은 &lt;code&gt;getCurrentLocation&lt;/code&gt; 요청을 취소하려고 둬요. 이미 응답이 왔다면 취소할 요청이 없어요. 두 함수 모두 위치 권한을 받은 뒤에 불러요.&lt;/p&gt;&lt;h2 id=&quot;3-whs로-운동-중-위치-받기&quot;&gt;3. WHS로 운동 중 위치 받기&lt;/h2&gt;&lt;h3 id=&quot;권한과-포그라운드-서비스&quot;&gt;권한과 포그라운드 서비스&lt;/h3&gt;&lt;p&gt;운동 추적은 포그라운드 서비스에서 해요. 공식 문서는 준비 단계를 포함한 운동 내내 포그라운드 서비스를 유지하라고 해요. Activity의 수명 주기에 묶여 있으면 센서 준비가 중간에 끊길 수 있어요.&lt;/p&gt;&lt;div class=&quot;code-block&quot;&gt;&lt;pre translate=&quot;no&quot; tabindex=&quot;0&quot; role=&quot;group&quot; aria-label=&quot;xml 코드&quot; data-language=&quot;xml&quot;&gt;&lt;code&gt;&lt;span class=&quot;tok-tag&quot;&gt;&amp;lt;uses-permission&lt;/span&gt; &lt;span class=&quot;tok-attribute&quot;&gt;android:name&lt;/span&gt;=&lt;span class=&quot;tok-string&quot;&gt;&amp;quot;android.permission.ACCESS_COARSE_LOCATION&amp;quot;&lt;/span&gt; &lt;span class=&quot;tok-tag&quot;&gt;/&amp;gt;&lt;/span&gt;
&lt;span class=&quot;tok-tag&quot;&gt;&amp;lt;uses-permission&lt;/span&gt; &lt;span class=&quot;tok-attribute&quot;&gt;android:name&lt;/span&gt;=&lt;span class=&quot;tok-string&quot;&gt;&amp;quot;android.permission.ACCESS_FINE_LOCATION&amp;quot;&lt;/span&gt; &lt;span class=&quot;tok-tag&quot;&gt;/&amp;gt;&lt;/span&gt;
&lt;span class=&quot;tok-tag&quot;&gt;&amp;lt;uses-permission&lt;/span&gt; &lt;span class=&quot;tok-attribute&quot;&gt;android:name&lt;/span&gt;=&lt;span class=&quot;tok-string&quot;&gt;&amp;quot;android.permission.ACTIVITY_RECOGNITION&amp;quot;&lt;/span&gt; &lt;span class=&quot;tok-tag&quot;&gt;/&amp;gt;&lt;/span&gt;
&lt;span class=&quot;tok-tag&quot;&gt;&amp;lt;uses-permission&lt;/span&gt; &lt;span class=&quot;tok-attribute&quot;&gt;android:name&lt;/span&gt;=&lt;span class=&quot;tok-string&quot;&gt;&amp;quot;android.permission.BODY_SENSORS&amp;quot;&lt;/span&gt; &lt;span class=&quot;tok-attribute&quot;&gt;android:maxSdkVersion&lt;/span&gt;=&lt;span class=&quot;tok-string&quot;&gt;&amp;quot;35&amp;quot;&lt;/span&gt; &lt;span class=&quot;tok-tag&quot;&gt;/&amp;gt;&lt;/span&gt;
&lt;span class=&quot;tok-tag&quot;&gt;&amp;lt;uses-permission&lt;/span&gt; &lt;span class=&quot;tok-attribute&quot;&gt;android:name&lt;/span&gt;=&lt;span class=&quot;tok-string&quot;&gt;&amp;quot;android.permission.health.READ_HEART_RATE&amp;quot;&lt;/span&gt; &lt;span class=&quot;tok-tag&quot;&gt;/&amp;gt;&lt;/span&gt;
&lt;span class=&quot;tok-tag&quot;&gt;&amp;lt;uses-permission&lt;/span&gt; &lt;span class=&quot;tok-attribute&quot;&gt;android:name&lt;/span&gt;=&lt;span class=&quot;tok-string&quot;&gt;&amp;quot;android.permission.FOREGROUND_SERVICE&amp;quot;&lt;/span&gt; &lt;span class=&quot;tok-tag&quot;&gt;/&amp;gt;&lt;/span&gt;
&lt;span class=&quot;tok-tag&quot;&gt;&amp;lt;uses-permission&lt;/span&gt; &lt;span class=&quot;tok-attribute&quot;&gt;android:name&lt;/span&gt;=&lt;span class=&quot;tok-string&quot;&gt;&amp;quot;android.permission.FOREGROUND_SERVICE_HEALTH&amp;quot;&lt;/span&gt; &lt;span class=&quot;tok-tag&quot;&gt;/&amp;gt;&lt;/span&gt;
&lt;span class=&quot;tok-tag&quot;&gt;&amp;lt;uses-permission&lt;/span&gt; &lt;span class=&quot;tok-attribute&quot;&gt;android:name&lt;/span&gt;=&lt;span class=&quot;tok-string&quot;&gt;&amp;quot;android.permission.FOREGROUND_SERVICE_LOCATION&amp;quot;&lt;/span&gt; &lt;span class=&quot;tok-tag&quot;&gt;/&amp;gt;&lt;/span&gt;

&lt;span class=&quot;tok-tag&quot;&gt;&amp;lt;service&lt;/span&gt;
    &lt;span class=&quot;tok-attribute&quot;&gt;android:name&lt;/span&gt;=&lt;span class=&quot;tok-string&quot;&gt;&amp;quot;.ExerciseService&amp;quot;&lt;/span&gt;
    &lt;span class=&quot;tok-attribute&quot;&gt;android:foregroundServiceType&lt;/span&gt;=&lt;span class=&quot;tok-string&quot;&gt;&amp;quot;health|location&amp;quot;&lt;/span&gt;
    &lt;span class=&quot;tok-attribute&quot;&gt;android:exported&lt;/span&gt;=&lt;span class=&quot;tok-string&quot;&gt;&amp;quot;false&amp;quot;&lt;/span&gt; &lt;span class=&quot;tok-tag&quot;&gt;/&amp;gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;권한마다 쓰이는 곳이 있어요.&lt;/p&gt;&lt;div class=&quot;table-scroll&quot; tabindex=&quot;0&quot; role=&quot;group&quot; aria-label=&quot;표: 권한, 필요한 곳&quot;&gt;&lt;table data-columns=&quot;2&quot;&gt;&lt;thead&gt;&lt;tr&gt;&lt;th scope=&quot;col&quot;&gt;권한&lt;/th&gt;&lt;th scope=&quot;col&quot;&gt;필요한 곳&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;code&gt;ACCESS_FINE_LOCATION&lt;/code&gt;, &lt;code&gt;ACCESS_COARSE_LOCATION&lt;/code&gt;&lt;/td&gt;&lt;td&gt;위치 데이터(&lt;code&gt;DataType.LOCATION&lt;/code&gt;), &lt;code&gt;isGpsEnabled = true&lt;/code&gt;. FINE은 COARSE와 같이 요청&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code&gt;ACTIVITY_RECOGNITION&lt;/code&gt;&lt;/td&gt;&lt;td&gt;거리 데이터(&lt;code&gt;DataType.DISTANCE&lt;/code&gt;)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code&gt;health.READ_HEART_RATE&lt;/code&gt;&lt;/td&gt;&lt;td&gt;심박 데이터. API 35 이하는 &lt;code&gt;BODY_SENSORS&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code&gt;FOREGROUND_SERVICE_HEALTH&lt;/code&gt;, &lt;code&gt;FOREGROUND_SERVICE_LOCATION&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code&gt;health&lt;/code&gt;, &lt;code&gt;location&lt;/code&gt; 타입의 포그라운드 서비스&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;&lt;/div&gt;&lt;p&gt;서비스 타입을 둘 다 적었으니 두 타입의 조건을 모두 채워야 해요. &lt;code&gt;location&lt;/code&gt; 타입은 기기의 위치 서비스가 켜져 있고 위치 권한을 받았을 때 시작돼요. &lt;code&gt;health&lt;/code&gt; 타입은 이 매니페스트처럼 &lt;code&gt;HIGH_SAMPLING_RATE_SENSORS&lt;/code&gt;를 선언하지 않았다면 &lt;code&gt;ACTIVITY_RECOGNITION&lt;/code&gt;, &lt;code&gt;health.READ_HEART_RATE&lt;/code&gt; 같은 런타임 권한 중 하나가 있어야 시작돼요. 런타임 권한 없이 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;startForeground&lt;/code&gt;를&lt;/span&gt; 부르면 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;SecurityException&lt;/code&gt;이&lt;/span&gt; 나요. 공식 문서는 준비 전에 &lt;code&gt;LocationManager.isProviderEnabled(GPS_PROVIDER)&lt;/code&gt;로 기기의 위치 설정도 확인하라고 해요.&lt;/p&gt;&lt;p&gt;공식 예제의 매니페스트에는 Health Services 패키지를 찾는 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;&amp;lt;queries&amp;gt;&lt;/code&gt;도&lt;/span&gt; 있어요. health-services-client의 매니페스트에 이미 들어 있어서, 매니페스트 병합을 쓰면 앱에 넣지 않아도 돼요.&lt;/p&gt;&lt;h3 id=&quot;지원-여부-확인&quot;&gt;지원 여부 확인&lt;/h3&gt;&lt;p&gt;운동 종류, 데이터 타입, 자동 일시정지는 기기마다 지원 여부가 달라요. WHS는 지원하지 않는 설정을 거부하므로 먼저 확인해요.&lt;/p&gt;&lt;div class=&quot;code-block&quot;&gt;&lt;pre translate=&quot;no&quot; tabindex=&quot;0&quot; role=&quot;group&quot; aria-label=&quot;kotlin 코드&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;tok-keyword&quot;&gt;private&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;suspend&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;fun&lt;/span&gt; &lt;span class=&quot;tok-function&quot;&gt;runningCapabilities&lt;/span&gt;()&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;ExerciseTypeCapabilities&lt;/span&gt;? {
    &lt;span class=&quot;tok-keyword&quot;&gt;val&lt;/span&gt; capabilities = exerciseClient&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;getCapabilities&lt;/span&gt;()
    &lt;span class=&quot;tok-keyword&quot;&gt;if&lt;/span&gt; (&lt;span class=&quot;tok-type&quot;&gt;ExerciseType&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-type&quot;&gt;RUNNING&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;!in&lt;/span&gt; capabilities&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;supportedExerciseTypes) &lt;span class=&quot;tok-keyword&quot;&gt;return&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;null&lt;/span&gt;
    &lt;span class=&quot;tok-keyword&quot;&gt;return&lt;/span&gt; capabilities&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;getExerciseTypeCapabilities&lt;/span&gt;(&lt;span class=&quot;tok-type&quot;&gt;ExerciseType&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-type&quot;&gt;RUNNING&lt;/span&gt;)
}&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;code&gt;getCapabilities&lt;/code&gt;, &lt;code&gt;prepareExercise&lt;/code&gt;, &lt;code&gt;startExercise&lt;/code&gt;, &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;endExercise&lt;/code&gt;는&lt;/span&gt; health-services-client의 suspend 확장 함수예요. &lt;code&gt;prepareExerciseAsync(...).await()&lt;/code&gt;처럼 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;ListenableFuture&lt;/code&gt;를&lt;/span&gt; 기다리지 않아도 돼요.&lt;/p&gt;&lt;h3 id=&quot;콜백을-먼저-등록하고-준비하기&quot;&gt;콜백을 먼저 등록하고 준비하기&lt;/h3&gt;&lt;p&gt;&lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;prepareExercise&lt;/code&gt;는&lt;/span&gt; 운동 시간을 재기 전에 센서를 미리 켜 두는 단계예요. 미리 켤 수 있는 센서는 GPS(&lt;code&gt;DataType.LOCATION&lt;/code&gt;)와 심박(&lt;code&gt;DataType.HEART_RATE_BPM&lt;/code&gt;) 두 가지예요.&lt;/p&gt;&lt;div class=&quot;code-block&quot;&gt;&lt;pre translate=&quot;no&quot; tabindex=&quot;0&quot; role=&quot;group&quot; aria-label=&quot;kotlin 코드&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;tok-keyword&quot;&gt;private&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;suspend&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;fun&lt;/span&gt; &lt;span class=&quot;tok-function&quot;&gt;prepare&lt;/span&gt;() {
    exerciseClient&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;setUpdateCallback&lt;/span&gt;(callback)
    &lt;span class=&quot;tok-keyword&quot;&gt;val&lt;/span&gt; warmUpConfig = &lt;span class=&quot;tok-function&quot;&gt;WarmUpConfig&lt;/span&gt;(
        exerciseType = &lt;span class=&quot;tok-type&quot;&gt;ExerciseType&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-type&quot;&gt;RUNNING&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt;
        dataTypes = &lt;span class=&quot;tok-function&quot;&gt;setOf&lt;/span&gt;(&lt;span class=&quot;tok-type&quot;&gt;DataType&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-type&quot;&gt;LOCATION&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;DataType&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-type&quot;&gt;HEART_RATE_BPM&lt;/span&gt;)&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt;
    )
    exerciseClient&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;prepareExercise&lt;/span&gt;(warmUpConfig)
}&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;준비 중에 바뀌는 위치 상태는 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;ExerciseUpdateCallback&lt;/code&gt;으로&lt;/span&gt; 오니, 콜백을 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;prepareExercise&lt;/code&gt;보다&lt;/span&gt; 먼저 등록해요. 에뮬레이터에서 콜백을 먼저 등록하면 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;ACQUIRING&lt;/code&gt;이&lt;/span&gt; 오고 약 4초 뒤 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;ACQUIRED_UNTETHERED&lt;/code&gt;와&lt;/span&gt; 첫 위치가 와요. 준비를 시작하고 5초 뒤에 콜백을 등록하면 등록하는 순간의 상태(&lt;code&gt;ACQUIRED_UNTETHERED&lt;/code&gt;)는 받지만, 그 전의 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;ACQUIRING&lt;/code&gt;과&lt;/span&gt; 준비 중에 온 위치는 받지 못해요.&lt;/p&gt;&lt;p&gt;사용자가 운동을 시작하지 않고 준비 화면을 떠나면 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;endExercise()&lt;/code&gt;로&lt;/span&gt; 센서를 꺼요. 준비 상태로 너무 오래 두면 WHS가 운동을 끝내요(&lt;code&gt;AUTO_END_PREPARE_EXPIRED&lt;/code&gt;).&lt;/p&gt;&lt;h3 id=&quot;위치-데이터와-상태-받기&quot;&gt;위치 데이터와 상태 받기&lt;/h3&gt;&lt;p&gt;콜백에서는 위치와 심박 데이터, 위치 상태를 받아요. 위치 상태는 서비스의 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;MutableStateFlow&lt;/code&gt;에&lt;/span&gt; 넣고, 화면은 공개한 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;locationAvailability&lt;/code&gt;를&lt;/span&gt; 구독해서 보여 줘요.&lt;/p&gt;&lt;div class=&quot;code-block&quot;&gt;&lt;pre translate=&quot;no&quot; tabindex=&quot;0&quot; role=&quot;group&quot; aria-label=&quot;kotlin 코드&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;tok-keyword&quot;&gt;private&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;val&lt;/span&gt; _locationAvailability = &lt;span class=&quot;tok-function&quot;&gt;MutableStateFlow&lt;/span&gt;(&lt;span class=&quot;tok-type&quot;&gt;LocationAvailability&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-type&quot;&gt;UNKNOWN&lt;/span&gt;)
&lt;span class=&quot;tok-keyword&quot;&gt;val&lt;/span&gt; locationAvailability&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;StateFlow&lt;/span&gt;&amp;lt;&lt;span class=&quot;tok-type&quot;&gt;LocationAvailability&lt;/span&gt;&amp;gt; = _locationAvailability&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;asStateFlow&lt;/span&gt;()

&lt;span class=&quot;tok-keyword&quot;&gt;private&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;val&lt;/span&gt; callback = &lt;span class=&quot;tok-keyword&quot;&gt;object&lt;/span&gt; &lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-function&quot;&gt;ExerciseUpdateCallback&lt;/span&gt; {
    &lt;span class=&quot;tok-keyword&quot;&gt;override&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;fun&lt;/span&gt; &lt;span class=&quot;tok-function&quot;&gt;onExerciseUpdateReceived&lt;/span&gt;(update&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;ExerciseUpdate&lt;/span&gt;) {
        update&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;latestMetrics
            &lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;getData&lt;/span&gt;(&lt;span class=&quot;tok-type&quot;&gt;DataType&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-type&quot;&gt;LOCATION&lt;/span&gt;)
            &lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;forEach { dataPoint -&amp;gt;
                &lt;span class=&quot;tok-keyword&quot;&gt;val&lt;/span&gt; location&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;LocationData&lt;/span&gt; = dataPoint&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;value
                &lt;span class=&quot;tok-function&quot;&gt;onLocation&lt;/span&gt;(location)
            }
        update&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;latestMetrics
            &lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;getData&lt;/span&gt;(&lt;span class=&quot;tok-type&quot;&gt;DataType&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-type&quot;&gt;HEART_RATE_BPM&lt;/span&gt;)
            &lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;forEach { dataPoint -&amp;gt; &lt;span class=&quot;tok-function&quot;&gt;onHeartRate&lt;/span&gt;(dataPoint&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;value) }
        &lt;span class=&quot;tok-keyword&quot;&gt;if&lt;/span&gt; (update&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;exerciseStateInfo&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;state&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;isEnded) {
            &lt;span class=&quot;tok-function&quot;&gt;onEnded&lt;/span&gt;(update&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;exerciseStateInfo&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;endReason)
        }
    }

    &lt;span class=&quot;tok-keyword&quot;&gt;override&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;fun&lt;/span&gt; &lt;span class=&quot;tok-function&quot;&gt;onAvailabilityChanged&lt;/span&gt;(
        dataType&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;DataType&lt;/span&gt;&amp;lt;*&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt; *&amp;gt;&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt;
        availability&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;Availability&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt;
    ) {
        &lt;span class=&quot;tok-keyword&quot;&gt;if&lt;/span&gt; (availability &lt;span class=&quot;tok-keyword&quot;&gt;is&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;LocationAvailability&lt;/span&gt;) {
            _locationAvailability&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;value = availability
        }
    }

    &lt;span class=&quot;tok-keyword&quot;&gt;override&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;fun&lt;/span&gt; &lt;span class=&quot;tok-function&quot;&gt;onLapSummaryReceived&lt;/span&gt;(lapSummary&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;ExerciseLapSummary&lt;/span&gt;) = &lt;span class=&quot;tok-type&quot;&gt;Unit&lt;/span&gt;
    &lt;span class=&quot;tok-keyword&quot;&gt;override&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;fun&lt;/span&gt; &lt;span class=&quot;tok-function&quot;&gt;onRegistered&lt;/span&gt;() = &lt;span class=&quot;tok-type&quot;&gt;Unit&lt;/span&gt;
    &lt;span class=&quot;tok-keyword&quot;&gt;override&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;fun&lt;/span&gt; &lt;span class=&quot;tok-function&quot;&gt;onRegistrationFailed&lt;/span&gt;(throwable&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;Throwable&lt;/span&gt;) = &lt;span class=&quot;tok-type&quot;&gt;Unit&lt;/span&gt;
}&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;code&gt;onLocation&lt;/code&gt;, &lt;code&gt;onHeartRate&lt;/code&gt;, &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;onEnded&lt;/code&gt;는&lt;/span&gt; 데이터를 저장하거나 운동 종료를 처리하는 앱의 함수예요. 공식 문서도 준비 중의 상태를 사용자에게 보여 주고 사용자가 보고 운동을 시작할지 정하게 하라고 해요.&lt;/p&gt;&lt;div class=&quot;table-scroll&quot; tabindex=&quot;0&quot; role=&quot;group&quot; aria-label=&quot;표: LocationAvailability, 뜻&quot;&gt;&lt;table data-columns=&quot;2&quot;&gt;&lt;thead&gt;&lt;tr&gt;&lt;th scope=&quot;col&quot;&gt;&lt;code&gt;LocationAvailability&lt;/code&gt;&lt;/th&gt;&lt;th scope=&quot;col&quot;&gt;뜻&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;code&gt;ACQUIRING&lt;/code&gt;&lt;/td&gt;&lt;td&gt;위치를 잡는 중&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code&gt;ACQUIRED_TETHERED&lt;/code&gt;&lt;/td&gt;&lt;td&gt;연결된 휴대전화로 위치를 받음&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code&gt;ACQUIRED_UNTETHERED&lt;/code&gt;&lt;/td&gt;&lt;td&gt;시계에서 위치를 받음&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code&gt;NO_GNSS&lt;/code&gt;&lt;/td&gt;&lt;td&gt;기기의 위치 서비스가 꺼져 있음&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code&gt;UNAVAILABLE&lt;/code&gt;&lt;/td&gt;&lt;td&gt;위치를 쓸 수 없음&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code&gt;UNKNOWN&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;콜백은 운동 내내 등록되어 있어야 해요. 콜백 없이 5분이 지나면 WHS가 운동을 끝내요(&lt;code&gt;AUTO_END_MISSING_LISTENER&lt;/code&gt;).&lt;/p&gt;&lt;h3 id=&quot;운동-시작&quot;&gt;운동 시작&lt;/h3&gt;&lt;p&gt;위치가 잡히고 사용자가 시작을 누르면, 기기가 지원하는 설정만 골라 운동을 시작해요.&lt;/p&gt;&lt;div class=&quot;code-block&quot;&gt;&lt;pre translate=&quot;no&quot; tabindex=&quot;0&quot; role=&quot;group&quot; aria-label=&quot;kotlin 코드&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;tok-keyword&quot;&gt;private&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;suspend&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;fun&lt;/span&gt; &lt;span class=&quot;tok-function&quot;&gt;start&lt;/span&gt;(capabilities&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;ExerciseTypeCapabilities&lt;/span&gt;) {
    &lt;span class=&quot;tok-keyword&quot;&gt;val&lt;/span&gt; config = &lt;span class=&quot;tok-function&quot;&gt;ExerciseConfig&lt;/span&gt;(
        exerciseType = &lt;span class=&quot;tok-type&quot;&gt;ExerciseType&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-type&quot;&gt;RUNNING&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt;
        dataTypes = &lt;span class=&quot;tok-function&quot;&gt;setOf&lt;/span&gt;(&lt;span class=&quot;tok-type&quot;&gt;DataType&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-type&quot;&gt;LOCATION&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;DataType&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-type&quot;&gt;DISTANCE&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;DataType&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-type&quot;&gt;HEART_RATE_BPM&lt;/span&gt;)
            &lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;intersect&lt;/span&gt;(capabilities&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;supportedDataTypes)&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt;
        isAutoPauseAndResumeEnabled = capabilities&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;supportsAutoPauseAndResume&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt;
        isGpsEnabled = &lt;span class=&quot;tok-keyword&quot;&gt;true&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt;
    )
    exerciseClient&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;startExercise&lt;/span&gt;(config)
}&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;요청할 데이터 타입은 기기가 지원하는 것만 남기고(&lt;code&gt;intersect&lt;/code&gt;), 자동 일시정지도 지원할 때만 켜요. 위치 데이터를 받으려면 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;isGpsEnabled&lt;/code&gt;가&lt;/span&gt; &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;true&lt;/code&gt;여야&lt;/span&gt; 해요. &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;DataType.DISTANCE&lt;/code&gt;는&lt;/span&gt; 구간마다의 거리라서 누적 거리를 보여 주려면 더하거나 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;DataType.DISTANCE_TOTAL&lt;/code&gt;을&lt;/span&gt; 요청해요.&lt;/p&gt;&lt;h2 id=&quot;4-시점별로-나눠-쓰기&quot;&gt;4. 시점별로 나눠 쓰기&lt;/h2&gt;&lt;p&gt;운동 앱에서는 두 API를 시점별로 나눠 써요. 공식 문서도 FLP의 위치를 첫 위치로 쓰다가, WHS에서 더 안정적인 위치가 오면 그것으로 바꾸라고 해요.&lt;/p&gt;&lt;div class=&quot;table-scroll&quot; tabindex=&quot;0&quot; role=&quot;group&quot; aria-label=&quot;표: 시점, 쓰는 API, 하는 일&quot;&gt;&lt;table data-columns=&quot;3&quot;&gt;&lt;thead&gt;&lt;tr&gt;&lt;th scope=&quot;col&quot;&gt;시점&lt;/th&gt;&lt;th scope=&quot;col&quot;&gt;쓰는 API&lt;/th&gt;&lt;th scope=&quot;col&quot;&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;FLP &lt;code&gt;lastLocation&lt;/code&gt;, &lt;code&gt;getCurrentLocation&lt;/code&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;WHS &lt;code&gt;prepareExercise&lt;/code&gt;&lt;/td&gt;&lt;td&gt;GPS와 심박 센서 예열, 위치 상태 표시&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;운동 중&lt;/td&gt;&lt;td&gt;WHS &lt;code&gt;startExercise&lt;/code&gt;, &lt;code&gt;ExerciseUpdateCallback&lt;/code&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;WHS &lt;code&gt;endExercise&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;WHS에서 &lt;code&gt;ACQUIRED_*&lt;/code&gt; 상태와 위치가 오면 그때부터는 WHS의 위치를 써요. 이 글의 코드는 화면을 떠날 때만 FLP 요청을 취소해요. WHS 위치가 먼저 왔을 때도 취소하려면 화면이 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;locationAvailability&lt;/code&gt;를&lt;/span&gt; 구독하다가 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;ACQUIRED_*&lt;/code&gt;를&lt;/span&gt; 받을 때 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;cancel()&lt;/code&gt;을&lt;/span&gt; 부르면 돼요.&lt;/p&gt;&lt;h2 id=&quot;마무리&quot;&gt;마무리&lt;/h2&gt;&lt;p&gt;저는 운동 앱이라면 위치는 WHS에 맡기고, FLP는 준비 화면의 첫 좌표처럼 짧게만 쓰는 편이 맞다고 생각해요. 새로 운동 추적 기능을 만든다면 준비 화면에서 콜백을 등록하고 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;prepareExercise&lt;/code&gt;를&lt;/span&gt; 부르는 부분부터 만들어 보기를 권해요.&lt;/p&gt;&lt;h2 id=&quot;참고&quot;&gt;참고&lt;/h2&gt;&lt;ul&gt;&lt;li&gt;&lt;a href=&quot;https://developer.android.com/training/wearables/apps/location-detection&quot; rel=&quot;noopener&quot;&gt;Wear OS에서 위치 감지&lt;/a&gt;: FLP와 WHS를 고르는 기준&lt;/li&gt;&lt;li&gt;&lt;a href=&quot;https://developer.android.com/health-and-fitness/guides/health-services/active-data&quot; rel=&quot;noopener&quot;&gt;ExerciseClient로 운동 기록&lt;/a&gt;: 지원 여부 확인, 준비, 콜백, 포그라운드 서비스, FLP를 첫 위치로 쓰는 방법&lt;/li&gt;&lt;li&gt;&lt;a href=&quot;https://developer.android.com/health-and-fitness/guides/health-services/permissions&quot; rel=&quot;noopener&quot;&gt;Health Services 권한&lt;/a&gt;&lt;/li&gt;&lt;li&gt;&lt;a href=&quot;https://developer.android.com/develop/background-work/services/fgs/service-types&quot; rel=&quot;noopener&quot;&gt;포그라운드 서비스 타입&lt;/a&gt;: &lt;code&gt;health&lt;/code&gt;, &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;location&lt;/code&gt;의&lt;/span&gt; 권한 조건&lt;/li&gt;&lt;li&gt;&lt;a href=&quot;https://developer.android.com/develop/sensors-and-location/location/permissions&quot; rel=&quot;noopener&quot;&gt;위치 권한&lt;/a&gt;: FINE과 COARSE를 같이 요청하는 이유&lt;/li&gt;&lt;li&gt;&lt;a href=&quot;https://developers.google.com/android/reference/com/google/android/gms/location/FusedLocationProviderClient&quot; rel=&quot;noopener&quot;&gt;&lt;code&gt;FusedLocationProviderClient&lt;/code&gt; 레퍼런스&lt;/a&gt;&lt;/li&gt;&lt;li&gt;&lt;a href=&quot;https://developer.android.com/health-and-fitness/guides/health-services/simulated-data&quot; rel=&quot;noopener&quot;&gt;에뮬레이터의 합성 데이터&lt;/a&gt;&lt;/li&gt;&lt;li&gt;&lt;a href=&quot;https://developer.android.com/jetpack/androidx/releases/health&quot; rel=&quot;noopener&quot;&gt;Health Services 릴리스 노트&lt;/a&gt;: 라이브러리 매니페스트의 &lt;code&gt;&amp;lt;queries&amp;gt;&lt;/code&gt;&lt;/li&gt;&lt;li&gt;&lt;a href=&quot;https://github.com/android/health-samples/tree/main/health-services/ExerciseSampleCompose&quot; rel=&quot;noopener&quot;&gt;health-samples ExerciseSampleCompose&lt;/a&gt;: 공식 운동 앱 예제&lt;/li&gt;&lt;/ul&gt;&lt;/div&gt;</content>
  </entry>
  <entry>
    <title>Navigation 3 가이드: 백스택부터 딥링크까지</title>
    <link rel="alternate" type="text/html" href="https://debugyu.pages.dev/posts/android-navigation3/"/>
    <id>https://debugyu.pages.dev/posts/android-navigation3/</id>
    <published>2026-03-31T00:00:00+09:00</published>
    <updated>2026-11-15T00:00:00+09:00</updated>
    <category term="Android"/>
    <category term="Jetpack Compose"/>
    <category term="Navigation 3"/>
    <summary>Navigation 3에서는 앱이 백스택을 리스트로 직접 들고 있어요. 키 정의, 백스택 관리, NavDisplay와 데코레이터, ViewModel에 키 넘기기, 다이얼로그와 큰 화면, 딥링크를 1.2.1 기준으로 정리했어요.</summary>
    <content type="html" xml:base="https://debugyu.pages.dev/">&lt;div&gt;&lt;p&gt;Navigation 2에서는 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;NavController&lt;/code&gt;가&lt;/span&gt; 백스택을 들고 있었어요. 앱은 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;navigate()&lt;/code&gt;와&lt;/span&gt; &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;popBackStack()&lt;/code&gt;을&lt;/span&gt; 불러 간접적으로만 백스택을 바꿀 수 있었어요. Navigation 3에서는 백스택이 앱이 만든 리스트예요. 리스트에 키를 넣으면 화면이 열리고 빼면 닫혀요. 이 글에서는 지출 목록 앱을 예로 들어 키 정의부터 백스택 관리, &lt;code&gt;NavDisplay&lt;/code&gt;, &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;ViewModel&lt;/code&gt;에&lt;/span&gt; 키 넘기기, 다이얼로그와 큰 화면, 딥링크까지 차례로 정리해요.&lt;/p&gt;&lt;p&gt;코드는 Navigation 3 1.2.1, lifecycle-viewmodel-navigation3 2.11.0, adaptive-navigation3 1.3.0, Kotlin 2.4.21, kotlinx.serialization 1.13.0, Dagger Hilt 2.60.1, hilt-lifecycle-viewmodel-compose 1.4.0 기준이에요. 모두 Robolectric 테스트로 실행해 확인했어요.&lt;/p&gt;&lt;h2 id=&quot;1-의존성-추가&quot;&gt;1. 의존성 추가&lt;/h2&gt;&lt;p&gt;Navigation 3 런타임과 UI, &lt;code&gt;ViewModel&lt;/code&gt; 연동, 큰 화면용 Material 3 Adaptive, 키를 저장할 때 쓰는 kotlinx.serialization을 추가해요.&lt;/p&gt;&lt;div class=&quot;code-block&quot;&gt;&lt;pre translate=&quot;no&quot; tabindex=&quot;0&quot; role=&quot;group&quot; aria-label=&quot;kotlin 코드&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;plugins {
    &lt;span class=&quot;tok-function&quot;&gt;id&lt;/span&gt;(&lt;span class=&quot;tok-string&quot;&gt;&amp;quot;org.jetbrains.kotlin.plugin.serialization&amp;quot;&lt;/span&gt;) version &lt;span class=&quot;tok-string&quot;&gt;&amp;quot;2.4.21&amp;quot;&lt;/span&gt;
}

dependencies {
    &lt;span class=&quot;tok-function&quot;&gt;implementation&lt;/span&gt;(&lt;span class=&quot;tok-string&quot;&gt;&amp;quot;androidx.navigation3:navigation3-runtime:1.2.1&amp;quot;&lt;/span&gt;)
    &lt;span class=&quot;tok-function&quot;&gt;implementation&lt;/span&gt;(&lt;span class=&quot;tok-string&quot;&gt;&amp;quot;androidx.navigation3:navigation3-ui:1.2.1&amp;quot;&lt;/span&gt;)
    &lt;span class=&quot;tok-function&quot;&gt;implementation&lt;/span&gt;(&lt;span class=&quot;tok-string&quot;&gt;&amp;quot;androidx.lifecycle:lifecycle-viewmodel-navigation3:2.11.0&amp;quot;&lt;/span&gt;)
    &lt;span class=&quot;tok-function&quot;&gt;implementation&lt;/span&gt;(&lt;span class=&quot;tok-string&quot;&gt;&amp;quot;androidx.compose.material3.adaptive:adaptive-navigation3:1.3.0&amp;quot;&lt;/span&gt;)
    &lt;span class=&quot;tok-function&quot;&gt;implementation&lt;/span&gt;(&lt;span class=&quot;tok-string&quot;&gt;&amp;quot;org.jetbrains.kotlinx:kotlinx-serialization-core:1.13.0&amp;quot;&lt;/span&gt;)
}&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;serialization 플러그인은 Kotlin과 함께 배포되므로 프로젝트의 Kotlin 버전과 같은 버전을 써요. 공식 시작 가이드의 버전 목록에는 alpha 버전도 있지만 이 글은 안정 버전만 썼어요.&lt;/p&gt;&lt;p&gt;시작 가이드는 compileSdk 36 이상이면 된다고 하지만, 이 버전 조합은 compileSdk 37이 필요해요. 36으로 빌드하면 lifecycle-viewmodel-navigation3 2.11.0 같은 의존성이 37 이상을 요구하며 AAR 메타데이터 검사에서 실패해요. lifecycle 2.11.0과 AndroidX Hilt 1.4.0은 AGP 9.2.0 이상도 요구해요.&lt;/p&gt;&lt;h2 id=&quot;2-목적지-키-정의&quot;&gt;2. 목적지 키 정의&lt;/h2&gt;&lt;p&gt;화면마다 키 타입을 하나씩 만들어요. 인자가 없는 화면은 &lt;code&gt;data object&lt;/code&gt;, 인자가 있는 화면은 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;data class&lt;/code&gt;로&lt;/span&gt; 써요.&lt;/p&gt;&lt;div class=&quot;code-block&quot;&gt;&lt;pre translate=&quot;no&quot; tabindex=&quot;0&quot; role=&quot;group&quot; aria-label=&quot;kotlin 코드&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;tok-annotation&quot;&gt;@Serializable&lt;/span&gt;
&lt;span class=&quot;tok-keyword&quot;&gt;data&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;object&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;ExpenseListKey&lt;/span&gt; &lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;NavKey&lt;/span&gt;

&lt;span class=&quot;tok-annotation&quot;&gt;@Serializable&lt;/span&gt;
&lt;span class=&quot;tok-keyword&quot;&gt;data&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;class&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;ExpenseDetailKey&lt;/span&gt;(&lt;span class=&quot;tok-keyword&quot;&gt;val&lt;/span&gt; expenseId&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;String&lt;/span&gt;) &lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;NavKey&lt;/span&gt;

&lt;span class=&quot;tok-annotation&quot;&gt;@Serializable&lt;/span&gt;
&lt;span class=&quot;tok-keyword&quot;&gt;data&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;object&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;ExpenseSettingsKey&lt;/span&gt; &lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;NavKey&lt;/span&gt;

&lt;span class=&quot;tok-annotation&quot;&gt;@Serializable&lt;/span&gt;
&lt;span class=&quot;tok-keyword&quot;&gt;data&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;class&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;DeleteExpenseKey&lt;/span&gt;(&lt;span class=&quot;tok-keyword&quot;&gt;val&lt;/span&gt; expenseId&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;String&lt;/span&gt;) &lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;NavKey&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;공식 문서에 따르면 키는 어떤 타입이어도 돼요. &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;NavKey&lt;/code&gt;와&lt;/span&gt; &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;@Serializable&lt;/code&gt;은&lt;/span&gt; 타입 안전성보다 백스택 저장을 위한 거예요. &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;rememberNavBackStack&lt;/code&gt;으로&lt;/span&gt; 백스택을 저장하려면 모든 키가 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;NavKey&lt;/code&gt;를&lt;/span&gt; 구현하고 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;@Serializable&lt;/code&gt;을&lt;/span&gt; 붙여야 해요. &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;NavKey&lt;/code&gt;는&lt;/span&gt; 이 키를 저장할 수 있다고 라이브러리에 알려 주는 마커 인터페이스예요. &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;@Serializable&lt;/code&gt;은&lt;/span&gt; 1절의 플러그인이 직렬화 코드를 만들어 줘야 동작해요. 7절의 딥링크 매처도 이 코드로 URI의 인자를 키로 바꿔요.&lt;/p&gt;&lt;p&gt;키에는 ID처럼 작은 값만 넣어요. 키는 백스택과 함께 저장돼요. Navigation 2 문서는 Android에서 저장 상태 전체가 쓸 수 있는 공간이 제한되어 있다고 해요. 그래서 객체 대신 ID를 넘기고 다음 화면이 그 ID로 데이터를 읽어 오게 해요.&lt;/p&gt;&lt;p&gt;멀티 모듈 앱이라면 공식 가이드처럼 키는 기능의 &lt;code&gt;api&lt;/code&gt; 모듈에 두고 화면과 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;entryProvider&lt;/code&gt;는&lt;/span&gt; &lt;code&gt;impl&lt;/code&gt; 모듈에 둬요. 다른 기능의 &lt;code&gt;impl&lt;/code&gt; 모듈이 &lt;code&gt;api&lt;/code&gt; 모듈의 키만 보고도 그 화면으로 이동할 수 있어요.&lt;/p&gt;&lt;h2 id=&quot;3-백스택을-감싸는-navigationstate&quot;&gt;3. 백스택을 감싸는 &lt;code&gt;NavigationState&lt;/code&gt;&lt;/h2&gt;&lt;p&gt;백스택을 바꾸는 코드를 한곳에 모으려고 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;NavigationState&lt;/code&gt;를&lt;/span&gt; 만들어요.&lt;/p&gt;&lt;div class=&quot;code-block&quot;&gt;&lt;pre translate=&quot;no&quot; tabindex=&quot;0&quot; role=&quot;group&quot; aria-label=&quot;kotlin 코드&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;tok-annotation&quot;&gt;@Stable&lt;/span&gt;
&lt;span class=&quot;tok-keyword&quot;&gt;class&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;NavigationState&lt;/span&gt;(
    &lt;span class=&quot;tok-keyword&quot;&gt;val&lt;/span&gt; backStack&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;NavBackStack&lt;/span&gt;&amp;lt;&lt;span class=&quot;tok-type&quot;&gt;NavKey&lt;/span&gt;&amp;gt;&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt;
) {
    &lt;span class=&quot;tok-keyword&quot;&gt;fun&lt;/span&gt; &lt;span class=&quot;tok-function&quot;&gt;navigate&lt;/span&gt;(key&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;NavKey&lt;/span&gt;) {
        backStack&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;add&lt;/span&gt;(key)
    }

    &lt;span class=&quot;tok-keyword&quot;&gt;fun&lt;/span&gt; &lt;span class=&quot;tok-function&quot;&gt;goBack&lt;/span&gt;() {
        &lt;span class=&quot;tok-keyword&quot;&gt;if&lt;/span&gt; (backStack&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;size &amp;gt; &lt;span class=&quot;tok-number&quot;&gt;1&lt;/span&gt;) {
            backStack&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;removeLastOrNull&lt;/span&gt;()
        }
    }
}

&lt;span class=&quot;tok-annotation&quot;&gt;@Composable&lt;/span&gt;
&lt;span class=&quot;tok-keyword&quot;&gt;fun&lt;/span&gt; &lt;span class=&quot;tok-function&quot;&gt;rememberNavigationState&lt;/span&gt;(
    initialBackStack&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;List&lt;/span&gt;&amp;lt;&lt;span class=&quot;tok-type&quot;&gt;NavKey&lt;/span&gt;&amp;gt; = &lt;span class=&quot;tok-function&quot;&gt;listOf&lt;/span&gt;(&lt;span class=&quot;tok-type&quot;&gt;ExpenseListKey&lt;/span&gt;)&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt;
)&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-function&quot;&gt;NavigationState&lt;/span&gt; {
    &lt;span class=&quot;tok-keyword&quot;&gt;val&lt;/span&gt; backStack = &lt;span class=&quot;tok-function&quot;&gt;rememberNavBackStack&lt;/span&gt;(*initialBackStack&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;toTypedArray&lt;/span&gt;())
    &lt;span class=&quot;tok-keyword&quot;&gt;return&lt;/span&gt; &lt;span class=&quot;tok-function&quot;&gt;remember&lt;/span&gt;(backStack) { &lt;span class=&quot;tok-function&quot;&gt;NavigationState&lt;/span&gt;(backStack) }
}&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;rememberNavBackStack&lt;/code&gt;이&lt;/span&gt; 만드는 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;NavBackStack&lt;/code&gt;은&lt;/span&gt; 내부에 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;SnapshotStateList&lt;/code&gt;를&lt;/span&gt; 두고 있어서 키를 넣거나 빼면 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;NavDisplay&lt;/code&gt;가&lt;/span&gt; 다시 그려요. 타입을 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;MutableList&amp;lt;NavKey&amp;gt;&lt;/code&gt;로&lt;/span&gt; 열어 두면 일반 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;mutableListOf()&lt;/code&gt;도&lt;/span&gt; 넘길 수 있어요. 그러면 키가 늘어나도 화면이 바뀌지 않아요. 그래서 타입을 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;NavBackStack&amp;lt;NavKey&amp;gt;&lt;/code&gt;로&lt;/span&gt; 좁혔어요. &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;rememberNavBackStack&lt;/code&gt;은&lt;/span&gt; 설정이 바뀌거나 프로세스가 종료된 뒤에도 백스택을 복원해요.&lt;/p&gt;&lt;p&gt;&lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;goBack&lt;/code&gt;에서&lt;/span&gt; 크기를 확인하는 이유는 백스택이 비면 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;NavDisplay&lt;/code&gt;가&lt;/span&gt; &lt;code&gt;IllegalArgumentException&lt;/code&gt;(&amp;quot;NavDisplay backstack cannot be empty&amp;quot;)을 던지기 때문이에요. 시스템 뒤로 가기는 이 검사와 상관없어요. 첫 화면에서는 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;NavDisplay&lt;/code&gt;가&lt;/span&gt; 뒤로 가기를 가로채지 않아요. &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;onBack&lt;/code&gt;은&lt;/span&gt; 불리지 않고 시스템 기본 동작으로 넘어가요. 이 검사는 화면 안의 뒤로 버튼처럼 앱 코드가 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;goBack&lt;/code&gt;을&lt;/span&gt; 부를 때를 위한 거예요.&lt;/p&gt;&lt;p&gt;Now in Android는 상태(&lt;code&gt;NavigationState&lt;/code&gt;)와 이동 함수(&lt;code&gt;Navigator&lt;/code&gt;)를 나누고 하단 탭마다 백스택을 따로 둬요. 이 글의 예시는 백스택이 하나뿐이라 한 클래스로 합쳤어요.&lt;/p&gt;&lt;h2 id=&quot;4-navdisplay로-화면-그리기&quot;&gt;4. &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;NavDisplay&lt;/code&gt;로&lt;/span&gt; 화면 그리기&lt;/h2&gt;&lt;p&gt;&lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;NavDisplay&lt;/code&gt;는&lt;/span&gt; 백스택을 받아 맨 위 키에 맞는 화면을 그려요. 키마다 어떤 화면을 그릴지는 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;entryProvider&lt;/code&gt;로&lt;/span&gt; 정해요.&lt;/p&gt;&lt;div class=&quot;code-block&quot;&gt;&lt;pre translate=&quot;no&quot; tabindex=&quot;0&quot; role=&quot;group&quot; aria-label=&quot;kotlin 코드&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;tok-annotation&quot;&gt;@Composable&lt;/span&gt;
&lt;span class=&quot;tok-keyword&quot;&gt;fun&lt;/span&gt; &lt;span class=&quot;tok-function&quot;&gt;ExpenseApp&lt;/span&gt;() {
    &lt;span class=&quot;tok-keyword&quot;&gt;val&lt;/span&gt; navigationState = &lt;span class=&quot;tok-function&quot;&gt;rememberNavigationState&lt;/span&gt;()

    &lt;span class=&quot;tok-function&quot;&gt;NavDisplay&lt;/span&gt;(
        backStack = navigationState&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;backStack&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt;
        onBack = { navigationState&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;goBack&lt;/span&gt;() }&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt;
        entryDecorators = &lt;span class=&quot;tok-function&quot;&gt;listOf&lt;/span&gt;(
            &lt;span class=&quot;tok-function&quot;&gt;rememberSaveableStateHolderNavEntryDecorator&lt;/span&gt;()&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt;
            &lt;span class=&quot;tok-function&quot;&gt;rememberViewModelStoreNavEntryDecorator&lt;/span&gt;()&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt;
        )&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt;
        entryProvider = entryProvider {
            entry&amp;lt;&lt;span class=&quot;tok-type&quot;&gt;ExpenseListKey&lt;/span&gt;&amp;gt; {
                &lt;span class=&quot;tok-function&quot;&gt;ExpenseListScreen&lt;/span&gt;(
                    onItemClick = { id -&amp;gt; navigationState&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;navigate&lt;/span&gt;(&lt;span class=&quot;tok-function&quot;&gt;ExpenseDetailKey&lt;/span&gt;(id)) }&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt;
                    onSettingsClick = { navigationState&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;navigate&lt;/span&gt;(&lt;span class=&quot;tok-type&quot;&gt;ExpenseSettingsKey&lt;/span&gt;) }&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt;
                )
            }
            entry&amp;lt;&lt;span class=&quot;tok-type&quot;&gt;ExpenseDetailKey&lt;/span&gt;&amp;gt; { key -&amp;gt;
                &lt;span class=&quot;tok-keyword&quot;&gt;val&lt;/span&gt; viewModel = hiltViewModel&amp;lt;&lt;span class=&quot;tok-type&quot;&gt;ExpenseDetailViewModel&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;ExpenseDetailViewModel&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-type&quot;&gt;Factory&lt;/span&gt;&amp;gt;(
                    creationCallback = { factory -&amp;gt; factory&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;create&lt;/span&gt;(key) }&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt;
                )
                &lt;span class=&quot;tok-function&quot;&gt;ExpenseDetailScreen&lt;/span&gt;(
                    viewModel = viewModel&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt;
                    onBackClick = { navigationState&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;goBack&lt;/span&gt;() }&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt;
                )
            }
            entry&amp;lt;&lt;span class=&quot;tok-type&quot;&gt;ExpenseSettingsKey&lt;/span&gt;&amp;gt;(
                metadata = metadata {
                    &lt;span class=&quot;tok-function&quot;&gt;put&lt;/span&gt;(&lt;span class=&quot;tok-type&quot;&gt;NavDisplay&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-type&quot;&gt;TransitionKey&lt;/span&gt;) {
                        slideInVertically { it } togetherWith &lt;span class=&quot;tok-type&quot;&gt;ExitTransition&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-type&quot;&gt;KeepUntilTransitionsFinished&lt;/span&gt;
                    }
                    &lt;span class=&quot;tok-function&quot;&gt;put&lt;/span&gt;(&lt;span class=&quot;tok-type&quot;&gt;NavDisplay&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-type&quot;&gt;PopTransitionKey&lt;/span&gt;) {
                        &lt;span class=&quot;tok-type&quot;&gt;EnterTransition&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-type&quot;&gt;None&lt;/span&gt; togetherWith slideOutVertically { it }
                    }
                    &lt;span class=&quot;tok-function&quot;&gt;put&lt;/span&gt;(&lt;span class=&quot;tok-type&quot;&gt;NavDisplay&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-type&quot;&gt;PredictivePopTransitionKey&lt;/span&gt;) {
                        &lt;span class=&quot;tok-type&quot;&gt;EnterTransition&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-type&quot;&gt;None&lt;/span&gt; togetherWith slideOutVertically { it }
                    }
                }&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt;
            ) {
                &lt;span class=&quot;tok-function&quot;&gt;ExpenseSettingsScreen&lt;/span&gt;(onNavigateBack = { navigationState&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;goBack&lt;/span&gt;() })
            }
        }&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt;
    )
}&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h3 id=&quot;데코레이터&quot;&gt;데코레이터&lt;/h3&gt;&lt;p&gt;&lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;entryDecorators&lt;/code&gt;를&lt;/span&gt; 넘기지 않으면 기본값은 &lt;code&gt;rememberSaveableStateHolderNavEntryDecorator()&lt;/code&gt; 하나예요. 이 데코레이터가 화면마다 &lt;code&gt;rememberSaveable&lt;/code&gt; 상태를 저장해요. 목록을 직접 넘기면 기본값을 대신하므로 이 데코레이터도 같이 넣어야 해요.&lt;/p&gt;&lt;p&gt;&lt;code&gt;rememberViewModelStoreNavEntryDecorator()&lt;/code&gt;는 엔트리마다 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;ViewModelStoreOwner&lt;/code&gt;를&lt;/span&gt; 줘요. 그래서 엔트리 안에서 만든 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;ViewModel&lt;/code&gt;이&lt;/span&gt; 그 엔트리에 묶여요. 화면을 백스택에서 빼면 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;ViewModel&lt;/code&gt;도&lt;/span&gt; 정리돼요(&lt;code&gt;onCleared&lt;/code&gt;). 이 데코레이터가 없으면 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;ViewModel&lt;/code&gt;은&lt;/span&gt; 가장 가까운 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;ViewModelStoreOwner&lt;/code&gt;인&lt;/span&gt; Activity에 묶여요. 화면을 닫아도 정리되지 않고 같은 화면을 다시 열면 이전 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;ViewModel&lt;/code&gt;을&lt;/span&gt; 그대로 받아요. 레퍼런스에 따르면 엔트리의 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;ViewModel&lt;/code&gt;이&lt;/span&gt; &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;SavedStateHandle&lt;/code&gt;을&lt;/span&gt; 제대로 쓰려면 이 데코레이터를 저장 상태 데코레이터와 함께 써야 해요.&lt;/p&gt;&lt;h3 id=&quot;화면-전환-애니메이션&quot;&gt;화면 전환 애니메이션&lt;/h3&gt;&lt;p&gt;설정 화면만 아래에서 올라오게 하려고 엔트리의 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;metadata&lt;/code&gt;에&lt;/span&gt; 전환을 넣었어요. 세 키는 화면을 열 때, 닫을 때, predictive back 제스처로 닫을 때의 전환이에요. 엔트리에 넣은 전환은 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;NavDisplay&lt;/code&gt;의&lt;/span&gt; &lt;code&gt;transitionSpec&lt;/code&gt; 같은 인자로 정한 앱 전체의 전환보다 우선해요. 정확히는 Scene의 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;metadata&lt;/code&gt;를&lt;/span&gt; 보는데, 한 화면씩 보여 주는 Scene은 맨 위 엔트리의 것을 그대로 써요.&lt;/p&gt;&lt;h2 id=&quot;5-viewmodel에-키-넘기기&quot;&gt;5. &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;ViewModel&lt;/code&gt;에&lt;/span&gt; 키 넘기기&lt;/h2&gt;&lt;p&gt;Navigation 2에서는 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;ViewModel&lt;/code&gt;이&lt;/span&gt; &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;SavedStateHandle&lt;/code&gt;에서&lt;/span&gt; 인자를 꺼냈어요. Navigation 3에서는 &lt;code&gt;entry&lt;/code&gt; 람다가 키 객체를 그대로 받으니, 그 키를 &lt;code&gt;ViewModel&lt;/code&gt; 생성자에 넘기면 돼요. Hilt를 쓴다면 assisted injection으로 넘겨요.&lt;/p&gt;&lt;div class=&quot;code-block&quot;&gt;&lt;pre translate=&quot;no&quot; tabindex=&quot;0&quot; role=&quot;group&quot; aria-label=&quot;kotlin 코드&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;plugins {
    &lt;span class=&quot;tok-function&quot;&gt;id&lt;/span&gt;(&lt;span class=&quot;tok-string&quot;&gt;&amp;quot;com.google.devtools.ksp&amp;quot;&lt;/span&gt;)
    &lt;span class=&quot;tok-function&quot;&gt;id&lt;/span&gt;(&lt;span class=&quot;tok-string&quot;&gt;&amp;quot;com.google.dagger.hilt.android&amp;quot;&lt;/span&gt;)
}

dependencies {
    &lt;span class=&quot;tok-function&quot;&gt;implementation&lt;/span&gt;(&lt;span class=&quot;tok-string&quot;&gt;&amp;quot;com.google.dagger:hilt-android:2.60.1&amp;quot;&lt;/span&gt;)
    &lt;span class=&quot;tok-function&quot;&gt;ksp&lt;/span&gt;(&lt;span class=&quot;tok-string&quot;&gt;&amp;quot;com.google.dagger:hilt-compiler:2.60.1&amp;quot;&lt;/span&gt;)
    &lt;span class=&quot;tok-function&quot;&gt;implementation&lt;/span&gt;(&lt;span class=&quot;tok-string&quot;&gt;&amp;quot;androidx.hilt:hilt-lifecycle-viewmodel-compose:1.4.0&amp;quot;&lt;/span&gt;)
}&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;hiltViewModel()&lt;/code&gt;은&lt;/span&gt; hilt-lifecycle-viewmodel-compose에서 가져와요. AndroidX Hilt 1.3.0에서 이 아티팩트로 옮겨졌고, 예전의 hilt-navigation-compose와 달리 Navigation 2에 의존하지 않아요.&lt;/p&gt;&lt;p&gt;&lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;ViewModel&lt;/code&gt;은&lt;/span&gt; 키를 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;@Assisted&lt;/code&gt;로&lt;/span&gt; 받고, Hilt가 만들어 주는 팩토리로 생성해요.&lt;/p&gt;&lt;div class=&quot;code-block&quot;&gt;&lt;pre translate=&quot;no&quot; tabindex=&quot;0&quot; role=&quot;group&quot; aria-label=&quot;kotlin 코드&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;tok-annotation&quot;&gt;@HiltViewModel&lt;/span&gt;(assistedFactory = &lt;span class=&quot;tok-type&quot;&gt;ExpenseDetailViewModel&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-type&quot;&gt;Factory&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;::&lt;/span&gt;&lt;span class=&quot;tok-keyword&quot;&gt;class&lt;/span&gt;)
&lt;span class=&quot;tok-keyword&quot;&gt;class&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;ExpenseDetailViewModel&lt;/span&gt; &lt;span class=&quot;tok-annotation&quot;&gt;@AssistedInject&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;constructor&lt;/span&gt;(
    &lt;span class=&quot;tok-annotation&quot;&gt;@Assisted&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;private&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;val&lt;/span&gt; key&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;ExpenseDetailKey&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt;
    expenseRepository&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;ExpenseRepository&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt;
) &lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-function&quot;&gt;ViewModel&lt;/span&gt;() {
    &lt;span class=&quot;tok-keyword&quot;&gt;val&lt;/span&gt; expense&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;StateFlow&lt;/span&gt;&amp;lt;&lt;span class=&quot;tok-type&quot;&gt;Expense&lt;/span&gt;?&amp;gt; = expenseRepository&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;expense&lt;/span&gt;(key&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;expenseId)
        &lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;stateIn&lt;/span&gt;(viewModelScope&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;SharingStarted&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;WhileSubscribed&lt;/span&gt;(&lt;span class=&quot;tok-number&quot;&gt;5_000&lt;/span&gt;)&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;null&lt;/span&gt;)

    &lt;span class=&quot;tok-annotation&quot;&gt;@AssistedFactory&lt;/span&gt;
    &lt;span class=&quot;tok-keyword&quot;&gt;interface&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;Factory&lt;/span&gt; {
        &lt;span class=&quot;tok-keyword&quot;&gt;fun&lt;/span&gt; &lt;span class=&quot;tok-function&quot;&gt;create&lt;/span&gt;(key&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;ExpenseDetailKey&lt;/span&gt;)&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;ExpenseDetailViewModel&lt;/span&gt;
    }
}&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;4절의 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;entry&amp;lt;ExpenseDetailKey&amp;gt;&lt;/code&gt;에서&lt;/span&gt; &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;hiltViewModel&lt;/code&gt;의&lt;/span&gt; &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;creationCallback&lt;/code&gt;으로&lt;/span&gt; 키를 넘겼어요. &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;ExpenseRepository&lt;/code&gt;는&lt;/span&gt; Hilt가 주입하고 키는 화면을 그리는 시점에 넘어와요. 키가 다른 상세 화면을 여러 개 열어도 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;ViewModel&lt;/code&gt;이&lt;/span&gt; 섞이지 않아요. &lt;code&gt;ViewModelStoreNavEntryDecorator&lt;/code&gt;가 엔트리마다 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;ViewModelStore&lt;/code&gt;를&lt;/span&gt; 따로 두기 때문이에요. nav3-recipes의 Hilt 예제도 같은 이유로 이 데코레이터를 쓰라고 적어 두었어요.&lt;/p&gt;&lt;h2 id=&quot;6-다이얼로그와-큰-화면&quot;&gt;6. 다이얼로그와 큰 화면&lt;/h2&gt;&lt;p&gt;&lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;NavDisplay&lt;/code&gt;는&lt;/span&gt; 백스택의 엔트리를 Scene으로 묶어서 그려요. 기본은 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;SinglePaneSceneStrategy&lt;/code&gt;라&lt;/span&gt; 맨 위 엔트리 하나만 보여요. &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;sceneStrategies&lt;/code&gt;에&lt;/span&gt; 전략 목록을 넘기면 앞에서부터 차례로 시도해서 처음으로 Scene을 만든 전략을 써요. 어느 전략도 Scene을 만들지 못하면 한 화면씩 보여요. 1.1.0부터는 전략 하나를 받던 &lt;code&gt;sceneStrategy&lt;/code&gt; 대신 목록을 받는 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;sceneStrategies&lt;/code&gt;를&lt;/span&gt; 써요.&lt;/p&gt;&lt;p&gt;4절의 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;ExpenseApp&lt;/code&gt;에&lt;/span&gt; 다이얼로그와 목록-상세 전략을 더하면 이렇게 돼요. 바뀐 부분만 남겼어요.&lt;/p&gt;&lt;div class=&quot;code-block&quot;&gt;&lt;pre translate=&quot;no&quot; tabindex=&quot;0&quot; role=&quot;group&quot; aria-label=&quot;kotlin 코드&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;tok-annotation&quot;&gt;@OptIn&lt;/span&gt;(&lt;span class=&quot;tok-type&quot;&gt;ExperimentalMaterial3AdaptiveApi&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;::&lt;/span&gt;&lt;span class=&quot;tok-keyword&quot;&gt;class&lt;/span&gt;)
&lt;span class=&quot;tok-annotation&quot;&gt;@Composable&lt;/span&gt;
&lt;span class=&quot;tok-keyword&quot;&gt;fun&lt;/span&gt; &lt;span class=&quot;tok-function&quot;&gt;ExpenseApp&lt;/span&gt;(initialBackStack&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;List&lt;/span&gt;&amp;lt;&lt;span class=&quot;tok-type&quot;&gt;NavKey&lt;/span&gt;&amp;gt; = &lt;span class=&quot;tok-function&quot;&gt;listOf&lt;/span&gt;(&lt;span class=&quot;tok-type&quot;&gt;ExpenseListKey&lt;/span&gt;)) {
    &lt;span class=&quot;tok-keyword&quot;&gt;val&lt;/span&gt; navigationState = &lt;span class=&quot;tok-function&quot;&gt;rememberNavigationState&lt;/span&gt;(initialBackStack)
    &lt;span class=&quot;tok-keyword&quot;&gt;val&lt;/span&gt; dialogStrategy = remember { &lt;span class=&quot;tok-type&quot;&gt;DialogSceneStrategy&lt;/span&gt;&amp;lt;&lt;span class=&quot;tok-type&quot;&gt;NavKey&lt;/span&gt;&amp;gt;() }
    &lt;span class=&quot;tok-keyword&quot;&gt;val&lt;/span&gt; listDetailStrategy = rememberListDetailSceneStrategy&amp;lt;&lt;span class=&quot;tok-type&quot;&gt;NavKey&lt;/span&gt;&amp;gt;()

    &lt;span class=&quot;tok-function&quot;&gt;NavDisplay&lt;/span&gt;(
        &lt;span class=&quot;tok-comment&quot;&gt;// ...&lt;/span&gt;
        sceneStrategies = &lt;span class=&quot;tok-function&quot;&gt;listOf&lt;/span&gt;(dialogStrategy&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt; listDetailStrategy)&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt;
        entryProvider = entryProvider {
            entry&amp;lt;&lt;span class=&quot;tok-type&quot;&gt;ExpenseListKey&lt;/span&gt;&amp;gt;(
                metadata = &lt;span class=&quot;tok-type&quot;&gt;ListDetailSceneStrategy&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;listPane&lt;/span&gt;(
                    detailPlaceholder = { &lt;span class=&quot;tok-function&quot;&gt;Text&lt;/span&gt;(&lt;span class=&quot;tok-string&quot;&gt;&amp;quot;Choose an expense&amp;quot;&lt;/span&gt;) }&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt;
                )&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt;
            ) {
                &lt;span class=&quot;tok-comment&quot;&gt;// ...&lt;/span&gt;
            }
            entry&amp;lt;&lt;span class=&quot;tok-type&quot;&gt;ExpenseDetailKey&lt;/span&gt;&amp;gt;(
                metadata = &lt;span class=&quot;tok-type&quot;&gt;ListDetailSceneStrategy&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;detailPane&lt;/span&gt;()&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt;
            ) { key -&amp;gt;
                &lt;span class=&quot;tok-comment&quot;&gt;// ...&lt;/span&gt;
            }
            entry&amp;lt;&lt;span class=&quot;tok-type&quot;&gt;DeleteExpenseKey&lt;/span&gt;&amp;gt;(
                metadata = &lt;span class=&quot;tok-type&quot;&gt;DialogSceneStrategy&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;dialog&lt;/span&gt;()&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt;
            ) { key -&amp;gt;
                &lt;span class=&quot;tok-function&quot;&gt;DeleteExpenseDialog&lt;/span&gt;(
                    expenseId = key&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;expenseId&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt;
                    onDismiss = { navigationState&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;goBack&lt;/span&gt;() }&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt;
                )
            }
            &lt;span class=&quot;tok-comment&quot;&gt;// ...&lt;/span&gt;
        }&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt;
    )
}&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;DialogSceneStrategy&lt;/code&gt;는&lt;/span&gt; navigation3-ui에 들어 있어요. 상세 화면의 삭제 버튼이 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;DeleteExpenseKey&lt;/code&gt;를&lt;/span&gt; 백스택에 넣으면, &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;metadata&lt;/code&gt;에&lt;/span&gt; &lt;code&gt;DialogSceneStrategy.dialog()&lt;/code&gt;를 넣은 이 엔트리가 아래 화면 위에 다이얼로그로 떠요. 상세 화면은 다이얼로그 아래에 그대로 남아요. 시스템 뒤로 가기를 누르면 다이얼로그만 닫혀요. 전략 객체는 공식 예제처럼 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;remember&lt;/code&gt;로&lt;/span&gt; 감싸서 리컴포지션마다 새로 만들지 않게 했어요.&lt;/p&gt;&lt;p&gt;&lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;ListDetailSceneStrategy&lt;/code&gt;는&lt;/span&gt; Material 3 Adaptive의 adaptive-navigation3에 있어요. 1.3.0에서도 &lt;code&gt;@ExperimentalMaterial3AdaptiveApi&lt;/code&gt;라서 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;@OptIn&lt;/code&gt;이&lt;/span&gt; 필요해요. 목록 화면에 &lt;code&gt;listPane()&lt;/code&gt;, 상세 화면에 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;detailPane()&lt;/code&gt;을&lt;/span&gt; 붙이면, 넓은 창에서는 목록과 상세를 나란히 보여 주고 좁은 창에서는 한 화면씩 보여 줘요. 상세 화면을 아직 열지 않았으면 넓은 창의 오른쪽에 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;detailPlaceholder&lt;/code&gt;가&lt;/span&gt; 보여요.&lt;/p&gt;&lt;h2 id=&quot;7-딥링크&quot;&gt;7. 딥링크&lt;/h2&gt;&lt;p&gt;이 글을 처음 쓴 2026년 3월에는 Navigation 3에 딥링크 API가 없어서 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;Intent&lt;/code&gt;의&lt;/span&gt; URI를 직접 파싱해 키로 바꿔야 했어요. 1.2.0부터는 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;DeepLinkRequest&lt;/code&gt;와&lt;/span&gt; &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;DeepLinkMatcher&lt;/code&gt;로&lt;/span&gt; URI를 키로 바꿀 수 있어요.&lt;/p&gt;&lt;p&gt;매니페스트의 Activity에 &lt;code&gt;https://example.com/expenses/`로 시작하는 URI를 받는 &lt;/code&gt;intent-filter`를 둔 뒤, URI 패턴과 키를 연결하는 매처를 만들어요.&lt;/p&gt;&lt;div class=&quot;code-block&quot;&gt;&lt;pre translate=&quot;no&quot; tabindex=&quot;0&quot; role=&quot;group&quot; aria-label=&quot;kotlin 코드&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;tok-keyword&quot;&gt;val&lt;/span&gt; expenseDetailMatcher = &lt;span class=&quot;tok-function&quot;&gt;UriDeepLinkMatcher&lt;/span&gt;(
    &lt;span class=&quot;tok-function&quot;&gt;DeepLinkUri&lt;/span&gt;(&lt;span class=&quot;tok-string&quot;&gt;&amp;quot;https://example.com/expenses/{expenseId}&amp;quot;&lt;/span&gt;)&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt;
    serializer&amp;lt;&lt;span class=&quot;tok-type&quot;&gt;ExpenseDetailKey&lt;/span&gt;&amp;gt;()&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt;
)&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;withBackStack { matchResult -&amp;gt;
    &lt;span class=&quot;tok-function&quot;&gt;listOf&lt;/span&gt;(&lt;span class=&quot;tok-type&quot;&gt;ExpenseListKey&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt; matchResult&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;key)
}

&lt;span class=&quot;tok-keyword&quot;&gt;fun&lt;/span&gt; &lt;span class=&quot;tok-function&quot;&gt;deepLinkBackStack&lt;/span&gt;(intent&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;Intent&lt;/span&gt;)&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;List&lt;/span&gt;&amp;lt;&lt;span class=&quot;tok-type&quot;&gt;NavKey&lt;/span&gt;&amp;gt; =
    expenseDetailMatcher&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;match&lt;/span&gt;(&lt;span class=&quot;tok-function&quot;&gt;DeepLinkRequest&lt;/span&gt;(intent = intent))?&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;backStack
        ?&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-function&quot;&gt;listOf&lt;/span&gt;(&lt;span class=&quot;tok-type&quot;&gt;ExpenseListKey&lt;/span&gt;)&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;UriDeepLinkMatcher&lt;/code&gt;는&lt;/span&gt; URI 패턴의 &lt;code&gt;{expenseId}&lt;/code&gt; 자리를 읽어 &lt;code&gt;@Serializable&lt;/code&gt; 키의 같은 이름 속성에 넣어요. &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;withBackStack&lt;/code&gt;으로는&lt;/span&gt; 딥링크로 열었을 때의 백스택을 정해요. &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;MainActivity&lt;/code&gt;의&lt;/span&gt; &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;onCreate&lt;/code&gt;에서&lt;/span&gt; &lt;code&gt;deepLinkBackStack(intent)&lt;/code&gt;로 만든 백스택을 &lt;code&gt;ExpenseApp(initialBackStack)&lt;/code&gt;에 넘기면 돼요.&lt;/p&gt;&lt;p&gt;&lt;code&gt;https://example.com/expenses/7`을 담은 &lt;/code&gt;Intent&lt;code&gt;로 앱을 열면 백스택이 &lt;/code&gt;[ExpenseListKey, ExpenseDetailKey(&amp;quot;7&amp;quot;)]`로 시작해요. 상세 화면이 바로 보이고 뒤로 가기를 누르면 목록으로 가요. 맞는 패턴이 없으면 목록 화면 하나로 시작해요.&lt;/p&gt;&lt;p&gt;몇 가지는 따로 챙겨야 해요.&lt;/p&gt;&lt;ul&gt;&lt;li&gt;&lt;code&gt;DeepLinkRequest(intent = intent)&lt;/code&gt;와 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;withBackStack&lt;/code&gt;은&lt;/span&gt; 확장 함수라서 &lt;code&gt;deeplink&lt;/code&gt; 패키지의 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;invoke&lt;/code&gt;와&lt;/span&gt; &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;withBackStack&lt;/code&gt;을&lt;/span&gt; 따로 import해야 해요.&lt;/li&gt;&lt;li&gt;Android 12부터는 앱이 도메인을 인증받지 않으면 https 링크가 앱이 아니라 기본 브라우저로 열려요. 실제 도메인이라면 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;intent-filter&lt;/code&gt;에&lt;/span&gt; &lt;code&gt;android:autoVerify=&amp;quot;true&amp;quot;&lt;/code&gt;를 두고 Android App Links 인증을 거쳐야 해요.&lt;/li&gt;&lt;li&gt;이 예시는 앱을 새로 열 때만 딥링크를 처리해요. 앱이 떠 있을 때 오는 딥링크는 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;onNewIntent&lt;/code&gt;에서&lt;/span&gt; 받아 지금 백스택을 바꿔야 해서, &lt;code&gt;singleTop&lt;/code&gt; 같은 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;launchMode&lt;/code&gt;와&lt;/span&gt; Activity가 바꿀 수 있는 백스택이 필요해요.&lt;/li&gt;&lt;/ul&gt;&lt;h2 id=&quot;마무리&quot;&gt;마무리&lt;/h2&gt;&lt;p&gt;저는 Navigation 3에서 화면 이동이 리스트에 키를 넣고 빼는 일이라, 어떤 화면이 열려 있는지 백스택만 보면 알 수 있어서 다루기 쉽다고 생각해요. 처음에는 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;rememberNavBackStack&lt;/code&gt;과&lt;/span&gt; 데코레이터 두 개로 시작하고 다이얼로그나 큰 화면이 필요해질 때 Scene 전략을 더하기를 권해요.&lt;/p&gt;&lt;h2 id=&quot;참고&quot;&gt;참고&lt;/h2&gt;&lt;ul&gt;&lt;li&gt;&lt;a href=&quot;https://developer.android.com/guide/navigation/navigation-3/get-started&quot; rel=&quot;noopener&quot;&gt;Navigation 3 시작하기&lt;/a&gt;: 의존성과 compileSdk&lt;/li&gt;&lt;li&gt;&lt;a href=&quot;https://developer.android.com/guide/navigation/navigation-3/basics&quot; rel=&quot;noopener&quot;&gt;Navigation 3 기본 사항&lt;/a&gt;: 백스택, 키, &lt;code&gt;entryProvider&lt;/code&gt;&lt;/li&gt;&lt;li&gt;&lt;a href=&quot;https://developer.android.com/guide/navigation/navigation-3/save-state&quot; rel=&quot;noopener&quot;&gt;상태 저장과 ViewModel 범위&lt;/a&gt;: &lt;code&gt;rememberNavBackStack&lt;/code&gt;, &lt;code&gt;NavKey&lt;/code&gt;, 데코레이터&lt;/li&gt;&lt;li&gt;&lt;a href=&quot;https://developer.android.com/reference/kotlin/androidx/lifecycle/viewmodel/navigation3/ViewModelStoreNavEntryDecorator&quot; rel=&quot;noopener&quot;&gt;&lt;code&gt;ViewModelStoreNavEntryDecorator&lt;/code&gt; 레퍼런스&lt;/a&gt;&lt;/li&gt;&lt;li&gt;&lt;a href=&quot;https://developer.android.com/guide/navigation/navigation-3/custom-layouts&quot; rel=&quot;noopener&quot;&gt;맞춤 레이아웃과 Scene&lt;/a&gt;: &lt;code&gt;sceneStrategies&lt;/code&gt;, &lt;code&gt;ListDetailSceneStrategy&lt;/code&gt;&lt;/li&gt;&lt;li&gt;&lt;a href=&quot;https://developer.android.com/guide/navigation/navigation-3/animate-destinations&quot; rel=&quot;noopener&quot;&gt;화면 전환 애니메이션&lt;/a&gt;&lt;/li&gt;&lt;li&gt;&lt;a href=&quot;https://developer.android.com/guide/navigation/navigation-3/deep-links&quot; rel=&quot;noopener&quot;&gt;딥링크&lt;/a&gt;&lt;/li&gt;&lt;li&gt;&lt;a href=&quot;https://developer.android.com/guide/navigation/navigation-3/modularize&quot; rel=&quot;noopener&quot;&gt;내비게이션 코드 모듈화&lt;/a&gt;&lt;/li&gt;&lt;li&gt;&lt;a href=&quot;https://developer.android.com/jetpack/androidx/releases/navigation3&quot; rel=&quot;noopener&quot;&gt;Navigation 3 릴리스 노트&lt;/a&gt;&lt;/li&gt;&lt;li&gt;&lt;a href=&quot;https://developer.android.com/jetpack/androidx/releases/lifecycle&quot; rel=&quot;noopener&quot;&gt;lifecycle 릴리스 노트&lt;/a&gt;: 2.11.0의 AGP 요구 사항&lt;/li&gt;&lt;li&gt;&lt;a href=&quot;https://developer.android.com/jetpack/androidx/releases/hilt&quot; rel=&quot;noopener&quot;&gt;AndroidX Hilt 릴리스 노트&lt;/a&gt;: &lt;code&gt;hilt-lifecycle-viewmodel-compose&lt;/code&gt;&lt;/li&gt;&lt;li&gt;&lt;a href=&quot;https://developer.android.com/guide/navigation/use-graph/pass-data&quot; rel=&quot;noopener&quot;&gt;Navigation 2 인자 전달&lt;/a&gt;: 최소한의 데이터만 넘기라는 권고&lt;/li&gt;&lt;li&gt;&lt;a href=&quot;https://developer.android.com/training/app-links/verify-android-applinks&quot; rel=&quot;noopener&quot;&gt;Android App Links 인증&lt;/a&gt;&lt;/li&gt;&lt;li&gt;&lt;a href=&quot;https://github.com/android/nav3-recipes&quot; rel=&quot;noopener&quot;&gt;nav3-recipes&lt;/a&gt;: 공식 예제 모음, Hilt로 키를 넘기는 예제와 딥링크 예제&lt;/li&gt;&lt;li&gt;&lt;a href=&quot;https://github.com/android/nowinandroid/blob/main/core/navigation/src/main/kotlin/com/google/samples/apps/nowinandroid/core/navigation/NavigationState.kt&quot; rel=&quot;noopener&quot;&gt;Now in Android &lt;code&gt;NavigationState&lt;/code&gt;&lt;/a&gt;&lt;/li&gt;&lt;li&gt;&lt;a href=&quot;https://github.com/androidx/androidx/blob/androidx-main/navigation3/navigation3-ui/src/commonMain/kotlin/androidx/navigation3/ui/NavDisplay.kt&quot; rel=&quot;noopener&quot;&gt;&lt;code&gt;NavDisplay&lt;/code&gt; 소스&lt;/a&gt;: 빈 백스택 검사&lt;/li&gt;&lt;/ul&gt;&lt;/div&gt;</content>
  </entry>
  <entry>
    <title>Android 테스트: Mock 대신 Fake로 상태 검증하기</title>
    <link rel="alternate" type="text/html" href="https://debugyu.pages.dev/posts/android-testing/"/>
    <id>https://debugyu.pages.dev/posts/android-testing/</id>
    <published>2026-02-08T00:00:00+09:00</published>
    <updated>2026-11-15T00:00:00+09:00</updated>
    <category term="Android"/>
    <category term="Test"/>
    <summary>호출을 검증하는 Mock 테스트는 동작이 그대로여도 구현이 바뀌면 깨져요. Fake로 상태를 검증하는 방법과 코루틴 코드를 테스트할 때 디스패처를 다루는 방법을 정리했어요.</summary>
    <content type="html" xml:base="https://debugyu.pages.dev/">&lt;div&gt;&lt;p&gt;화면은 그대로 잘 동작하는데 리팩터링을 하고 나니 테스트가 실패하는 경우가 있어요. 테스트가 결과 대신 구현 방식을 확인하고 있으면 이런 일이 생겨요. 이 글에서는 Mock으로 호출을 검증하는 테스트가 어떻게 깨지는지 보고 Fake로 상태를 검증하는 테스트로 바꾸는 방법과 코루틴 코드를 테스트할 때 필요한 도구를 정리해요.&lt;/p&gt;&lt;p&gt;코드는 lifecycle 2.11.0, kotlinx-coroutines-test 1.11.0, Turbine 1.2.1, Mockito 5.24.0 기준이에요. 모두 Android 라이브러리 모듈의 로컬 테스트로 실행해 확인했어요.&lt;/p&gt;&lt;h2 id=&quot;1-호출을-검증하는-테스트의-한계&quot;&gt;1. 호출을 검증하는 테스트의 한계&lt;/h2&gt;&lt;p&gt;예시는 사용자 한 명을 불러와 화면 상태로 바꾸는 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;ViewModel&lt;/code&gt;이에요&lt;/span&gt;.&lt;/p&gt;&lt;div class=&quot;code-block&quot;&gt;&lt;pre translate=&quot;no&quot; tabindex=&quot;0&quot; role=&quot;group&quot; aria-label=&quot;kotlin 코드&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;tok-keyword&quot;&gt;data&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;class&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;User&lt;/span&gt;(&lt;span class=&quot;tok-keyword&quot;&gt;val&lt;/span&gt; id&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;String&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;val&lt;/span&gt; name&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;String&lt;/span&gt;)

&lt;span class=&quot;tok-keyword&quot;&gt;interface&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;UserRepository&lt;/span&gt; {
    &lt;span class=&quot;tok-keyword&quot;&gt;fun&lt;/span&gt; &lt;span class=&quot;tok-function&quot;&gt;getUser&lt;/span&gt;(userId&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;String&lt;/span&gt;)&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;Flow&lt;/span&gt;&amp;lt;&lt;span class=&quot;tok-type&quot;&gt;Result&lt;/span&gt;&amp;lt;&lt;span class=&quot;tok-type&quot;&gt;User&lt;/span&gt;&amp;gt;&amp;gt;
    &lt;span class=&quot;tok-keyword&quot;&gt;suspend&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;fun&lt;/span&gt; &lt;span class=&quot;tok-function&quot;&gt;saveUser&lt;/span&gt;(user&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;User&lt;/span&gt;)
}

&lt;span class=&quot;tok-keyword&quot;&gt;sealed&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;interface&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;UiState&lt;/span&gt; {
    &lt;span class=&quot;tok-keyword&quot;&gt;data&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;object&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;Loading&lt;/span&gt; &lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;UiState&lt;/span&gt;
    &lt;span class=&quot;tok-keyword&quot;&gt;data&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;class&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;Success&lt;/span&gt;(&lt;span class=&quot;tok-keyword&quot;&gt;val&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;data&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;User&lt;/span&gt;) &lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;UiState&lt;/span&gt;
    &lt;span class=&quot;tok-keyword&quot;&gt;data&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;class&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;Error&lt;/span&gt;(&lt;span class=&quot;tok-keyword&quot;&gt;val&lt;/span&gt; message&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;String&lt;/span&gt;) &lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;UiState&lt;/span&gt;
}

&lt;span class=&quot;tok-keyword&quot;&gt;class&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;UserViewModel&lt;/span&gt;(
    &lt;span class=&quot;tok-keyword&quot;&gt;private&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;val&lt;/span&gt; userRepository&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;UserRepository&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt;
) &lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-function&quot;&gt;ViewModel&lt;/span&gt;() {
    &lt;span class=&quot;tok-keyword&quot;&gt;private&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;val&lt;/span&gt; _uiState = &lt;span class=&quot;tok-type&quot;&gt;MutableStateFlow&lt;/span&gt;&amp;lt;&lt;span class=&quot;tok-type&quot;&gt;UiState&lt;/span&gt;&amp;gt;(&lt;span class=&quot;tok-type&quot;&gt;UiState&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-type&quot;&gt;Loading&lt;/span&gt;)
    &lt;span class=&quot;tok-keyword&quot;&gt;val&lt;/span&gt; uiState&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;StateFlow&lt;/span&gt;&amp;lt;&lt;span class=&quot;tok-type&quot;&gt;UiState&lt;/span&gt;&amp;gt; = _uiState&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;asStateFlow&lt;/span&gt;()

    &lt;span class=&quot;tok-keyword&quot;&gt;fun&lt;/span&gt; &lt;span class=&quot;tok-function&quot;&gt;loadUser&lt;/span&gt;(userId&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;String&lt;/span&gt;) {
        viewModelScope&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;launch {
            userRepository&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;getUser&lt;/span&gt;(userId)&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;collect { result -&amp;gt;
                _uiState&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;value = result&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;fold&lt;/span&gt;(
                    onSuccess = { &lt;span class=&quot;tok-type&quot;&gt;UiState&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;Success&lt;/span&gt;(it) }&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt;
                    onFailure = { &lt;span class=&quot;tok-type&quot;&gt;UiState&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;Error&lt;/span&gt;(it&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;message&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;orEmpty&lt;/span&gt;()) }&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt;
                )
            }
        }
    }
}&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Mockito로 이 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;ViewModel&lt;/code&gt;을&lt;/span&gt; 테스트하면 이렇게 쓸 수 있어요. &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;UserRepository&lt;/code&gt;가&lt;/span&gt; 돌려줄 값을 정해 두고 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;loadUser&lt;/code&gt;가&lt;/span&gt; &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;getUser&lt;/code&gt;를&lt;/span&gt; 한 번 불렀는지 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;verify&lt;/code&gt;로&lt;/span&gt; 확인해요. &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;MainDispatcherRule&lt;/code&gt;은&lt;/span&gt; 5절에서 설명해요.&lt;/p&gt;&lt;div class=&quot;code-block&quot;&gt;&lt;pre translate=&quot;no&quot; tabindex=&quot;0&quot; role=&quot;group&quot; aria-label=&quot;kotlin 코드&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;tok-keyword&quot;&gt;class&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;UserViewModelMockTest&lt;/span&gt; {
    &lt;span class=&quot;tok-annotation&quot;&gt;@get&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;tok-type&quot;&gt;Rule&lt;/span&gt;
    &lt;span class=&quot;tok-keyword&quot;&gt;val&lt;/span&gt; mainDispatcherRule = &lt;span class=&quot;tok-function&quot;&gt;MainDispatcherRule&lt;/span&gt;()

    &lt;span class=&quot;tok-keyword&quot;&gt;private&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;val&lt;/span&gt; userRepository = &lt;span class=&quot;tok-type&quot;&gt;Mockito&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;mock&lt;/span&gt;(&lt;span class=&quot;tok-type&quot;&gt;UserRepository&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;::&lt;/span&gt;&lt;span class=&quot;tok-keyword&quot;&gt;class&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;java)

    &lt;span class=&quot;tok-annotation&quot;&gt;@Test&lt;/span&gt;
    &lt;span class=&quot;tok-keyword&quot;&gt;fun&lt;/span&gt; &lt;span class=&quot;tok-function&quot;&gt;loadUser_callsRepositoryOnce&lt;/span&gt;() {
        &lt;span class=&quot;tok-type&quot;&gt;Mockito&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;`&lt;span class=&quot;tok-keyword&quot;&gt;when&lt;/span&gt;`(userRepository&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;getUser&lt;/span&gt;(&lt;span class=&quot;tok-string&quot;&gt;&amp;quot;user_1&amp;quot;&lt;/span&gt;))
            &lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;thenReturn&lt;/span&gt;(&lt;span class=&quot;tok-function&quot;&gt;flowOf&lt;/span&gt;(&lt;span class=&quot;tok-type&quot;&gt;Result&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;success&lt;/span&gt;(&lt;span class=&quot;tok-function&quot;&gt;User&lt;/span&gt;(id = &lt;span class=&quot;tok-string&quot;&gt;&amp;quot;user_1&amp;quot;&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt; name = &lt;span class=&quot;tok-string&quot;&gt;&amp;quot;Mingyu&amp;quot;&lt;/span&gt;))))
        &lt;span class=&quot;tok-keyword&quot;&gt;val&lt;/span&gt; viewModel = &lt;span class=&quot;tok-function&quot;&gt;UserViewModel&lt;/span&gt;(userRepository)

        viewModel&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;loadUser&lt;/span&gt;(&lt;span class=&quot;tok-string&quot;&gt;&amp;quot;user_1&amp;quot;&lt;/span&gt;)

        &lt;span class=&quot;tok-type&quot;&gt;Mockito&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;verify&lt;/span&gt;(userRepository&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;Mockito&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;times&lt;/span&gt;(1))&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;getUser&lt;/span&gt;(&lt;span class=&quot;tok-string&quot;&gt;&amp;quot;user_1&amp;quot;&lt;/span&gt;)
    }
}&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;이 테스트는 통과해요. 이제 화면이 받는 상태는 그대로 두고 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;ViewModel&lt;/code&gt;만&lt;/span&gt; &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;stateIn&lt;/code&gt;으로&lt;/span&gt; 상태를 만드는 형태로 바꿔요. Now in Android의 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;ViewModel&lt;/code&gt;들이&lt;/span&gt; 쓰는 형태예요. &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;Result&lt;/code&gt;를&lt;/span&gt; &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;UiState&lt;/code&gt;로&lt;/span&gt; 바꾸는 부분은 1절과 같아서 줄였어요.&lt;/p&gt;&lt;div class=&quot;code-block&quot;&gt;&lt;pre translate=&quot;no&quot; tabindex=&quot;0&quot; role=&quot;group&quot; aria-label=&quot;kotlin 코드&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;tok-annotation&quot;&gt;@OptIn&lt;/span&gt;(&lt;span class=&quot;tok-type&quot;&gt;ExperimentalCoroutinesApi&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;::&lt;/span&gt;&lt;span class=&quot;tok-keyword&quot;&gt;class&lt;/span&gt;)
&lt;span class=&quot;tok-keyword&quot;&gt;class&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;UserViewModel&lt;/span&gt;(
    &lt;span class=&quot;tok-keyword&quot;&gt;private&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;val&lt;/span&gt; userRepository&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;UserRepository&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt;
) &lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-function&quot;&gt;ViewModel&lt;/span&gt;() {
    &lt;span class=&quot;tok-keyword&quot;&gt;private&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;val&lt;/span&gt; userId = &lt;span class=&quot;tok-type&quot;&gt;MutableStateFlow&lt;/span&gt;&amp;lt;&lt;span class=&quot;tok-type&quot;&gt;String&lt;/span&gt;?&amp;gt;(&lt;span class=&quot;tok-keyword&quot;&gt;null&lt;/span&gt;)

    &lt;span class=&quot;tok-keyword&quot;&gt;val&lt;/span&gt; uiState&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;StateFlow&lt;/span&gt;&amp;lt;&lt;span class=&quot;tok-type&quot;&gt;UiState&lt;/span&gt;&amp;gt; = userId
        &lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;filterNotNull&lt;/span&gt;()
        &lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;flatMapLatest { id -&amp;gt; userRepository&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;getUser&lt;/span&gt;(id) }
        &lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;map { result -&amp;gt;
            &lt;span class=&quot;tok-comment&quot;&gt;// ...&lt;/span&gt;
        }
        &lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;stateIn&lt;/span&gt;(viewModelScope&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;SharingStarted&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;WhileSubscribed&lt;/span&gt;(&lt;span class=&quot;tok-number&quot;&gt;5_000&lt;/span&gt;)&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;UiState&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-type&quot;&gt;Loading&lt;/span&gt;)

    &lt;span class=&quot;tok-keyword&quot;&gt;fun&lt;/span&gt; &lt;span class=&quot;tok-function&quot;&gt;loadUser&lt;/span&gt;(userId&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;String&lt;/span&gt;) {
        &lt;span class=&quot;tok-keyword&quot;&gt;this&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;userId&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;value = userId
    }
}&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;바꾼 뒤 같은 테스트를 돌리면 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;WantedButNotInvoked&lt;/code&gt;로&lt;/span&gt; 실패해요. &lt;code&gt;SharingStarted.WhileSubscribed&lt;/code&gt;는 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;uiState&lt;/code&gt;를&lt;/span&gt; 구독하는 쪽이 생겨야 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;getUser&lt;/code&gt;를&lt;/span&gt; 부르는 Flow를 시작해요. 이 테스트는 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;uiState&lt;/code&gt;를&lt;/span&gt; 구독하지 않아서 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;getUser&lt;/code&gt;가&lt;/span&gt; 불리지 않았어요. 실제 화면은 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;uiState&lt;/code&gt;를&lt;/span&gt; 구독하니 사용자가 보는 결과는 똑같아요. 동작은 그대로인데 테스트만 깨졌어요.&lt;/p&gt;&lt;p&gt;공식 문서는 Mock을 어떤 호출을 받을지 기대가 정해진 테스트 더블로 설명해요. 그래서 Mock으로 쓴 테스트는 결과보다 호출 방식에 묶이고, 호출 방식을 바꾸는 리팩터링을 할 때마다 같이 고쳐야 해요.&lt;/p&gt;&lt;h2 id=&quot;2-테스트용으로-만든-가벼운-구현-fake&quot;&gt;2. 테스트용으로 만든 가벼운 구현, Fake&lt;/h2&gt;&lt;p&gt;Android 공식 문서는 테스트 더블을 여섯 가지로 나눠요.&lt;/p&gt;&lt;div class=&quot;table-scroll&quot; tabindex=&quot;0&quot; role=&quot;group&quot; aria-label=&quot;표: 종류, 설명&quot;&gt;&lt;table data-columns=&quot;2&quot;&gt;&lt;thead&gt;&lt;tr&gt;&lt;th scope=&quot;col&quot;&gt;종류&lt;/th&gt;&lt;th scope=&quot;col&quot;&gt;설명&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;Fake&lt;/td&gt;&lt;td&gt;테스트에 맞게 단순하게 만든, 실제로 동작하는 구현. 예: 인메모리 데이터베이스&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Mock&lt;/td&gt;&lt;td&gt;정해 둔 대로 동작하며 호출이 기대와 다르면 테스트를 실패시키는 객체. 예: 메서드가 정확히 한 번 불렸는지 확인&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Stub&lt;/td&gt;&lt;td&gt;정해 둔 대로 동작하지만 호출을 검증하지는 않는 객체&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Dummy&lt;/td&gt;&lt;td&gt;인자를 채우려고 넘기기만 하고 쓰지 않는 객체&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Spy&lt;/td&gt;&lt;td&gt;실제 객체를 감싸고 호출 기록 같은 추가 정보를 함께 남기는 객체&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Shadow&lt;/td&gt;&lt;td&gt;Robolectric에서 쓰는 Fake&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;&lt;/div&gt;&lt;p&gt;이 중 공식 문서가 권하는 것은 Fake예요. Fake는 실제로 동작하지만 테스트에 맞게 단순하게 만들어서 프로덕션에는 쓸 수 없는 구현이에요. Mocking 프레임워크가 필요 없고 가벼워요. Now in Android의 테스트 전략 문서는 아예 Mocking 프레임워크를 쓰지 않고 Fake를 쓴다고 정해 두었어요.&lt;/p&gt;&lt;h2 id=&quot;3-fake로-상태를-검증하기&quot;&gt;3. Fake로 상태를 검증하기&lt;/h2&gt;&lt;p&gt;Fake를 쓰면 함수가 불렸는지 대신 상태가 기대한 대로 바뀌었는지를 확인할 수 있어요. 1절의 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;UserViewModel&lt;/code&gt;을&lt;/span&gt; Fake로 다시 테스트해요.&lt;/p&gt;&lt;h3 id=&quot;의존성을-인터페이스로-받기&quot;&gt;의존성을 인터페이스로 받기&lt;/h3&gt;&lt;p&gt;&lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;UserViewModel&lt;/code&gt;은&lt;/span&gt; 생성자로 &lt;code&gt;UserRepository&lt;/code&gt; 인터페이스를 받아요. 그래서 테스트에서는 실제 구현 대신 Fake를 넘길 수 있어요. 공식 문서가 테스트하기 쉬운 구조를 만드는 방법으로 드는 네 가지 중 하나예요. 나머지 셋은 레이어나 기능별 모듈로 나누기, Activity와 Fragment에 로직을 넣지 않기, 비즈니스 로직이 프레임워크에 직접 의존하지 않게 하기예요. 인터페이스를 쓰고 의존성 주입(DI)을 쓰는 건 DI 프레임워크가 없어도 할 수 있어요.&lt;/p&gt;&lt;h3 id=&quot;fake-만들기&quot;&gt;Fake 만들기&lt;/h3&gt;&lt;p&gt;Fake는 &lt;code&gt;test&lt;/code&gt; 소스 세트에 둬서 앱과 함께 배포되지 않게 해요. 여러 모듈의 테스트가 같은 Fake를 쓴다면 Now in Android처럼 테스트 전용 모듈(&lt;code&gt;core:testing&lt;/code&gt;)을 만들고 각 모듈이 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;testImplementation&lt;/code&gt;으로&lt;/span&gt; 가져다 써요.&lt;/p&gt;&lt;div class=&quot;code-block&quot;&gt;&lt;pre translate=&quot;no&quot; tabindex=&quot;0&quot; role=&quot;group&quot; aria-label=&quot;kotlin 코드&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;tok-keyword&quot;&gt;class&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;FakeUserRepository&lt;/span&gt; &lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-function&quot;&gt;UserRepository&lt;/span&gt; {
    &lt;span class=&quot;tok-keyword&quot;&gt;private&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;val&lt;/span&gt; users = &lt;span class=&quot;tok-type&quot;&gt;MutableStateFlow&lt;/span&gt;&amp;lt;&lt;span class=&quot;tok-type&quot;&gt;List&lt;/span&gt;&amp;lt;&lt;span class=&quot;tok-type&quot;&gt;User&lt;/span&gt;&amp;gt;&amp;gt;(&lt;span class=&quot;tok-function&quot;&gt;emptyList&lt;/span&gt;())

    &lt;span class=&quot;tok-keyword&quot;&gt;override&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;fun&lt;/span&gt; &lt;span class=&quot;tok-function&quot;&gt;getUser&lt;/span&gt;(userId&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;String&lt;/span&gt;)&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;Flow&lt;/span&gt;&amp;lt;&lt;span class=&quot;tok-type&quot;&gt;Result&lt;/span&gt;&amp;lt;&lt;span class=&quot;tok-type&quot;&gt;User&lt;/span&gt;&amp;gt;&amp;gt; =
        users&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;map { list -&amp;gt;
            list&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;find { it&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;id == userId }
                ?&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;let { &lt;span class=&quot;tok-type&quot;&gt;Result&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;success&lt;/span&gt;(it) }
                ?&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;Result&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;failure&lt;/span&gt;(&lt;span class=&quot;tok-function&quot;&gt;NoSuchElementException&lt;/span&gt;(&lt;span class=&quot;tok-string&quot;&gt;&amp;quot;No user: $userId&amp;quot;&lt;/span&gt;))
        }

    &lt;span class=&quot;tok-keyword&quot;&gt;override&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;suspend&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;fun&lt;/span&gt; &lt;span class=&quot;tok-function&quot;&gt;saveUser&lt;/span&gt;(user&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;User&lt;/span&gt;) {
        users&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;update { current -&amp;gt; current&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;filterNot { it&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;id == user&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;id } + user }
    }
}&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;데이터는 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;MutableStateFlow&lt;/code&gt;에&lt;/span&gt; 담긴 리스트예요. 데이터베이스나 네트워크 없이 메모리에서만 동작해요. &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;saveUser&lt;/code&gt;로&lt;/span&gt; 넣은 사용자를 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;getUser&lt;/code&gt;가&lt;/span&gt; 돌려줘요.&lt;/p&gt;&lt;h3 id=&quot;테스트-작성&quot;&gt;테스트 작성&lt;/h3&gt;&lt;p&gt;Flow로 나오는 상태는 Turbine으로 확인해요. &lt;code&gt;test {}&lt;/code&gt; 안에서 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;awaitItem()&lt;/code&gt;을&lt;/span&gt; 부르면 값이 나온 순서대로 하나씩 받아요. Turbine은 별도 라이브러리라 의존성을 추가해야 해요. Mockito는 1절과 4절의 예시에만 필요해요.&lt;/p&gt;&lt;div class=&quot;code-block&quot;&gt;&lt;pre translate=&quot;no&quot; tabindex=&quot;0&quot; role=&quot;group&quot; aria-label=&quot;kotlin 코드&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;dependencies {
    &lt;span class=&quot;tok-function&quot;&gt;testImplementation&lt;/span&gt;(&lt;span class=&quot;tok-string&quot;&gt;&amp;quot;org.jetbrains.kotlinx:kotlinx-coroutines-test:1.11.0&amp;quot;&lt;/span&gt;)
    &lt;span class=&quot;tok-function&quot;&gt;testImplementation&lt;/span&gt;(&lt;span class=&quot;tok-string&quot;&gt;&amp;quot;app.cash.turbine:turbine:1.2.1&amp;quot;&lt;/span&gt;)
    &lt;span class=&quot;tok-function&quot;&gt;testImplementation&lt;/span&gt;(&lt;span class=&quot;tok-string&quot;&gt;&amp;quot;org.mockito:mockito-core:5.24.0&amp;quot;&lt;/span&gt;)
}&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;div class=&quot;code-block&quot;&gt;&lt;pre translate=&quot;no&quot; tabindex=&quot;0&quot; role=&quot;group&quot; aria-label=&quot;kotlin 코드&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;tok-keyword&quot;&gt;class&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;UserViewModelFakeTest&lt;/span&gt; {
    &lt;span class=&quot;tok-annotation&quot;&gt;@get&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;tok-type&quot;&gt;Rule&lt;/span&gt;
    &lt;span class=&quot;tok-keyword&quot;&gt;val&lt;/span&gt; mainDispatcherRule = &lt;span class=&quot;tok-function&quot;&gt;MainDispatcherRule&lt;/span&gt;()

    &lt;span class=&quot;tok-annotation&quot;&gt;@Test&lt;/span&gt;
    &lt;span class=&quot;tok-keyword&quot;&gt;fun&lt;/span&gt; &lt;span class=&quot;tok-function&quot;&gt;loadUser_whenUserExists_showsUser&lt;/span&gt;() = runTest {
        &lt;span class=&quot;tok-keyword&quot;&gt;val&lt;/span&gt; repository = &lt;span class=&quot;tok-function&quot;&gt;FakeUserRepository&lt;/span&gt;()
        repository&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;saveUser&lt;/span&gt;(&lt;span class=&quot;tok-function&quot;&gt;User&lt;/span&gt;(id = &lt;span class=&quot;tok-string&quot;&gt;&amp;quot;user_1&amp;quot;&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt; name = &lt;span class=&quot;tok-string&quot;&gt;&amp;quot;Mingyu&amp;quot;&lt;/span&gt;))
        &lt;span class=&quot;tok-keyword&quot;&gt;val&lt;/span&gt; viewModel = &lt;span class=&quot;tok-function&quot;&gt;UserViewModel&lt;/span&gt;(repository)

        viewModel&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;uiState&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;test {
            &lt;span class=&quot;tok-function&quot;&gt;assertEquals&lt;/span&gt;(&lt;span class=&quot;tok-type&quot;&gt;UiState&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-type&quot;&gt;Loading&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt; &lt;span class=&quot;tok-function&quot;&gt;awaitItem&lt;/span&gt;())

            viewModel&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;loadUser&lt;/span&gt;(&lt;span class=&quot;tok-string&quot;&gt;&amp;quot;user_1&amp;quot;&lt;/span&gt;)

            &lt;span class=&quot;tok-keyword&quot;&gt;val&lt;/span&gt; state = &lt;span class=&quot;tok-function&quot;&gt;awaitItem&lt;/span&gt;() &lt;span class=&quot;tok-keyword&quot;&gt;as&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;UiState&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-type&quot;&gt;Success&lt;/span&gt;
            &lt;span class=&quot;tok-function&quot;&gt;assertEquals&lt;/span&gt;(&lt;span class=&quot;tok-string&quot;&gt;&amp;quot;Mingyu&amp;quot;&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt; state&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-keyword&quot;&gt;data&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;name)
        }
    }
}&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;when&lt;/code&gt;도&lt;/span&gt; &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;verify&lt;/code&gt;도&lt;/span&gt; 없어요. 저장해 둔 사용자가 화면 상태로 나오는지만 확인해요. 없는 사용자를 찾으면 에러 상태가 되는지도 같은 방식으로 확인해요. 첫 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;awaitItem()&lt;/code&gt;이&lt;/span&gt; &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;Loading&lt;/code&gt;인&lt;/span&gt; 이유는 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;StateFlow&lt;/code&gt;가&lt;/span&gt; 새 구독자에게 현재 값을 바로 보내기 때문이에요. &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;runTest&lt;/code&gt;는&lt;/span&gt; 5절에서 설명해요.&lt;/p&gt;&lt;p&gt;1절처럼 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;ViewModel&lt;/code&gt;을&lt;/span&gt; &lt;code&gt;stateIn&lt;/code&gt; 형태로 바꿔도 이 테스트는 그대로 통과해요. Turbine의 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;test {}&lt;/code&gt;가&lt;/span&gt; &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;uiState&lt;/code&gt;를&lt;/span&gt; 구독하고, 호출 대신 상태를 확인하기 때문이에요.&lt;/p&gt;&lt;h2 id=&quot;4-stub-대신-fake를-쓰는-이유&quot;&gt;4. Stub 대신 Fake를 쓰는 이유&lt;/h2&gt;&lt;p&gt;3절의 테스트가 리팩터링을 버틴 이유는 Fake 자체보다 상태를 확인했다는 데 있어요. 1절의 Mock 테스트에서 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;verify&lt;/code&gt;를&lt;/span&gt; 빼고 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;getUser&lt;/code&gt;의&lt;/span&gt; 반환값만 정해 둔 Stub으로 넘긴 뒤, 3절처럼 Turbine으로 상태를 확인해도 &lt;code&gt;stateIn&lt;/code&gt; 버전에서 통과해요.&lt;/p&gt;&lt;p&gt;그래도 저는 Stub보다 Fake를 쓰는 편이 낫다고 생각해요.&lt;/p&gt;&lt;ol&gt;&lt;li&gt;&lt;strong&gt;프레임워크가 필요 없음&lt;/strong&gt;: Fake는 평범한 Kotlin 클래스예요. 공식 문서도 단순하다는 이유로 Stub보다 Fake를 권해요.&lt;/li&gt;&lt;li&gt;&lt;strong&gt;저장과 조회가 맞물림&lt;/strong&gt;: Stub은 호출마다 돌려줄 값을 하나씩 정해야 해요. Fake는 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;saveUser&lt;/code&gt;로&lt;/span&gt; 넣은 사용자를 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;getUser&lt;/code&gt;가&lt;/span&gt; 돌려주니, 테스트를 저장하고 불러오는 흐름 그대로 쓸 수 있어요.&lt;/li&gt;&lt;/ol&gt;&lt;p&gt;다만 Fake의 로직은 테스트용으로 단순하게 만든 것이라 실제 &lt;code&gt;UserRepository&lt;/code&gt; 구현까지 검증하지는 않아요. 실제 구현은 그 구현의 테스트에서 따로 확인해야 해요.&lt;/p&gt;&lt;h2 id=&quot;5-코루틴-테스트&quot;&gt;5. 코루틴 테스트&lt;/h2&gt;&lt;p&gt;코루틴을 쓰는 코드는 비동기로 여러 스레드에서 돌 수 있어서, kotlinx-coroutines-test의 도구로 실행 시점을 제어해요.&lt;/p&gt;&lt;h3 id=&quot;runtest&quot;&gt;&lt;code&gt;runTest&lt;/code&gt;&lt;/h3&gt;&lt;p&gt;&lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;runTest&lt;/code&gt;는&lt;/span&gt; 테스트용 코루틴 빌더예요. &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;runBlocking&lt;/code&gt;과&lt;/span&gt; 달리 가상 시간을 써서 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;delay()&lt;/code&gt;를&lt;/span&gt; 실제로 기다리지 않고 건너뛰어요. &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;delay(1_000L)&lt;/code&gt;을&lt;/span&gt; 부르는 함수를 &lt;code&gt;runTest&lt;/code&gt; 안에서 실행하면 바로 끝나고, 가상 시간을 나타내는 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;currentTime&lt;/code&gt;은&lt;/span&gt; 1,000을 가리켜요.&lt;/p&gt;&lt;h3 id=&quot;두-가지-testdispatcher&quot;&gt;두 가지 &lt;code&gt;TestDispatcher&lt;/code&gt;&lt;/h3&gt;&lt;p&gt;테스트 안에서 새 코루틴이 언제 실행될지는 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;TestDispatcher&lt;/code&gt;가&lt;/span&gt; 정해요. 두 가지가 있어요.&lt;/p&gt;&lt;p&gt;&lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;StandardTestDispatcher&lt;/code&gt;는&lt;/span&gt; &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;runTest&lt;/code&gt;의&lt;/span&gt; 기본값이에요. 새 코루틴을 스케줄러의 대기열에 넣어 두고 테스트 스레드가 양보할 때 실행해요. &lt;code&gt;advanceUntilIdle()&lt;/code&gt;, &lt;code&gt;advanceTimeBy()&lt;/code&gt;, &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;runCurrent()&lt;/code&gt;를&lt;/span&gt; 부르거나 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;join()&lt;/code&gt;으로&lt;/span&gt; 기다리면 양보하게 돼요. 끝까지 양보하지 않으면 새 코루틴은 테스트 본문이 끝난 뒤, &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;runTest&lt;/code&gt;가&lt;/span&gt; 반환되기 전에야 실행돼요.&lt;/p&gt;&lt;p&gt;&lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;UnconfinedTestDispatcher&lt;/code&gt;는&lt;/span&gt; 새 코루틴을 바로 시작해요. 다만 끝까지 바로 실행하지는 않아요. 코루틴이 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;delay&lt;/code&gt;처럼&lt;/span&gt; 중단되는 지점을 만나면 그 뒤는 다른 코루틴과 마찬가지로 스케줄러에서 차례를 기다려요. 공식 문서는 간단한 테스트에는 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;UnconfinedTestDispatcher&lt;/code&gt;가&lt;/span&gt; 편하다고 해요. 다만 실제 디스패처와 동작이 달라서 동시성을 검증하는 테스트에는 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;StandardTestDispatcher&lt;/code&gt;를&lt;/span&gt; 쓰라고 해요.&lt;/p&gt;&lt;h3 id=&quot;디스패처를-주입받기&quot;&gt;디스패처를 주입받기&lt;/h3&gt;&lt;p&gt;프로덕션 코드에서 &lt;code&gt;withContext(Dispatchers.IO)&lt;/code&gt;처럼 디스패처를 직접 쓰면 테스트에서 바꿀 수 없어요. 생성자로 디스패처를 받게 하면 테스트에서 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;TestDispatcher&lt;/code&gt;를&lt;/span&gt; 넘길 수 있어요. 기본값을 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;Dispatchers.IO&lt;/code&gt;로&lt;/span&gt; 두면 프로덕션 코드에서는 따로 넘기지 않아도 돼요.&lt;/p&gt;&lt;div class=&quot;code-block&quot;&gt;&lt;pre translate=&quot;no&quot; tabindex=&quot;0&quot; role=&quot;group&quot; aria-label=&quot;kotlin 코드&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;tok-keyword&quot;&gt;class&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;UserFileStore&lt;/span&gt;(
    &lt;span class=&quot;tok-keyword&quot;&gt;private&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;val&lt;/span&gt; file&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;File&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt;
    &lt;span class=&quot;tok-keyword&quot;&gt;private&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;val&lt;/span&gt; ioDispatcher&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;CoroutineDispatcher&lt;/span&gt; = &lt;span class=&quot;tok-type&quot;&gt;Dispatchers&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-type&quot;&gt;IO&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt;
) {
    &lt;span class=&quot;tok-keyword&quot;&gt;suspend&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;fun&lt;/span&gt; &lt;span class=&quot;tok-function&quot;&gt;readName&lt;/span&gt;()&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;String&lt;/span&gt; = &lt;span class=&quot;tok-function&quot;&gt;withContext&lt;/span&gt;(ioDispatcher) {
        file&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;readText&lt;/span&gt;()
    }
}&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;테스트에서는 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;StandardTestDispatcher&lt;/code&gt;를&lt;/span&gt; 만들어 넘기는데, 이때 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;runTest&lt;/code&gt;의&lt;/span&gt; &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;testScheduler&lt;/code&gt;를&lt;/span&gt; 같이 넘겨요. 공식 문서는 한 테스트에서 쓰는 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;TestDispatcher&lt;/code&gt;가&lt;/span&gt; 모두 스케줄러 하나를 같이 써야 한다고 해요.&lt;/p&gt;&lt;p&gt;이렇게 주입하면 &lt;code&gt;withContext&lt;/code&gt; 안의 코드도 테스트 스레드에서 돌고, 그 안에 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;delay&lt;/code&gt;가&lt;/span&gt; 있으면 가상 시간으로 건너뛰어요. &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;Dispatchers.IO&lt;/code&gt;를&lt;/span&gt; 그대로 쓰면 다른 스레드에서 돌고 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;delay&lt;/code&gt;도&lt;/span&gt; 실제로 기다려요.&lt;/p&gt;&lt;h3 id=&quot;dispatchersmain-바꾸기&quot;&gt;&lt;code&gt;Dispatchers.Main&lt;/code&gt; 바꾸기&lt;/h3&gt;&lt;p&gt;로컬 테스트는 개발 PC의 JVM에서 실행돼요. 그래서 Android UI 스레드를 감싼 &lt;code&gt;Main&lt;/code&gt; 디스패처가 없어요. 공식 문서는 테스트할 코드가 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;Main&lt;/code&gt;을&lt;/span&gt; 쓰면 예외가 난다고 해요. kotlinx-coroutines-test가 있는 로컬 테스트에서는 &lt;code&gt;setMain&lt;/code&gt; 없이 &lt;code&gt;Dispatchers.Main.immediate&lt;/code&gt;를 읽으면 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;IllegalStateException&lt;/code&gt;이&lt;/span&gt; 나요.&lt;/p&gt;&lt;p&gt;&lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;viewModelScope&lt;/code&gt;는&lt;/span&gt; 조금 달라요. lifecycle 2.11.0의 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;viewModelScope&lt;/code&gt;는&lt;/span&gt; &lt;code&gt;Dispatchers.Main.immediate&lt;/code&gt;를 읽다가 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;IllegalStateException&lt;/code&gt;이&lt;/span&gt; 나면 예외를 내지 않고 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;EmptyCoroutineContext&lt;/code&gt;로&lt;/span&gt; 대신해요. 규칙 없이 1절의 첫 번째 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;UserViewModel&lt;/code&gt;을&lt;/span&gt; 테스트하면 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;loadUser&lt;/code&gt;의&lt;/span&gt; 코루틴이 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;Dispatchers.Default&lt;/code&gt;의&lt;/span&gt; 스레드에서 돌아요. &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;loadUser&lt;/code&gt;를&lt;/span&gt; 부른 직후의 상태는 대개 아직 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;Loading&lt;/code&gt;이고&lt;/span&gt;, 언제 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;Success&lt;/code&gt;로&lt;/span&gt; 바뀌는지는 스레드 타이밍에 달려 있어요. 이래서는 믿을 수 있는 테스트가 되지 않아요.&lt;/p&gt;&lt;p&gt;로컬 테스트에서는 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;Dispatchers.Main&lt;/code&gt;을&lt;/span&gt; &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;TestDispatcher&lt;/code&gt;로&lt;/span&gt; 바꿔요. 테스트마다 직접 바꾸는 대신 JUnit 규칙으로 만들어 두고 쓰는 방식을 흔히 써요. 아래 코드는 공식 문서와 Now in Android의 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;MainDispatcherRule&lt;/code&gt;과&lt;/span&gt; 같은 형태이고, JUnit 4의 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;TestWatcher&lt;/code&gt;를&lt;/span&gt; 써요.&lt;/p&gt;&lt;div class=&quot;code-block&quot;&gt;&lt;pre translate=&quot;no&quot; tabindex=&quot;0&quot; role=&quot;group&quot; aria-label=&quot;kotlin 코드&quot; data-language=&quot;kotlin&quot;&gt;&lt;code&gt;&lt;span class=&quot;tok-annotation&quot;&gt;@OptIn&lt;/span&gt;(&lt;span class=&quot;tok-type&quot;&gt;ExperimentalCoroutinesApi&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;::&lt;/span&gt;&lt;span class=&quot;tok-keyword&quot;&gt;class&lt;/span&gt;)
&lt;span class=&quot;tok-keyword&quot;&gt;class&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;MainDispatcherRule&lt;/span&gt;(
    &lt;span class=&quot;tok-keyword&quot;&gt;val&lt;/span&gt; testDispatcher&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;TestDispatcher&lt;/span&gt; = &lt;span class=&quot;tok-function&quot;&gt;UnconfinedTestDispatcher&lt;/span&gt;()&lt;span class=&quot;tok-punctuation&quot;&gt;,&lt;/span&gt;
) &lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-function&quot;&gt;TestWatcher&lt;/span&gt;() {
    &lt;span class=&quot;tok-keyword&quot;&gt;override&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;fun&lt;/span&gt; &lt;span class=&quot;tok-function&quot;&gt;starting&lt;/span&gt;(description&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;Description&lt;/span&gt;) {
        &lt;span class=&quot;tok-type&quot;&gt;Dispatchers&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;setMain&lt;/span&gt;(testDispatcher)
    }

    &lt;span class=&quot;tok-keyword&quot;&gt;override&lt;/span&gt; &lt;span class=&quot;tok-keyword&quot;&gt;fun&lt;/span&gt; &lt;span class=&quot;tok-function&quot;&gt;finished&lt;/span&gt;(description&lt;span class=&quot;tok-punctuation&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;tok-type&quot;&gt;Description&lt;/span&gt;) {
        &lt;span class=&quot;tok-type&quot;&gt;Dispatchers&lt;/span&gt;&lt;span class=&quot;tok-punctuation&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;tok-function&quot;&gt;resetMain&lt;/span&gt;()
    }
}&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;테스트 클래스에서는 &lt;code&gt;@get:Rule val mainDispatcherRule = MainDispatcherRule()&lt;/code&gt; 한 줄이면 돼요. 1절과 3절의 테스트가 이렇게 썼어요.&lt;/p&gt;&lt;p&gt;&lt;code&gt;setMain&lt;/code&gt;, &lt;code&gt;resetMain&lt;/code&gt;, &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;UnconfinedTestDispatcher&lt;/code&gt;는&lt;/span&gt; kotlinx-coroutines-test 1.11.0에서도 &lt;code&gt;@ExperimentalCoroutinesApi&lt;/code&gt;라서 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;@OptIn&lt;/code&gt;을&lt;/span&gt; 붙였어요.&lt;/p&gt;&lt;p&gt;이 규칙은 로컬 테스트에서만 써요. 실제 UI 스레드가 있는 계측 테스트에서는 &lt;code&gt;Main&lt;/code&gt; 디스패처를 바꾸지 않아요.&lt;/p&gt;&lt;h2 id=&quot;마무리&quot;&gt;마무리&lt;/h2&gt;&lt;p&gt;저는 테스트가 확인할 것은 사용자가 보게 될 상태라고 생각해요. 그래서 직접 만든 Repository처럼 인터페이스로 받는 의존성은 Fake로, 라이브러리나 프레임워크의 타입은 그 라이브러리가 공식으로 제공하는 테스트 도구로 테스트하기를 권해요.&lt;/p&gt;&lt;h2 id=&quot;참고&quot;&gt;참고&lt;/h2&gt;&lt;ul&gt;&lt;li&gt;&lt;a href=&quot;https://developer.android.com/training/testing/fundamentals/test-doubles&quot; rel=&quot;noopener&quot;&gt;Android에서 테스트 더블 사용&lt;/a&gt;: 테스트 더블의 종류와 Fake를 권하는 이유&lt;/li&gt;&lt;li&gt;&lt;a href=&quot;https://developer.android.com/training/testing/fundamentals&quot; rel=&quot;noopener&quot;&gt;앱 테스트의 기본사항&lt;/a&gt;: 테스트하기 쉬운 구조, 범위와 실행 위치에 따른 테스트 분류&lt;/li&gt;&lt;li&gt;&lt;a href=&quot;https://developer.android.com/kotlin/coroutines/test&quot; rel=&quot;noopener&quot;&gt;Android에서 Kotlin 코루틴 테스트&lt;/a&gt;: &lt;code&gt;runTest&lt;/code&gt;, &lt;code&gt;TestDispatcher&lt;/code&gt;, &lt;code&gt;Dispatchers.Main&lt;/code&gt; 교체&lt;/li&gt;&lt;li&gt;&lt;a href=&quot;https://github.com/cashapp/turbine&quot; rel=&quot;noopener&quot;&gt;Turbine&lt;/a&gt;&lt;/li&gt;&lt;li&gt;&lt;a href=&quot;https://github.com/android/nowinandroid/wiki/Testing-strategy-and-how-to-test&quot; rel=&quot;noopener&quot;&gt;Now in Android 테스트 전략&lt;/a&gt;&lt;/li&gt;&lt;li&gt;&lt;a href=&quot;https://github.com/android/nowinandroid/blob/main/core/testing/src/main/kotlin/com/google/samples/apps/nowinandroid/core/testing/util/MainDispatcherRule.kt&quot; rel=&quot;noopener&quot;&gt;Now in Android &lt;code&gt;MainDispatcherRule&lt;/code&gt;&lt;/a&gt;&lt;/li&gt;&lt;li&gt;&lt;a href=&quot;https://github.com/androidx/androidx/blob/androidx-main/lifecycle/lifecycle-viewmodel/src/commonMain/kotlin/androidx/lifecycle/viewmodel/internal/CloseableCoroutineScope.kt&quot; rel=&quot;noopener&quot;&gt;lifecycle &lt;code&gt;createViewModelScope&lt;/code&gt; 소스&lt;/a&gt;: &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;Dispatchers.Main&lt;/code&gt;이&lt;/span&gt; 없을 때 &lt;span class=&quot;nobr&quot;&gt;&lt;code&gt;EmptyCoroutineContext&lt;/code&gt;로&lt;/span&gt; 대신하는 코드&lt;/li&gt;&lt;li&gt;&lt;a href=&quot;https://github.com/M1n9yu23/LifeLog-Compose-Clean-Architecture&quot; rel=&quot;noopener&quot;&gt;LifeLog&lt;/a&gt;: 단위 테스트와 통합 테스트를 넣은 제 메모 앱&lt;/li&gt;&lt;li&gt;&lt;a href=&quot;https://github.com/M1n9yu23/android-test-code&quot; rel=&quot;noopener&quot;&gt;android-test-code&lt;/a&gt;: 단위, 통합, UI 테스트를 모은 제 예제 프로젝트&lt;/li&gt;&lt;/ul&gt;&lt;/div&gt;</content>
  </entry>
</feed>
