line/abc-kmm-location

Location Service Manager for Kotlin Multiplatform Mobile iOS and Android

Location Service Manager for Kotlin Multiplatform Mobile iOS and android

Features

• Super easy to use location capability in one interface
• Provides simple permission settings and management
• Dramatically reduce code to write
• Common interface available on KMM Shared

Usage

Register handlers for permissions

• Android

  ABCLocation
      .onPermissionUpdated(this) { isGranted ->
          println("onPermissionUpdated -> isGranted: $isGranted")
      }
      .onLocationUnavailable(this) {
          println("onLocationUnavailable")
      }

• iOS

  ABCLocation.Companion()
      .onPermissionUpdated(target: self) { isGranted ->
          print("onPermissionUpdated -> isGranted: \(isGranted)")
      }
      .onLocationUnavailable(target: self) {
          print("onLocationUnavailable")
      }
      .onAlwaysAllowsPermissionRequired(target: self) {
          print("onAlwaysAllowsPermissionRequired")
      }

To get current location just once

• Android

  ABCLocation.currentLocation { data ->
      println("currentLocation -> data: $data")
  }

• iOS

  ABCLocation.Companion().currentLocation { data in
      print("currentLocation -> data: \(data)")
  }

To get current location whenever location changes

• Android

  ABCLocation
      .onLocationUpdated(this) { data ->
          println("onLocationUpdated -> data: $data")
      }
      .startLocationUpdating()

• iOS

  ABCLocation.Companion()
      .onLocationUpdated(target: self) { data in
          print("onLocationUpdated -> data: \(data)")
      }
      .startLocationUpdating()

To stop location updating

• Android

  ABCLocation.stopLocationUpdating()

• iOS

  ABCLocation.Companion().stopLocationUpdating()

Installation

Gradle Settings

Add below gradle settings into your KMP (Kotlin Multiplatform Project)

build.gradle.kts in shared

plugins {
    id("com.android.library")
    kotlin("multiplatform")
}

val abcLocationLib = "com.linecorp.abc:kmm-location:0.2.4"

kotlin {
    android()
    ios {
        binaries
            .filterIsInstance<Framework>()
            .forEach {
                it.baseName = "shared"
                it.transitiveExport = true
                it.export(abcLocationLib)
            }
    }

    sourceSets {
        val commonMain by getting {
            dependencies {
                implementation(abcLocationLib)
            }
        }
        val commonTest by getting {
            dependencies {
                implementation(kotlin("test-common"))
                implementation(kotlin("test-annotations-common"))
            }
        }
        val androidMain by getting {
            dependencies {
                implementation("com.google.android.material:material:1.2.1")
                implementation(abcLocationLib)
            }
        }
        val androidTest by getting {
            dependencies {
                implementation(kotlin("test-junit"))
                implementation("junit:junit:4.13.2")
                implementation("androidx.test:core:1.0.0")
                implementation("androidx.test:runner:1.1.0")
                implementation("org.robolectric:robolectric:4.2")
            }
        }
        val iosMain by getting {
            dependencies {
                implementation(abcLocationLib)
            }
        }
        val iosTest by getting
    }
}

Project Settings

Android

• You can use right now without other settings.

iOS

1. Create Podfile with below setting in your project root.

use_frameworks!

platform :ios, '10.0'

install! 'cocoapods', :deterministic_uuids => false

target 'iosApp' do
    pod 'shared', :path => '../shared/'
end

2. Run command pod install on the terminal

Requirements

• iOS
  • Deployment Target 10.0 or higher
• Android
  • minSdkVersion 21

abc-kmm-location's Issues

Can't fetch library from maven repository not yet

Preparing to upload to public maven repository

Location service not working on Android12

Any plans on supporting KMP, or have suggested alternatives?

When attempting to add his library to a KMP project, i get this error:

The dependency com.linecorp.abc:kmm-location:0.2.11 was published in the legacy mode. Support for such dependencies will be removed in the future. See https://kotl.in/0b5kn8 for details.

#Versions
kotlin.version=1.9.10
agp.version=8.0.2
compose.version=1.5.2

Invalid permission checking when authorizationStatus is always on iOS

LocationManager.previousAuthorizationStatus value is not updated,
AllwaysAllow Permission Fixes the problem that permission check was not performed.