Runtime Permissions

KAppMaker ships a small, app-level permissions API backed by Calf. It shows real system permission dialogs on Android and iOS, and acts as a granted no-op on desktop and web — so shared code never needs platform checks.

Using a permission

Each common permission has a ready-made helper composable:

@Composable
fun MyScreen() {
    val cameraPermission = rememberCameraPermissionState { granted ->
        // called with the result after request()
    }

    when {
        cameraPermission.isGranted -> CameraPreview()
        cameraPermission.shouldShowRationale -> RationaleCard(
            onAllow = { cameraPermission.openSettings() },
        )
        else -> Button(onClick = { cameraPermission.request() }) {
            Text("Enable camera")
        }
    }
}

Available helpers (in util/permissions/AppPermissionState.kt):

Helper	Permission	iOS Info.plist key
rememberNotificationPermissionState()	Notifications (Android 13+ / iOS)	—
rememberCameraPermissionState()	Camera	NSCameraUsageDescription
rememberGalleryPermissionState()	Photo gallery	NSPhotoLibraryUsageDescription
rememberLocationPermissionState()	Precise location	NSLocationWhenInUseUsageDescription
rememberMicrophonePermissionState()	Microphone	NSMicrophoneUsageDescription

Ask on screen entry

For permissions that should be requested as soon as a screen appears (e.g. notifications on the home screen):

RequestPermissionOnEntry(rememberNotificationPermissionState())

This skips the request if the permission is already granted, or if the user previously denied it (prompting again unasked is hostile UX — show a rationale UI with a button instead).

Any other permission

Every other Calf permission works through the same wrapper:

val bluetooth = rememberAppPermissionState(Permission.Bluetooth)

Add the matching iOS usage-description key to iosApp/iosApp/Info.plist, and the Android <uses-permission> entry to androidApp/src/main/AndroidManifest.xml if the permission requires one.