<servizio>

<service android:description="string resource"
         android:directBootAware=["true" | "false"]
         android:enabled=["true" | "false"]
         android:exported=["true" | "false"]
         android:foregroundServiceType=["camera" | "connectedDevice" |
                                        "dataSync" | "health" | "location" |
                                        "mediaPlayback" | "mediaProjection" |
                                        "microphone" | "phoneCall" |
                                        "remoteMessaging" | "shortService" |
                                        "specialUse" | "systemExempted"]
         android:icon="drawable resource"
         android:isolatedProcess=["true" | "false"]
         android:label="string resource"
         android:name="string"
         android:permission="string"
         android:process="string" >
    ...
</service>

Tutti i servizi devono essere rappresentati da elementi <service> nel file manifest. Quelle non dichiarate non vengono rilevate dal sistema e non vengono mai eseguite.

Nota: su Android 8.0 (livello API 26) e versioni successive, il sistema limita le azioni consentite all'app mentre è in esecuzione in background. Per saperne di più, consulta le guide che trattano i limiti di esecuzione in background e i limiti per le posizioni in background.

android:description

Una stringa leggibile dall'utente che descrive il servizio. La descrizione è impostata come riferimento a una risorsa stringa, pertanto può essere localizzata come altre stringhe nell'interfaccia utente.

android:directBootAware

Indica se il servizio è consapevole all'avvio diretto, ovvero se può essere eseguito prima che l'utente sblocchi il dispositivo.

Nota : durante l'avvio diretto, un servizio nella tua applicazione può accedere solo ai dati archiviati nello spazio di archiviazione protetto dal dispositivo.

Il valore predefinito è "false".

android:enabled

Indica se il sistema può creare un'istanza del servizio. È "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 i componenti dell'applicazione, inclusi i servizi. Per poter abilitare il servizio, gli attributi <application> e <service> devono essere entrambi "true", perché sono entrambi per impostazione predefinita. Se uno dei due è "false", il servizio è disabilitato e non è possibile creare un'istanza.

android:exported

Indica se i componenti di altre applicazioni possono richiamare il servizio o interagirvi. La risposta è "true" se può e "false" in caso contrario. Quando il valore è "false", solo i componenti della stessa applicazione o applicazioni con lo stesso ID utente possono avviare il servizio o associarsi a questo.

Il valore predefinito dipende dalla presenza o meno di filtri per intent nel servizio. L'assenza di filtri significa che può essere richiamato solo specificando il nome esatto della classe. Ciò implica che il servizio è destinato solo all'uso interno all'applicazione, poiché gli altri non conoscono il nome della classe. Quindi, in questo caso, il valore predefinito è "false". D'altra parte, la presenza di almeno un filtro implica che il servizio è destinato a un uso esterno, quindi il valore predefinito è "true".

Questo attributo non è l'unico modo per limitare l'esposizione di un servizio ad altre applicazioni. Puoi anche utilizzare un'autorizzazione per limitare le entità esterne che possono interagire con il servizio. Vedi l'attributo permission.

android:foregroundServiceType

Specifica che il servizio è un servizio in primo piano che soddisfa un determinato caso d'uso. Ad esempio, un tipo di servizio in primo piano "location" indica che un'app sta ricevendo la posizione attuale del dispositivo, in genere per continuare un'azione avviata dall'utente relativa alla posizione del dispositivo.

Puoi assegnare più tipi di servizi in primo piano a un servizio specifico.

android:icon

Un'icona che rappresenta il servizio. Questo attributo è impostato come riferimento a una risorsa disegnabile contenente la definizione dell'immagine. Se non è impostato, viene utilizzata l'icona specificata per l'applicazione nel suo insieme. Vedi l'attributo icon dell'elemento <application>.

L'icona del servizio, impostata qui o dall'elemento <application>, è anche l'icona predefinita per tutti i filtri per intent del servizio. Controlla l'attributo icon dell'elemento <intent-filter>.

android:isolatedProcess

Se è impostato su "true", il servizio viene eseguito in un processo speciale, isolato dal resto del sistema e non dispone di autorizzazioni proprie. L'unica comunicazione con questo metodo avviene tramite l'API Service, con associazione e avvio.

android:label

Un nome leggibile per il servizio. Se questo attributo non è impostato, viene utilizzata l'etichetta impostata per l'applicazione nel suo insieme. Vedi l'attributo label dell'elemento <application>.

L'etichetta del servizio, impostata qui o dall'elemento <application>, è anche l'etichetta predefinita per tutti i filtri per intent del servizio. Controlla l'attributo label dell'elemento <intent-filter>.

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

android:name

Il nome della sottoclasse Service che implementa il servizio. Questo è un nome completo della classe, come "com.example.project.RoomService". Tuttavia, se il primo carattere del nome è un punto, ad esempio ".RoomService", viene aggiunto al nome del pacchetto specificato nell'elemento <manifest>.

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

Non esiste un'impostazione predefinita. È necessario specificare il nome.

android:permission

Il nome di un'autorizzazione necessaria a un'entità per avviare il servizio o associarlo. Se al chiamante di startService(), bindService() o stopService() non viene concessa questa autorizzazione, il metodo non funziona e l'oggetto Intent non viene consegnato al servizio.

Se questo attributo non è impostato, al servizio viene applicata l'autorizzazione impostata dall'attributo permission dell'elemento <application>. Se nessuno dei due attributi è impostato, il servizio non è protetto da un'autorizzazione.

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

android:process

Il nome del processo in cui viene eseguito il servizio. Normalmente, tutti i componenti di un'applicazione vengono eseguiti nel processo predefinito creato per l'applicazione. Ha lo stesso nome del pacchetto dell'applicazione. L'attributo process dell'elemento <application> può impostare un valore predefinito diverso per tutti i componenti. Tuttavia, un componente può eseguire l'override del valore predefinito con il proprio attributo process, consentendoti di distribuire l'applicazione in più processi.

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

Se il nome del processo inizia con un carattere minuscolo, il servizio viene eseguito in un processo globale con quel nome, a condizione che disponga dell'autorizzazione per farlo. Ciò consente ai componenti di diverse applicazioni di condividere un processo, riducendo l'utilizzo delle risorse.