@react-native-kakao/map 2.2.7 → 3.2.0

package/CHANGELOG.md

@@ -0,0 +1,27 @@
+# @react-native-kakao/map
+
+## 3.2.0
+
+### Minor Changes
+
+- c86587c: Add an independent Expo Module for Kakao Maps on Android and iOS, with camera control, lifecycle events, and explicit initialization.
+- 0422fad: Add map presentation options, projection helpers, camera updates, and advanced camera controls with platform capabilities.
+- eb54ea5: Add route rendering, progress animations, replacement, and route command APIs.
+- bdd3dd1: Add dim screen highlights, visibility controls, and animation commands.
+- a2f659e: Add map utilities for coordinates, POI state, viewport, fonts, cache, and version queries.
+- af79548: Add GUI sprites, info windows, widgets, image sizing, events, and animation controls.
+- 34dfbfc: Add label scenes, image loading, events, commands, animations, and platform capability reporting.
+- bc7242d: Add geographic and model shape scenes, commands, animations, and label-to-shape transform sharing.
+
+## 3.1.0-next.2
+
+### Minor Changes
+
+- c86587c: Add an independent Expo Module for Kakao Maps on Android and iOS, with camera control, lifecycle events, and explicit initialization.
+- 0422fad: Add map presentation options, projection helpers, camera updates, and advanced camera controls with platform capabilities.
+- eb54ea5: Add route rendering, progress animations, replacement, and route command APIs.
+- bdd3dd1: Add dim screen highlights, visibility controls, and animation commands.
+- a2f659e: Add map utilities for coordinates, POI state, viewport, fonts, cache, and version queries.
+- af79548: Add GUI sprites, info windows, widgets, image sizing, events, and animation controls.
+- 34dfbfc: Add label scenes, image loading, events, commands, animations, and platform capability reporting.
+- bc7242d: Add geographic and model shape scenes, commands, animations, and label-to-shape transform sharing.

package/README.md

@@ -1,42 +1,9 @@
-<p align="center">
-  <a href="https://rnkakao.dev">
-    <img width="160px" src="https://raw.githubusercontent.com/mym0404/image-archive/master/202404201234177.webp"><br/>
-  </a>
-  <h1 align="center">React Native Kakao Map</h1>
-  <p align="center">
-  <a href="https://www.npmjs.com/package/@react-native-kakao/core"><img src="https://img.shields.io/npm/dm/@react-native-kakao/core.svg?style=flat-square" alt="NPM downloads"></a>
-  <a href="https://www.npmjs.com/package/@react-native-kakao/core"><img src="https://img.shields.io/npm/v/@react-native-kakao/core.svg?style=flat-square" alt="NPM version"></a>
-  <a href="/LICENSE"><img src="https://img.shields.io/npm/l/@react-native-kakao/core.svg?style=flat-square" alt="License"></a>
-  <a href="https://github.com/lerna-lite/lerna-lite"><img src="https://img.shields.io/badge/maintained%20with-lerna--lite-e137ff?style=flat-square" alt="License"></a>
-  <h3 align="center">Native Kakao SDK All In One Solution</h3>
-  </p>
-</p>
-<a href="https://rnkakao.dev">Documentation</a>
+# React Native Kakao Map
 
+Native Kakao Maps for Android and iOS, implemented with Expo Modules. Requires Expo 52+, React Native 0.76+, and the New Architecture. Core is not required.
 
