Integrar com o SDK AMAPI

O SDK da API Android Management (AMAPI) permite que apps específicos se comuniquem diretamente com a política do dispositivo Android (ADP). Ele inclui suporte para:

Siga estas etapas para integrar o SDK da AMAPI ao seu aplicativo:

  1. Adicione a biblioteca do SDK da AMAPI.
  2. Adicione o elemento de consultas se o SDK de destino for >= 30.

Pré-requisitos

  • Verifique se o minSdkVersion do app está definido como pelo menos o nível 21 da API.
  • Adicione as dependências da versão mais recente do SDK da AMAPI ao seu aplicativo. Para encontrar a versão da biblioteca mais recente disponível e saber como adicioná-la ao seu aplicativo, acesse a página de notas da versão do SDK da AMAPI.

Adicionar elemento de consultas

Se o app segmentar o SDK 30 ou mais recente, o elemento de consultas será necessário no AndroidManifest.xml para especificar que ele vai interagir com o ADP.

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

Consulte Filtragem de visibilidade do pacote no Android para mais informações.

Implementar um NotificationReceiverService

Alguns recursos exigem a criação de um NotificationReceiverService, e outros fazem uso opcional dele. Para usá-lo, defina uma classe que estenda NotificationReceiverService, adicione-a como um service ao AndroidManifest.xml e verifique se ela foi exportada.


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.
  }
}

É necessário fornecer ao app ADP o ComponentName da sua classe NotificationReceiverService. Há duas abordagens para fazer isso. A documentação de cada recurso especifica qual abordagem usar.

API explícita

Nesse caso, o ComponentName é transmitido ao app ADP por uma API adequada. A documentação do recurso em questão tem os detalhes. No AndroidManifest.xml, adicione:

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

Descoberta automática

Com essa abordagem, é preciso marcar o serviço para que ele seja descoberto automaticamente. No AndroidManifest.xml, adicione:

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

A string específica a ser usada para android:name do meta-data está documentada para cada recurso que usa essa abordagem (consulte Gerenciar papéis do aplicativo para ver um exemplo). Para que essa marcação seja válida, o app precisa ter exatamente um serviço ativado e com meta-data, em que android:name é essa string específica e android:value é uma string vazia. É possível adicionar vários meta-data ao mesmo serviço.