A partir de 27 de março de 2025, recomendamos usar android-latest-release
em vez de aosp-main
para criar e contribuir com o AOSP. Para mais informações, consulte Mudanças no AOSP.
Atualizações OTA corporativas
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
O
Documento de definição de compatibilidade
do Android (CDD) para software atualizável
exige que os dispositivos implementem a classe
SystemUpdatePolicy
. O SystemUpdatePolicy
permite que o app do proprietário do dispositivo (DO, na sigla em inglês), se
presente, controle a instalação de atualizações do sistema.
Notificar os proprietários dos dispositivos
O cliente OTA precisa notificar os apps do proprietário do dispositivo sobre
as atualizações OTA recebidas usando uma API do sistema. O cliente OTA também precisa
incluir uma gravação de carimbo de data/hora quando a atualização OTA
ficou disponível pela primeira vez. Os clientes OTA podem chamar
DevicePolicyManager.notifyPendingSystemUpdate(long updateReceivedTime, boolean isSecurityPatch)
para notificar os apps de proprietários de dispositivos. Se o cliente OTA não souber se uma atualização
é um patch de segurança, ele poderá usar
DevicePolicyManager.notifyPendingSystemUpdate(long updateReceivedTime)
.
Se uma atualização não estiver disponível no momento, o cliente OTA vai informar isso
definindo o argumento updateReceivedTime
como -1
.
Recomendamos enviar notificações sempre que o cliente OTA consulta o
servidor OTA ou quando um OTA é enviado para o cliente. Também é possível enviar
notificações com mais frequência.
Política de atualização do sistema
O Android 9 aprimora a capacidade dos proprietários de dispositivos
controlar
atualizações, permitindo que eles adiem as atualizações OTA por até
90 dias. Com foco em soluções de dispositivos dedicados (antes chamadas de COSU),
esse recurso permite que os proprietários pausem a versão do SO em execução
em dispositivos durante períodos críticos, como feriados.
Para obedecer ao CDD, o cliente de OTA precisa implementar políticas
comportamentais. O DO pode definir as seguintes políticas, que precisam ser
respeitadas pelos subsistemas de atualização do sistema do dispositivo:
Os proprietários de dispositivos também podem
definir
períodos de congelamento (no Android 9 ou versões mais recentes) que congelam a versão do SO
em períodos críticos, como feriados ou outros momentos de grande demanda. O sistema
não instala atualizações OTA durante um período de congelamento. Recomendamos o uso de
SystemUpdatePolicy.InstallationOption
(consulte
a seção a seguir). No entanto, o cliente OTA também pode chamar
SystemUpdatePolicy.getFreezePeriods()
para verificar se o dispositivo está em um período de congelamento.
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-07-27 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-07-27 UTC."],[],[],null,["# Enterprise OTA updates\n\nThe\n[Android\nCompatibility Definition Document (CDD) Updatable Software](/compatibility/android-cdd#11_updatable_software)\nrequires devices to implement the\n[`SystemUpdatePolicy`](https://developer.android.com/reference/android/app/admin/SystemUpdatePolicy.html)\nclass. `SystemUpdatePolicy` lets the device owner (DO) app, if\npresent, control the installation of system updates.\n\nNotify device owners\n--------------------\n\n\nThe over-the-air (OTA) client must notify device owner apps about\nincoming OTA updates using a system API. The OTA client must also\ninclude a timestamp recording when the OTA update first became\navailable. OTA clients can call\n`DevicePolicyManager.notifyPendingSystemUpdate(long updateReceivedTime, boolean isSecurityPatch)`\nto notify device owner apps. If the OTA client doesn't know if an update\nis a security patch, the OTA client can fall back to using\n`DevicePolicyManager.notifyPendingSystemUpdate(long updateReceivedTime)`.\n\n\nIf an update isn't currently available, the OTA client reports this by\nsetting the `updateReceivedTime` argument to `-1`.\nWe recommend sending notifications whenever the OTA client polls the\nOTA server, or when an OTA is pushed to the client. You can also send\nout notifications more frequently.\n\nSystem update policy\n--------------------\n\n\nAndroid 9 enhances the ability for device\nowners to\n[control\nupdates](https://developer.android.com/work/dpc/system-updates) by allowing device owners to postpone OTA updates for up to\n90 days. Focusing on dedicated device (previously called COSU)\nsolutions, this feature lets owners pause the OS version running on\ndevices over critical periods, such as holidays.\n\n\nTo comply with the CDD, the OTA client must implement behavioral\npolicies. The DO can set the following policies, which must be\nrespected by the device system update subsystems:\n\n- [`TYPE_INSTALL_AUTOMATIC`](https://developer.android.com/reference/android/app/admin/SystemUpdatePolicy.html#TYPE_INSTALL_AUTOMATIC)\n- [`TYPE_INSTALL_WINDOWED`](https://developer.android.com/reference/android/app/admin/SystemUpdatePolicy.html#TYPE_INSTALL_WINDOWED)\n- [`TYPE_POSTPONE`](https://developer.android.com/reference/android/app/admin/SystemUpdatePolicy.html#TYPE_POSTPONE)\n\n\nDevice owners can also\n[set\nfreeze periods](https://developer.android.com/work/dpc/system-updates#freeze-periods) (in Android 9 or later) that freeze the OS version\nover critical periods, such as holidays or other busy times. The system\ndoesn't install OTA updates during a freeze period. We recommend using\n`SystemUpdatePolicy.InstallationOption` (see\nfollowing section), however the OTA client can also call\n[`SystemUpdatePolicy.getFreezePeriods()`](https://developer.android.com/reference/android/app/admin/SystemUpdatePolicy#getFreezePeriods())\nto check if the device is in a freeze period."]]