Photo Library Permission — 기본, 액세스 유형 및 작동 원리

Photo Library Permission 기본

Photo Library Permission은 기기에 저장된 미디어 파일에 대한 앱의 액세스를 제어하는 시스템 권한입니다. 읽기(사진 및 비디오 보기 및 선택)와 쓰기(갤러리에 새 파일 저장)를 모두 포괄합니다. 모바일 플랫폼은 사진에 개인 및 민감한 정보가 포함될 수 있으므로 미디어 라이브러리를 민감한 데이터로 간주합니다.

Android 13(API 33)에서 Google은 단일 READ_EXTERNAL_STORAGE 권한을 세 개로 분할했습니다: READ_MEDIA_IMAGES(사진용), READ_MEDIA_VIDEO(비디오용), READ_MEDIA_AUDIO(오디오용). 이를 통해 사용자는 특정 유형의 미디어 파일에만 액세스 권한을 부여할 수 있습니다. iOS에서는 iOS 14부터 PhotoKit을 통해 사용자가 전체 라이브러리를 여는 대신 특정 사진을 선택하여 액세스할 수 있습니다.

Counterpoint Research(2024)에 따르면, 소셜 네트워크, 커뮤니케이션 및 사진 편집기 카테고리의 모바일 앱 중 70% 이상이 Photo Library Permission을 요청합니다. 동시에 사용자의 32%는 앱이 자신의 사진을 왜 필요로 하는지 이해하지 못할 경우 갤러리 액세스를 거부합니다. Apple과 Google은 전체 액세스를 요청하지 않고 개별 파일을 선택하기 위해 시스템 PhotoPicker를 사용할 것을 권장합니다.

Android에서 갤러리 액세스

Android에서 갤러리 액세스는 Android 13 출시와 함께 크게 변경되었습니다. 단일 READ_EXTERNAL_STORAGE 권한 대신 각 미디어 유형에 대한 세분화된 권한이 도입되어 사용자에게 더 많은 제어권을 제공합니다.

Android 13+ 권한

Android 13부터 사진 액세스에는 READ_MEDIA_IMAGES, 비디오 액세스에는 READ_MEDIA_VIDEO가 사용됩니다. READ_EXTERNAL_STORAGE 권한은 더 이상 미디어 파일에 대한 액세스를 제공하지 않으며 — 공유 저장소에서 비미디어 파일을 읽는 용도로만 유지됩니다. 매니페스트의 선언은 다음과 같습니다:

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

Android 12 이하와의 호환성

Android 12 이하와의 하위 호환성을 위해 READ_EXTERNAL_STORAGE도 선언해야 합니다. 그러나 Android 13은 새로운 세분화된 권한이 있는 경우 이 권한을 자동으로 무시합니다. 새 버전에서 이전 권한을 숨기려면 매니페스트에서 android:maxSdkVersion="32" 속성을 사용하세요. 이렇게 하면 Android 13+를 실행하는 기기에서 중복 요청을 방지할 수 있습니다.

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"
    android:maxSdkVersion="32" />

Kotlin에서 런타임 요청

Android에서 Photo Library Permission에 대한 런타임 요청은 Activity Result API를 통해 수행됩니다. 이미지 액세스 요청 예시:

private val photoPermissionLauncher =
    registerForActivityResult(ActivityResultContracts.RequestPermission()) { granted ->
    if (granted) {
        loadGalleryImages()
    } else {
        showPermissionDenied()
    }
}

fun pickPhoto() {
    val permission = if (Build.version.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
        Manifest.permission.READ_MEDIA_IMAGES
    } else {
        Manifest.permission.READ_EXTERNAL_STORAGE
    }
    if (ContextCompat.checkSelfPermission(this, permission)
        == PackageManager.PERMISSION_GRANTED) {
        loadGalleryImages()
    } else {
        photoPermissionLauncher.launch(permission)
    }
}

iOS에서 갤러리 액세스

iOS에서 갤러리 액세스는 PhotoKit 프레임워크와 Info.plist의 NSPhotoLibraryUsageDescription 및 NSPhotoLibraryAddUsageDescription 키를 통해 관리됩니다. iOS 14부터 사용자는 선택한 사진에만 액세스 권한을 부여할 수 있습니다(Limited Photo Library).

Info.plist 구성

라이브러리에서 사진을 읽으려면 NSPhotoLibraryUsageDescription이 필요하고, 쓰기(사진 저장)에는 NSPhotoLibraryAddUsageDescription이 필요합니다. 앱이 미디어를 저장만 하고 읽지 않는 경우 두 번째 키면 충분합니다.

<key>NSPhotoLibraryUsageDescription</key>
<string>앱이 프로필 이미지를 선택하고 스냅샷을 게시하려면 사진에 액세스해야 합니다.</string>
<key>NSPhotoLibraryAddUsageDescription</key>
<string>앱이 처리된 사진을 갤러리에 저장하려면 액세스가 필요합니다.</string>

Swift에서 요청

iOS에서 사진 액세스 요청은 PHPhotoLibrary.requestAuthorization을 통해 수행됩니다. iOS 14부터 .limited 상태는 사용자가 제한된 사진 세트에 대한 액세스 권한을 부여했음을 나타냅니다.

import PhotosUI

