device-manager-kmp

0.0.1indexed

Unified API for runtime permission management and device information, offering asynchronous, coroutine-friendly permission requests/status (single or batch), rationale handling, and location monitoring with live-tracking and state updates.

AndroidNative·big-gates/device-manager-kmp

Stars

—

Used by

dependents

—

Health

/ 100

Device Manager KMP

Kotlin Multiplatform 라이브러리로 Android와 iOS에서 권한 관리와 디바이스 정보를 통합된 API로 제공합니다.

직관적이고 간결한 API를 제공합니다.

Module	Version
devicemanager-permission	0.0.1
devicemanager-device	0.0.1

Features

Permission Module - 런타임 권한 요청 및 상태 확인
Device Module - 위치 모니터링 및 디바이스 정보
Kotlin Multiplatform - Android & iOS 지원
Coroutines - suspend 함수 기반의 비동기 API

Installation

Gradle (Kotlin DSL)

// build.gradle.kts
dependencies {
    // Permission 모듈만 사용
    implementation("io.github.big-gates:devicemanager-permission:0.0.1")

    // Device 모듈 사용 (Permission 모듈 포함)
    implementation("io.github.big-gates:devicemanager-device:0.0.1")
}

Version Catalog

# libs.versions.toml
[versions]
devicemanager = "0.0.1"

[libraries]
devicemanager-permission = { module = "io.github.big-gates:devicemanager-permission", version.ref = "devicemanager" }
devicemanager-device = { module = "io.github.big-gates:devicemanager-device", version.ref = "devicemanager" }

Quick Start

1. 초기화 (Android Only)

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

        // PermissionHandler 초기화 (필수)
        PermissionHandler.init(this)
    }
}

2. 권한 요청

// 단일 권한 요청
val status = Permission.Camera.request()

when (status) {
    PermissionStatus.Granted -> {
        // 권한 허용됨 - 기능 사용 가능
    }
    PermissionStatus.Denied -> {
        // 권한 거부됨 - 다시 요청 가능
    }
    PermissionStatus.PermanentlyDenied -> {
        // 영구 거부됨 - 설정에서 변경 필요
        openAppSettings()
    }
    else -> { }
}

3. 권한 상태 확인

// 현재 권한 상태 확인
val status = Permission.Location.status()

if (status.isGranted) {
    // 권한이 허용된 상태
}

Permission Module

Supported Permissions

Permission Status

API Reference

Usage Examples

단일 권한 요청

lifecycleScope.launch {
    val status = Permission.Camera.request()

    if (status.isGranted) {
        openCamera()
    }
}

여러 권한 동시 요청

lifecycleScope.launch {
    val results = listOf(
        Permission.Camera,
        Permission.Microphone
    ).request()

    val allGranted = results.all { it.value.isGranted }

    if (allGranted) {
        startVideoRecording()
    }
}

권한 상태에 따른 UI 분기

@Composable
fun CameraScreen() {
    var permissionStatus by remember { mutableStateOf<PermissionStatus?>(null) }

    LaunchedEffect(Unit) {
        permissionStatus = Permission.Camera.status()
    }

    when (permissionStatus) {
        PermissionStatus.Granted -> {
            CameraPreview()
        }
        PermissionStatus.PermanentlyDenied -> {
            SettingsPrompt(
                onOpenSettings = {
                    coroutineScope.launch { openAppSettings() }
                }
            )
        }
        else -> {
            RequestPermissionButton(
                onClick = {
                    coroutineScope.launch {
                        permissionStatus = Permission.Camera.request()
                    }
                }
            )
        }
    }
}

Device Module

Device 모듈은 Permission 모듈을 포함하며, 위치 모니터링 등 디바이스 기능을 제공합니다.

Location Monitor

// LocationMonitor 생성
val locationMonitor = AndroidLocationMonitor(context) // Android
val locationMonitor = IosLocationMonitor()            // iOS

// 위치 업데이트 시작 (권한 필요)
locationMonitor.start()

