Implantar o Zebra OEMConfig e o Enterprise Browser

Aplicação: Nomid MDM Documento: V1.0.0 Última atualização: 07/11/2026 Responsável editorial: Documentação Nomid MDM Última revisão editorial: 07/11/2026 Idioma editorial: pt-BR

Este guia mostra como instalar dois apps da Zebra pelo Google Play gerenciado em dispositivos Zebra gerenciados pelo Nomid MDM e como configurá-los com configurações gerenciadas:

• Zebra OEMConfig Powered by MX (com.zebra.oemconfig.release) aplica configurações do dispositivo Zebra, como relógio, tela, Wi-Fi, leitor (DataWedge), teclado e licenças, por meio do framework de gerenciamento MX da Zebra.
• Zebra Enterprise Browser (com.zebra.mdna.enterprisebrowser) executa apps web em dispositivos Zebra, com opções de quiosque, leitura de códigos e SAP.

Você pode implantar cada app sozinho. As etapas usam o editor Policy 2.0. No editor Classic, os mesmos campos abrem pela engrenagem do card do app; veja 4.1 Políticas de tablets — Classic.

Risco: o OEMConfig altera configurações do próprio dispositivo. Um valor errado de Wi-Fi, relógio, bloqueio de tela, serviços do Google ou atualização pode desconectar o dispositivo da rede e do gerenciamento, impedir o acesso das pessoas ou reiniciar o dispositivo. As configurações de quiosque do Enterprise Browser podem desativar as teclas HOME, BACK e RECENT. O comportamento no dispositivo descrito neste guia vem da documentação da Zebra. Teste cada mudança em uma política piloto com um único dispositivo Zebra antes de vincular a política à frota.

Antes de começar

• Uma empresa Android Enterprise no Nomid MDM com dispositivos Zebra totalmente gerenciados, e a permissão Editar política na política que você vai alterar.
• Dispositivos Zebra com os serviços do Google Play. O Google Play gerenciado só instala os dois apps em dispositivos com Google Mobile Services (GMS). Para dispositivos sem GMS, a Zebra oferece o OEMConfig no portal de suporte dela; essa instalação está fora deste guia.
• O app OEMConfig certo para a versão do Android. Segundo a Zebra, o Zebra OEMConfig Powered by MX (com.zebra.oemconfig.release) é compatível com o Android 11 e posteriores e não é compatível com o Android 10 ou anteriores. O Legacy Zebra OEMConfig (com.zebra.oemconfig.common) atende dispositivos mais antigos e não é compatível com o Android 13 ou posteriores. Em uma frota com os dois casos, use políticas separadas. Este guia usa o Powered by MX.
• Para as configurações gerenciadas do Enterprise Browser, a Zebra exige o Enterprise Browser 5.0 ou posterior em dispositivos Zebra com Android 11 ou posterior. O licenciamento do Enterprise Browser é tratado pela Zebra; consulte a documentação do Enterprise Browser.
• Uma política piloto vinculada a um único dispositivo Zebra de teste, para que um valor errado afete somente esse dispositivo.

Adicionar os apps à política

1. No Portal Nomid, abra Políticas e selecione a política piloto.
2. Abra a aba Apps e experiência e selecione Apps nesta política.
3. Selecione Adicionar App. Escolha Adicionar via Pacote, digite com.zebra.oemconfig.release e confira se Zebra OEMConfig Powered by MX aparece abaixo do campo. Selecione Adicionar. Você também pode escolher Adicionar via Play Store e procurar o app no Google Play gerenciado.

Digite o nome do pacote e confira se o resultado é o app da Zebra antes de adicioná-lo.

4. Repita a etapa 3 com com.zebra.mdna.enterprisebrowser para adicionar o Zebra Enterprise Browser.
5. Os dois apps passam a aparecer na lista com o selo Configurável, que indica que eles publicam configurações gerenciadas. O rodapé do painel mostra Editado. Salve a política para aplicar até você salvar. A opção de instalação ao lado de cada app começa como Obrigatório, que instala o app e o mantém no dispositivo. Opcional, Bloqueado e os demais controles do app estão descritos em 4. Políticas — Policy 2.0.

Abrir as configurações gerenciadas

Selecione a engrenagem ao lado do app na lista. O editor Configurações gerenciadas lista todos os campos que a versão atual do app publica. O Google Play fornece essa lista a partir do app, por isso ela muda quando a Zebra lança uma nova versão; o Google Play guarda somente o esquema mais recente.