func requestPhotoLibraryAccess() {
    PHPhotoLibrary.requestAuthorization { status in
        DispatchQueue.main.async {
            switch status {
            case .authorized:
                self.loadPhotoLibrary()
            case .limited:
                self.loadSelectedPhotos()
            case .denied, .restricted:
                self.showSettingsAlert()
            case .notDetermined:
                break
            }
        }
    }
}

private func loadPhotoLibrary() {
    let fetchOptions = PHFetchOptions()
    fetchOptions.sortDescriptors = [NSSortDescriptor(key: "creationDate", ascending: false)]
    let assets = PHAsset.fetchAssets(with: .image, options: fetchOptions)
    // 요청 결과 처리
}

제한된 액세스 처리

iOS 14+의 .limited 상태는 사용자가 선택한 몇 장의 사진에만 액세스 권한을 부여했음을 의미합니다. 앱은 PHPhotoLibrary.shared().presentLimitedLibraryPicker를 호출하여 시스템 대화 상자를 통해 확장된 액세스를 요청할 수 있습니다. 이 대화 상자는 사용자가 추가 사진이 필요한 기능을 명시적으로 요청할 때만 표시하는 것이 좋습니다.

PhotoPicker vs 시스템 권한

PhotoPicker는 전체 라이브러리에 액세스할 권한이 필요하지 않은 미디어 파일 선택을 위한 시스템 구성 요소입니다. Android 13 및 iOS 14부터 Google과 Apple은 앱이 하나 또는 몇 장의 사진만 선택하면 되는 경우 Photo Library Permission을 요청하는 대신 PhotoPicker를 사용할 것을 권장합니다.

Android의 PhotoPicker

Android 13+에서 내장된 PhotoPicker(ActivityResultContracts.PickVisualMedia)를 통해 사용자는 전체 갤러리에 대한 액세스 권한을 부여하지 않고 사진이나 비디오를 선택할 수 있습니다. 앱은 선택된 파일의 URI만 받습니다. PhotoPicker는 매니페스트에서 권한을 선언하지 않고 작동합니다.

private val pickMedia =
    registerForActivityResult(ActivityResultContracts.PickVisualMedia()) { uri ->
    if (uri != null) {
        // 선택한 파일의 URI, 전체 라이브러리에 액세스하지 않음
        showImage(uri)
    }
}

fun selectPhoto() {
    pickMedia.launch(PickVisualMediaRequest(ActivityResultContracts.PickVisualMedia.ImageOnly))
}

iOS의 PHPicker

iOS 14+에서 PHPickerViewController가 도입되었습니다 — 전체 라이브러리에 대한 액세스가 필요하지 않은 시스템 피커입니다. PHPicker는 별도의 프로세스에서 실행되며 앱의 라이브러리에 액세스할 수 없습니다. 대부분의 시나리오에서 사진을 선택하는 선호되는 방법입니다.

import PhotosUI

func presentPhotoPicker() {
    var config = PHPickerConfiguration()
    config.selectionLimit = 1
    config.filter = .images

    let picker = PHPickerViewController(configuration: config)
    picker.delegate = self
    present(picker, animated: true)
}

전체 권한이 필요한 경우

PhotoPicker는 앱이 백업, 클라우드 동기화, 갤러리 앱, 파일 관리자와 같은 대량 작업을 위해 전체 라이브러리에 액세스해야 하는 경우 적합하지 않습니다. 이러한 경우 Photo Library Permission을 요청하고 제한된 액세스(Limited)를 처리해야 합니다. iOS의 경우 .limited 상태 처리를 포함하고 사용자에게 액세스를 확장할 수 있는 옵션을 제공해야 합니다.

갤러리 액세스 모범 사례

모범 사례를 따라 Photo Library Permission을 처리하면 거부 횟수를 줄이고 플랫폼의 개인정보 보호 요구 사항을 준수할 수 있습니다.

기본적으로 PhotoPicker 사용

하나 또는 여러 장의 사진을 선택하려면 시스템 PhotoPicker 또는 PHPicker를 사용하세요. 이러한 구성 요소는 권한이 필요하지 않으며 최상의 사용자 경험을 제공합니다. 앱 기능이 전체 미디어 라이브러리에 액세스해야 하는 경우에만 전체 갤러리 액세스를 요청하세요. Google과 Apple은 개발자 문서에서 이 접근 방식을 명시적으로 권장합니다.

전체 액세스 이유 설명

앱이 정말로 전체 갤러리 액세스가 필요한 경우 설명과 함께 사전 화면을 표시하세요. 모든 사진이 필요한 이유를 설명합니다. 예를 들어, 백업 앱은 복사본을 만들기 위해 모든 미디어 파일을 스캔할 것이라고 설명해야 합니다. 사전 권한 화면은 제한된 액세스 메커니즘 때문에 iOS에서 특히 중요합니다.

필요한 권한만 요청

앱이 사진을 저장만 하고 읽지 않는 경우(예: 결과를 저장하는 사진 편집기), 갤러리에 대한 쓰기 권한만 요청하세요. Android에서는 WRITE_EXTERNAL_STORAGE(Android 12 이하의 경우) 또는 권한 없는 MediaStore API(Android 10+의 경우)입니다. iOS에서는 NSPhotoLibraryUsageDescription 없이 NSPhotoLibraryAddUsageDescription을 사용하세요.