Che cos’è Android Photo Picker e quale accesso concede

Android Photo Picker è un’interfaccia integrata che mostra una raccolta multimediale, consentendo a una persona di scegliere le foto o i video da condividere con un’app. Android descrive questo meccanismo come un modo per concedere l’accesso ai file selezionati invece che all’intera raccolta. Può servire, per esempio, per allegare un’immagine a un messaggio o scegliere un video per un post.

La distinzione fondamentale è tra consegnare elementi specifici e autorizzare l’accesso generale alla raccolta. L’accesso concesso tramite Photo Picker riguarda i contenuti selezionati nel selettore; non descrive eventuali altre autorizzazioni di cui l’app potrebbe disporre separatamente. Perciò, il flusso del selettore non va confuso con una richiesta di accesso esteso allo spazio di archiviazione.

Nei contratti documentati da Android per i risultati delle attività, l’app riceve uno o più URI associati agli elementi selezionati. L’accesso a quei file non va considerato necessariamente permanente: Android indica che, per impostazione predefinita, viene mantenuto fino al riavvio del dispositivo o all’arresto dell’app. Per un’attività prolungata, come il caricamento di un file in background, l’app può conservare l’accesso tramite takePersistableUriPermission() quando serve.

Come aprire il selettore da un’app

Android documenta i contratti Jetpack Activity per avviare Photo Picker. PickVisualMedia permette di scegliere una foto o un video; PickMultipleVisualMedia consente selezioni multiple. La raccomandazione di Android per semplificare l’integrazione è includere la versione 1.7.0 o successiva della libreria androidx.activity; ciò non implica che sia l’unico modo per usare il selettore.

Il flusso abituale con questi contratti consiste nell’avviare il selettore, lasciare che la persona scelga i contenuti ed elaborare il risultato ricevuto. Se il selettore viene chiuso senza scegliere un contenuto, gli esempi di Android mostrano che il risultato può essere nullo per una selezione singola o una lista vuota per una selezione multipla. L’app dovrebbe gestire entrambi i casi e non presumere che venga sempre restituito un file.

Se Photo Picker non è disponibile su un dispositivo, la libreria richiama automaticamente l’azione ACTION_OPEN_DOCUMENT come alternativa. Android indica che questa azione è compatibile con i dispositivi a partire da Android 4.4, livello API 19. L’alternativa non garantisce un’interfaccia identica su tutti i dispositivi: si tratta di un diverso flusso di selezione dei documenti.

Photo Picker e Selected Photos Access: due meccanismi diversi

Selected Photos Access è il modello di accesso parziale di Android 14 per le app che richiedono autorizzazioni di lettura di foto o video. Consente alla persona di autorizzare contenuti specifici invece di tutti i contenuti di un determinato tipo. Secondo Android, la modifica si applica quando l’app ha come destinazione Android 14, livello API 34, o una versione successiva.

Photo Picker è diverso: permette di selezionare contenuti da condividere tramite la sua interfaccia, senza che questo flusso richieda autorizzazioni di archiviazione. Android consiglia il selettore alle app che non lo usano ancora e devono selezionare immagini o video. Pertanto, usare Photo Picker non significa che l’app stia implementando il modello di autorizzazioni di una propria galleria.

L’autorizzazione READ_MEDIA_VISUAL_USER_SELECTED è pertinente alle app che mantengono un proprio selettore di galleria basato sulle autorizzazioni e devono gestire l’accesso parziale e la nuova selezione. Android consiglia di adattare questa implementazione quando serve controllare la galleria. Se un’app mantiene un selettore proprio basato sulle autorizzazioni senza includere la nuova autorizzazione, il sistema può eseguirla in modalità di compatibilità; questo comportamento riguarda tale caso, non tutte le app che non usano Photo Picker.

Quale approccio scegliere in base alla funzione

La scelta dipende dall’attività. Per ricevere una o più immagini o video scelti da una persona, Photo Picker offre un flusso circoscritto. Una galleria integrata può essere adatta quando l’app deve controllare la presentazione o l’interrogazione della raccolta; in cambio, deve gestire le autorizzazioni e riflettere le modifiche all’accesso autorizzato.

Nei contratti Jetpack Activity descritti da Android, il risultato include gli URI degli elementi selezionati. In una galleria integrata con autorizzazioni, l’app può interrogare MediaStore entro l’ambito concesso. L’accesso parziale non equivale a quello completo: interfaccia e risultati devono corrispondere alle autorizzazioni concesse dalla persona.

Confronto pratico

Approccio Che cosa riceve l’app Che cosa deve gestire
Photo Picker con contratti Jetpack Activity URI dei contenuti selezionati in quel flusso Risultato vuoto o nullo, elaborazione degli URI e durata dell’accesso
Galleria integrata con autorizzazioni Interrogazione dei contenuti entro l’ambito autorizzato, parziale o completo Richiesta e verifica delle autorizzazioni, aggiornamento dei risultati e nuova selezione

La tabella riassume la differenza funzionale, non tutti i requisiti d’implementazione. Per decidere, conviene partire dalle esigenze della funzione: se basta che l’utente fornisca determinati file, il selettore è di solito adatto; se serve una galleria integrata nell’app, occorre progettare anche la gestione delle autorizzazioni.

Contenuti remoti e selezione sul dispositivo

Photo Picker può consentire di selezionare foto e video archiviati da remoto quando sul dispositivo sono disponibili provider cloud multimediali idonei. La disponibilità dipende dal provider: Android non afferma che tutti i servizi cloud compaiano in ogni selettore.

Android indica inoltre che lo strumento si aggiorna automaticamente e può offrire funzionalità ampliate senza modifiche al codice dell’app. Questo non garantisce che un determinato provider o file remoto sia disponibile su uno specifico dispositivo. La persona può aprire il selettore e controllare i contenuti che vi vengono proposti.

Che cosa controllare quando si condivide o si sviluppa

Quando si selezionano più contenuti, la guida di Android descrive un’anteprima degli elementi scelti e la possibilità di rimuovere i file prima di aggiungerli. Avverte anche che il numero massimo selezionabile può arrivare a 100 foto o video, o essere inferiore in base alla configurazione dell’app. È possibile rivedere la selezione prima di completare il flusso descritto nella guida.

Chi sviluppa un’app dovrebbe scegliere tra selettore e galleria integrata in base alla funzione e gestire con attenzione i risultati del selettore. Se un’attività in background deve continuare ad accedere a un URI, occorre considerare la durata predefinita dell’autorizzazione e richiederne la persistenza quando è opportuno. Non si dovrebbe presumere che l’accesso a un elemento continui indefinitamente.

Per una galleria integrata in Android 14, l’app dovrebbe controllare lo stato effettivo delle autorizzazioni e consentire alla persona di modificare i contenuti autorizzati. Android avverte che l’accesso parziale può cambiare e consiglia di aggiornare i risultati quando l’app torna in primo piano. L’interfaccia deve rispecchiare l’accesso attuale, non un’autorizzazione presunta o salvata come permanente.