• Cada campo mostra o título, uma descrição escrita pela Zebra e o nome da chave. A Zebra publica títulos e descrições em inglês. O botão ao lado da chave copia um link para aquele campo.
• As descrições do OEMConfig costumam terminar com Supported from: MX e uma versão, ou com Not supported on Device(s) e uma lista de modelos. O campo não tem efeito em um dispositivo com versão do MX mais antiga nem em um modelo listado.
• Valor padrão mostra o valor que o app declara. É apenas informativo: o editor não o envia.
• Um campo de escolha mostra Select options... até você escolher um valor. Enquanto mostra esse texto, o Nomid não envia nada para o campo. Use o × do campo para limpá-lo. Algumas escolhas do OEMConfig incluem Do not change, que é um valor definido pela Zebra, e não um campo vazio.
• Os grupos abrem e fecham pela seta à direita; Expandir Tudo e Recolher tudo fazem isso em todos os grupos. Um grupo com valores mostra Limpar configuração, que limpa todos os valores daquele grupo.
• Listas, como Files Configuration ou Package Configuration no OEMConfig, começam vazias. Adicionar Novo Item adiciona um elemento e mostra os campos dele; o × do elemento o remove.
• Use a caixa de filtro para encontrar uma chave, e Todos, Preenchido ou Não Preenchido para revisar o que você preencheu.
• Apagar todas as configurações, no fim do editor, apaga todos os valores deste app na política.
• Salvar mantém seus valores na edição da política. Cancelar pergunta Descartar suas alterações?: Descartar sai do editor sem eles, e Continuar editando volta ao editor. Nenhuma das duas envia algo aos dispositivos até você salvar a política.

Configurações do Zebra OEMConfig

O OEMConfig Powered by MX organiza as configurações em nove grupos principais. Em 07/11/2026, o editor mostrava quase 500 campos, além dos campos de cada elemento de lista. A tabela traz os grupos e o que cada um cobre, segundo as descrições da própria Zebra. Para cada campo, siga a descrição no editor e a documentação do OEMConfig da Zebra (em inglês).

Recolher tudo mostra os grupos principais e suas chaves; role para ver o restante. Abra somente o grupo de que precisa.

Alguns grupos pedem cuidado extra:

• Wireless LAN e Network Connection mudam a forma como o dispositivo se conecta. As políticas do Nomid também gerenciam redes Wi-Fi em Conectividade. Configure cada rede em um só lugar e mantenha uma rede funcionando no dispositivo piloto até confirmar a mudança.
• GMS Configuration pode limitar quais apps e serviços do Google funcionam. O gerenciamento Android Enterprise e o Google Play gerenciado dependem dos serviços do Google Play.
• Lifeguard Configuration controla as atualizações do sistema Zebra LifeGuard, incluindo modo de atualização, atualizações pela rede celular e supressão de reinicialização. Planeje-o junto com suas janelas de atualização; as políticas do Nomid também têm configurações de atualização do sistema em Sistema.
• Screen Lock Configuration se sobrepõe às configurações de senha e bloqueio da política Nomid. Defina cada opção em um só lugar.
• Pass-Through Command envia XML do MX diretamente ao dispositivo. A descrição da Zebra diz que o XML não pode incluir Batch, ConditionMgr nem XML de persistência. Use-o somente para recursos que o esquema não oferece.

Exemplo de valores do OEMConfig para dispositivos compartilhados

Este exemplo mantém o relógio e a tela consistentes em dispositivos compartilhados. Troque ntp.example.com pelo seu servidor de horário.

Chaves do Enterprise Browser

A Zebra descreve como o Enterprise Browser trata as configurações gerenciadas em Using Managed Configurations (em inglês):

• Configurações gerenciadas e um arquivo Config.xml não podem ser combinados. Quando as configurações gerenciadas chegam, o Enterprise Browser grava um novo Config.xml só com esses valores; todas as outras configurações voltam ao padrão.
• Os novos valores passam a valer na próxima vez que o Enterprise Browser abrir. Se ele estiver aberto quando a mudança chegar, mostra uma mensagem no dispositivo.
• O Enterprise Browser precisa estar instalado e ter sido aberto uma vez no dispositivo antes que qualquer configuração seja aplicada.
• A Zebra informa que algumas configurações do Enterprise Browser existem somente no Config.xml. Se precisar de uma delas, use o Config.xml em vez das configurações gerenciadas.

Cada campo mostra a chave e o valor padrão que a Zebra declara.

As tabelas seguem os títulos dos campos exibidos no editor; quando a chave é diferente, ela aparece entre parênteses. A maioria dos valores padrão aparece como números: segundo a Zebra, 0 é a primeira opção (Turn Off, Hidden ou Use EMDK) e 1 é a segunda (Turn On, Shown ou Use DataWedge). Em 07/11/2026, o editor mostrava 67 campos e 2 listas.