-## Documentation
+See the [installation and API guide](https://rnkakao.mjstudio.net/docs/map/intro).
 
-- [Quick Start](https://rnkakao.dev)
+Kakao Maps SDK versions: Android 2.15.2 and iOS 2.12.19. Use a native development or Release build; Expo Go and web maps are unsupported. Android map runtime requires an ARM device or emulator.
 
-## Contributing
-
-- [Contributing](https://github.com/mym0404/react-native-kakao/blob/main/CONTRIBUTING.md)
-- [Issues](https://github.com/mym0404/react-native-kakao/issues)
-- [PRs](https://github.com/mym0404/react-native-kakao/pulls)
-- [Documentation](https://rnkakao.dev)
-- [Code of Conduct](https://github.com/mym0404/react-native-kakao/blob/main/CODE_OF_CONDUCT.md)
-
-## License
-
-- See [LICENSE](/LICENSE)
-
----
-
-<p align="center">
-  <a href="https://mjstudio.net/">
-    <img width="75px" src="https://raw.githubusercontent.com/mym0404/image-archive/master/202404201239152.webp">
-  </a>
-  <p align="center">
-    Built and maintained by <a href="https://mjstudio.net/">MJ Studio</a>.
-  </p>
-</p>
+Licensed under MIT. The underlying Kakao SDK is subject to Kakao's terms.

package/RNCKakaoMap.podspec

@@ -1,56 +1,20 @@
-require "json"
+require 'json'
 
-package = JSON.parse(File.read(File.join(__dir__, "package.json")))
-corePackage = JSON.parse(File.read(File.join(__dir__, "..", "core", "package.json")))
-sdk_version = corePackage['sdkVersions']['ios']['map']
-
-folly_compiler_flags = '-DFOLLY_NO_CONFIG -DFOLLY_MOBILE=1 -DFOLLY_USE_LIBCPP=1 -Wno-comma -Wno-shorten-64-to-32'
+package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
 
 Pod::Spec.new do |s|
-  s.name         = "RNCKakaoMap"
-  s.version      = package["version"]
-  s.summary      = package["description"]
-  s.homepage     = package["homepage"]
-  s.license      = package["license"]
-  s.authors      = package["author"]
-
-  s.platforms    = { :ios => min_ios_version_supported }
-  s.source       = { :git => "https://github.com/mym0404/react-native-kakao.git", :tag => "#{s.version}" }
-
-  s.source_files = "ios/**/*.{h,m,mm}"
-
-  # Use install_modules_dependencies helper to install the dependencies if React Native version >=0.71.0.
-  # See https://github.com/facebook/react-native/blob/febf6b7f33fdb4904669f99d795eba4c0f95d7bf/scripts/cocoapods/new_architecture.rb#L79.
-  if respond_to?(:install_modules_dependencies, true)
-    install_modules_dependencies(s)
-  else
-  s.dependency "React-Core"
-
-  # Don't install the dependencies when we run `pod install` in the old architecture.
-  if ENV['RCT_NEW_ARCH_ENABLED'] == '1' then
-    s.compiler_flags = folly_compiler_flags + " -DRCT_NEW_ARCH_ENABLED=1"
-    s.pod_target_xcconfig    = {
-        "HEADER_SEARCH_PATHS" => "\"$(PODS_ROOT)/boost\"",
-        "OTHER_CPLUSPLUSFLAGS" => "-DFOLLY_NO_CONFIG -DFOLLY_MOBILE=1 -DFOLLY_USE_LIBCPP=1",
-        "CLANG_CXX_LANGUAGE_STANDARD" => "c++17"
-    }
-    s.dependency "React-RCTFabric"
-    s.dependency "React-Codegen"
-    s.dependency "RCT-Folly"
-    s.dependency "RCTRequired"
-    s.dependency "RCTTypeSafety"
-    s.dependency "ReactCommon/turbomodule/core"
-   end
-  end
-
-  # Override Version by User
-  if defined?($KakaoMapSDKVersion)
-    Pod::UI.puts "#{s.name}: Using user specified Kakao SDK version '#{$KakaoMapSDKVersion}'"
-    sdk_version = $KakaoMapSDKVersion
-  end
-
-  s.dependency          'RNCKakaoCore'
-
-  # Kakao dependencies
-  s.dependency          'KakaoMapsSDK', sdk_version
+  s.name = 'RNCKakaoMap'
+  s.version = package['version']
+  s.summary = package['description']
+  s.homepage = package['homepage']
+  s.license = package['license']
+  s.author = package['author']
+  s.source = { :git => package['repository']['url'], :tag => s.version.to_s }
+  s.platforms = { :ios => '15.1' }
+  s.swift_version = '5.4'
+  s.static_framework = true
+  s.source_files = 'ios/**/*.swift'
+  s.pod_target_xcconfig = { 'DEFINES_MODULE' => 'YES' }
+  s.dependency 'ExpoModulesCore'
+  s.dependency 'KakaoMapsSDK', '2.12.19'
 end

package/android/build.gradle

@@ -1,117 +1,22 @@
-apply from: file('./../../core/android/package-json.gradle')
-def Versions = project.ext.RNCKakaoSdkVersions
-Project coreProject = project.ext.getWorkspaceProject("core")
+apply plugin: 'com.android.library'
 
-buildscript {
-    // Buildscript is evaluated before everything else so we can't use getExtOrDefault
-    def kotlin_version = rootProject.ext.has("kotlinVersion") ? rootProject.ext.get("kotlinVersion") : project.properties["Kakao_kotlinVersion"]
+def expoModulesCorePlugin = new File(project(':expo-modules-core').projectDir, 'ExpoModulesCorePlugin.gradle')
+apply from: expoModulesCorePlugin
+applyKotlinExpoModulesCorePlugin()
+useCoreDependencies()
+useDefaultAndroidSdkVersions()
 
-    repositories {
-        google()
-        mavenCentral()
-    }
-
-    dependencies {
-        classpath "com.android.tools.build:gradle:7.2.1"
-        // noinspection DifferentKotlinGradleVersion
-        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
-    }
-}
-
-def isNewArchitectureEnabled() {
-    return rootProject.hasProperty("newArchEnabled") && rootProject.getProperty("newArchEnabled") == "true"
-}
-
-apply plugin: "com.android.library"
-apply plugin: "kotlin-android"
-
-if (isNewArchitectureEnabled()) {
-    apply plugin: "com.facebook.react"
-}
-
-def supportsNamespace() {
-    def parsed = com.android.Version.ANDROID_GRADLE_PLUGIN_VERSION.tokenize('.')
-    def major = parsed[0].toInteger()
-    def minor = parsed[1].toInteger()
-
-    // Namespace support was added in 7.3.0
-    return (major == 7 && minor >= 3) || major >= 8
-}
+group = 'net.mjstudio.rnkakao.map'
+version = '3.0.0'
 
 android {
-    if (supportsNamespace()) {
-        namespace "net.mjstudio.rnkakao.map"
-
-        sourceSets {
-            main {
-                manifest.srcFile "src/main/AndroidManifestNew.xml"
-            }
-        }
-    }
-
-    compileSdkVersion Versions.compileSdk
-
+    namespace 'net.mjstudio.rnkakao.map'
     defaultConfig {
-        minSdkVersion Versions.minSdk
-        targetSdkVersion Versions.targetSdk
-        buildConfigField "boolean", "IS_NEW_ARCHITECTURE_ENABLED", isNewArchitectureEnabled().toString()
+        consumerProguardFiles 'consumer-rules.pro'
     }
-
-    buildFeatures {
-        buildConfig true
-    }
-
-    buildTypes {
-        release {
-            minifyEnabled false
-        }
-    }
-
-    lintOptions {
-        disable "GradleCompatible"
-    }
-
-    compileOptions {
-        sourceCompatibility JavaVersion.VERSION_1_8
-        targetCompatibility JavaVersion.VERSION_1_8
-    }
-
-
-    sourceSets {
-        main {
-            if (isNewArchitectureEnabled()) {
-                java.srcDirs += [
-                        "src/newarch",
-                        // This is needed to build Kotlin project with NewArch enabled
-                        "${project.buildDir}/generated/source/codegen/java"
-                ]
-            } else {
-                java.srcDirs += ["src/oldarch"]
-            }
-        }
-    }
-}
-
-repositories {
-    mavenCentral()
-    google()
 }
 
 dependencies {
-    // For < 0.71, this will be from the local maven repo
-    // For > 0.71, this will be replaced by `com.facebook.react:react-android:$version` by react gradle plugin
-    //noinspection GradleDynamicVersion
-    implementation "com.facebook.react:react-native:+"
-    implementation "org.jetbrains.kotlin:kotlin-stdlib:${Versions.kotlin}"
-
-    api coreProject
-    implementation "com.kakao.maps.open:android:${Versions.map}"
+    implementation 'com.facebook.react:react-android'
+    implementation 'com.kakao.maps.open:android:2.15.2'
 }
-
-if (isNewArchitectureEnabled()) {
-    react {
-        jsRootDir = file("../src/")
-        libraryName = "RNCKakaoMap"
-        codegenJavaPackageName = "net.mjstudio.rnkakao.map"
-    }
-}

package/android/consumer-rules.pro

@@ -0,0 +1,2 @@
+-keep class com.kakao.vectormap.** { *; }
+-keep interface com.kakao.vectormap.**

package/android/src/main/AndroidManifest.xml

@@ -1 +1,3 @@
-<manifest package="net.mjstudio.rnkakao.map"></manifest>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+  <uses-permission android:name="android.permission.INTERNET" />
+</manifest>

package/android/src/main/java/net/mjstudio/rnkakao/map/CameraOptions.kt

@@ -0,0 +1,61 @@
+package net.mjstudio.rnkakao.map
+
+import com.kakao.vectormap.LatLng
+import com.kakao.vectormap.camera.CameraPosition
+import expo.modules.kotlin.exception.CodedException
+import expo.modules.kotlin.records.Field
+import expo.modules.kotlin.records.Record
+import expo.modules.kotlin.records.Required
+
+internal const val INVALID_ARGUMENT = "ERR_KAKAO_MAP_INVALID_ARGUMENT"
+internal const val NOT_INITIALIZED = "ERR_KAKAO_MAP_NOT_INITIALIZED"
+internal const val NOT_READY = "ERR_KAKAO_MAP_NOT_READY"
+
+class CameraOptions : Record {
+  @Field @Required
+  var latitude: Double = Double.NaN
+
+  @Field @Required
+  var longitude: Double = Double.NaN
+
+  @Field @Required
+  var zoomLevel: Double = Double.NaN
+
+  @Field var tilt: Double = 0.0
+
+  @Field var rotation: Double = 0.0
+
+  fun values() = listOf(latitude, longitude, zoomLevel, tilt, rotation)
+
+  fun position(
+    minZoom: Int,
+    maxZoom: Int,
+  ): CameraPosition {
+    if (!values().all { it.isFinite() } || latitude !in -90.0..90.0 || longitude !in -180.0..180.0 ||
+      zoomLevel % 1.0 != 0.0 || zoomLevel < minZoom || zoomLevel > maxZoom || tilt !in 0.0..90.0
+    ) {
+      throw CodedException(INVALID_ARGUMENT, "Invalid camera coordinates, zoom level, tilt, or rotation.", null)
+    }
+    return CameraPosition.from(
+      CameraPosition
+        .Builder()
+        .setPosition(LatLng.from(latitude, longitude))
+        .setZoomLevel(zoomLevel.toInt())
+        .setTiltAngle(Math.toRadians(tilt))
+        .setRotationAngle(rotation.toNativeCameraRotation()),
+    )
+  }
+}
+
+internal fun CameraPosition.toPayload() =
+  mapOf(
+    "latitude" to position.latitude,
+    "longitude" to position.longitude,
+    "zoomLevel" to zoomLevel,
+    "tilt" to Math.toDegrees(tiltAngle),
+    "rotation" to Math.toDegrees(rotationAngle).normalizedCameraDegrees(),
+  )
+
+internal fun Double.toNativeCameraRotation() = Math.toRadians(normalizedCameraDegrees())
+
+internal fun Double.normalizedCameraDegrees() = (this % 360.0 + 360.0) % 360.0

package/android/src/main/java/net/mjstudio/rnkakao/map/KakaoMapModule.kt

@@ -0,0 +1,131 @@
+package net.mjstudio.rnkakao.map
+
+import com.kakao.vectormap.KakaoMapSdk
+import expo.modules.kotlin.Promise
+import expo.modules.kotlin.exception.CodedException
+import expo.modules.kotlin.functions.Queues
+import expo.modules.kotlin.modules.Module
+import expo.modules.kotlin.modules.ModuleDefinition
+
+class KakaoMapModule : Module() {
+  override fun definition() =
+    ModuleDefinition {
+      Name("RNCKakaoMap")
+      AsyncFunction("initialize") { key: String ->
+        if (key.isBlank()) throw CodedException(INVALID_ARGUMENT, "App key must not be empty.", null)
+        if (appKey != null &&
+          appKey != key
+        ) {
+          throw CodedException("ERR_KAKAO_MAP_ALREADY_INITIALIZED", "Kakao Maps is already initialized with another key.", null)
+        }
+        if (appKey == null) {
+          KakaoMapSdk.init(appContext.reactContext ?: throw CodedException("React context is unavailable."), key)
+          appKey = key
+        }
+      }.runOnQueue(Queues.MAIN)
+      View(KakaoMapView::class) {
+        Events(
+          "onMapReady",
+          "onError",
+          "onCameraMoveStart",
+          "onCameraIdle",
+          "onMapClick",
+          "onMapLongClick",
+          "onTerrainClick",
+          "onViewportClick",
+          "onVisibilityChanged",
+          "onFocusChanged",
+          "onPoiClick",
+          "onCompassClick",
+          "onMapTypeChanged",
+          "onPaddingChanged",
+          "onViewportChanged",
+          "onLabelClick",
+          "onLabelAnimationStopped",
+          "onLabelsChanged",
+          "onShapeAnimationStop",
+          "onShapesChanged",
+          "onRoutesChanged",
+          "onRouteProgress",
+          "onRouteAnimationStop",
+          "onGuiEvent",
+          "onDimScreenEvent",
+          "onCameraOperation",
+        )
+        Prop("initialCamera") { view: KakaoMapView, camera: CameraOptions? -> view.pendingInitialCamera = camera }
+        Prop("camera") { view: KakaoMapView, camera: CameraOptions? -> view.camera = camera }
+        Prop("options") { view: KakaoMapView, options: MapOptionsRecord? -> view.pendingOptions = options }
+        Prop("labels") { view: KakaoMapView, scene: MapLabelSceneRecord? -> view.queueLabels(scene) }
+        Prop("shapes") { view: KakaoMapView, scene: Map<String, Any?>? -> view.queueShapes(scene) }
+        Prop("routes") { view: KakaoMapView, scene: Map<String, Any?>? -> view.queueRoutes(scene) }
+        OnViewDidUpdateProps { view: KakaoMapView -> view.updateProps() }
+        AsyncFunction("moveCamera") { view: KakaoMapView, camera: CameraOptions, duration: Double -> view.moveCamera(camera, duration) }
+        AsyncFunction("getCamera") { view: KakaoMapView, promise: Promise -> view.getCamera(promise) }
+        AsyncFunction("updateCamera") { view: KakaoMapView, update: CameraUpdateRecord, duration: Double, promise: Promise ->
+          view.updateCamera(update, duration, promise)
+        }
+        AsyncFunction("getMapInfo") { view: KakaoMapView -> view.getMapInfo() }
+        AsyncFunction("screenToCoordinate") { view: KakaoMapView, point: ScreenPointRecord -> view.screenToCoordinate(point) }
+        AsyncFunction("coordinateToScreen") { view: KakaoMapView, coordinate: CoordinateRecord ->
+          view.coordinateToScreen(coordinate)
+        }
+        AsyncFunction("clearCache") { view: KakaoMapView -> view.clearCache() }
+        AsyncFunction("runLabelCommand") { view: KakaoMapView, command: MapLabelCommandRecord -> view.runLabelCommand(command) }
+        AsyncFunction("getLabelCapabilities") { view: KakaoMapView -> view.getLabelCapabilities() }
+        AsyncFunction("getLabelState") { view: KakaoMapView -> view.getLabelState() }
+        AsyncFunction("applyShapes") { view: KakaoMapView, scene: Map<String, Any?> -> view.applyShapes(scene) }
+          .runOnQueue(Queues.MAIN)
+        AsyncFunction("executeShapeCommand") { view: KakaoMapView, command: Map<String, Any?> ->
+          view.executeShapeCommand(command)
+        }.runOnQueue(Queues.MAIN)
+        AsyncFunction("applyRoutes") { view: KakaoMapView, scene: Map<String, Any?>, promise: Promise -> view.applyRoutes(scene, promise) }
+        AsyncFunction("executeRouteCommand") { view: KakaoMapView, command: Map<String, Any?> -> view.executeRouteCommand(command) }
+        AsyncFunction("applyGui") { view: KakaoMapView, scene: MapGuiSceneRecord, promise: Promise ->
+          view.requireGui().apply(scene) { error ->
+            if (error != null) promise.reject(error) else promise.resolve(null)
+          }
+        }
+        AsyncFunction("showInfoWindow") { view: KakaoMapView, id: String, autoMove: Boolean, duration: Double? ->
+          view.requireGui().showInfoWindow(id, autoMove, duration)
+        }
+        AsyncFunction("hideInfoWindow") { view: KakaoMapView, id: String -> view.requireGui().hideInfoWindow(id) }
+        AsyncFunction("moveInfoWindow") { view: KakaoMapView, id: String, position: CoordinateRecord, duration: Double ->
+          view.requireGui().moveInfoWindow(id, position, duration)
+        }
+        AsyncFunction("showWidget") { view: KakaoMapView, id: String -> view.requireGui().showWidget(id) }
+        AsyncFunction("hideWidget") { view: KakaoMapView, id: String -> view.requireGui().hideWidget(id) }
+        AsyncFunction(
+          "positionWidget",
+        ) { view: KakaoMapView, id: String, position: MapWidgetPositionRecord -> view.requireGui().positionWidget(id, position) }
+        AsyncFunction("rotateWidget") { view: KakaoMapView, id: String, rotation: Double -> view.requireGui().rotateWidget(id, rotation) }
+        AsyncFunction("startGuiAnimation") { view: KakaoMapView, id: String -> view.requireGui().startAnimation(id) }
+        AsyncFunction("stopGuiAnimation") { view: KakaoMapView, id: String -> view.requireGui().stopAnimation(id) }
+        AsyncFunction(
+          "controlAnimatedImage",
+        ) { view: KakaoMapView, ownerType: String, ownerId: String, componentId: String, action: String ->
+          view.requireGui().controlAnimatedImage(ownerType, ownerId, componentId, action)
+        }
+        AsyncFunction("getGuiStatus") { view: KakaoMapView -> view.requireGui().status() }
+        AsyncFunction("applyDimScreen") { view: KakaoMapView, options: Map<String, Any?> -> view.requireDimScreen().apply(options) }
+        AsyncFunction(
+          "setDimHighlightVisible",
+        ) { view: KakaoMapView, id: String, visible: Boolean -> view.requireDimScreen().setHighlightVisible(id, visible) }
+        AsyncFunction("startDimAnimation") { view: KakaoMapView, id: String -> view.requireDimScreen().startAnimation(id) }
+        AsyncFunction("stopDimAnimation") { view: KakaoMapView, id: String -> view.requireDimScreen().stopAnimation(id) }
+        AsyncFunction("getDimScreenStatus") { view: KakaoMapView -> view.requireDimScreen().status() }
+        AsyncFunction(
+          "executeUtilityCommand",
+        ) { view: KakaoMapView, command: Map<String, Any?> -> view.requireUtilities().command(command) }
+        AsyncFunction("requestPoiState") { view: KakaoMapView, promise: Promise -> view.requireUtilities().requestPoiState(promise) }
+        AsyncFunction(
+          "executeCameraCommand",
+        ) { view: KakaoMapView, command: Map<String, Any?>, promise: Promise -> view.executeCameraCommand(command, promise) }
+        OnViewDestroys { view: KakaoMapView -> view.destroy() }
+      }
+    }
+
+  companion object {
+    var appKey: String? = null
+      private set
+  }
+}