MANAGE_EXTERNAL_STORAGE-Richtlinie (Zugriff auf alle Dateien) auf Google Play
1. Was die Richtlinie tatsächlich ist. Google Play behandelt den Zugriff auf alle Dateien als einen hochriskanten speziellen App-Zugriff. „Google Play beschränkt die Nutzung hochriskanker oder sensibler Berechtigungen, einschließlich des speziellen App-Zugriffs namens Zugriff auf alle Dateien. Dies gilt nur für Apps, die auf Android 11 (API-Level 30) abzielen und die Berechtigung MANAGE_EXTERNAL_STORAGE deklarieren, die in Android 11 hinzugefügt wurde. Außerdem betrifft diese Richtlinie nicht die Nutzung der Berechtigung READ_EXTERNAL_STORAGE.“ (https://support.google.com/googleplay/android-developer/answer/10467955)
2. Wenn Sie sie nicht benötigen, müssen Sie sie aus dem Manifest entfernen. Das ist die häufigste Behebung einer berechtigungsbedingten Ablehnung in der App-Prüfung: „If your app does not require access to the MANAGE_EXTERNAL_STORAGE permission, you must remove it from your app's manifest in order to successfully meet the policy review requirements. Details on policy-compliant alternative implementations are also enumerated below.“ (https://support.google.com/googleplay/android-developer/answer/10467955)
3. Wenn Sie sie tatsächlich benötigen, ist die Erklärung verpflichtend – und sie zu unterlassen, ist selbst ein Verstoß. „Wenn Ihre App die Richtlinienanforderungen für eine zulässige Nutzung erfüllt oder für eine Ausnahme infrage kommt, müssen Sie dies und alle anderen Berechtigungen mit hohem Risiko über das Berechtigungserklärungsformular in der Play Console deklarieren.“ Und: „Apps, die die Richtlinienanforderungen nicht erfüllen oder kein Berechtigungserklärungsformular einreichen, können aus Google Play entfernt werden.“ (https://support.google.com/googleplay/android-developer/answer/10467955)
4. Der Maßstab ist „keine wirksame Alternative“, nicht „es ist bequem“. „Sie sollten auf die Berechtigung für den Zugriff auf alle Dateien nur dann zugreifen, wenn Ihre App die datenschutzfreundlicheren Best Practices wie das Storage Access Framework oder die MediaStore-API nicht wirksam nutzen kann. Denken Sie daran, dass Ihre App keine Berechtigungen deklarieren sollte, die sie nicht benötigt oder verwendet.“ (https://support.google.com/googleplay/android-developer/answer/10467955)
5. Die Kernfunktion wird von Google definiert und muss in Ihrem Store-Eintrag sichtbar sein. „Darüber hinaus muss die Verwendung der Berechtigung durch die App in zulässige Verwendungszwecke fallen und direkt an die Kernfunktion der App gebunden sein. Die Kernfunktion ist als der Hauptzweck der App definiert. Ohne diese Kernfunktion ist die App ‚defekt‘ oder unbrauchbar. Die Kernfunktion sowie alle Kernfeatures, aus denen diese Kernfunktion besteht, müssen in der App-Beschreibung deutlich dokumentiert und beworben werden.“ „Wenn die Kernfunktion einer App die Berechtigung für den Zugriff auf alle Dateien erfordert, muss der Entwickler das Berechtigungserklärungsformular ausfüllen und die Genehmigung von Google Play erhalten.“ (https://support.google.com/googleplay/android-developer/answer/10467955)
6. Die Liste der zulässigen Verwendungen – und ihr Sternchen. „Für Apps, die Zugriff auf die Berechtigung für den Zugriff auf alle Dateien anfordern, umfassen die beabsichtigte und zulässige Verwendung Dateimanager, Backup- und Wiederherstellungs-Apps, Antivirus-Apps und Dokumentenverwaltungs-Apps." Die Richtlinientabelle ergänzt: Dateiverwaltung („Der Kernzweck der App umfasst den Zugriff auf, das Bearbeiten und die Verwaltung (einschließlich Wartung) von Dateien und Ordnern außerhalb ihres app-spezifischen Speicherbereichs"), Backup und Wiederherstellung („Die App muss aus Gründen von Backup und Wiederherstellung automatisch auf mehrere Verzeichnisse außerhalb ihres app-spezifischen Speicherbereichs zugreifen können"), Antivirus („Der Kernzweck der App ist das Scannen des Geräts und das Bereitstellen von Antivirus-Sicherheitsfunktionen für den Gerätenutzer"), Dokumentenverwaltung („Apps, die kompatible Dateitypen außerhalb ihres app-spezifischen oder gemeinsamen Speichers finden, darauf zugreifen und bearbeiten müssen"), geräteinterne Suche, Verschlüsselung und Sperrung von Datenträgern/Ordnern sowie Gerätemigration/Telefonübertragung. Jede Zeile trägt die Fußnote „* Vorbehaltlich Prüfung und Genehmigung durch Google Play", und „Apps, denen Zugriff auf diese Berechtigung gewährt wurde, dürfen ihre Verwendung nicht auf nicht offengelegte oder unzulässige Zwecke ausweiten." (https://support.google.com/googleplay/android-developer/answer/10467955)
7. Was eine vorübergehende Ausnahme rechtfertigt. „Google Play kann Apps eine vorübergehende Ausnahme gewähren, die nicht als oben bezeichnete zulässige Nutzung gelten, wenn: Die Nutzung der Berechtigung die Kernfunktionalität der App ermöglicht. Derzeit gibt es keine alternative Methode, um die Kernfunktionalität bereitzustellen, oder die Nutzung datenschutzfreundlicher Alternativen (zum Beispiel MediaStore API oder Storage Access Framework) hat erhebliche nachteilige Auswirkungen auf die kritischen Funktionen der App, die an die Kernfunktionalität gebunden sind. Die Auswirkungen auf die Privatsphäre der Nutzer werden durch Sicherheits- und Datenschutz-Best-Practices abgemildert.“ Die abschließende Bedingung liegt bei Ihnen: „Der Entwickler muss in seiner Console-Deklaration begründen, warum das Storage Access Framework oder die MediaStore API für den Zweck seiner App nicht ausreichen.“ (https://support.google.com/googleplay/android-developer/answer/10467955)
8. Anwendungsfälle, die Google bereits ausgeschlossen hat. „Nachfolgend finden Sie eine Liste häufiger Anwendungsfälle, für die die Berechtigung MANAGE_EXTERNAL_STORAGE nicht beantragt werden darf: Zugriff auf Mediendateien (siehe Alternativen unten); jede Dateiauswahl-Aktivität, bei der der Nutzer einzelne Dateien manuell auswählt (siehe Alternativen unten)." Beachten Sie, dass die Liste nur beispielhaft ist: „Diese Liste ist nicht vollständig. Ausführliche Hinweise finden Sie in der Dokumentation zum Zugriff auf alle Dateien und in den Best Practices für Scoped Storage für Entwickler." (https://support.google.com/googleplay/android-developer/answer/10467955)
9. Die beiden Ersatzlösungen und warum sie in der Regel ausreichen. Für Medien gilt: „Mit der MediaStore API können Apps Medien, die auf einem externen Speichervolume verfügbar sind, bereitstellen und darauf zugreifen, ohne die Berechtigung Alle Dateien zugreifen zu benötigen. Mit der MediaStore API können Nutzer Medien-Dateien einfach abrufen und aktualisieren. Diese Dateien verbleiben auf dem externen Speichervolume auf dem Gerät des Nutzers – selbst nachdem die App deinstalliert wurde.“ Für vom Nutzer ausgewählte Dateien gilt: „Entwickler sollten das Storage Access Framework als datenschutzfreundliche Option für den Zugriff auf Dateien im gemeinsamen Speicher in Betracht ziehen. Dieses Framework unterstützt die überwiegende Mehrheit der Einsatzzwecke von Apps für den vollen Funktionsumfang.“ SAF ist zudem die einzige der drei Optionen, die überhaupt keine Laufzeitberechtigung benötigt: „Da der Nutzer an der Auswahl der Dateien oder Verzeichnisse beteiligt ist, auf die Ihre App zugreifen kann, erfordert dieser Mechanismus keine Systemberechtigungen, und die Kontrolle des Nutzers und der Datenschutz werden verbessert.“ (https://support.google.com/googleplay/android-developer/answer/10467955 / https://developer.android.com/training/data-storage/shared/documents-files)
10. Wie die Berechtigung angefordert wird und was sie tatsächlich freischaltet. „Eine App kann den Zugriff auf alle Dateien beim Nutzer anfordern, indem sie Folgendes tut: Die Berechtigung MANAGE_EXTERNAL_STORAGE im Manifest deklarieren. Die Intent-Aktion ACTION_MANAGE_ALL_FILES_ACCESS_PERMISSION verwenden, um Nutzer zu einer Systemeinstellungsseite zu führen ... Um festzustellen, ob Ihrer App die Berechtigung MANAGE_EXTERNAL_STORAGE gewährt wurde, rufen Sie Environment.isExternalStorageManager() auf." Einmal gewährt, verschafft sie „Lese- und Schreibzugriff auf alle Dateien im gemeinsamen Speicher" (und „Das Verzeichnis /sdcard/Android/media ist Teil des gemeinsamen Speichers"), „Zugriff auf die Inhalte der Tabelle MediaStore.Files", „Zugriff auf das Stammverzeichnis sowohl des USB-On-the-Go-(OTG-)Laufwerks als auch der SD-Karte" und „Schreibzugriff auf alle internen Speicherverzeichnisse außer /Android/data/, /sdcard/Android und den meisten Unterverzeichnissen von /sdcard/Android". Andere Apps erreicht sie weiterhin nicht: „Apps, denen diese Berechtigung gewährt wurde, können weiterhin nicht auf die app-spezifischen Verzeichnisse anderer Apps zugreifen, da diese Verzeichnisse als Unterverzeichnisse von Android/data/ auf einem Speichervolume erscheinen." (https://developer.android.com/training/data-storage/manage-all-files)
11. Verwechseln Sie die beiden Mechanismen nicht. Der Besitz der Berechtigung schränkt ein, was SAF sehen kann, statt es zu erweitern: „Wenn Sie das Storage Access Framework verwenden, können Sie jedoch nur auf eine Datei oder ein Verzeichnis zugreifen, wenn Sie dies ohne die Berechtigung MANAGE_EXTERNAL_STORAGE tun können." Eine „nur für den Fall" deklarierte Berechtigung kann also einen Pfad verschlechtern, der bereits funktioniert hat. Ab Android 12 (API 31) und höher können Apps, die sowohl MANAGE_EXTERNAL_STORAGE als auch QUERY_ALL_PACKAGES besitzen (Dateimanager), getManageSpaceActivityIntent() nutzen, um den Nutzer zur benutzerdefinierten Speicherverwaltungsaktivität einer anderen App zu führen. (https://developer.android.com/training/data-storage/manage-all-files)
12. Die Migration selbst: requestLegacyExternalStorage stirbt in dem Moment, in dem Sie auf Android 11 abzielen. „Apps, die auf Android 11 laufen, aber auf Android 10 (API-Level 29) abzielen, können weiterhin das Attribut requestLegacyExternalStorage anfordern … Nachdem Sie Ihre App auf Android 11 aktualisiert haben, ignoriert das System das Flag requestLegacyExternalStorage." Gehen Sie die Arbeit also der Reihe nach an: „Wenn Ihre App das Legacy-Speichermodell verwendet und zuvor auf Android 10 oder niedriger abgezielt hat, speichern Sie möglicherweise Daten in einem Verzeichnis, auf das Ihre App nicht zugreifen kann, wenn das Scoped-Storage-Modell aktiviert ist. Bevor Sie auf Android 11 abzielen, migrieren Sie die Daten in ein Verzeichnis, das mit Scoped Storage kompatibel ist." Zwei weitere mechanische Änderungen: „Ab Android 11 können Apps kein eigenes app-spezifisches Verzeichnis im externen Speicher mehr anlegen. Um auf das Verzeichnis zuzugreifen, das das System für Ihre App bereitstellt, rufen Sie getExternalFilesDirs() auf." Und zum Testen deaktivieren Sie das Scoped-Storage-Verhalten über das App-Kompatibilitäts-Flag – „DEFAULT_SCOPED_STORAGE (standardmäßig für alle Apps aktiviert)" und „FORCE_ENABLE_SCOPED_STORAGE (standardmäßig für alle Apps deaktiviert)". (https://developer.android.com/about/versions/11/privacy/storage)
13. Die Berechtigung zu behalten, nachdem Sie ihre Verwendung geändert haben, ist der teure Fehler. „If you change how your app uses these restricted permissions, you must submit the form again with updated and accurate information. Deceptive and undeclared uses of these permissions may result in a suspension of your app and/or termination of your developer account.“ In der Praxis bedeutet das, die Erklärung erneut abzugeben, sobald eine neue Funktion auf breiten Dateizugriff zugreift – und für Apps, deren Speichernutzung gewöhnlich ist (vom Nutzer ausgewählte Dokumente, Fotos, Exporte), ist der günstigste Weg weiterhin, MANAGE_EXTERNAL_STORAGE aus dem Manifest zu entfernen und stattdessen MediaStore + SAF + den Photo Picker auszuliefern. (https://support.google.com/googleplay/android-developer/answer/10467955)