Navigation Configuration (navigationConfig)

Kiosk Configuration (kioskConfig)

Barcode Scanning Configuration (barcodeScanningConfig)

ScannerOnNav e ExistingAudioFile ficam dentro de EMDKBarcodeConfiguration; os três campos de bipe ficam em UseEBGeneratedAudio, dentro dele. A Zebra exige que os três campos de bipe sejam definidos juntos.

Application UI Configuration (appUiConfig)

Broadcast Receiver Configuration (broadcastReceiverConfig)

DOM Custom Configuration (domCustomConfiguration)

Licença, teclado e WebView

Os campos de zoom ficam em webViewConfig > webUiConfig > zoomConfig, e os de viewport em viewPortConfig, ao lado.

SAP ITS e ZPP

Estes grupos valem somente para apps SAP. SAP ITS Configuration (sapItsConfig) é para apps SAP ITSmobile, e ZPP Configuration (zppConfig) é para o Zebra Picking Plus, o app da Zebra baseado no Enterprise Browser para o SAP Extended Warehouse Management (EWM).

As onze primeiras linhas pertencem ao SAP ITS e as demais ao ZPP.

Nomes na documentação da Zebra

A página de configurações gerenciadas da Zebra lista a maioria das configurações pelos títulos acima, e não pelas chaves, e alguns nomes diferem do editor: ela usa BadLinkUri para BadLinkUrl, EbKb para KbEb e IntentCategrory para a lista de categorias de intent, e não lista o AutoRotate. O editor mostra o que o app publica, e o Nomid envia as chaves que ele mostra.

Exemplo de política do Enterprise Browser para dispositivos compartilhados

Este exemplo abre um app web de armazém em tela cheia e mantém o navegador nos sites da empresa. Troque os endereços pelos seus.

Confira no dispositivo piloto todos os endereços que seu app web carrega, inclusive páginas de login: um endereço que falte em UrlWhitelist é bloqueado.

Para manter as pessoas dentro do Enterprise Browser, prefira o quiosque de app único do Nomid: em Modo launcher, escolha Nomid Quiosque, Aplicativo único e o Enterprise Browser como Aplicativo de quiosque, conforme 4. Políticas — Policy 2.0. Ele mantém uma saída de manutenção protegida por senha. Se, em vez disso, desativar as teclas HOME, BACK e RECENT no Enterprise Browser, confira no dispositivo piloto que ainda é possível sair do app para manutenção.

Use Preenchido para revisar todos os valores antes de salvar.

Salvar e aplicar a política

1. No editor de configurações gerenciadas, selecione Salvar e depois Concluído no painel de apps.
2. Selecione Salvar no cabeçalho da política, revise a lista de alterações e confirme.
3. Os dispositivos vinculados recebem a política quando sincronizam. O OEMConfig aplica os valores que recebe; o Enterprise Browser os aplica na próxima vez que abrir.

Verificar no dispositivo

1. Em Dispositivos, abra o dispositivo piloto, execute uma sincronização e confirme que os dois apps estão instalados.
2. Confira cada configuração do OEMConfig no próprio dispositivo. Com os valores do exemplo, as configurações de data e hora do Android devem mostrar hora automática e formato de 24 horas, e a tela deve apagar depois de cinco minutos. As notas de versão da Zebra dizem que o OEMConfig 10.0 e posteriores mostram um resultado SUCCESS ou FAILURE para as ações de configuração gerenciada. O Portal Nomid não mostra esses resultados.
3. Abra o Enterprise Browser uma vez. Se ele já estava aberto, feche-o e abra de novo. A página inicial abre em tela cheia, a barra de status fica oculta e um endereço fora de UrlWhitelist é bloqueado.

Solução de problemas

Desfazer a configuração

• Para deixar de enviar um valor, limpe o campo pelo × e salve a política. Limpar um campo não restaura necessariamente a configuração anterior do dispositivo; para voltar uma configuração do dispositivo, escolha o valor que deseja e salve.
• Limpar configuração limpa um grupo, e Apagar todas as configurações remove todos os valores do app desta política depois que você salva.
• Para remover um app, mude a instalação para Bloqueado, conforme 4. Políticas — Policy 2.0, e salve.

Veja também

• 4. Políticas — Policy 2.0: apps e modo launcher
• 4.1 Políticas de tablets — Classic: configuração gerenciada do app
• 3. Dispositivos: sincronização e apps instalados
• Documentação do Zebra OEMConfig (em inglês)
• Perguntas frequentes do Zebra OEMConfig (em inglês)
• Zebra Enterprise Browser: uso de configurações gerenciadas (em inglês)