Integrazione con l'SDK AMAPI

L'SDK dell'API Android Management (AMAPI) consente ad app specifiche 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 target è >= 30.

Prerequisiti

  • Verifica che l'attributo 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 della libreria più recente 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, l'elemento queries è necessario nel file 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.

Implementa un NotificationReceiverService

Alcune funzionalità richiedono la creazione di un NotificationReceiverService, mentre altre ne fanno un uso facoltativo. Per utilizzarlo, definisci una classe che estende 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 l'elemento 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, il ComponentName viene passato all'app ADP tramite un'API adatta. I dettagli sono disponibili nella documentazione della funzionalità in questione. In AndroidManifest.xml, aggiungi:

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

Rilevamento automatico

Con questo approccio, devi aggiungere un tag al servizio in modo che possa essere rilevato automaticamente. Nel tuo 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 (consulta Gestisci i ruoli dell'applicazione per un esempio). Affinché questo tagging sia valido, la tua app deve avere esattamente un servizio abilitato e con meta-data il cui android:name è questa stringa specifica e android:value è una stringa vuota. Puoi aggiungere più meta-data allo stesso servizio.