Share
Embed
NAVER Map in Jetpack Compose
11/19 (토) DevFest 2022 - GDG Songdo, Incheon & GDSC Inha, TUKorea 행사에서 발표한 자료입니다.
https://festa.io/events/2758
아래 오픈소스 라이브러리에 대한 내용입니다.
https://github.com/fornewid/naver-map-compose
Sungyong An
November 19, 2022
Transcript
126 slides
-
Songdo, Incheon NAVER Map in Jetpack Compose Sungyong An
Android GDE, NAVER WEBTOON -
Sungyong An NAVER WEBTOON Android GDE @fornewid Link: h tt
ps://github.com/fornewid -
Sungyong An NAVER WEBTOON Android GDE @fornewid Link: h tt
ps://github.com/fornewid Slide Template ठۄ٘ ೞױী ݂о णפ. -
Code Template View Compose ஏ ࢚ױী যڃ ٘ੋ ইਸ दפ.
Compose ٘݅ ઝஏী ֣࢝ ߄ܳ दפ. -
Link: h tt ps://developer.android.com/develop/ui/views/layout/declaring-layout <?xml version="1.0" encoding="utf-8"?> <LinearLayout android:layout_width="match_parent" android:layout_height="match_parent"
android:orientation="vertical" > <TextView android:id="@+id/text" android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="Hello, I am a TextView" /> <Button android:id="@+id/button" android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="Hello, I am a Button" /> </LinearLayout> View System അসীࢲח View Systemਵ۽ ѐߊೞח Ѫ ࣼೡ Ѫ эणפ. উ٘۽٘ ѐߊਸ ೡ ٸب ࠁా Layout XMLࠗఠ दೞભ. -
Link: h tt ps://developer.android.com/jetpack/compose Jetpack Compose (Modern Android Development )
ਃ્ীח Jetpack Composeо ݆ ࣗѐغҊ ҳਃ. ࢜۽ ࣗध ߈ Composeੌ ب۽ ҙबਸ ߉Ҋ णפ. -
Link: h tt ps://developer.android.com/jetpack/compose/interop/migration-strategy Migrate from View to Compose 🤔
Ӓ۞ࠁפ ݆ ٜ࠙ Viewܳ Compose۽ ജೞҊ Ѣա, ജਸ Ҋ۰ೞҊ ਸѢۄ ࢤпפ. -
Toy Project Link: h tt ps://github.com/Moop-App/Moop-Android য়ט അসীࢲ ਊೠ ղਊ
ইפҊ, ష ۽ંী ೠ ղਊੑפ. -
Link: h tt ps://github.com/navermaps/android-map-sdk Official SDK based on View 🤔
֎ߡب SDKח View Systemਵ۽ ҳഅغয णפ. Ӓېࢲ Ѧ ஹನૉীࢲ যڌѱ ॶ ࣻ ਸ Ҋ೮ભ. -
How to use in Jetpack Compose? -(1) ݽٚ ٘ܳ Compose۽
द ࢿೠ -(2) ೨ब ٘ܳ ܻ࠙ೞৈ Composeীࢲ ഝਊೠ -(3) ࢚ഐ ਊࢿ APIܳ ࢎਊೞৈ ӝઓ ٘ܳ ېೝೠ ݢ ݽٚ ٘ܳ Compose۽ ৮ ࢜۽ ҳഅೞח ߑߨ णפ. ਵ۽ ೨ब ٘ܳ ܻ࠙ೞৈ, ੌࠗ࠙ ࠗ࠙݅ Compose۽ ࢿೞח ߑߨ णפ. ݄݃ਵ۽ ࢚ഐਊࢿ APIܳ ਊೞৈ, ӝઓ ٘ܳ ېೝೞח ߑߨب णפ. -
How to use in Jetpack Compose? -(1) ݽٚ ٘ܳ Compose۽
द ࢿೠ (X) -(2) ೨ब ٘ܳ ܻ࠙ೞৈ Composeীࢲ ഝਊೠ (X) -(3) ࢚ഐ ਊࢿ APIܳ ࢎਊೞৈ ӝઓ ٘ܳ ېೝೠ ✅ NAVER Map SDK != Open Source Project ইऔѱب ֎ߡب SDKח য়ࣗझо ইפۄࢲ ࣻೡ ߑߨ হणפ. Ӓېࢲ ݄݃ ߑߨੋ ӝઓ ٘ܳ ېೝೞח ߑधਵ۽ ೯೮णפ. -
Link: h tt ps://github.com/Moop-App/Moop-Android/pull/120 (1) Migrate using Compose API ীח
Compose APIܳ ਊ೧ࢲ ష ۽ંী ࢤ۽ ٸ۰߅ח(?) সਸ ೮णפ. -
Link: h tt ps://github.com/fornewid/naver-map-compose (2) For Jetpack Compose Unofficial wrapper
library Ӓ ীח ખ ؊ ҕਊചػ ਬૉாझী ݏ Compose wrapper ۄ࠳۞ܻܳ ٜ݅णפ. -
Toy Project UseCase ҳഅೞӝ Link: h tt ps://github.com/Moop-App/Moop-Android/pull/120 ݢ ష
۽ંী ҳഅೠ 5о ਬૉாझܳ ಝࠁѷणפ. -
MapView class MapViewActivity : AppCompatActivity() { private var mapView: MapView?
= null override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_map_view) mapView = findViewById(R.id.map_view) } } Activityীࢲ ࢸ೧ݶ ؾפ -
MapView class MapComposeActivity : ComponentActivity() { override fun onCreate(savedInstanceState: Bundle?)
{ super.onCreate(savedInstanceState) setContent { ... } } } Link: h tt ps://developer.android.com/jetpack/compose/interop/interop-apis#compose-in-views Composeীࢲח Layout XML न setContentী Composableਸ ׳ೞݶ ؾפ -
MapView val context = LocalContext.current AndroidView(factory = { context ->
MapView(context) }) Link: h tt ps://developer.android.com/jetpack/compose/interop/interop-apis#views-in-compose ۧѱ AndroidViewۄח APIо ઁҕغҊ যࢲ factoryীࢲ MapViewܳ ࢤࢿೞݶ ؾפ -
MapView Lifecycle override fun onCreate(...) { super.onCreate(...) mapView?.onCreate(...) } override
fun onStart() { super.onStart() mapView?.onStart() } override fun onResume() { super.onResume() mapView?.onResume() } override fun onPause() { super.onPause() mapView?.onPause() } override fun onStop() { super.onStop() mapView?.onStop() } override fun onDestroy() { super.onDestroy() mapView?.onDestroy() } 🤔 View Systemীࢲח ۠ ഋక۽ ഐೞҊ ਸ ѩפ -
MapView Lifecycle val context = LocalContext.current AndroidView(factory = { context
-> MapView(context) }) द ٘۽ جইоࠁѷणפ -
MapView Lifecycle val context = LocalContext.current val mapView = remember
{ MapView(context) } AndroidView(factory = { mapView }) Link: h tt ps://developer.android.com/jetpack/compose/pe rf ormance/bestpractices#use-remember MapView ೣࣻܳ ഐ೧ঠ ೞפө, ݢ remember ೣࣻܳ ਊ೧ࢲ MapViewܳ ܻ࠙೧յ ѩפ -
Link: h tt ps://developer.android.com/jetpack/compose/lifecycle remember Recompositionীࢲ ࢚కܳ ਬೠ. рр
ۧѱ Compose APIܳ ࢸݺೞח ठۄ٘о णפ -
MapView Lifecycle val context = LocalContext.current val mapView = remember(context){
MapView(context) } // (X) AndroidView(factory = { mapView }) Link: h tt ps://developer.android.com/jetpack/compose/pe rf ormance/bestpractices#use-remember ٸ remember ೣࣻী keyܳ ֍ਵݶ, keyо ߸҃ؼ ٸ݃ MapViewܳ द ࢤࢿೞ۽ ೧ঠ פ -
MapView Lifecycle val context = LocalContext.current val mapView = remember
{ MapView(context) } AndroidView(factory = { mapView }) Link: h tt ps://developer.android.com/jetpack/compose/pe rf ormance/bestpractices#use-remember ৈӝࢲח MapViewо Compositionীࢲ݅ ೠߣ ࢤࢿغب۾ keyܳ ֍ ঋणפ -
MapView Lifecycle val mapView = rememberMapViewWithLifecycle() AndroidView(factory = { mapView
}) @Composable fun rememberMapViewWithLifecycle(): MapView { val context = LocalContext.current val mapView = remember { MapView(context) } ... return mapView } MapViewܳ ܻ࠙೮ਵפ, ઁח Lifecycleਸ ܻ೧ࠅөਃ? -
MapView Lifecycle private fun getMapLifecycleObserver( mapView: MapView, savedInstanceState: Bundle? )
= LifecycleEventObserver { _, event -> when (event) { Lifecycle.Event.ON_CREATE -> mapView.onCreate(savedInstanceState) Lifecycle.Event.ON_START -> mapView.onStart() Lifecycle.Event.ON_RESUME -> mapView.onResume() Lifecycle.Event.ON_PAUSE -> mapView.onPause() Lifecycle.Event.ON_STOP -> mapView.onStop() Lifecycle.Event.ON_DESTROY -> mapView.onDestroy() else -> throw IllegalStateException() } } LifecycleEventObserverܳ ਊ೧ࢲ пп ߮݃ MapView ೣࣻܳ ഐ೧સפ -
MapView Lifecycle fun rememberMapViewWithLifecycle(): MapView { ... val lifecycle =
LocalLifecycleOwner.current.lifecycle DisposableEffect(lifecycle, mapView) { val lifecycleObserver = getMapLifecycleObserver(mapView, null) lifecycle.addObserver(lifecycleObserver) onDispose { lifecycle.removeObserver(lifecycleObserver) } } return mapView } ӒܻҊ Observerܳ Lifecycleী োѾ/೧ઁ೧ח ٘ܳ ࢿೞݶ ؾפ -
MapView Lifecycle fun rememberMapViewWithLifecycle(): MapView { ... val lifecycle =
LocalLifecycleOwner.current.lifecycle DisposableEffect(lifecycle, mapView) { val lifecycleObserver = getMapLifecycleObserver(mapView, null) lifecycle.addObserver(lifecycleObserver) onDispose { lifecycle.removeObserver(lifecycleObserver) } } return mapView } Link: h tt ps://developer.android.com/jetpack/compose/side-e ff ects#disposablee ff ect ٸ, DisposableEffect৬ onDisposeۄח Ѫਸ ਊ೧ࢲ Observer োѾҗ ೧ઁ दਸ ೧ݶ غחؘਃ -
Compositionਸ ઙܐೠ റ, ܻ೧ঠ ೡ ٸ ࢎਊೠ. Source: h tt
ps://medium.com/mobile-app-development-publication/a4867f876928 DisposableEffect -
ഐ೧ঠ ೞח Lifecycle ೣࣻо ই թই. Lifecycle Link: h tt
ps://navermaps.github.io/android-map-sdk/guide-ko/2-1.html -
SavedInstanceState class MapViewActivity : AppCompatActivity() { override fun onCreate(savedInstanceState: Bundle?)
{ ... mapView?.onCreate(savedInstanceState) } override fun onSaveInstanceState(outState: Bundle) { super.onSaveInstanceState(outState) mapView?.onSaveInstanceState(outState) } } View Systemীࢲח onCreate৬ onSaveInstanceStateীࢲ ೣࣻܳ ഐ೧ݶ غҳਃ -
SavedInstanceState val savedInstanceState = rememberSavedInstanceState() val mapView = rememberMapViewWithLifecycle(savedInstanceState) AndroidView(factory
= { mapView }) @Composable fun rememberSavedInstanceState(): Bundle { return rememberSaveable { Bundle() } // Survives config changes } Composeীࢲח Bundleਸ ҙܻೞח ߑߨਸ ࢎਊೡ ࣻ যਃ ٸ, Bundleਸ rememberSaveable۽ פ -
Recomposition, Configuration Changesীࢲ ࢚కܳ ਬೠ. Link: h tt ps://developer.android.com/jetpack/compose/state#restore-ui-state
rememberSaveable Configuration Changes -
SavedInstanceState @Composable fun rememberMapViewWithLifecycle(savedInstanceState: Bundle): MapView { ... DisposableEffect(lifecycle, mapView,
savedInstanceState) { val lifecycleObserver = getMapLifecycleObserver( mapView, savedInstanceState.takeUnless { it.isEmpty } ) onDispose { ... mapView.onSaveInstanceState(savedInstanceState) } } return mapView } Ӓېࢲ ҙܻೞח Bundle ёܳ ׳೧ݶ ৮ܐؾפ -
SavedInstanceState private fun getMapLifecycleObserver( mapView: MapView, savedInstanceState: Bundle? ) =
LifecycleEventObserver { _, event -> when (event) { Lifecycle.Event.ON_CREATE -> mapView.onCreate(savedInstanceState) ... } } LifecycleEventObserverীࢲب োѾ೧ݶ غѷભ -
onLowMemory override fun onLowMemory() { super.onLowMemory() mapView?.onLowMemory() } ݄݃ਵ۽ onLowMemory
ੑפ Viewীࢲח ೣࣻо ઁҕغҊ যࢲ рױೠؘਃ -
onLowMemory fun MapView.componentCallbacks(): ComponentCallbacks { return object : ComponentCallbacks {
override fun onConfigurationChanged(config: Configuration) {} override fun onLowMemory() { [email protected]() } } } Composeীࢲח LifecycleObserverۢ ComponentCallbacksܳ ٜ݅যࢲ ഐೞݶ ؾפ -
onLowMemory fun rememberMapViewWithLifecycle(): MapView { ... val lifecycle = LocalLifecycleOwner.current.lifecycle
DisposableEffect(lifecycle, mapView) { val callbacks = mapView.componentCallbacks() context.registerComponentCallbacks(callbacks) onDispose { context.unregisterComponentCallbacks(callbacks) } } return mapView } ١۾/೧ઁೞח ࠗ࠙ খࢶ җҗ زੌפ -
MapViewח View ೡ݅ਸ ೠ. APIܳ ഐೞ۰ݶ ੋఠಕझ ೡਸ ೞח NaverMap
ёо ਃೞ. OnMapReadyCallback Link: h tt ps://navermaps.github.io/android-map-sdk/guide-ko/2-1.html MapView۽ ب ࠁৈח স լ݅ খਵ۽ بܳ ஶ܀ೞח সٜ ਃפ -
OnMapReadyCallback private val callback = object : OnMapReadyCallback { override
fun onMapReady(naverMap: NaverMap) { ... } } mapView?.getMapAsync(callback) NaverMap ёܳ ਵ۰ݶ, OnMapReadyCallbackਸ ࢎਊೞৈ Callback ഋక۽ оઉয়ݶ ؾפ -
OnMapReadyCallback suspend fun MapView.awaitMap(): NaverMap { return suspendCoroutine { continuation
-> getMapAsync { continuation.resume(it) } } } val coroutineScope = rememberCoroutineScope() val mapView = rememberMapViewWithLifecycle(...) coroutineScope.launch { val naverMap: NaverMap = mapView.awaitMap() } Link: h tt ps://developer.android.com/jetpack/compose/side-e ff ects#remembercoroutinescope Composeীࢲח ܖ౯ਵ۽ оઉয়ח ೣࣻܳ ٜ݅ҳਃ ਃೡ ٸ CoroutineScopeܳ ࢤࢿ೧ NaverMap ёܳ оઉৢ ࣻ णפ -
Compositionਸ ઙܐೠ റ زਵ۽ ஂࣗغب۾ ߧਤо ػ ܖ౯ਸ प೯ೠ. Source:
h tt ps://medium.com/mobile-app-development-publication/a4867f876928 rememberCoroutineScope -
OnMapReadyCallback suspend fun MapView.awaitMap(): NaverMap { return suspendCoroutine { continuation
-> getMapAsync { continuation.resume(it) } } } val coroutineScope = rememberCoroutineScope() val mapView = rememberMapViewWithLifecycle(...) coroutineScope.launch { val naverMap: NaverMap = mapView.awaitMap() } ✅ ۧѱ NaverMap ёܳ оઉয়ח ؘө ޖࢎ ݃ଢ଼णפ -
ب ২࣌ mapView.getMapAsync { naverMap -> if (isDarkTheme) { naverMap.mapType
= NaverMap.MapType.Navi naverMap.isNightModeEnabled = true } else { naverMap.mapType = NaverMap.MapType.Basic naverMap.isNightModeEnabled = false } } ঠрݽ٘ա ب ఋੑ ١ਸ ߸҃ೞҊ रݶ, NaverMap ёীо mapType ١ਸ ࢸ೧ݶ ؾפ -
ب ২࣌ AndroidView(factory = { mapView.apply { coroutineScope.launch { val
naverMap = awaitMap() if (isDarkTheme) { naverMap.mapType = NaverMap.MapType.Navi naverMap.isNightModeEnabled = true } else { naverMap.mapType = NaverMap.MapType.Basic naverMap.isNightModeEnabled = false } } } }) Composeীࢲب Ѣ زੌೠ ٘ܳ Ӓ۽ ࢎਊೞݶ غѷणפ -
ب ࣘࢿ <com.naver.maps.map.MapView android:id="@+id/map_view" android:layout_width="match_parent" android:layout_height="match_parent" app:navermap_extent="31.43,122.37,44.35,132" app:navermap_locationButtonEnabled="true" app:navermap_scaleBarEnabled="false" app:navermap_minZoom="6"
app:navermap_zoom="12" /> ਵ۽ Layout XMLীࢲ ݻ о ӝࠄੋ ࣘࢿਸ ೡ ࣻ חؘਃ -
ب ࣘࢿ val context = LocalContext.current val mapView = remember
{ MapView(context, naverMapOptions()) } AndroidView(factory = { mapView }) private fun naverMapOptions() = NaverMapOptions() .extent(LatLngBounds.from(LatLng(31.43, 122.37),LatLng(44.35, 132.0))) .locationButtonEnabled(true) .scaleBarEnabled(false) .minZoom(6.0) .camera(CameraPosition(LatLng.INVALID, 12.0)) ۠ ٜࠗ࠙ب ٘۽ ೞҊ, MapView ࢤࢿী ׳ೞݶ ؾפ ل ࠺तೠ ٘о ٜ݅যભ? -
ب ߮ mapView.getMapAsync { naverMap -> naverMap.setOnMapClickListener { _, _
-> /* Do domething*/ } } NaverMapী Click Listenerܳ ١۾ೞח ٘ੑפ -
ب ߮ AndroidView(factory = { mapView.apply { coroutineScope.launch { val
naverMap = awaitMap() naverMap.setOnMapClickListener { _, _ -> /* Do domething*/ } } } }) Composeীࢲب زੌೠ ٘ܳ ࢿೞݶ ؾפ -
݃ழ val marker = Marker().apply { captionText = "caption" position
= LatLng(..., ...) icon = OverlayImage.fromResource(R.drawable.marker_icon) setOnClickListener { ... true } } Viewٚ Composeٚ ࢚ҙহ ݃ழܳ ۧѱ ࢤࢿפ -
Example: ӓ ݃ழ ҙܻೞӝ var markers = listOf<Marker>() fun render(theaters:
List<TheaterMarkerUiModel>) { markers.forEach { it.map = null } markers = theaters.map { theater -> Marker().apply { ... map = naverMap } } } ӓ ݾ۾ਸ ݃ழ۽ दೞח ઁ ٘ੑפ Markerী NaverMapਸ ࢸೞҊ, null۽ ೧ઁ೧ঠ פ -
Example: ӓ ݃ழ ҙܻೞӝ var markers by remember { mutableStateOf<List<Marker>>(emptyList())
} LaunchedEffect(theaters) { val naverMap = mapView.awaitMap() markers.forEach { it.map = null } markers = theaters.map { theater -> Marker().apply { ... map = naverMap } } } Link: h tt ps://developer.android.com/jetpack/compose/side-e ff ects#launchede ff ect Composeীࢲب زੌೠ ٘ܳ ࢿ೮ҳਃ LaunchedEffectܳ ࢎਊ೧ࢲ theaters ߄Չ ٸ݅ ݃ழܳ द Ӓܻب۾ ೮णפ -
Composable ߧਤীࢲ suspend funܳ ഐೡ ٸ ࢎਊೠ. Composition द ژח
keyо ߸҃ؼ ٸ݃ द ഐػ. LaunchedEffect Source: h tt ps://medium.com/mobile-app-development-publication/a4867f876928 -
ݫۄ ز // move naverMap.moveCamera(CameraUpdate.zoomTo(12.0)) // animation naverMap.moveCamera( CameraUpdate .scrollAndZoomTo(LatLng(...,
...), 16.0) .animate(CameraAnimation.Fly) ) Link: h tt ps://navermaps.github.io/android-map-sdk/guide-ko/3-2.html ݫۄܳ زೞח ٘۽, গפݫ࣌ ৈࠗী ٮۄ ࢎਊߑߨ ઑӘ ܵפ নೠ APIо ਵפ, ֎ߡب SDK ޙࢲܳ ଵҊೞݶ بؼ Ѫ эणפ -
Example: ݃ழ ࢶఖೞӝ Marker().apply { setOnClickListener { /* Marker Selected
*/ naverMap.moveCamera(...) } } mapView.getMapAsync { naverMap -> naverMap.setOnMapClickListener { _, _ -> /* Marker Unselected */ naverMap.moveCamera(...) } } ݃ழ৬ بܳ ܼೞݶ ݫۄܳ زೞח ઁ ٘ੑפ -
Example: ݃ழ ࢶఖೞӝ var selectedTheater by remember { mutableStateOf<TheaterMarkerUiModel?>)(null) }
Marker().apply { setOnClickListener { /* Marker Selected */ selectedTheater = theater } } mapView.getMapAsync { naverMap -> naverMap.setOnMapClickListener { _, _ -> /* Marker Unselected */ selectedTheater = null } } Composeীࢲب زੌೞѱ ೡ ࣻ ݅, ࢶఖػ ӓਸ ࢚క۽ ೧فҊ ࢚కо ߸҃ؼ ٸ ݫۄܳ زೞח ߑߨਸ ࢎਊ೮णפ -
Composeীࢲ ҙೡ ࣻ ח MutableState<T>ܳ ࢤࢿೞח ೣࣻ. valueо ߸҃غݶ, valueܳ
੍ח Composable ೣࣻ Recomposition ডػ. mutableStateOf Link: h tt ps://developer.android.com/jetpack/compose/state#state-in-composables interface MutableState<T> : State<T> { override var value: T } var value by remember { mutableStateOf(default) } Recompositionীࢲ valueܳ ਬೞ۰ݶ rememberܳ ࢎਊ೧ঠ ೠ. -
Example: ݃ழ ࢶఖೞӝ var selectedTheater by remember { mutableStateOf<TheaterMarkerUiModel?>)(null) }
LaunchedEffect(selectedTheater) { val naverMap = mapView.awaitMap() if (selectedTheater != null) { naverMap.moveCamera(...) } else { naverMap.moveCamera(...) } } LaunchedEffectܳ ਊೞৈ, ࢶఖػ ӓ ч ߸҃ؼ ٸ݃ ೠ ਤ۽ ݫۄܳ زೡ ࣻ ѷणפ -
ৈӝࢲ ਫ਼Ӭ! Architecture: Unidirectional Data Flow var name by remember
{ mutableStateOf("") } OutlinedTextField( value = name, onValueChange = { name = it }, label = { Text("Name") } ) Link: h tt ps://developer.android.com/jetpack/compose/architecture ࢚కח ইې۽ زೞҊ ߮ח ਤ۽ زೞח ٣ੋ ಁఢ. -
val savedInstanceState = rememberSavedInstanceState() val mapView = rememberMapViewWithLifecycle(savedInstanceState, naverMapOptions()) AndroidView(factory
= { mapView.apply { coroutineScope.launch { val naverMap = awaitMap() naverMap.mapType = NaverMap.MapType.Navi naverMap.isNightModeEnabled = true naverMap.setOnMapClickListener { _, _ -> /* Do domething*/ } } } }) খীࢲ ࢿ೮؍ ٘о ࢶഋ UIী ೞѱ ҳഅغח ࢤп೧ࠇद -
@Composable fun NaverMap( modifier: Modifier = Modifier, mapOptions: NaverMapOptions =
..., mapProperties: MapProperties = ..., onMapClick: (PointF, LatLng) -> Unit = { _, _ -> }, ) { val savedInstanceState = rememberSavedInstanceState() val mapView = rememberMapViewWithLifecycle(savedInstanceState, mapOptions) AndroidView(factory = { mapView.apply { coroutineScope.launch { val naverMap = awaitMap() naverMap.mapType = mapProperties.mapType naverMap.isNightModeEnabled = mapProperties.isNightModeEnabled naverMap.setOnMapClickListener(onMapClick) } } }) } ٘ܳ хऱࢲ NaverMapۄח Composableਸ ٜ݅ ࣻ णפ -
@Composable fun NaverMap( modifier: Modifier = Modifier, mapOptions: NaverMapOptions =
..., mapProperties: MapProperties = ..., onMapClick: (PointF, LatLng) -> Unit = { _, _ -> }, ) { val savedInstanceState = rememberSavedInstanceState() val mapView = rememberMapViewWithLifecycle(savedInstanceState, mapOptions) AndroidView(factory = { mapView.apply { coroutineScope.launch { val naverMap = awaitMap() naverMap.mapType = mapProperties.mapType naverMap.isNightModeEnabled = mapProperties.isNightModeEnabled naverMap.setOnMapClickListener(onMapClick) } } }) } NaverMap( mapOptions = naverMapOptions(), mapProperties = MapProperties( mapType = NaverMap.MapType.Navi, isNightModeEnabled = true, ), onMapClick = { _, _ -> /* Do domething*/ } ) ࢎਊೞח ٘ दੑפ Ӓۢ ࢶഋ UIܳ ҳഅ೮Ҋ ೡ ࣻ ਸөਃ? -
@Composable fun NaverMap( modifier: Modifier = Modifier, mapOptions: NaverMapOptions =
..., mapProperties: MapProperties = ..., onMapClick: (PointF, LatLng) -> Unit = { _, _ -> }, ) { val savedInstanceState = rememberSavedInstanceState() val mapView = rememberMapViewWithLifecycle(savedInstanceState, mapOptions) AndroidView(factory = { mapView.apply { coroutineScope.launch { val naverMap = awaitMap() naverMap.mapType = mapProperties.mapType naverMap.isNightModeEnabled = mapProperties.isNightModeEnabled naverMap.setOnMapClickListener(onMapClick) } } }) } 🤔 ࢚కо ߸҃ػݶ? 🫠 Recompositionীࢲ factoryח द ഐغ ঋח. updateীࢲ јनೡ ࣻח ݅, ݒߣ side-e ff ectܳ ݅٘ח ޙઁ. -
Library۽ ҕਊചೞӝ Link: h tt ps://github.com/fornewid/naver-map-compose Әө ࢿೠ ٘ח ೞա
জীࢲ ࢎਊೞӝীח ࠙೮݅, ۄ࠳۞ܻ۽ ٜ݅ٸח ҕਊചػ ਬૉாझী ݏࢲ ࢿ೧ঠѷભ? Ӓېࢲ ߣীח খীࢲ ҳഅ೮؍ 5о ਬૉாझܳ ѐࢶ೧ࠁ۰Ҋ פ -
ب ࠁৈӝ ✅ NaverMap(...) ࠗ࠙ ѱ Ҋச ࠗ࠙ হ
ইө ࢿ೮؍ ٜ٘ਸ Ӓ۽ ࢎਊೞݶ ؾפ -
ب ২࣌ @Composable fun NaverMap(properties: MapProperties = ...) { ...
AndroidView(factory = { mapView.apply { coroutineScope.launch { val naverMap = awaitMap() naverMap.mapType = properties.mapType naverMap.isNightModeEnabled = properties.isNightModeEnabled } } }) ইө ࢿ೮؍ NaverMap ёী mapType ١ਸ ࢸೞח ٘ੑפ -
ب ২࣌ @Composable fun NaverMap(properties: MapProperties = ...) { ...
AndroidView(factory = { mapView }) LaunchedEffect(Unit) { val naverMap = mapView.awaitMap() naverMap.mapType = properties.mapType naverMap.isNightModeEnabled = properties.isNightModeEnabled } } Side-effect APIੋ LaunchedEffectܳ ਊ೧ࢲ Compositionীࢲ݅ ഐغب۾ ߸҃ೡ ࣻ णפ ۞ݶ Recompositionীࢲח द ࢸغ ঋѷભ -
ب ২࣌ @Composable fun NaverMap(properties: MapProperties = ...) { ...
AndroidView(factory = { mapView }) LaunchedEffect(Unit) { val naverMap = mapView.awaitMap() naverMap.mapType = properties.mapType naverMap.isNightModeEnabled = properties.isNightModeEnabled } } prope rt iesо ߸҃غযب ߈غ ঋח ޙઁ. ೞ݅ propertiesо ߸҃غযب ߈غ ঋח ޙઁо ࢤӤפ -
ب ২࣌ @Composable fun NaverMap(properties: MapProperties = ...) { ...
AndroidView(factory = { mapView }) val currentProperties by rememberUpdatedState(properties) LaunchedEffect(Unit) { val naverMap = mapView.awaitMap() naverMap.mapType = currentProperties.mapType naverMap.isNightModeEnabled = currentProperties.isNightModeEnabled } } Link: h tt ps://developer.android.com/jetpack/compose/side-e ff ects#rememberupdatedstate rememberUpdatedState۽ propertiesܳ хऱࢲ ׳ೞݶ ݄݃ী ׳߉ propertiesী Ӕೡ ࣻ णפ -
rememberUpdatedState ч ߸҃غযب दೞ ঋইঠ ೞח ബҗ чਸ ଵઑೡ ٸ
ࢎਊೠ. Source: h tt ps://medium.com/mobile-app-development-publication/a4867f876928 -
ب ২࣌ val currentProperties by rememberUpdatedState(properties) LaunchedEffect(Unit) { val naverMap
= mapView.awaitMap() naverMap.mapType = currentProperties.mapType naverMap.isNightModeEnabled = currentProperties.isNightModeEnabled } ٘۽ द جইоࠇद ٘ীࢲ side-effectо ߊࢤೞח द হભ? -
ب ২࣌ val currentProperties by rememberUpdatedState(properties) val parentComposition = rememberCompositionContext()
LaunchedEffect(Unit) { val naverMap = mapView.awaitMap() val composition = Composition(MapApplier(naverMap), parentComposition).apply { setContent { MapUpdater(mapProperties = currentProperties) } } try { awaitCancellation() } finally { composition.dispose() } } ࣁࠗੋ ࠗ࠙ ࡅחؘ, पઁ۽ח ۧѱ ࢿ೮णפ -
ب ২࣌ val currentProperties by rememberUpdatedState(properties) val parentComposition = rememberCompositionContext()
LaunchedEffect(Unit) { val naverMap = mapView.awaitMap() val composition = Composition(MapApplier(naverMap), parentComposition).apply { setContent { MapUpdater(mapProperties = currentProperties) } } try { awaitCancellation() } finally { composition.dispose() } } Link: h tt ps://developer.android.com/reference/kotlin/androidx/compose/runtime/#Composition ࢜۽ Compositionਸ दೞח ߑߨ. rememberCompositionContext۽ parentCompositionਸ ٜ݅Ҋ Compositionਵ۽ child compositionਸ ٜ݅णפ setContent উীࢲח Composableਸ ࢶೡ ࣻ Ҋ, ݽف աݶ disposeܳ ഐפ -
ب ২࣌ val currentProperties by rememberUpdatedState(properties) val parentComposition = rememberCompositionContext()
LaunchedEffect(Unit) { val naverMap = mapView.awaitMap() val composition = Composition(MapApplier(naverMap), parentComposition).apply { setContent { MapUpdater(mapProperties = currentProperties) } } try { awaitCancellation() } finally { composition.dispose() } } Link: h tt ps://developer.android.com/reference/kotlin/androidx/compose/runtime/Applier ب ࣘࢿਸ Composable উীࢲ ҙܻೠ. ب ࣘࢿ MapUpdaterۄח Composable উীࢲ ҙܻೞҳਃ Child Compositionਸ ࢤࢿೡ ٸ, Composable Treeܳ ҙܻೞח Applierܳ ֍णפ -
MapApplierח Composition ী MapNode ܻܳ ҙܻೞח ೡ. MapUpdaterח ب ࣘࢿਸ
ҙܻೞח ComposeNodeܳ ࢤࢿೠ. MapUpdater NaverMap MapApplier, MapUpdater MapApplier MapPropertiesNode Listeners getMap() MapNode MapNode MapNode = ComposeNode NaverMap @Composable @Composable -
MapApplier class MapApplier( val map: NaverMap, ) : AbstractApplier<MapNode>(MapNodeRoot) {
private val decorations = mutableListOf<MapNode>() ... } interface MapNode object MapRootNode : MapNode class MapPropertiesNode(val map: NaverMap) : MapNode MapApplierীࢲ MapNode Listܳ ҙܻೞҊ, MapNode ҳഅ ী MapPropertiesNodeо णפ -
MapUpdater @Composable fun MapUpdater(mapProperties: MapProperties) { val map = (currentComposer.applier
as MapApplier).map ComposeNode<MapPropertiesNode, MapApplier>( factory = { MapPropertiesNode(map = map) }, update = { set(mapProperties.mapType) { map.mapType = it.value } set(mapProperties.isNightModeEnabled) { map.isNightModeEnabled = it } } ) Link: h tt ps://developer.android.com/reference/kotlin/androidx/compose/runtime/#ComposeNode MapPropertiesNodeח MapUpdater Composable ղࠗীࢲ ComposeNode APIܳ ਊ೧ࢲ ࢤࢿೞҳਃ AndroidView APIۢ factoryীࢲ ࢤࢿ, updateীࢲ јन೧ח ഋక۽ غয णפ -
MapProperties data class MapProperties( public val mapType: MapType = MapType.Basic,
public val isNightModeEnabled: Boolean = false, ) @Immutable enum class MapType( public val value: com.naver.maps.map.NaverMap.MapType ) { Basic(com.naver.maps.map.NaverMap.MapType.Basic), ... } Link: h tt ps://medium.com/androiddevelopers/jetpack-compose-stability-explained-79c10db270c8 MapPropertiesח mapType э ب ࣘࢿҗ ݒடغח data classੑפ ৈӝࢲ MapType ֎ߡب SDK MapTypeਸ хऱח ഋక۽ غয חؘਃ -
MapProperties data class MapProperties( public val mapType: MapType = MapType.Basic,
public val isNightModeEnabled: Boolean = false, ) @Immutable enum class MapType( public val value: com.naver.maps.map.NaverMap.MapType ) { Basic(com.naver.maps.map.NaverMap.MapType.Basic), ... } Link: h tt ps://medium.com/androiddevelopers/jetpack-compose-stability-explained-79c10db270c8 Compose ஹੌ۞о प೯غ ঋח ݽٕ ېझח ࠛউೠ Ѫਵ۽ ୶ۿػ. wrapper classী ࠛ߸ਸ ೞৈ Recompositionਸ ୭ࣗചೡ ࣻ . Ӓ ਬח, ֎ߡب SDKח Compose ஹੌ۞о प೯غ ঋই Composeীࢲח ۠ ېझܳ unstable۽ ୶ۿೞӝ ٸޙੑפ @immutableਸ ୶оೞৈ ࠛਃೠ recompositionਸ ੌ ࣻ णפ -
ب ২࣌ ✅ NaverMap( ... mapProperties = MapProperties( mapType =
NaverMap.MapType.Navi, isNightModeEnabled = true, ), ... ) ب ২࣌ਸ ࢚క۽ ׳ೞח ࠗ࠙ਸ ৮ࢿ೮णפ -
ب ২࣌ @Composable fun NaverMap(properties: MapProperties = ...) { ...
val currentProperties by rememberUpdatedState(properties) val parentComposition = rememberCompositionContext() LaunchedEffect(Unit) { val naverMap = mapView.awaitMap() val composition = Composition( MapApplier(naverMap), parentComposition ).apply { setContent { MapUpdater(mapProperties = currentProperties) } } ߑӘө ࠄ ب ২࣌ ٘۽, propertiesܳ ׳೧ח ࠗ࠙ਸ ࢿ೮חؘਃ -
ب ߮ @Composable fun NaverMap(onMapClick: (PointF, LatLng) -> Unit =
{ _, _ -> }) { ... val mapClickListeners = remember { MapClickListeners() } .also { it.onMapClick = onMapClick } val parentComposition = rememberCompositionContext() LaunchedEffect(Unit) { val naverMap = mapView.awaitMap() val composition = Composition( MapApplier(naverMap), parentComposition ).apply { setContent { MapUpdater(clickListeners = mapClickListeners) } } ب ߮ীࢲח onMapClickۄח ۈܳ ׳פ -
ب ߮ @Composable fun NaverMap(onMapClick: (PointF, LatLng) -> Unit =
{ _, _ -> }) { ... val mapClickListeners = remember { MapClickListeners() } .also { it.onMapClick = onMapClick } val parentComposition = rememberCompositionContext() LaunchedEffect(Unit) { val naverMap = mapView.awaitMap() val composition = Composition( MapApplier(naverMap), parentComposition ).apply { setContent { MapUpdater(clickListeners = mapClickListeners) } } class MapClickListeners { var onMapClick: (PointF, LatLng) -> Unit by mutableStateOf({ _, _ -> }) } MapClickListenersח onMapClick ۈܳ MutableState۽ ҙܻೞҊ, recompositionীࢲ MapClickListenersо ߄Շ ঋب۾ remember۽ ӝর೧સפ -
ب ߮ @Composable fun NaverMap(onMapClick: (PointF, LatLng) -> Unit =
{ _, _ -> }) { ... val mapClickListeners = remember { MapClickListeners() } .also { it.onMapClick = onMapClick } val parentComposition = rememberCompositionContext() LaunchedEffect(Unit) { val naverMap = mapView.awaitMap() val composition = Composition( MapApplier(naverMap), parentComposition ).apply { setContent { MapUpdater(clickListeners = mapClickListeners) } } Ӓېࢲ MapUpdater ղࠗীࢲ ߮о ߊࢤೞݶ ۠ ࣽࢲ۽ ߮о ࢚ਤ۽ ؾפ -
// Composition ب ߮ @Composable fun MapUpdater(clickListeners: MapClickListeners) { ComposeNode<MapPropertiesNode,
MapApplier>( factory = { MapPropertiesNode(clickListeners = clickListeners) }, update = { update(clickListeners) { this.clickListeners = it } }, ) } class MapPropertiesNode( var map: NaverMap, var clickListeners: MapClickListeners, ) : MapNode { override fun onAttached() { map.setOnMapClickListener { point, coord -> clickListeners.onMapClick(point, coord) } } MapUpdaterীࢲח Composition दী clickListenersܳ ׳೧Ҋ -
// Recomposition ب ߮ @Composable fun MapUpdater(clickListeners: MapClickListeners) { ComposeNode<MapPropertiesNode,
MapApplier>( factory = { MapPropertiesNode(clickListeners = clickListeners) }, update = { update(clickListeners) { this.clickListeners = it } }, ) } class MapPropertiesNode( var map: NaverMap, var clickListeners: MapClickListeners, ) : MapNode { override fun onAttached() { map.setOnMapClickListener { point, coord -> clickListeners.onMapClick(point, coord) } } Recomposition दীח ۈо ߄Շਸ ࣻ ਵפ MapClickListenersܳ द Ү೧સפ -
ب ߮ @Composable fun MapUpdater(clickListeners: MapClickListeners) { ComposeNode<MapPropertiesNode, MapApplier>( factory
= { MapPropertiesNode(clickListeners = clickListeners) }, update = { update(clickListeners) { this.clickListeners = it } }, ) } class MapPropertiesNode( var map: NaverMap, var clickListeners: MapClickListeners, ) : MapNode { override fun onAttached() { map.setOnMapClickListener { point, coord -> clickListeners.onMapClick(point, coord) } } MapPropertiesNodeо attachغݶ NaverMapী Listenerܳ ١۾פ -
ب ߮ @Composable fun MapUpdater(clickListeners: MapClickListeners) { ComposeNode<MapPropertiesNode, MapApplier>( factory
= { MapPropertiesNode(clickListeners = clickListeners) }, update = { update(clickListeners) { this.clickListeners = it } }, ) } class MapPropertiesNode( var map: NaverMap, var clickListeners: MapClickListeners, ) : MapNode { override fun onAttached() { map.setOnMapClickListener { point, coord -> clickListeners.onMapClick(point, coord) } } ֎ߡبীࢲ ߮о ߊࢤೞݶ ۠ ࣽਵ۽ ࢚ਤ۽ ؾפ -
ب ߮ ✅ NaverMap( ... onMapClick = { _, _
-> /* Do domething*/ } ... ) ۧѱ ֎ߡبীࢲ ߮ܳ ܖח ࠗ࠙ب ҳഅ೧ࠌणפ -
// State ݃ழ val marker = Marker().apply { captionText =
"caption" position = LatLng(..., ...) icon = OverlayImage.fromResource(R.drawable.marker_icon) setOnClickListener { ... true } map = naverMap } ۧѱ ࢚కܳ ೞח ࠗ࠙ Ҋ -
// Event ݃ழ val marker = Marker().apply { captionText =
"caption" position = LatLng(..., ...) icon = OverlayImage.fromResource(R.drawable.marker_icon) setOnClickListener { ... true } map = naverMap } ߮ী ೠ ࠗ࠙ Ҋ -
// Display ݃ழ val marker = Marker().apply { captionText =
"caption" position = LatLng(..., ...) icon = OverlayImage.fromResource(R.drawable.marker_icon) setOnClickListener { ... true } map = naverMap } ֎ߡبী ࠁৈח ࠗ࠙ णפ -
݃ழ Marker( captionText = "caption", position = LatLng(..., ...), icon
= OverlayImage.fromResource(R.drawable.marker_icon), onClick = { ... true }, ) Composeীࢲח ۠ ഋక۽ ࢎਊೡ ࣻ ѱ ٜ݅णפ -
݃ழ Marker( captionText = "caption", position = LatLng(..., ...), icon
= OverlayImage.fromResource(R.drawable.marker_icon), onClick = { ... true }, ) @Composable fun Marker( captionText: String? = ..., position: LatLng = ..., icon: OverlayImage = ..., onClick: (Marker) -> Boolean = { false }, ) { ... } ۢ ComposeNodeܳ ഝਊ೧ࢲ Marker Composableਸ ٜ݅ݶ ؾפ -
ComposeNodeܳ ࢤࢿೞৈ ࢚కܳ সؘ. MapApplierܳ ా೧ بী दೠ. Marker NaverMap
Marker ҳઑ MapApplier MarkerNode Marker onClick getMap() MapNode MapNode MapNode = ComposeNode NaverMap @Composable @Composable Link: h tt ps://github.com/fornewid/naver-map-compose/.../com/naver/maps/map/compose/Marker.kt -
݃ழ Marker( captionText = "caption", position = LatLng(..., ...), icon
= OverlayImage.fromResource(R.drawable.marker_icon), onClick = { ... true }, ) // map = naverMap ? NaverMapী द೧ח ࠗ࠙ ٘۽ যڌѱ അೞݶ જਸөਃ? -
݃ழ NaverMap(...) { Marker( captionText = "caption", position = LatLng(...,
...), icon = OverlayImage.fromResource(R.drawable.marker_icon), onClick = { ... true }, ) } ۧѱ NaverMap Composable ղࠗী Child Composable۽ ࢶ೧ݶ ؾפ -
Example: ӓ ݃ழ ҙܻೞӝ var markers by remember { mutableStateOf<List<Marker>>(emptyList())
} LaunchedEffect(theaters) { val naverMap = mapView.awaitMap() markers.forEach { it.map = null } markers = theaters.map { theater -> Marker().apply { ... map = naverMap } } } ష ۽ંীࢲ ࢿ೮؍ ٘ח UIܳ Side-effect۽ ҙܻೞח ו՝חؘਃ -
Example: ӓ ݃ழ ҙܻೞӝ NaverMap(...) { theaters.forEach { theater ->
Marker( ... ) } } ઁ ખ ؊ ࢶഋ UIী оӰѱ ݃ழܳ दೡ ࣻ णפ -
݃ழ ࠁৈӝ ✅ NaverMap { Marker( position = LatLng(..., ...),
... onClick = { /* Do domething*/ true }, ) } -
Use Case 5: ݫۄ ز Con fi g Changes दী
࢚కܳ ਬೡ ࣻ হਸө? rememberSaveable -
ݫۄী ೠ ࢚క, ߮ܳ ҙܻೞח State Holder. MapUpdater CameraPositionState NaverMap
MapPropertiesNode CameraPositionState CameraPosition NaverMap Listeners Composition only State Holder Event New CameraPosition @Composable Compositionীࢲ݅ ݄݃ী ೠ ਤ۽ ݫۄܳ زפ -
࢚క ҙܻ: State Holder Link: h tt ps://developer.android.com/jetpack/compose/state#state-holder-source-of-truth ࠂೠ UI
࢚క৬ UI ۽ਸ ನೣೞח ېझ. Composable ࠂࢿਸ ৈળ. -
internal class MapPropertiesNode( val map: NaverMap, cameraPositionState: CameraPositionState, ) :
MapNode { init { cameraPositionState.setMap(map) } private val cameraIdleListener = NaverMap.OnCameraIdleListener { cameraPositionState.rawPosition = map.cameraPosition } private val cameraChangeListener = NaverMap.OnCameraChangeListener { _, _ -> cameraPositionState.rawPosition = map.cameraPosition } override fun onAttached() { map.addOnCameraIdleListener(cameraIdleListener) map.addOnCameraChangeListener(cameraChangeListener) } } MapPropertiesNode ٘ܳ ಝࠇद -
internal class MapPropertiesNode( val map: NaverMap, cameraPositionState: CameraPositionState, ) :
MapNode { init { cameraPositionState.setMap(map) } private val cameraIdleListener = NaverMap.OnCameraIdleListener { cameraPositionState.rawPosition = map.cameraPosition } private val cameraChangeListener = NaverMap.OnCameraChangeListener { _, _ -> cameraPositionState.rawPosition = map.cameraPosition } override fun onAttached() { map.addOnCameraIdleListener(cameraIdleListener) map.addOnCameraChangeListener(cameraChangeListener) } } cameraPositionStateী NaverMap ёܳ ࢸ೧Ҋ Listenerܳ ా೧, ߄Ո ݫۄ ਤо ٜযয়ݶ rawPositionਸ সؘ ೧સפ -
public class CameraPositionState(position: CameraPosition = ...) { internal var rawPosition
by mutableStateOf(position) public var position: CameraPosition get() = rawPosition set(value) { ... } internal fun setMap(map: NaverMap?) { this.map = map if (map != null) { map.moveCamera(CameraUpdate.toCameraPosition(position)) } } } NaverMap द ࢸغݶ(=Composition), ݄݃ ਤ۽ زೠ. NaverMap द ࢸغݶ Compositionਵ۽ ౸ױೞҊ, ݄݃ ਤ۽ زदெח ܻо ٜযо णפ -
@Composable public inline fun rememberCameraPositionState( key: String? = null, crossinline
init: CameraPositionState.() -> Unit = {}, ): CameraPositionState = rememberSaveable( key = key, saver = CameraPositionState.Saver ) { CameraPositionState().apply(init) } public val Saver: Saver<CameraPositionState, CameraPosition> = Saver( save = { it.position }, restore = { CameraPositionState(it) } ) Con fi g Changes दী ݄݃ ࢚కܳ ೧ળ. Link: h tt ps://developer.android.com/jetpack/compose/state#restore-ui-state rememberSaveableܳ ਊ೧ࢲ Config Changes दী ݄݃ ࢚కܳ /ࠂҳ ೧સפ -
val cameraPositionState = rememberCameraPositionState() NaverMap(cameraPositionState = cameraPositionState) val coroutineScope =
rememberCoroutineScope() coroutineScope.launch { cameraPositionState.animate( CameraUpdate.scrollTo(position), animation = CameraAnimation.Fly, durationMs = 1_000 ) } ݫۄ ز ✅ ࢎਊೡ ٸח NaverMap Composableী State Holderܳ ׳೧Ҋ زೡ ٸח ܖ౯ਸ ਊೞৈ গפݫ࣌ ܻܳ ೡ ࣻ णפ -
• Composable Lifecycle - Composition - Recomposition • Architecture -
Unidirectional Data Flow - State Holder • State - remember - rememberSaveable - mutableStateOf - @Immutable Keywords • Side-effects - LaunchedEffect - DisposableEffect - rememberCoroutineScope - rememberUpdatedState • Interoperability APIs - AndroidView - setContent • Custom Composition - rememberCompositionContext - Composition - Applier, ComposeNode