Release 0.20.0

.github/workflows/compilation-check.yml

@@ -12,10 +12,10 @@ jobs:
 
     steps:
       - uses: actions/checkout@v1
-      - name: Set up JDK 11
+      - name: Set up JDK 17
         uses: actions/setup-java@v1
         with:
-          java-version: 11
+          java-version: 17
       - name: Build and publish local
         run: ./gradlew build publishToMavenLocal syncMultiPlatformLibraryDebugFrameworkIosX64
       - name: Install pods

.github/workflows/publish.yml

@@ -21,12 +21,15 @@ jobs:
 
     steps:
       - uses: actions/checkout@v1
-      - name: Set up JDK 11
+      - name: Set up JDK 17
         uses: actions/setup-java@v1
         with:
-          java-version: 11
-      - name: Build and publish to Bintray
-        run: ./gradlew publish
+          java-version: 17
+      - name: Prebuild library
+        run: ./gradlew publishToMavenLocal
+      - name: Publish
+        run: ./gradlew publishToSonatype closeAndReleaseSonatypeStagingRepository
+
   release:
     name: Create release
     needs: publish

README.md

@@ -39,23 +39,23 @@ allprojects {
 project **build.gradle**
 ```groovy
 dependencies {
-    commonMainApi("dev.icerock.moko:permissions:0.19.1")
+    commonMainApi("dev.icerock.moko:permissions:0.20.0")
 
     // specific permissions support
-    commonMainImplementation("dev.icerock.moko:permissions-bluetooth:0.19.1")
-    commonMainImplementation("dev.icerock.moko:permissions-camera:0.19.1")
-    commonMainImplementation("dev.icerock.moko:permissions-contacts:0.19.1")
-    commonMainImplementation("dev.icerock.moko:permissions-gallery:0.19.1")
-    commonMainImplementation("dev.icerock.moko:permissions-location:0.19.1")
-    commonMainImplementation("dev.icerock.moko:permissions-microphone:0.19.1")
-    commonMainImplementation("dev.icerock.moko:permissions-motion:0.19.1")
-    commonMainImplementation("dev.icerock.moko:permissions-notifications:0.19.1")
-    commonMainImplementation("dev.icerock.moko:permissions-storage:0.19.1")
+    commonMainImplementation("dev.icerock.moko:permissions-bluetooth:0.20.0")
+    commonMainImplementation("dev.icerock.moko:permissions-camera:0.20.0")
+    commonMainImplementation("dev.icerock.moko:permissions-contacts:0.20.0")
+    commonMainImplementation("dev.icerock.moko:permissions-gallery:0.20.0")
+    commonMainImplementation("dev.icerock.moko:permissions-location:0.20.0")
+    commonMainImplementation("dev.icerock.moko:permissions-microphone:0.20.0")
+    commonMainImplementation("dev.icerock.moko:permissions-motion:0.20.0")
+    commonMainImplementation("dev.icerock.moko:permissions-notifications:0.20.0")
+    commonMainImplementation("dev.icerock.moko:permissions-storage:0.20.0")
 
     // compose multiplatform
-    commonMainApi("dev.icerock.moko:permissions-compose:0.19.1") // permissions api + compose extensions
+    commonMainApi("dev.icerock.moko:permissions-compose:0.20.0") // permissions api + compose extensions
 
-    commonTestImplementation("dev.icerock.moko:permissions-test:0.19.1")
+    commonTestImplementation("dev.icerock.moko:permissions-test:0.20.0")
 }
 ```
 

gradle.properties

@@ -1,4 +1,4 @@
-org.gradle.jvmargs=-Xmx4096m
+org.gradle.jvmargs=-Xmx4096m -Dfile.encoding=UTF-8
 org.gradle.configureondemand=false
 org.gradle.parallel=true
 
@@ -8,8 +8,8 @@ kotlin.mpp.androidSourceSetLayoutVersion=2
 
 android.useAndroidX=true
 
-moko.android.targetSdk=33
-moko.android.compileSdk=33
+moko.android.targetSdk=34
+moko.android.compileSdk=34
 moko.android.minSdk=16
 
 moko.publish.name=MOKO permissions

gradle/libs.versions.toml

@@ -10,8 +10,8 @@ androidLifecycleVersion = "2.2.0"
 androidCoreTestingVersion = "2.2.0"
 coroutinesVersion = "1.6.4"
 mokoMvvmVersion = "0.16.0"
-mokoPermissionsVersion = "0.19.1"
-composeJetBrainsVersion = "1.5.1"
+mokoPermissionsVersion = "0.20.0"
+composeJetBrainsVersion = "1.7.1"
 lifecycleRuntime = "2.6.1"
 composeUiVersion = "1.0.1"
 
@@ -34,7 +34,7 @@ androidCoreTesting = { module = "androidx.arch.core:core-testing", version.ref =
 
 kotlinGradlePlugin = { module = "org.jetbrains.kotlin:kotlin-gradle-plugin", version.ref = "kotlinVersion" }
 androidGradlePlugin = { module = "com.android.tools.build:gradle", version = "7.4.2" }
-mokoGradlePlugin = { module = "dev.icerock.moko:moko-gradle-plugin", version = "0.2.0" }
+mokoGradlePlugin = { module = "dev.icerock.moko:moko-gradle-plugin", version = "0.5.1" }
 mobileMultiplatformGradlePlugin = { module = "dev.icerock:mobile-multiplatform", version = "0.14.2" }
 kotlinSerializationGradlePlugin = { module = "org.jetbrains.kotlin:kotlin-serialization", version.ref = "kotlinVersion" }
 composeJetBrainsGradlePlugin = { module = "org.jetbrains.compose:compose-gradle-plugin", version.ref = "composeJetBrainsVersion" }

gradle/wrapper/gradle-wrapper.properties

@@ -1,5 +1,6 @@
+#Tue Jun 10 21:09:29 CEST 2025
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-7.6.1-bin.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.4-bin.zip
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists

permissions-avfoundation/src/iosMain/kotlin/dev/icerock/moko/permissions/avfoundation/AVCaptureDelegate.kt

@@ -23,7 +23,7 @@ import kotlin.coroutines.suspendCoroutine
 
 class AVCaptureDelegate(
     private val type: AVMediaType,
-    private val permission: Permission
+    private val permission: Permission,
 ) : PermissionDelegate {
     override suspend fun providePermission() {
         val status: AVAuthorizationStatus = currentAuthorizationStatus()
@@ -33,8 +33,11 @@ class AVCaptureDelegate(
                 val isGranted: Boolean = suspendCoroutine { continuation ->
                     AVCaptureDevice.requestAccess(type) { continuation.resume(it) }
                 }
-                if (isGranted) return
-                else throw DeniedAlwaysException(permission)
+                if (isGranted) {
+                    return
+                } else {
+                    throw DeniedAlwaysException(permission)
+                }
             }
 
             AVAuthorizationStatusDenied -> throw DeniedAlwaysException(permission)
@@ -60,9 +63,12 @@ class AVCaptureDelegate(
 
 private fun AVCaptureDevice.Companion.requestAccess(
     type: AVMediaType,
-    callback: (isGranted: Boolean) -> Unit
+    callback: (isGranted: Boolean) -> Unit,
 ) {
-    this.requestAccessForMediaType(type, mainContinuation { isGranted: Boolean ->
-        callback(isGranted)
-    })
+    this.requestAccessForMediaType(
+        type,
+        mainContinuation { isGranted: Boolean ->
+            callback(isGranted)
+        }
+    )
 }

permissions-bluetooth/src/iosMain/kotlin/dev/icerock/moko/permissions/bluetooth/BluetoothPermissionDelegate.kt

@@ -31,7 +31,7 @@ import kotlin.coroutines.resume
 import kotlin.coroutines.suspendCoroutine
 
 internal class BluetoothPermissionDelegate(
-    private val permission: Permission
+    private val permission: Permission,
 ) : PermissionDelegate {
     @OptIn(ExperimentalForeignApi::class)
     override suspend fun providePermission() {
@@ -45,11 +45,14 @@ internal class BluetoothPermissionDelegate(
 
         val state: CBManagerState = if (isNotDetermined) {
             suspendCoroutine { continuation ->
-                CBCentralManager(object : NSObject(), CBCentralManagerDelegateProtocol {
-                    override fun centralManagerDidUpdateState(central: CBCentralManager) {
-                        continuation.resume(central.state)
-                    }
-                }, null)
+                CBCentralManager(
+                    object : NSObject(), CBCentralManagerDelegateProtocol {
+                        override fun centralManagerDidUpdateState(central: CBCentralManager) {
+                            continuation.resume(central.state)
+                        }
+                    },
+                    null
+                )
             }
         } else {
             CBCentralManager().state
@@ -91,7 +94,8 @@ internal class BluetoothPermissionDelegate(
         return when (state) {
             CBManagerStatePoweredOn -> PermissionState.Granted
             CBManagerStateUnauthorized, CBManagerStatePoweredOff,
-            CBManagerStateResetting, CBManagerStateUnsupported -> PermissionState.DeniedAlways
+            CBManagerStateResetting, CBManagerStateUnsupported,
+            -> PermissionState.DeniedAlways
 
             CBManagerStateUnknown -> PermissionState.NotDetermined
             else -> error("unknown state $state")

permissions-compose/src/androidMain/kotlin/dev/icerock/moko/permissions/compose/BindEffect.android.kt

@@ -5,11 +5,11 @@
 package dev.icerock.moko.permissions.compose
 
 import android.content.Context
+import androidx.activity.ComponentActivity
 import androidx.compose.runtime.Composable
 import androidx.compose.runtime.LaunchedEffect
 import androidx.compose.ui.platform.LocalContext
 import androidx.compose.ui.platform.LocalLifecycleOwner
-import androidx.activity.ComponentActivity
 import androidx.lifecycle.LifecycleOwner
 import dev.icerock.moko.permissions.PermissionsController
 

permissions-contacts/src/androidMain/kotlin/dev/icerock/moko/permissions/contacts/ContactsPermission.android.kt

@@ -17,3 +17,12 @@ actual val contactsDelegate = object : PermissionDelegate {
             Manifest.permission.WRITE_CONTACTS
         )
 }
+
+actual val readContactsDelegate = object : PermissionDelegate {
+    override fun getPermissionStateOverride(applicationContext: Context) = null
+
+    override fun getPlatformPermission() =
+        listOf(
+            Manifest.permission.READ_CONTACTS
+        )
+}

permissions-contacts/src/commonMain/kotlin/dev/icerock/moko/permissions/contacts/ContactPermission.kt

@@ -8,9 +8,28 @@ import dev.icerock.moko.permissions.Permission
 import dev.icerock.moko.permissions.PermissionDelegate
 
 internal expect val contactsDelegate: PermissionDelegate
+internal expect val readContactsDelegate: PermissionDelegate
 
+/**
+ * Permission to read and write contacts.
+ *
+ * On Android, declare both `READ_CONTACTS` and `WRITE_CONTACTS` permissions
+ * in `AndroidManifest.xml`
+ */
 object ContactPermission : Permission {
     override val delegate get() = contactsDelegate
 }
 
+/**
+ * Permission to read contacts
+ *
+ * On Android, declare `READ_CONTACTS` permission in `AndroidManifest.xml`
+ *
+ * On iOS this permission is the same with [ContactPermission]
+ */
+object ReadContactPermission : Permission {
+    override val delegate get() = readContactsDelegate
+}
+
 val Permission.Companion.CONTACTS get() = ContactPermission
+val Permission.Companion.READ_CONTACTS get() = ReadContactPermission

permissions-contacts/src/iosMain/kotlin/dev/icerock/moko/permissions/contacts/ContactsPermission.ios.kt

@@ -70,9 +70,10 @@ private class ContactsPermissionDelegate(
     }
 }
 
-// declared as constant because at now we use kotlin 1.9.10 that not know about 
+// declared as constant because at now we use kotlin 1.9.10 that not know about
 // platform.Contacts.CNAuthorizationStatusLimited
 @Suppress("TopLevelPropertyNaming")
 private const val CNAuthorizationStatusLimited: Long = 4
 
 actual val contactsDelegate: PermissionDelegate = ContactsPermissionDelegate(ContactPermission)
+actual val readContactsDelegate: PermissionDelegate = ContactsPermissionDelegate(ReadContactPermission)

permissions-gallery/src/iosMain/kotlin/dev/icerock/moko/permissions/gallery/GalleryPermissionDelegate.kt

@@ -49,9 +49,11 @@ internal class GalleryPermissionDelegate : PermissionDelegate {
 }
 
 private fun requestGalleryAccess(callback: (PHAuthorizationStatus) -> Unit) {
-    PHPhotoLibrary.requestAuthorization(mainContinuation { status: PHAuthorizationStatus ->
-        callback(status)
-    })
+    PHPhotoLibrary.requestAuthorization(
+        mainContinuation { status: PHAuthorizationStatus ->
+            callback(status)
+        }
+    )
 }
 
 actual val galleryDelegate: PermissionDelegate = GalleryPermissionDelegate()

permissions-location/src/iosMain/kotlin/dev/icerock/moko/permissions/location/LocationManagerDelegate.kt

@@ -8,7 +8,10 @@ import platform.CoreLocation.CLAuthorizationStatus
 import platform.CoreLocation.CLLocationManager
 import platform.CoreLocation.CLLocationManagerDelegateProtocol
 import platform.darwin.NSObject
+import kotlin.experimental.ExperimentalObjCName
 
+@OptIn(ExperimentalObjCName::class)
+@ObjCName("LocationManagerDelegate")
 internal class LocationManagerDelegate : NSObject(), CLLocationManagerDelegateProtocol {
     private var callback: ((CLAuthorizationStatus) -> Unit)? = null
 
@@ -18,17 +21,25 @@ internal class LocationManagerDelegate : NSObject(), CLLocationManagerDelegatePr
         locationManager.delegate = this
     }
 
-    fun requestLocationAccess(callback: (CLAuthorizationStatus) -> Unit) {
+    fun authorizationStatus(): CLAuthorizationStatus {
+        return locationManager.authorizationStatus
+    }
+
+    fun requestWhenInUseAuthorization(callback: (CLAuthorizationStatus) -> Unit) {
         this.callback = callback
 
         locationManager.requestWhenInUseAuthorization()
     }
 
-    override fun locationManager(
-        manager: CLLocationManager,
-        didChangeAuthorizationStatus: CLAuthorizationStatus
-    ) {
-        callback?.invoke(didChangeAuthorizationStatus)
+    fun requestAlwaysAuthorization(callback: (CLAuthorizationStatus) -> Unit) {
+        this.callback = callback
+
+        locationManager.requestAlwaysAuthorization()
+    }
+
+    override fun locationManagerDidChangeAuthorization(manager: CLLocationManager) {
+        val authorizationStatus: CLAuthorizationStatus = manager.authorizationStatus
+        callback?.invoke(authorizationStatus)
         callback = null
     }
 }