Notas da versão do SDK Android Management

O processo de lançamento do SDK do Android Management (SDK da AMAPI) pode incluir uma etapa de versão candidata a lançamento como parte do processo de lançamento padrão.

Atualização mais recente

Versão estável Versão candidata a lançamento
28 de outubro de 2026 1.9.0

Declarar dependências

Para adicionar uma dependência ao SDK da AMAPI, adicione o repositório Maven do Google ao seu projeto:

repositories {
  ...
  google()
}

Adicione as dependências dos artefatos necessários no arquivo build.gradle para seu app ou módulo:

dependencies {
    def amapi_version = "1.9.0"

    implementation "com.google.android.libraries.enterprise.amapi:amapi:$amapi_version"
}

Para mais informações sobre dependências, consulte Adicionar dependências de build.

Versão 1.9.0

28 de outubro de 2026

Esta versão inclui as seguintes atualizações:

Versão 1.8.4

10 de setembro de 2026

Esta versão inclui as seguintes atualizações:

  • Atualizamos as dependências transitivas do SDK para que sejam compatíveis com o Kotlin 2.4.0. Isso corrige uma falha que ocorre durante a notificação de função do aplicativo, afetando as versões 1.8.2 e 1.8.3, quando o app de integração não especifica kotlinx-coroutines-core 1.11.0 ou mais recente.

  • Esclarecimento da documentação de Instruction.InstructionType#FORCE.

Versão 1.8.3

12 de agosto de 2026

Esta versão inclui as seguintes atualizações:

  • Correção de um problema em que o SDK podia retornar um estado desatualizado "instalado, mas não pronto" ao usar o papel DEVICE_POLICY_CONTROLLER se o processo do cliente fosse reiniciado após uma preparação bem-sucedida do ambiente.
  • O nível mínimo da API Android com suporte agora é 24 (antes era 23).

Versão 1.8.2

15 de julho de 2026

Esta versão inclui as seguintes atualizações:

  • Correção de um problema em que a chamada de prepareEnvironment não atualizava a Google Play Store para a versão necessária, fazendo com que a instalação da política do dispositivo Android falhasse.

Versão 1.8.1

2 de junho de 2026

Esta versão inclui as seguintes atualizações:

  • Melhoria na confiabilidade e nos relatórios de erros durante o processo de instalação do app Android Device Policy.
  • Melhoramos o fluxo de preparação do ambiente para aumentar a compatibilidade e a confiabilidade durante as atualizações da Google Play Store.

Versão 1.8.0

15 de abril de 2026

Esta versão apresenta suporte para parceiros OEM, permitindo que os clientes de OTA (Over-the-Air) do OEM se comuniquem de forma bidirecional com o app Política do dispositivo Android (ADP) sobre atualizações do sistema.

Esta versão inclui as seguintes atualizações:

  • Adição da interface OemSystemUpdateClient, que permite que os clientes de OTA do OEM informem o ADP sobre atualizações e consultem instruções. A interface inclui métodos para:
    • Criar, receber e listar atualizações do sistema (por exemplo, createSystemUpdate, getSystemUpdate, listSystemUpdates).
    • Informar vários estágios do processo de atualização (por exemplo, reportSystemUpdateDownloading, reportSystemUpdateDownloaded, reportSystemUpdateApplied, reportSystemUpdateAborted).
    • Relate as ações tomadas ao substituir as instruções da AMAPI ou quando for impedido de segui-las (por exemplo, reportSystemUpdateDownloadingWithOverride, reportSystemUpdateDownloadPrevented).
    • Gerenciar e consultar o estado de controle de atualização (por exemplo, updateUpdateControlState, getUpdateControlState).
  • Adicione a interface OemSystemUpdateHandler, que os clientes de OTA do OEM precisam implementar para receber callbacks do ADP. Isso inclui:
    • onSystemUpdatesChanged: notifica o cliente OEM sobre mudanças nas instruções de atualização.
    • listPendingSystemUpdates: chamado pelo ADP para solicitar a lista de atualizações pendentes.
    • getUpdateControlState: chamado pelo ADP para recuperar o estado de controle de atualização atual do cliente OEM.