// 위치 상태 구독
locationMonitor.state.collect { location ->
    location?.let {
        println("위도: ${it.latitude}, 경도: ${it.longitude}")
    }
}

// 실시간 추적 모드 전환
locationMonitor.enableLiveTracking(true)

// 중지
locationMonitor.stop()

Note: start() 및 enableLiveTracking() 호출 전에 위치 권한이 필요합니다. 권한이 없으면 IllegalStateException이 발생합니다.

// 권한 확인 후 사용
if (Permission.Location.isGranted()) {
    locationMonitor.start()
} else {
    val status = Permission.Location.request()
    if (status.isGranted) {
        locationMonitor.start()
    }
}

Platform Setup

Android

AndroidManifest.xml에 필요한 권한을 선언하세요:

iOS

Info.plist에 필요한 Usage Description을 추가하세요:

Requirements

Kotlin: 1.9.0+
Android: minSdk 24+
iOS: 14.0+

License

Copyright 2025 Big Gates

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http:

Unless   applicable law  agreed to  writing, software
distributed under the License  distributed  an  BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express  implied.
See the License  the specific language governing permissions 
limitations under the License.

Related libraries

Surfaced from shared tags and platforms — no rankings paid for.

kaluga★ 397

splendoOffers modular tools for cross-platform mobile app development, including features like MVVM architecture, location services, permissions management, Bluetooth communication, and more, using coroutines and `Flow` for efficient design.Shared: kotlin-coroutines, device, apple

TextToSpeechKt★ 57

Marc-JBCross-platform text-to-speech library enabling speech synthesis with coroutine support. Features include volume, pitch, and rate adjustments, with Compose integration for enhanced functionality.Shared: kotlin-native, kotlin-coroutines, apple

KmpEssentials★ 359

Ares-Defence-LabsLightweight library simplifies development with APIs for battery management, file system operations, and package information retrieval, supporting integration with multiple platforms and providing Swift package availability.Shared: device, apple

KScan★ 336

ismai117Enables easy barcode scanning in apps using Google’s MLKit on Android and Apple's AVFoundation on iOS, supporting QR and EAN-13 formats with simple integration.Shared: device, apple

SimpleMVI★ 224

artttttLightweight MVI library enables structured state management with unidirectional data flow, type safety, coroutine support, and clear separation between UI and domain logic.Shared: kotlin-coroutines, apple

konnection★ 170

TM-AppsLibrary emits network connection status, offers immediate connection state checks, IP info retrieval, and network state observation. Supports customizable instance creation and includes default IP resolvers.Shared: kotlin-coroutines, apple

`Permission.Location`	ACCESS_FINE_LOCATION, ACCESS_COARSE_LOCATION	locationWhenInUseAuthorization
`Permission.LocationAlways`	ACCESS_BACKGROUND_LOCATION (Q+)	locationAlwaysAuthorization
`Permission.Camera`	CAMERA	AVCaptureDevice
`Permission.Microphone`	RECORD_AUDIO	AVAudioSession
`Permission.Notification`	POST_NOTIFICATIONS (13+)	UNUserNotificationCenter
`Permission.Storage`	READ_MEDIA_* (13+) / READ_EXTERNAL_STORAGE	N/A (Sandbox)
`Permission.Photos`	READ_MEDIA_IMAGES, READ_MEDIA_VIDEO	PHPhotoLibrary
`Permission.Bluetooth`	BLUETOOTH_SCAN, BLUETOOTH_CONNECT (S+)	CBCentralManager
`Permission.Contacts`	READ_CONTACTS, WRITE_CONTACTS	CNContactStore
`Permission.Calendar`	READ_CALENDAR, WRITE_CALENDAR	EKEventStore

`Granted`	권한이 허용됨
`Denied`	권한이 거부됨 (다시 요청 가능)
`PermanentlyDenied`	영구 거부됨 (설정에서만 변경 가능)
`Restricted`	기기 정책에 의해 제한됨 (iOS)
`Limited`	제한된 접근 허용 (iOS 14+ Photos)
`NotDetermined`	아직 결정되지 않음