DocumentsUI 모듈은 문서 권한(예: 이메일 파일 첨부)을 처리하는 구성요소와 관련된 특정 파일에 액세스하는 권한을 제어합니다. 이 모듈은 업데이트할 수 있습니다. 즉, 일반적인 Android 출시 주기 외에도 기능 업데이트를 받을 수 있습니다.
저장소 액세스 및 권한을 모듈로 만들면 최종 사용자의 개인 정보 보호 및 보안 수준이 강화되는 동시에 Android 파트너가 런타임 리소스 오버레이(RRO)를 통해 앱의 기능 및 테마를 맞춤설정할 수 있습니다. 모듈 형식은 모든 기기가 동일한 DocumentsUI 환경으로 제공되도록 함으로써 사용자가 어떤 관련 API를 찾는지 개발자가 알 수 있게 해줍니다.
DocumentsUI 모듈은 다음 작업을 처리합니다.
안정적인 @SystemApi API를 통해서만 프레임워크와 상호작용합니다(@hide API 사용 없음).
Android 파트너가 기능과 테마를 맞춤설정할 수 있도록 하는 메커니즘을 노출합니다.
서명 권한을 사용하여 MANAGE_DOCUMENTS 권한을 보호합니다.
파일 런처 아이콘 표시
Android 10에서는 DocumentsUI 모듈이 is_launcher_enabled를 사용하여 앱 검색 창에 파일 런처 아이콘을 표시해야 하는지 확인합니다. Android 11 이상에서 이 모듈은 component-override 패키지를 사용하여 앱 검색 창에 파일 런처 아이콘이 표시되는지 확인합니다.
기본적으로 아이콘은 사용 설정되어 있습니다. 사용 중지하려면 다음 XML을 /etc/sysconfig에 추가합니다.
DocumentsUI 모듈은 GET_CONTENT 작업을 구현합니다. 이 작업을 통해 앱은 사용자의 다른 데이터에 관한 액세스를 요청할 수 있습니다.
모듈 형식
DocumentsUI 모듈(com.android.documentsui)은 APK 파일로 제공되며 Android 10 이상을 실행하는 기기에서 사용할 수 있습니다.
모듈 종속 항목
이 DocumentsUI 모듈은 서명 권한에 의해 보호되는 MANAGE_DOCUMENTS 권한에 종속됩니다. 추가 권한 클래스는 기기에서 하나의 앱만 MANAGE_DOCUMENTS 권한을 보유하도록 합니다.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-07-27(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-07-27(UTC)"],[],[],null,["# DocumentsUI\n\n| **Important:** Starting in Android 12, file browsing through DocumentsUI is disabled.\n\nThe DocumentsUI module controls access to specific files for components that\nhandle document permissions (such as attaching a file to an email). This module\nis updatable, meaning it can receive updates to functionality outside of the\nnormal Android release cycle.\n\nMaking storage access and permissions into a module increases privacy and\nsecurity for end users while allowing Android partners to customize the features\nand theming of the app through [runtime resource overlays\n(RROs)](/docs/core/architecture/rros). The module format ensures that all\ndevices ship with the same DocumentsUI experience, enabling developers to know\nwhat users see for associated APIs.\n\nThe DocumentsUI module handles the following actions.\n\n- Interacts with the framework only through stable `@SystemApi` APIs (no\n `@hide` API usage).\n\n- Exposes a mechanism for enabling Android partners to customize features and\n theming.\n\n- Protects the `MANAGE_DOCUMENTS` permission using a signature permission.\n\nDisplay Files launcher icon\n---------------------------\n\nIn Android 10, the DocumentsUI module uses `is_launcher_enabled` to determine if\nthe Files launcher icon should display in the app drawer. In Android\n11 or higher, the module uses the `component-override`\npackage to determine if the Files launcher icon displays in the app drawer.\n\nBy default, the icon is enabled. To disable it, add the following XML to\n`/etc/sysconfig`. \n\n \u003c?xml version=\"1.0\" encoding=\"utf-8\"?\u003e\n \u003cconfig\u003e\n \u003ccomponent-override package=\"com.android.documentsui\" \u003e\n \u003ccomponent class=\"com.android.documentsui.LauncherActivity\" enabled=\"false\" /\u003e\n \u003c/component-override\u003e\n \u003c/config\u003e\n\nRequest user data\n-----------------\n\nThe DocumentsUI module implements the `GET_CONTENT` action that enables apps to\nrequest access to other data from the user.\n\nModule format\n-------------\n\nThe DocumentsUI module (`com.android.documentsui`) is delivered as an\nAPK file and is available for devices running Android\n10 or higher.\n\nModule dependencies\n-------------------\n\nThis DocumentsUI module depends on the `MANAGE_DOCUMENTS` permission protected\nby the signature permission; an additional permission class ensures that only\none app on the device has the `MANAGE_DOCUMENTS` permission."]]