<ricevitore>

<receiver android:directBootAware=["true" | "false"]
          android:enabled=["true" | "false"]
          android:exported=["true" | "false"]
          android:icon="drawable resource"
          android:label="string resource"
          android:name="string"
          android:permission="string"
          android:process="string" >
    ...
</receiver>

Esistono due modi per rendere noto al sistema un broadcast receiver. Il primo è dichiararlo nel file manifest con questo elemento. L'altro è creare il ricevitore in modo dinamico nel codice e lo registri con Context.registerReceiver() o una delle sue versioni sovraccaricate.

Per ulteriori informazioni su come creare dinamicamente ricevitori, vedi BroadcastReceiver corso o l'audiodescrizione.

Se questo ricevitore gestisce trasmissioni non di sistema, specifica un valore per android:exported. Imposta questo valore su "true" se vuoi che il ricevitore possa ricevi annunci da altre applicazioni o "false" se vuoi che il ricevitore possa ricevere annunci dalla tua app.

Non è necessario rimuovere l'attributo android:permission se lo ha già dichiarato.

Avviso: limita il numero di trasmissioni ricevitori che imposti nell'app. Avere troppi broadcast receiver può influisce sulle prestazioni dell'app e sulla durata della batteria degli utenti dispositivi mobili. Per ulteriori informazioni sulle API, puoi utilizzare al posto della BroadcastReceiver corso per programmare il lavoro in background, vedi Ottimizzazione in background.

android:directBootAware

Se il broadcast receiver è a conoscenza di Direct Boot, è se può essere eseguito prima che l'utente sblocchi il dispositivo.

Nota: durante Avvio diretto, una trasmissione il destinatario nella tua applicazione può accedere soltanto ai dati archiviati spazio di archiviazione protetto dal dispositivo.

Il valore predefinito è "false".

android:enabled

Indica se il sistema può creare un'istanza del broadcast receiver. È "true" se può esserlo e "false" in caso contrario. Il valore predefinito è "true".

L'elemento <application> ha il proprio Attributo enabled che si applica a tutti dei componenti dell'applicazione, tra cui i broadcast receiver. La <application> e Gli attributi <receiver> devono essere entrambi "true" per il broadcast receiver da attivare. Se uno dei due è "false", è disabilitata e non può essere creata un'istanza.

android:exported

Se il broadcast receiver può ricevere messaggi da fonti non di sistema al di fuori della sua applicazione. È "true" se può e "false" in caso contrario. Se "false", vengono inviati solo i messaggi al broadcast receiver riceve sono quelle inviate dal sistema, dai componenti della stessa applicazione o con lo stesso ID utente.

Se non specificato, il valore predefinito dipende dal fatto che il broadcast receiver contenga un intent filtri corretti. Se il destinatario contiene almeno un filtro per intent, il valore predefinito è "true". In caso contrario, il valore predefinito è "false".

Questo attributo non è l'unico modo per limitare l'esposizione esterna di un broadcast receiver. Puoi utilizzare un'autorizzazione anche per limitare le entità esterne che possono inviarle messaggi. Vedi l'attributo permission.

android:icon

Un'icona che rappresenta il broadcast receiver. Questo attributo è impostato come riferimento a una risorsa drawable contenente la definizione dell'immagine. Se non è impostata, viene utilizzata l'icona specificata per l'applicazione nel suo complesso . Consulta <application> attributo icon dell'elemento.

L'icona del broadcast receiver, impostata qui o tramite il <application> è anche l'elemento icona predefinita per tutti i filtri per intent del destinatario. Consulta le Di <intent-filter> elemento Attributo icon.

android:label

Un'etichetta leggibile dall'utente per il broadcast receiver. Se questo attributo non è impostata, l'etichetta impostata per l'applicazione nel suo insieme è al suo posto. Visualizza l'elemento <application> Attributo label.

L'etichetta del broadcast receiver, impostata qui o tramite il <application> è anche l'elemento etichetta predefinita per tutti i filtri per intent del destinatario. Consulta le Di <intent-filter> elemento Attributo label.

L'etichetta è impostata come riferimento a una risorsa stringa, in modo che può essere localizzata come altre stringhe nell'interfaccia utente. Tuttavia, per comodità durante lo sviluppo dell'applicazione, può anche essere impostato come stringa non elaborata.

android:name

Il nome della classe che implementa il broadcast receiver, una sottoclasse BroadcastReceiver. Si tratta di un modello di nome della classe, ad esempio "com.example.project.ReportReceiver". Tuttavia, come forma abbreviata, se il primo carattere del nome è un punto, ad esempio, ".ReportReceiver", viene aggiunto al nome del pacchetto specificato in l'elemento <manifest>.

Una volta pubblicata l'applicazione, non modificare questo nome, a meno che non imposti android:exported="false".

Non esiste un valore predefinito. È necessario specificare il nome.

android:permission

Il nome di un'autorizzazione di cui gli emittenti hanno bisogno per inviare un al broadcast receiver. Se questo attributo non è impostato, l'autorizzazione impostata dal Di <application> elemento Si applica l'attributo permission al broadcast receiver. Se nessuno dei due attributi è impostato, il destinatario non è protetto da un'autorizzazione.

Per ulteriori informazioni sulle autorizzazioni, consulta Autorizzazioni nella panoramica del file manifest dell'app Suggerimenti per la sicurezza.

android:process

Il nome del processo in cui viene eseguito il broadcast receiver. Normalmente, tutti i componenti di un'applicazione vengono eseguiti nel processo predefinito creato per l'applicazione. Ha lo stesso nome del pacchetto dell'applicazione.

La Di <application> elemento L'attributo process può impostare un valore diverso predefinita per tutti i componenti. Ma ogni componente può sostituire il valore predefinito con il proprio attributo process, che ti consente di diffondere un'applicazione in più processi.

Se il nome assegnato a questo attributo inizia con i due punti (:), viene privato per l'applicazione, viene creato quando è necessario e il broadcast receiver viene eseguito in quel processo.

Se il nome del processo inizia con un carattere minuscolo, il ricevitore viene eseguito in un processo globale con questo nome, a condizione che sia autorizzato a farlo. Ciò consente ai componenti di applicazioni diverse di condividere un processo, e l'utilizzo delle risorse.