[Android] 런타임 권한(runtime permissions) 처리

🍋‍🟩 런타임 권한(Runtime Permissions)

안드로이드 6.0(API 23) 이상에서는 런타임 권한(Runtime Permission) 또는 위험 권한(Dangerous Permission)이라는 개념이 도입되었습니다.

 

🍋‍🟩 런타임 권한이란?

런타임 권한은 앱이 제한된 데이터에 접근하거나, 시스템 및 다른 앱에 영향을 줄 수 있는 동작을 수행할 때 반드시 요청해야 하는 권한입니다.
설치 시 자동으로 부여되지 않으며, 앱 실행 중 실제로 필요할 때 팝업 다이얼로그로 요청됩니다.
즉, 개발자는 권한이 이미 부여되어 있다고 가정해서는 안되며, 기능 실행 전마다 권한을 확인하고 필요 시 요청해야 합니다.

앱에서 런타임 권한을 요청 시 표시되는 시스템 권한 메시지

 

🍋‍🟩 위험 권한 예시

런타임 권한 대부분은 민감한 사용자 데이터와 관련이 있습니다.

• 위치 정보 (Location)
• 연락처 (Contacts)
• 마이크 (Microphone)
• 카메라 (Camera)

이 중 특히 마이크와 카메라는 사생활과 직접적으로 연결된 매우 민감한 정보에 접근할 수 있기 때문에, 안드로이드는 앱이 해당 권한을 요청할 때 사용자에게 권한이 필요한 이유를 설명할 수 있도록 지원합니다.

 

🍋‍🟩 시스템 보호 수준

안드로이드는 런타임 권한을 dangerous(위험)보호 수준으로 분류합니다.

• Normal 권한 → 자동 부여 (예: 인터넷 접근)
• Dangerous 권한 → 런타임에 사용자 동의 필요 (예: 위치, 카메라 등)

 

🍋‍🟩 권한 처리 가이드

1. 권한 선언 및 확인

권한을 요청하기 전에 AndroidManifest.xml에 해당 권한을 선언해야 합니다.

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

런타임 시에는 사용자가 실제로 해당 기능을 사용할 때만 권한을 요청하는 것이 바람직하며 요청 전에는 반드시 ContextCompat.checkSelfPermission()을 통해 권한이 이미 부여되었는지 확인해야 합니다.

• 허용됨 → 기능 실행
• 허용되지 않음 → 권한 요청 진행

// 권한 확인 및 요청
fun checkAndRequestPermission() {
    when {
        // 이미 권한 있음
        ContextCompat.checkSelfPermission(
            this, Manifest.permission.CAMERA
        ) == PackageManager.PERMISSION_GRANTED -> {
            startCamera()
        }

        // 권한이 필요한 이유 설명
        shouldShowRequestPermissionRationale(Manifest.permission.CAMERA) -> {
            showPermissionExplanationDialog {
                requestPermissionLauncher.launch(Manifest.permission.CAMERA)
            }
        }

        // 권한 요청
        else -> {
            requestPermissionLauncher.launch(Manifest.permission.CAMERA)
        }
    }
}

2. 권한 요청하기

안드로이드에서 권장하는 최신 방식은 ActivityResultLauncher API 를 활용하는 것입니다.
시스템이 자동으로 권한 다이얼로그를 띄워주고, 사용자는 허용/거부를 선택할 수 있습니다. 결과는 콜백으로 간단히 처리할 수 있어 코드가 깔끔해집니다.

// 권한 요청 런처 등록
private val requestPermissionLauncher =
    registerForActivityResult(ActivityResultContracts.RequestPermission()) { isGranted: Boolean ->
        if (isGranted) {
            // 권한 허용됨 → 기능 실행
        } else {
            // 권한 거부됨 → 사용자 안내
        }
    }

3. 권한 요청 근거 제공하기

경우에 따라 시스템은 shouldShowRequestPermissionRationale()을 true로 반환할 수 있습니다. 이때는 권한 요청 전, 사용자에게 해당 기능에 권한이 왜 필요한지 UI로 설명해야 합니다. 이렇게 하면 사용자가 권한의 필요성을 이해하여 권한 허용 가능성을 높일 수 있습니다.

4. 권한 거부 처리하기

사용자가 권한을 여러 번 거부하면, 안드로이드는 이를 영구 거부로 간주합니다. 이 경우 앱은 더 이상 권한 요청 다이얼로그를 띄울 수 없으며, 앱은 사용자에게 기능 제한을 명확히 안내하고 필요한 경우 시스템 설정 화면으로 이동하도록 유도해야 합니다.

Android에서 권한을 사용하는 대략적인 워크플로

[앱 실행]
    │
    ▼
[권한 선언 확인 (Manifest)]
    │
    ▼
[권한 확인]
 ┌───────────────┬────────────────────────┐
 │               │                        │
 ▼               ▼                        ▼
이미 허용됨   설명 필요(true)           권한 없음
(바로 실행)   → 근거 표시 후 요청       → 권한 요청
 │
 ▼
사용자 응답
 ┌───────────────┬────────────────────────┐
 │               │                        │
 ▼               ▼                        ▼
허용됨        거부됨                  영구 거부됨
기능 실행    → 안내 메시지           → 설정 화면 유도

 

 

🔗 참고

• Manifest Interview Android
• https://developer.android.com/guide/topics/permissions/overview?hl=ko#runtime