Integrazione con l'SDK AMAPI

L'SDK dell'API Android Management (AMAPI) consente a determinate app di comunicare direttamente con Android Device Policy (ADP). Include il supporto per:

Per integrare l'SDK AMAPI con la tua applicazione, devi seguire questi passaggi:

  1. Aggiungi la libreria dell'SDK AMAPI.
  2. Aggiungi l'elemento queries, se l'SDK di destinazione è >= 30.

Prerequisiti

  • Verifica che minSdkVersion della tua app sia impostato almeno sul livello API 21.
  • Aggiungi le dipendenze per l'ultima versione dell'SDK AMAPI alla tua applicazione. Puoi trovare la versione dell'ultima libreria disponibile e come aggiungerla alla tua applicazione nella pagina delle note di rilascio dell'SDK AMAPI.

Aggiungi elemento di query

Se la tua app ha come target l'SDK 30 o versioni successive, è necessario l'elemento queries in AndroidManifest.xml per specificare che interagirà con ADP.

<queries>
    <package android:name="com.google.android.apps.work.clouddpc" />
</queries>

Per saperne di più, consulta l'articolo relativo al filtraggio della visibilità dei pacchetti su Android.

Implementare un NotificationReceiverService

Alcune funzionalità richiedono la creazione di un NotificationReceiverService, mentre altre ne fanno un uso facoltativo. Per utilizzarlo, definisci una classe che estenda NotificationReceiverService, aggiungila come service al tuo AndroidManifest.xml e assicurati che venga esportata.


import com.google.android.managementapi.notification.NotificationReceiverService;

...

public final class MyAppNotificationReceiverService extends NotificationReceiverService {

  @Override
  protected void setupInjection() {
    // This method can be optionally used to inject dependencies at the
    // beginning of the service lifecycle.
  }
}

Devi fornire all'app ADP il ComponentName della tua classe NotificationReceiverService. Esistono due approcci per farlo. La documentazione di ogni funzionalità specifica l'approccio da utilizzare.

API esplicita

In questo caso, ComponentName viene trasmesso all'app ADP tramite un'API adatta. Per i dettagli, consulta la documentazione della funzionalità in questione. In AndroidManifest.xml, aggiungi:

<service
 android:name = ".MyAppNotificationReceiverService"
 android:exported = "true" />

Rilevamento automatico

Con questo approccio, devi taggare il tuo servizio in modo che possa essere scoperto automaticamente. In AndroidManifest.xml, aggiungi:

<service
 android:name = ".MyAppNotificationReceiverService"
 android:exported = "true" >
    <meta-data android:name="Insert name here" android:value=""/>
</service>

La stringa specifica da utilizzare per android:name di meta-data è documentata per ogni funzionalità che utilizza questo approccio (vedi Gestire i ruoli dell'applicazione per un esempio). Affinché questo tagging sia valido, la tua app deve avere esattamente un servizio abilitato con meta-data il cui android:name è questa stringa specifica e android:value è una stringa vuota. Puoi aggiungere più meta-data allo stesso servizio.