Das DocumentsUI-Modul steuert den Zugriff auf bestimmte Dateien für Komponenten, die Dokumentberechtigungen verarbeiten (z. B. das Anhängen einer Datei an eine E-Mail). Dieses Modul kann aktualisiert werden, d. h. es kann Funktionsupdates außerhalb des normalen Android-Releasezyklus erhalten.
Die Umwandlung von Speicherzugriff und Berechtigungen in ein Modul erhöht den Datenschutz und die Sicherheit für Endnutzer und ermöglicht es Android-Partnern, die Funktionen und das Thema der App über Laufzeitressourcen-Overlays (Laufzeitressourcen-Overlays, RROs) anzupassen. Das Modulformat sorgt dafür, dass alle Geräte mit derselben DocumentsUI ausgeliefert werden. So können Entwickler genau sehen, was Nutzer für die zugehörigen APIs sehen.
Das DocumentsUI-Modul verarbeitet die folgenden Aktionen.
Interagiert nur über stabile
@SystemApi
APIs mit dem Framework (keine@hide
API-Nutzung).Bietet einen Mechanismus, mit dem Android-Partner Funktionen und Designs anpassen können.
Schützt die Berechtigung
MANAGE_DOCUMENTS
mit einer Signaturberechtigung.
Launcher-Symbol für „Dateien“ anzeigen
In Android 10 verwendet das DocumentsUI-Modul is_launcher_enabled
, um zu bestimmen, ob das Symbol für den Dateien-Launcher im App-Drawer angezeigt werden soll. Unter Android 11 oder höher verwendet das Modul das component-override
-Paket, um zu ermitteln, ob das Symbol für den Dateimanager im App-Schublade angezeigt wird.
Das Symbol ist standardmäßig aktiviert. Wenn Sie die Funktion deaktivieren möchten, fügen Sie /etc/sysconfig
die folgende XML-Datei hinzu.
<?xml version="1.0" encoding="utf-8"?>
<config>
<component-override package="com.android.documentsui" >
<component class="com.android.documentsui.LauncherActivity" enabled="false" />
</component-override>
</config>
Nutzerdaten anfordern
Das DocumentsUI-Modul implementiert die Aktion GET_CONTENT
, mit der Apps vom Nutzer Zugriff auf andere Daten anfordern können.
Modulformat
Das DocumentsUI-Modul (com.android.documentsui
) wird als APK-Datei bereitgestellt und ist für Geräte mit Android 10 oder höher verfügbar.
Modulabhängigkeiten
Dieses DocumentsUI-Modul hängt von der Berechtigung MANAGE_DOCUMENTS
ab, die durch die Signaturberechtigung geschützt ist. Eine zusätzliche Berechtigungsklasse sorgt dafür, dass nur eine App auf dem Gerät die Berechtigung MANAGE_DOCUMENTS
hat.