Dichiarare le esigenze di visibilità dei pacchetti

Durante la creazione dell'app, è importante considerare le altre app presenti sul dispositivo con cui deve interagire. Se la tua app ha come target Android 11 (livello API 30) o versioni successive, il sistema rende alcune app visibili automaticamente alla tua app, ma esclude altre app per impostazione predefinita. Questa guida descrive come rendere visibili queste altre app alla tua app.

Se la tua app ha come target Android 11 o versioni successive e deve interagire con app diverse da quelle visibili automaticamente, aggiungi l'elemento <queries> nel file manifest dell'app. All'interno dell'elemento <queries>, specifica le altre app per nome del pacchetto, per firma di intent o dall'autorità del provider, come descritto nelle sezioni seguenti.

Nomi di pacchetti specifici

Se conosci le app specifiche su cui vuoi eseguire query o con cui vuoi interagire, ad esempio le app che si integrano con la tua app o le app di cui utilizzi i servizi, includi i relativi nomi dei pacchetti in un insieme di elementi <package> all'interno dell'elemento <queries>:

<manifest package="com.example.game">
    <queries>
        <package android:name="com.example.store" />
        <package android:name="com.example.services" />
    </queries>
    ...
</manifest>

Comunicare con un'app host in una raccolta

Se sviluppi una libreria Android, puoi dichiarare le tue esigenze di visibilità dei pacchetti aggiungendo un elemento <queries> nel file manifest AAR. Questo elemento <queries> ha la stessa funzionalità dell'elemento che le app possono dichiarare nei propri manifest.

Se la libreria prevede la comunicazione con un'app host, ad esempio l'utilizzo di un servizio associato, includi un elemento <package> che specifichi il nome del pacchetto dell'app host:

<!-- Place inside the <queries> element. -->
<package android:name=PACKAGE_NAME />

Se includi questa dichiarazione, puoi verificare se l'app host è installata e interagire con l'app, ad esempio chiamando bindService(). L'app per le chiamate che utilizza la tua raccolta diventa automaticamente visibile all'app host a seguito di questa interazione.

Pacchetti che corrispondono alla firma di un filtro per intent

La tua app potrebbe dover eseguire query o interagire con un insieme di app che hanno uno scopo particolare, ma potresti non conoscere i nomi di pacchetto specifici da includere. In questo caso, puoi elencare le firme dei filtri per intent nell'elemento <queries>. La tua app può quindi rilevare le app che hanno elementi <intent-filter> corrispondenti.

Nell'esempio di codice riportato di seguito viene mostrato un elemento <intent> che consente all'app di visualizzare altre app installate che supportano la condivisione di immagini JPEG:

<manifest package="com.example.game">
    <queries>
        <intent>
            <action android:name="android.intent.action.SEND" />
            <data android:mimeType="image/jpeg" />
        </intent>
    </queries>
    ...
</manifest>

L'elemento <intent> ha alcune limitazioni:

  • Devi includere esattamente un elemento <action>.
  • Non puoi utilizzare gli attributi path, pathPrefix, pathPattern o port in un elemento <data>. Il sistema si comporta come se imposti il valore di ogni attributo sul carattere jolly generico (*).
  • Non puoi utilizzare l'attributo mimeGroup di un elemento <data>.

  • All'interno degli elementi <data> di un singolo elemento <intent>, puoi utilizzare ciascuno dei seguenti attributi contemporaneamente:

    • mimeType
    • scheme
    • host

    Puoi distribuire questi attributi su più elementi <data> o utilizzarli in un singolo elemento <data>.

L'elemento <intent> supporta il carattere jolly generico (*) come valore per alcuni attributi:

  • Attributo name dell'elemento <action>.
  • Il sottotipo dell'attributo mimeType di un elemento <data> (image/*).
  • Il tipo e il sottotipo dell'attributo mimeType di un elemento <data> (*/*).
  • Attributo scheme di un elemento <data>.
  • Attributo host di un elemento <data>.

Se non diversamente specificato nell'elenco precedente, il sistema non supporta una combinazione di caratteri di testo e caratteri jolly, ad esempio prefix*.

Pacchetti che utilizzano un'autorità specifica

Se devi eseguire una query a un fornitore di contenuti ma non conosci i nomi specifici dei pacchetti, puoi dichiarare l'autorità del provider in un elemento <provider>, come mostrato nello snippet seguente:

<manifest package="com.example.suite.enterprise">
    <queries>
        <provider android:authorities="com.example.settings.files" />
    </queries>
    ...
</manifest>

Puoi dichiarare le autorità dei provider in un singolo elemento <queries>. All'interno dell'elemento <queries>, puoi dichiarare uno o più elementi <provider>. Un elemento <provider> può includere una singola autorità di provider o un elenco di autorità provider delimitato da punti e virgola.

Tutte le app (sconsigliato)

In rari casi, l'app potrebbe dover inviare query o interagire con tutte le app installate su un dispositivo, indipendentemente dai componenti che contengono. Per consentire alla tua app di vedere tutte le altre app installate, il sistema fornisce l'autorizzazione QUERY_ALL_PACKAGES.

Ecco alcuni esempi di casi d'uso in cui è opportuno includere l'autorizzazione QUERY_ALL_PACKAGES:

  • App di accessibilità
  • Browser
  • App di gestione dei dispositivi
  • App per la sicurezza
  • App antivirus

Tuttavia, in genere è possibile soddisfare i casi d'uso dell'app interagendo con l'insieme di app che sono visibili automaticamente e dichiarando nel file manifest le altre app a cui l'app deve accedere. Per rispettare la privacy degli utenti, l'app deve richiedere la visibilità dei pacchetti minima necessaria per il funzionamento dell'app.

Questo aggiornamento delle norme da Google Play fornisce linee guida per le app che richiedono l'autorizzazione QUERY_ALL_PACKAGES.

Indietro
Sapere quali pacchi sono visibili automaticamente
Avanti
Soddisfa i casi d'uso comuni