Versão 1.7.1

19 de janeiro de 2026

Esta versão inclui as seguintes atualizações:

  • Correção de um bug que impedia que os aplicativos chamassem prepareEnvironment no Android 8 ou versões anteriores ao usar o papel DEVICE_POLICY_CONTROLLER. Outros papéis ainda exigem o Android 10 ou mais recente.
  • Melhoria no registro para diagnósticos mais precisos. Recomendamos que os parceiros adotem essa versão.

Versão 1.7.0

3 de novembro de 2025

Esta versão inclui as seguintes atualizações:

  • Adicione aos indicadores de confiança do dispositivo disponíveis o ManagementProviderInfo, que contém um nome comercial legível por humanos do provedor de gerenciamento.
  • Introdução do comando REQUEST_DEVICE_INFO para permitir que apps DPC leiam o EID do dispositivo. Chame IssueCommandRequest com um tipo RequestDeviceInfo e especifique DeviceInfo.EID como o identificador do dispositivo que está sendo solicitado.
  • Atualização das dependências para corrigir a CVE-2023-2976.

Versão 1.7.0-rc01

29 de setembro de 2025

Esta versão inclui as seguintes atualizações:

  • Adicione aos indicadores de confiança do dispositivo disponíveis o ManagementProviderInfo, que contém um nome comercial legível por humanos do provedor de gerenciamento.
  • Introdução do comando REQUEST_DEVICE_INFO para permitir que apps DPC leiam o EID do dispositivo. Chame IssueCommandRequest com um tipo RequestDeviceInfo e especifique DeviceInfo.EID como o identificador do dispositivo que está sendo solicitado.

Versão 1.6.0

11 de setembro de 2025

Esta versão inclui as seguintes atualizações:

Versão 1.6.0-rc01

28 de agosto de 2025

Esta versão inclui as seguintes atualizações:

  • Introduzir a possibilidade de os EMMs que usam a API Android Management instalarem aplicativos personalizados. Consulte Gerenciar apps personalizados com a AMAPI.
  • Aumente o minSDK para o nível 23 da API.

Versão 1.5.0

11 de agosto de 2025

Esta versão inclui as seguintes atualizações:

  • Melhoria no fluxo de registro de dispositivos para controladores de política de dispositivo (DPC) personalizados. Essa abordagem simplificada usa o SDK da AMAPI e o app Android Device Policy (ADP) para facilitar o registro de dispositivos.
  • Melhorias de estabilidade e desempenho com mais informações disponíveis nas exceções de confiança do dispositivo. Consulte AmapiSdkException.

Versão 1.5.0-rc01

24 de julho de 2025

Esta versão apresenta um fluxo de registro de dispositivos aprimorado para controladores de política de dispositivo (DPC) personalizados. Essa abordagem simplificada usa o SDK da AMAPI e o app Android Device Policy (ADP) para facilitar o registro de dispositivos.

Versão 1.4.0

18 de junho de 2025

Esta versão inclui o indicador Device.WorkProfileState para identificar o estado de gerenciamento do dispositivo.

Não há diferenças em relação à v1.4.0-rc01.

Versão 1.4.0-rc01

2 de junho de 2025

Esta versão inclui o indicador Device.WorkProfileState para identificar o estado de gerenciamento do dispositivo.

Versão 1.3.0

14 de abril de 2025

Esta versão inclui o primeiro lançamento do Device Trust do Android Enterprise.

Não há diferenças em relação à v1.3.0-rc01.

Versão 1.3.0-rc01

18 de fevereiro de 2025

Esta versão inclui a primeira versão candidata a lançamento do Device Trust do Android Enterprise.

Versão 1.1.5

13 de maio de 2024

Esta versão inclui as seguintes atualizações:

  • Correções de bugs e melhorias internas.

Versão 1.1.4

24 de janeiro de 2024

Esta versão inclui as seguintes atualizações:

Versão 1.0.1

15 de fevereiro de 2022

Esta versão inclui as seguintes atualizações:

  • Correções de bugs e melhorias internas.

Versão 1.0.0

20 de setembro de 2021

Esta versão inclui as seguintes atualizações:

  • Versão inicial.