KappS 지식 베이스 · FAQ

Google Play의 MANAGE_EXTERNAL_STORAGE(모든 파일 접근) 정책

FAQ 권한 및 API

1. 정책의 실제 내용. Google Play은 모든 파일 액세스를 고위험 특수 앱 액세스로 취급합니다. "Google Play은 모든 파일 액세스라는 특수 앱 액세스를 포함한 고위험 또는 민감한 권한의 사용을 제한합니다. 이는 Android 11(API 레벨 30)을 타깃으로 하며 Android 11에 추가된 MANAGE_EXTERNAL_STORAGE 권한을 선언하는 앱에만 적용됩니다. 또한 이 정책은 READ_EXTERNAL_STORAGE 권한의 사용에는 영향을 미치지 않습니다." (https://support.google.com/googleplay/android-developer/answer/10467955)

2. 필요하지 않다면 매니페스트에서 제거해야 합니다. 권한 관련 심사 거절에서 가장 흔한 해결책이 바로 이것입니다. "앱에서 MANAGE_EXTERNAL_STORAGE 권한에 대한 접근이 필요하지 않은 경우, 정책 심사 요구사항을 성공적으로 충족하려면 앱 매니페스트에서 해당 권한을 제거해야 합니다. 정책을 준수하는 대체 구현에 대한 자세한 내용도 아래에 나열되어 있습니다." (https://support.google.com/googleplay/android-developer/answer/10467955)

3. 정말 필요하다면 신고는 의무이며, 이를 건너뛰는 것 자체가 위반입니다. "앱이 허용되는 사용에 관한 정책 요건을 충족하거나 예외 대상에 해당한다면, Play Console의 권한 신고 양식을 통해 이 권한과 다른 고위험 권한을 신고해야 합니다." 그리고 "정책 요건을 충족하지 못하거나 권한 신고 양식을 제출하지 않은 앱은 Google Play에서 삭제될 수 있습니다." (https://support.google.com/googleplay/android-developer/answer/10467955)

4. 기준은 "실질적인 대안이 없을 것"이지 "편리할 것"이 아닙니다. "앱이 Storage Access Framework나 MediaStore API처럼 개인정보 보호에 더 적합한 모범 사례를 효과적으로 활용할 수 없을 때만 모든 파일 접근 권한에 접근해야 합니다. 앱이 필요로 하거나 사용하지 않는 권한을 선언해서는 안 된다는 점을 명심하세요." (https://support.google.com/googleplay/android-developer/answer/10467955)

5. 핵심 기능은 Google이 정의하며, 스토어 등록정보에 반드시 드러나야 합니다. "또한 앱의 권한 사용은 허용된 용도에 부합해야 하고 앱의 핵심 기능과 직접 연결되어야 합니다. 핵심 기능은 앱의 주된 목적으로 정의됩니다. 이 핵심 기능이 없으면 앱은 '고장 난' 상태이거나 사용할 수 없게 됩니다. 핵심 기능과 이를 구성하는 모든 핵심 요소는 앱 설명에 모두 명확하게 문서화되고 홍보되어야 합니다." "앱의 핵심 기능에 모든 파일 접근 권한이 필요한 경우, 개발자는 권한 신고 양식을 작성해 Google Play의 승인을 받아야 합니다." (https://support.google.com/googleplay/android-developer/answer/10467955)

6. 허용되는 사용 목록과 그 옆의 별표. "모든 파일 접근 권한에 대한 액세스를 요청하는 앱의 경우, 의도되고 허용되는 사용에는 파일 관리자, 백업 및 복원 앱, 바이러스 백신 앱, 문서 관리 앱이 포함됩니다." 정책 표에는 다음과 같이 추가되어 있습니다. 파일 관리("앱의 핵심 목적이 앱 전용 저장 공간 외부의 파일과 폴더에 대한 접근, 편집, 관리(유지 관리 포함)를 포함하는 경우"), 백업 및 복원("백업 및 복원을 목적으로 앱 전용 저장 공간 외부의 여러 디렉터리에 자동으로 접근해야 하는 경우"), 바이러스 백신("앱의 핵심 목적이 기기를 검사하고 기기 사용자에게 바이러스 백신 보안 기능을 제공하는 경우"), 문서 관리("앱 전용 또는 공유 저장 공간 외부에서 호환되는 파일 유형을 찾고, 접근하고, 편집해야 하는 앱"), 기기 내 검색, 디스크/폴더 암호화 및 잠금, 기기 이관/휴대폰 전송이 있습니다. 모든 행에는 각주 "* Google Play 심사 및 승인 대상"이 붙어 있으며, "이 권한에 대한 액세스가 승인된 앱은 공개되지 않았거나 유효하지 않은 목적으로 사용을 확장할 수 없습니다." (https://support.google.com/googleplay/android-developer/answer/10467955)

7. 임시 예외가 인정되는 경우. "Google Play는 위에 명시된 허용 사용 사례에 해당하지 않는 앱에 대해 다음과 같은 경우 임시 예외를 제공할 수 있습니다. 해당 권한의 사용이 앱의 핵심 기능을 가능하게 하는 경우. 현재 핵심 기능을 제공할 대체 방법이 없거나, 개인정보 친화적 대안(예: MediaStore API 또는 Storage Access Framework)을 사용하면 핵심 기능과 연결된 앱의 중요 기능에 상당한 악영향이 발생하는 경우. 사용자 개인정보에 미치는 영향이 보안 및 개인정보 보호 모범 사례를 통해 완화되는 경우." 마지막 조건은 개발자의 몫입니다. "개발자는 Storage Access Framework 또는 MediaStore API가 앱의 목적에 충분하지 않은 이유를 Console 신고에서 입증해야 합니다." (https://support.google.com/googleplay/android-developer/answer/10467955)

8. Google가 이미 배제한 사례. "다음은 MANAGE_EXTERNAL_STORAGE 권한을 요청할 수 없는 일반적인 사용 사례 목록입니다. 미디어 파일 접근(아래 대안 참조), 사용자가 개별 파일을 직접 선택하는 모든 파일 선택 활동(아래 대안 참조)." 이 목록은 예시일 뿐입니다. "이 목록은 전체가 아닙니다. 자세한 지침은 모든 파일 접근 문서와 개발자를 위한 범위 지정 저장소 모범 사례 지침을 참조하십시오." (https://support.google.com/googleplay/android-developer/answer/10467955)

9. 두 가지 대체 방식, 그리고 그것으로 대개 충분한 이유. 미디어의 경우 "MediaStore API를 사용하면 앱이 모든 파일 접근 권한 없이도 외부 저장소 볼륨에서 사용 가능한 미디어에 기여하고 접근할 수 있습니다. MediaStore API를 사용하면 사용자가 미디어 파일을 손쉽게 검색하고 업데이트할 수 있습니다. 이러한 파일은 앱을 삭제한 후에도 사용자 기기의 외부 저장소 볼륨에 그대로 남습니다." 사용자가 선택한 파일의 경우 "개발자는 공유 저장소의 파일에 접근하는 개인정보 친화적 옵션으로 Storage Access Framework 사용을 고려해야 합니다. 이 프레임워크는 앱이 모든 범위의 기능을 수행하는 데 필요한 대다수 사용 사례를 지원합니다." SAF는 세 가지 중 런타임 권한이 전혀 필요 없는 유일한 방식이기도 합니다. "사용자가 앱이 접근할 수 있는 파일이나 디렉터리를 선택하는 과정에 참여하므로 이 메커니즘은 시스템 권한이 필요 없으며, 사용자 제어와 개인정보 보호가 강화됩니다." (https://support.google.com/googleplay/android-developer/answer/10467955 / https://developer.android.com/training/data-storage/shared/documents-files)

10. 권한을 요청하는 방법과, 권한이 실제로 여는 범위. "앱은 다음과 같이 사용자에게 모든 파일 접근 권한을 요청할 수 있습니다. 매니페스트에 MANAGE_EXTERNAL_STORAGE 권한을 선언합니다. ACTION_MANAGE_ALL_FILES_ACCESS_PERMISSION 인텐트 액션을 사용해 사용자를 시스템 설정 페이지로 안내합니다... 앱에 MANAGE_EXTERNAL_STORAGE 권한이 부여되었는지 확인하려면 Environment.isExternalStorageManager()를 호출합니다." 권한이 부여되면 "공유 저장 공간 내 모든 파일에 대한 읽기 및 쓰기 액세스"("/sdcard/Android/media 디렉터리는 공유 저장 공간의 일부입니다"), "MediaStore.Files 테이블 콘텐츠에 대한 액세스", "USB OTG(on-the-go) 드라이브와 SD 카드 양쪽의 루트 디렉터리에 대한 액세스", "/Android/data/, /sdcard/Android, 그리고 /sdcard/Android의 대부분 하위 디렉터리를 제외한 모든 내부 저장 공간 디렉터리에 대한 쓰기 액세스"가 제공됩니다. 그래도 다른 앱에는 접근할 수 없습니다. "이 권한이 부여된 앱도 다른 앱에 속한 앱 전용 디렉터리에는 여전히 접근할 수 없습니다. 이러한 디렉터리는 저장 볼륨에서 Android/data/의 하위 디렉터리로 표시되기 때문입니다." (https://developer.android.com/training/data-storage/manage-all-files)

11. 두 가지 메커니즘을 혼동하지 마세요. 권한을 보유하면 SAF가 볼 수 있는 범위가 넓어지는 것이 아니라 좁아집니다. "그러나 저장소 액세스 프레임워크를 사용할 때는 MANAGE_EXTERNAL_STORAGE 권한 없이 접근할 수 있는 파일이나 디렉터리에만 접근할 수 있습니다." 따라서 '혹시 몰라서' 선언한 권한이 이미 작동하던 경로를 오히려 저하시킬 수 있습니다. Android 12(API 31) 이상에서 MANAGE_EXTERNAL_STORAGE와 QUERY_ALL_PACKAGES를 모두 보유한 앱(파일 관리자)은 getManageSpaceActivityIntent()를 사용해 사용자를 다른 앱의 맞춤 저장공간 관리 액티비티로 이동시킬 수 있습니다. (https://developer.android.com/training/data-storage/manage-all-files)

12. 이관 작업 자체: targetSdkVersion을 Android 11로 올리는 순간 requestLegacyExternalStorage는 효력을 잃습니다. "Android 11에서 실행되지만 Android 10(API 레벨 29)을 타깃으로 하는 앱은 여전히 requestLegacyExternalStorage 속성을 요청할 수 있습니다... 앱을 Android 11 타깃으로 업데이트하면 시스템은 requestLegacyExternalStorage 플래그를 무시합니다." 따라서 순서대로 작업하세요. "앱이 레거시 저장소 모델을 사용하고 이전에 Android 10 이하를 타깃으로 했다면, 범위 지정 저장소 모델이 활성화되었을 때 앱이 접근할 수 없는 디렉터리에 데이터를 저장하고 있을 수 있습니다. Android 11을 타깃으로 하기 전에 범위 지정 저장소와 호환되는 디렉터리로 데이터를 이관하세요." 기계적인 변경이 두 가지 더 있습니다. "Android 11부터 앱은 외부 저장소에 자체 앱 전용 디렉터리를 만들 수 없습니다. 시스템이 앱에 제공하는 디렉터리에 접근하려면 getExternalFilesDirs()를 호출하세요." 그리고 테스트하려면 앱별 호환성 플래그에서 범위 지정 저장소 동작을 해제하세요. "DEFAULT_SCOPED_STORAGE(모든 앱에 기본 활성화)"와 "FORCE_ENABLE_SCOPED_STORAGE(모든 앱에 기본 비활성화)"입니다. (https://developer.android.com/about/versions/11/privacy/storage)

13. 사용 방식을 바꾼 뒤에도 권한을 그대로 유지하는 것이 가장 큰 비용을 초래하는 실수입니다. "앱에서 이러한 제한된 권한의 사용 방식을 변경하는 경우, 업데이트되고 정확한 정보로 양식을 다시 제출해야 합니다. 이러한 권한의 기만적이고 신고되지 않은 사용은 앱 정지 및/또는 개발자 계정 해지로 이어질 수 있습니다." 실무적으로 이는 새로운 기능이 광범위한 파일 접근을 건드리기 시작할 때마다 신고를 다시 해야 한다는 뜻이며, 저장소 사용이 일반적인 앱(사용자가 선택한 문서, 사진, 내보내기)의 경우 가장 저렴한 방법은 여전히 매니페스트에서 MANAGE_EXTERNAL_STORAGE를 제거하고 MediaStore + SAF + 포토 피커를 사용하는 것입니다. (https://support.google.com/googleplay/android-developer/answer/10467955)