runtime_permission_handler

Lightweight runtime permission handler with simple callback API, multiple and sequential requests, permanent-denial detection, location/background permission support, and Compose-ready integration.

#utility
#device
#compose-multiplatform
#compose
#apple

Suggest an edit

Android JVMKotlin/Native

GitHub stars0

Authorsoooplatform

Open issues0

LicenseMIT License

Creation date8 days ago

Last activity7 days ago

Latest release1.0.0 (5 days ago)

GitHub repository Wiki page

Runtime Permission Handler

Simple and lightweight runtime permission handling library for Kotlin Multiplatform Mobile (KMM).

✨ Features

✅ Kotlin Multiplatform support
✅ Android & iOS
✅ Compose Multiplatform ready
✅ Simple callback API
✅ Multiple permission requests
✅ Permanent denial detection
✅ Location permissions support
✅ Lightweight and easy to integrate

📦 Installation

Gradle

dependencies {
    
}

Supported Permissions

Permission	Android	iOS
Camera	✅	✅
Gallery	✅	✅
Microphone	✅	✅
PostNotifications	✅	✅
GeolocationOnAppUsing	✅	✅
GeolocationAlways	✅	✅
ReadContacts	✅	✅
WriteContacts	✅	✅
ReadExternalStorage	✅	✅
WriteExternalStorage	✅	✅

🚀 How to use

On Andriod

Initialize PermissionHandler object on MainActivity or Application

class MainActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        PermissionHandler.start(this)
        super.onCreate(savedInstanceState)

        setContent {
            App()
        }
    }
}

<uses-permission android:name="android.permission.CAMERA" />

On iOS

<key>NSCameraUsageDescription</key>
<string>We want to access the camera to take photos.</string>

Compose Multiplatform Example

Check or request single permission

PermissionHandler.requestSingle(
    Permission.Camera
) { granted ->

    if (granted) {
        // Permission granted your code for start camera, and take photo
    } else {
        // Permission denied
    }
}

Check or request multiple permissions.

PermissionHandler.requestMultiple(
    Permission.Camera,
    Permission.Microphone
) { grantedMap ->

    val cameraGranted = grantedMap[Permission.Camera]
    val microphoneGranted = grantedMap[Permission.Microphone]
}

Check or request multiple permissions in a specific order.

PermissionHandler.requestMultiplySequential(
    Permission.GeolocationOnAppUsing,
    Permission.GeolocationAlways
) { grantedMap -> // Requests background location sequentially after obtaining "While Using the App" permission

  val backgroundGeolocation = grantedMap.all { (permission, granted) -> granted }

  if (backgroundGeolocation) {
    // Granted background geolocation start service
  } else {
    // Permission denied
  }
}