KappS Base de connaissances · FAQ

Politique MANAGE_EXTERNAL_STORAGE (accès à tous les fichiers) sur Google Play

FAQ Autorisations et API

1. Ce que dit réellement la politique. Google Play considère l’accès à tous les fichiers comme un accès spécial à haut risque. « Google Play restreint l’usage des autorisations à haut risque ou sensibles, y compris l’accès spécial à tous les fichiers. Cela ne s’applique qu’aux applications ciblant Android 11 (niveau d’API 30) et déclarant l’autorisation MANAGE_EXTERNAL_STORAGE, ajoutée dans Android 11. Cette politique n’affecte pas non plus l’usage de l’autorisation READ_EXTERNAL_STORAGE. » (https://support.google.com/googleplay/android-developer/answer/10467955)

2. Si vous n'en avez pas besoin, vous devez la retirer du manifeste. C'est la correction la plus courante pour un rejet d'examen de l'application lié à une autorisation : « 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. Si vous en avez réellement besoin, la déclaration est obligatoire — et l’omettre constitue en soi une violation. « Si votre application satisfait aux exigences de la politique pour un usage acceptable ou est éligible à une exception, vous devrez le déclarer, ainsi que toute autre autorisation à haut risque, au moyen du formulaire de déclaration des autorisations dans la Play Console. » Et : « Les applications qui ne satisfont pas aux exigences de la politique ou qui ne soumettent pas de formulaire de déclaration des autorisations peuvent être retirées de Google Play. » (https://support.google.com/googleplay/android-developer/answer/10467955)

4. Le critère est « aucune alternative efficace », pas « c’est pratique ». « Vous ne devez accéder à l’autorisation d’accès à tous les fichiers que lorsque votre application ne peut pas exploiter efficacement les bonnes pratiques plus respectueuses de la vie privée, comme le Storage Access Framework ou l’API MediaStore. Gardez à l’esprit que votre application ne doit pas déclarer d’autorisations dont elle n’a pas besoin ou qu’elle n’utilise pas. » (https://support.google.com/googleplay/android-developer/answer/10467955)

5. La fonctionnalité principale est définie par Google, et elle doit être visible dans votre fiche App Store. « De plus, l’utilisation de l’autorisation par l’application doit relever des usages autorisés et être directement liée à la fonctionnalité principale de l’application. La fonctionnalité principale est définie comme l’objectif premier de l’application. Sans cette fonctionnalité principale, l’application est “cassée” ou inutilisable. La fonctionnalité principale, ainsi que toute fonctionnalité essentielle qui la compose, doivent toutes être clairement documentées et mises en avant dans la description de l’application. » « Lorsque la fonctionnalité principale d’une application nécessite l’autorisation d’accès à tous les fichiers, le développeur doit remplir le formulaire de déclaration des autorisations et obtenir l’approbation de Google Play. » (https://support.google.com/googleplay/android-developer/answer/10467955)

6. La liste des usages autorisés, et son astérisque. « Pour les applications demandant l'accès à l'autorisation d'accès à tous les fichiers, l'usage prévu et autorisé comprend les gestionnaires de fichiers, les applications de sauvegarde et de restauration, les antivirus et les applications de gestion de documents. » Le tableau des politiques ajoute : gestion de fichiers (« l'objectif principal de l'application implique l'accès, la modification et la gestion (y compris la maintenance) de fichiers et de dossiers en dehors de son espace de stockage propre à l'application »), sauvegarde et restauration (« l'application doit avoir besoin d'accéder automatiquement à plusieurs répertoires en dehors de son espace de stockage propre à l'application aux fins de sauvegarde et de restauration »), antivirus (« l'objectif principal de l'application est d'analyser l'appareil et de fournir des fonctionnalités de sécurité antivirus à l'utilisateur de l'appareil »), gestion de documents (« les applications qui doivent localiser, accéder et modifier des types de fichiers compatibles en dehors de leur stockage propre à l'application ou de leur stockage partagé »), la recherche sur l'appareil, le chiffrement et le verrouillage de disques/dossiers, et la migration d'appareil/le transfert de téléphone. Chaque ligne porte la note de bas de page « * Sous réserve de l'examen et de l'approbation de Google Play », et « les applications auxquelles cet accès est accordé ne peuvent pas étendre son usage à des fins non divulguées ou non valides. » (https://support.google.com/googleplay/android-developer/answer/10467955)

7. Ce qui vaut une exception temporaire. « Google Play peut accorder une exception temporaire aux applications qui ne relèvent pas des usages autorisés désignés ci-dessus lorsque : l’utilisation de l’autorisation permet la fonctionnalité principale de l’application ; il n’existe actuellement aucune méthode alternative pour fournir la fonctionnalité principale, ou le recours à des alternatives respectueuses de la vie privée (par exemple MediaStore API ou Storage Access Framework) a un impact substantiellement préjudiciable sur les fonctionnalités critiques de l’application liées à la fonctionnalité principale ; l’impact sur la vie privée des utilisateurs est atténué par les bonnes pratiques de sécurité et de confidentialité. » La condition finale vous incombe : « Le développeur doit justifier dans sa déclaration Console pourquoi le Storage Access Framework ou MediaStore API ne suffit pas à l’objectif de son application. » (https://support.google.com/googleplay/android-developer/answer/10467955)

8. Cas d’usage déjà écartés par Google. « Voici une liste de cas d’usage courants qui ne seront pas autorisés à demander l’autorisation MANAGE_EXTERNAL_STORAGE : accès aux fichiers multimédias (voir les alternatives ci-dessous) ; toute activité de sélection de fichiers où l’utilisateur choisit manuellement des fichiers individuels (voir les alternatives ci-dessous). » Notez que cette liste n’est qu’indicative : « Cette liste n’est pas exhaustive. Pour des conseils approfondis, consultez la documentation sur l’accès à tous les fichiers et les bonnes pratiques de stockage délimité pour les développeurs. » (https://support.google.com/googleplay/android-developer/answer/10467955)

9. Les deux solutions de remplacement, et pourquoi elles suffisent généralement. Pour les médias : « Avec l’API MediaStore, les applications peuvent ajouter et accéder aux médias disponibles sur un volume de stockage externe sans avoir besoin de l’autorisation d’accès à tous les fichiers. Avec l’API MediaStore, les utilisateurs peuvent facilement récupérer et mettre à jour des fichiers multimédias. Ces fichiers restent sur le volume de stockage externe de l’appareil de l’utilisateur, même après la désinstallation de l’application. » Pour les fichiers choisis par l’utilisateur : « Les développeurs devraient envisager le Storage Access Framework comme l’option respectueuse de la vie privée pour accéder aux fichiers du stockage partagé. Ce framework couvre la grande majorité des cas d’usage permettant aux applications d’assurer l’ensemble de leurs fonctionnalités. » SAF est aussi le seul des trois à ne nécessiter aucune autorisation à l’exécution : « Comme l’utilisateur participe à la sélection des fichiers ou répertoires auxquels votre application peut accéder, ce mécanisme ne requiert aucune autorisation système, et le contrôle de l’utilisateur ainsi que la confidentialité s’en trouvent renforcés. » (https://support.google.com/googleplay/android-developer/answer/10467955 / https://developer.android.com/training/data-storage/shared/documents-files)

10. Comment l'autorisation est demandée, et ce qu'elle débloque réellement. « Une application peut demander l'accès à tous les fichiers à l'utilisateur en procédant comme suit : déclarer l'autorisation MANAGE_EXTERNAL_STORAGE dans le manifeste. Utiliser l'action d'intent ACTION_MANAGE_ALL_FILES_ACCESS_PERMISSION pour diriger les utilisateurs vers une page de paramètres système... Pour déterminer si votre application s'est vu accorder l'autorisation MANAGE_EXTERNAL_STORAGE, appelez Environment.isExternalStorageManager(). » Une fois accordée, elle donne « un accès en lecture et en écriture à tous les fichiers du stockage partagé » (et « le répertoire /sdcard/Android/media fait partie du stockage partagé »), « l'accès au contenu de la table MediaStore.Files », « l'accès au répertoire racine du lecteur USB on-the-go (OTG) et de la carte SD », et « un accès en écriture à tous les répertoires de stockage interne, sauf /Android/data/, /sdcard/Android et la plupart des sous-répertoires de /sdcard/Android ». Elle n'atteint toujours pas les autres applications : « Les applications auxquelles cette autorisation est accordée ne peuvent toujours pas accéder aux répertoires propres à d'autres applications, car ces répertoires apparaissent comme des sous-répertoires de Android/data/ sur un volume de stockage. » (https://developer.android.com/training/data-storage/manage-all-files)

11. Ne confondez pas les deux mécanismes. Détenir l’autorisation restreint ce que SAF peut voir plutôt que de l’élargir : « Lorsque vous utilisez le Storage Access Framework, vous ne pouvez toutefois accéder à un fichier ou à un répertoire que si vous pouvez le faire sans disposer de l’autorisation MANAGE_EXTERNAL_STORAGE. » Ainsi, une autorisation déclarée « au cas où » peut dégrader un chemin qui fonctionnait déjà. Sur Android 12 (API 31) et versions ultérieures, les applications qui détiennent à la fois MANAGE_EXTERNAL_STORAGE et QUERY_ALL_PACKAGES (gestionnaires de fichiers) peuvent utiliser getManageSpaceActivityIntent() pour envoyer l’utilisateur vers l’activité de gestion d’espace personnalisée d’une autre application. (https://developer.android.com/training/data-storage/manage-all-files)

12. La migration elle-même : requestLegacyExternalStorage disparaît dès que vous ciblez Android 11. « Les applications qui s’exécutent sur Android 11 mais ciblent Android 10 (niveau d’API 29) peuvent toujours demander l’attribut requestLegacyExternalStorage… Après la mise à jour de votre application pour cibler Android 11, le système ignore l’indicateur requestLegacyExternalStorage. » Procédez donc dans l’ordre : « Si votre application utilise le modèle de stockage hérité et ciblait auparavant Android 10 ou une version antérieure, il est possible que vous stockiez des données dans un répertoire auquel votre application ne pourra pas accéder une fois le modèle de stockage délimité activé. Avant de cibler Android 11, migrez les données vers un répertoire compatible avec le stockage délimité. » Deux autres changements mécaniques : « À partir de Android 11, les applications ne peuvent plus créer leur propre répertoire spécifique sur le stockage externe. Pour accéder au répertoire que le système fournit pour votre application, appelez getExternalFilesDirs(). » Et pour tester, décochez le comportement de stockage délimité via l’indicateur de compatibilité par application — « DEFAULT_SCOPED_STORAGE (activé par défaut pour toutes les applications) » et « FORCE_ENABLE_SCOPED_STORAGE (désactivé par défaut pour toutes les applications) ». (https://developer.android.com/about/versions/11/privacy/storage)

13. Conserver l’autorisation après avoir changé son usage est l’erreur qui coûte cher. « Si vous modifiez la façon dont votre application utilise ces autorisations restreintes, vous devez soumettre à nouveau le formulaire avec des informations à jour et exactes. Les usages trompeurs et non déclarés de ces autorisations peuvent entraîner la suspension de votre application et/ou la résiliation de votre compte développeur. » Concrètement, il faut refaire la déclaration dès qu’une nouvelle fonctionnalité touche à l’accès large aux fichiers — et pour les applications dont l’usage du stockage est ordinaire (documents choisis par l’utilisateur, photos, exports), la voie la moins coûteuse reste de retirer MANAGE_EXTERNAL_STORAGE du manifeste et de livrer MediaStore + SAF + le sélecteur de photos à la place. (https://support.google.com/googleplay/android-developer/answer/10467955)