Qu’est-ce qu’Android Photo Picker et quel accès accorde-t-il ?
Android Photo Picker est une interface intégrée qui présente une bibliothèque multimédia afin qu’une personne choisisse les photos ou vidéos qu’elle souhaite partager avec une application. Android décrit ce mécanisme comme un moyen d’accorder l’accès aux fichiers sélectionnés plutôt qu’à l’ensemble de la bibliothèque. Il peut, par exemple, servir à joindre une image à un message ou à choisir une vidéo pour une publication.
La distinction essentielle oppose la transmission d’éléments précis à l’autorisation d’un accès général à la bibliothèque. L’accès accordé par Photo Picker concerne les médias choisis dans le sélecteur ; il ne décrit pas les autres autorisations dont l’application pourrait disposer séparément. Le parcours du sélecteur ne doit donc pas être confondu avec une demande d’accès étendu au stockage.
Dans les contrats de résultat d’activité documentés par Android, l’application reçoit un ou plusieurs URI associés aux éléments choisis. L’accès à ces fichiers ne doit pas être considéré comme nécessairement permanent : Android indique qu’il est maintenu par défaut jusqu’au redémarrage de l’appareil ou à l’arrêt de l’application. Pour une tâche prolongée, comme le téléversement d’un fichier en arrière-plan, l’application peut conserver l’accès au moyen de takePersistableUriPermission() lorsque cela est nécessaire.
Comment une application ouvre le sélecteur
Android documente les contrats Jetpack Activity permettant de lancer Photo Picker. PickVisualMedia permet de choisir une photo ou une vidéo ; PickMultipleVisualMedia autorise plusieurs sélections. La recommandation d’Android pour simplifier cette intégration consiste à inclure la version 1.7.0 ou ultérieure de la bibliothèque androidx.activity ; cela ne signifie pas qu’il s’agit de la seule manière d’utiliser le sélecteur.
Le parcours habituel avec ces contrats consiste à lancer le sélecteur, à laisser la personne choisir du contenu, puis à traiter le résultat reçu. Si le sélecteur est fermé sans qu’un média soit choisi, les exemples d’Android montrent que le résultat peut être nul pour une sélection unique ou une liste vide pour une sélection multiple. L’application doit gérer ces deux cas et ne pas supposer qu’un fichier sera toujours renvoyé.
Si Photo Picker n’est pas disponible sur un appareil, la bibliothèque appelle automatiquement l’action ACTION_OPEN_DOCUMENT comme solution de remplacement. Android indique que cette action est compatible avec les appareils à partir d’Android 4.4, niveau d’API 19. La solution de remplacement ne garantit pas une interface identique sur tous les appareils : il s’agit d’un autre parcours de sélection de documents.
Photo Picker et Selected Photos Access : deux mécanismes distincts
Selected Photos Access est le modèle d’accès partiel d’Android 14 pour les applications qui demandent des autorisations de lecture des photos ou des vidéos. Il permet à la personne d’autoriser des médias précis plutôt que tous les médias d’un type donné. Selon Android, ce changement s’applique lorsque l’application cible Android 14, niveau d’API 34, ou une version ultérieure.
Photo Picker est différent : il permet de sélectionner du contenu à partager par l’intermédiaire de son interface, sans que ce parcours exige des autorisations de stockage. Android recommande le sélecteur aux applications qui ne l’utilisent pas encore et qui doivent sélectionner des images ou des vidéos. Utiliser Photo Picker ne signifie donc pas que l’application met en œuvre le modèle d’autorisations d’une galerie qui lui est propre.
L’autorisation READ_MEDIA_VISUAL_USER_SELECTED concerne les applications qui conservent leur propre sélecteur de galerie fondé sur des autorisations et doivent gérer l’accès partiel ainsi que la nouvelle sélection. Android recommande d’adapter cette implémentation lorsqu’un contrôle de la galerie est nécessaire. Si une application conserve son propre sélecteur avec autorisations sans intégrer la nouvelle autorisation, le système peut l’exécuter en mode de compatibilité ; ce comportement concerne ce cas, et non toutes les applications qui n’utilisent pas Photo Picker.
Choisir l’approche adaptée à la fonction
Le choix dépend de la tâche. Pour recevoir une ou plusieurs images ou vidéos choisies par une personne, Photo Picker propose un parcours à portée limitée. Une galerie intégrée peut convenir lorsque l’application doit contrôler la présentation ou la consultation de la bibliothèque ; en contrepartie, elle doit gérer les autorisations et répercuter les changements apportés à l’accès accordé.
Dans les contrats Jetpack Activity décrits par Android, le résultat comprend les URI des éléments sélectionnés. Avec une galerie intégrée qui utilise des autorisations, l’application peut interroger MediaStore dans les limites de l’accès accordé. L’accès partiel n’est pas un accès complet : l’interface et les résultats doivent correspondre aux autorisations accordées par la personne.
Comparaison pratique
| Approche | Ce que reçoit l’application | Ce qu’elle doit gérer |
|---|---|---|
| Photo Picker avec les contrats Jetpack Activity | URI des médias choisis dans ce parcours | Résultat nul ou vide, traitement des URI et durée de l’accès |
| Galerie intégrée avec autorisations | Consultation des médias dans les limites autorisées, qui peuvent être partielles ou complètes | Demande et vérification des autorisations, actualisation des résultats et nouvelle sélection |
Le tableau résume la différence fonctionnelle, et non l’ensemble des exigences de mise en œuvre. Pour décider, il est utile de partir des besoins de la fonctionnalité : si l’utilisateur doit simplement fournir certains fichiers, le sélecteur convient généralement ; si l’application a besoin d’une galerie intégrée, la gestion des autorisations doit aussi être conçue.
Contenu distant et sélection sur l’appareil
Photo Picker peut permettre de choisir des photos et des vidéos stockées à distance lorsqu’il existe sur l’appareil des fournisseurs cloud de médias éligibles. La disponibilité dépend du fournisseur : Android n’affirme pas que tous les services cloud apparaissent dans tous les sélecteurs.
Android indique également que l’outil est mis à jour automatiquement et peut proposer des fonctionnalités étendues sans modification du code de l’application. Cela ne garantit pas qu’un fournisseur ou un fichier distant donné sera disponible sur un appareil particulier. La personne peut ouvrir le sélecteur et examiner le contenu qui y est proposé.
Points à vérifier pour le partage ou le développement
Lorsque plusieurs médias sont sélectionnés, le guide d’aide d’Android décrit un aperçu des éléments choisis et la possibilité de retirer des fichiers avant de les ajouter. Il précise également que le maximum sélectionnable peut atteindre 100 photos ou vidéos, ou être inférieur selon la configuration de l’application. La sélection peut être vérifiée avant de terminer le parcours décrit dans ce guide.
Les développeurs doivent choisir entre le sélecteur et une galerie intégrée en fonction de la fonctionnalité, et traiter soigneusement les résultats du sélecteur. Si une tâche en arrière-plan doit continuer à accéder à un URI, elle doit tenir compte de la durée par défaut de l’autorisation et demander sa persistance lorsque cela convient. Il ne faut pas supposer que l’accès à un élément se poursuivra indéfiniment.
Pour une galerie intégrée sous Android 14, l’application doit vérifier l’état réel des autorisations et permettre à la personne de modifier les médias autorisés. Android avertit que l’accès partiel peut changer et recommande d’actualiser les résultats lorsque l’application revient au premier plan. L’interface doit refléter l’accès en vigueur, et non une autorisation présumée ou enregistrée comme permanente.