# Instalação Pulsus - ZEBRA TC21

<span data-path-to-node="1,0">Essa é uma opção que permite provisionar e configurar o agente Pulsus MDM em modo Kiosk (*Device Owner*) no coletor de dados Zebra TC21 rodando Android 10 Nativo (Enterprise)</span><span class="" data-path-to-node="1,1"><sup class="superscript"></sup></span><span data-path-to-node="1,2">. Embora o equipamento possua integração de fábrica com o ecossistema Android Enterprise, devido às travas de permissão de localização do Android 10, é necessário executar a injeção de parâmetros via terminal (ADB) localmente em bancada para liberar o uso seguro em loja</span><span class="" data-path-to-node="1,3"><sup class="superscript"></sup></span><span data-path-to-node="1,4">.</span>

#### <span data-path-to-node="2,0">**1. Objetivo**</span><span class="" data-path-to-node="2,1"><sup class="superscript"></sup></span>

<span data-path-to-node="2,2">Orientar na configuração via Android Enterprise (AFW), na quebra do loop de localização via linha de comando (ADB) e na sincronização remota do coletor Zebra TC21</span><span class="" data-path-to-node="2,3"><sup class="superscript"></sup></span><span data-path-to-node="2,4">. Este procedimento elimina o travamento cíclico de permissões de GPS do Android 10 e garante a operação estável e segura do dispositivo em loja ou logística</span><span class="" data-path-to-node="2,5"><sup class="superscript"></sup></span><span data-path-to-node="2,6">.</span>

---

#### <span data-path-to-node="3,0">**2. Configuração via Android Enterprise (AfW)**</span><span class="" data-path-to-node="3,1"><sup class="superscript"></sup></span>

<span data-path-to-node="3,2">A inscrição do Zebra TC21 é realizada de forma limpa diretamente no assistente de primeiro uso do Android</span><span class="" data-path-to-node="3,3"><sup class="superscript"></sup></span><span data-path-to-node="3,4">:</span>

- <span data-path-to-node="4,0,0,0">Realize o reset completo de fábrica do dispositivo (*Hard Reset*)</span><span class="" data-path-to-node="4,0,0,1"><sup class="superscript"></sup></span><span data-path-to-node="4,0,0,2">.</span>
- <span data-path-to-node="4,1,0,0">Na tela inicial de boas-vindas do assistente do Google (*Setup Wizard*), avance as etapas e conecte-se à rede Wi-Fi corporativa</span><span class="" data-path-to-node="4,1,0,1"><sup class="superscript"></sup></span><span data-path-to-node="4,1,0,2">.</span>
- <span data-path-to-node="4,2,0,0">No campo de inclusão de conta de e-mail do Google, digite o identificador oficial de inscrição da plataforma</span><span class="" data-path-to-node="4,2,0,1"><sup class="superscript"></sup></span><span data-path-to-node="4,2,0,2">: `afw#pulsus`</span><span class="" data-path-to-node="4,2,0,3"><sup class="superscript"></sup></span>

[![image.png](https://kb.illimitar.pro/uploads/images/gallery/2026-11/scaled-1680-/01Kimage.png)](https://kb.illimitar.pro/uploads/images/gallery/2026-11/01Kimage.png)

<p class="callout info"><span data-path-to-node="5,0,0">**Informação:** Ao reconhecer a instrução `afw#pulsus`, basta avançar e instalar, o Android realiza o download automático do pacote do agente Pulsus e registra a aplicação com o papel de *Device Owner*</span><span data-path-to-node="5,0,1"><sup class="superscript"></sup></span><span data-path-to-node="5,0,2">.</span></p>

---

#### **3. Quebra do Loop de Localização (Scripts via Linha de Comando)**<span class="" data-path-to-node="6,1"><sup class="superscript"></sup></span>

<p class="callout warning"><span data-path-to-node="7,0,0">**Atenção (Sintoma Crítico):** Por regras internas de privacidade do Android 10, o agente Pulsus entra em um travamento cíclico infinito na tela de inicialização pedindo permissões de GPS em segundo plano</span><span data-path-to-node="7,0,1"><sup class="superscript"></sup></span><span data-path-to-node="7,0,2">.</span></p>

- <span data-path-to-node="8,0,0,0">Para realizar o contorno (*bypass*) permanente desse loop, ative a **Depuração USB** nas opções do desenvolvedor do Zebra e execute os comandos abaixo em lote no terminal (substituindo `[ID_DO_ZEBRA]` pelo identificador do aparelho) conforme a numeração</span><span class="" data-path-to-node="8,0,0,1"><sup class="superscript"></sup></span><span data-path-to-node="8,0,0,2">:</span>
- <span data-path-to-node="8,0,0,2">Certifique-se de que o **SDK Platform-Tools (ADB)** esteja ativo no computador.</span>
- <span data-path-to-node="8,0,0,2">No coletor, ative as **Opções de Desenvolvedor** clicando **7 vezes** na versão de compilação e habilite a **Depuração USB**.</span>

**1 - Validar a comunicação do cabo USB com o aparelho:**

`./adb devices`

<p class="callout info">**Exemplo de retorno:** L2S123456789 device - (utilize esse código nos comandos abaixo).</p>

<span data-path-to-node="9,0,0,0">**2- Conceder permissão de localização precisa (GPS de alta precisão):**</span><span class="" data-path-to-node="9,0,0,1"><sup class="superscript"></sup></span>

<span data-path-to-node="9,0,0,2">`./adb -s [ID_DO_ZEBRA] shell pm grant mobi.pulsus android.permission.ACCESS_FINE_LOCATION`</span><span class="" data-path-to-node="9,0,0,3"><sup class="superscript"></sup></span>

<span data-path-to-node="9,1,0,0">**3- Conceder permissão de localização aproximada (Triangulação de Antenas/Wi-Fi):**</span><span class="" data-path-to-node="9,1,0,1"><sup class="superscript"></sup></span>

<span data-path-to-node="9,1,0,2">`./adb -s [ID_DO_ZEBRA] shell pm grant mobi.pulsus android.permission.ACCESS_COARSE_LOCATION`</span><span class="" data-path-to-node="9,1,0,3"><sup class="superscript"></sup></span>

<span data-path-to-node="9,2,0,0">**4- Conceder direito crítico de rastreamento em segundo plano ("Permitir o tempo todo"):**</span><span class="" data-path-to-node="9,2,0,1"><sup class="superscript"></sup></span>

<span data-path-to-node="9,2,0,2">`./adb -s [ID_DO_ZEBRA] shell pm grant mobi.pulsus android.permission.ACCESS_BACKGROUND_LOCATION`</span><span class="" data-path-to-node="9,2,0,3"><sup class="superscript"></sup></span>

<span data-path-to-node="9,3,0,0">**5- Forçar ativação conjunta e permanente de todas as antenas de localização no banco de dados:**</span><span class="" data-path-to-node="9,3,0,1"><sup class="superscript"></sup></span>

<span data-path-to-node="9,3,0,2">`./adb -s [ID_DO_ZEBRA] shell settings put secure location_providers_allowed +gps, network`</span><span class="" data-path-to-node="9,3,0,3"><sup class="superscript"></sup></span>

<span data-path-to-node="9,4,0,0">**6- Encerrar o processo do aplicativo Pulsus para salvar e validar o novo estado das flags:**</span><span class="" data-path-to-node="9,4,0,1"><sup class="superscript"></sup></span>

<span data-path-to-node="9,4,0,2">`./adb -s [ID_DO_ZEBRA] shell am force-stop mobi.pulsus`</span><span class="" data-path-to-node="9,4,0,3"><sup class="superscript"></sup></span>

<span data-path-to-node="9,5,0,0">**7- Comando de auditoria para certificar a retenção do Device Owner:**</span><span class="" data-path-to-node="9,5,0,1"><sup class="superscript"></sup></span>

<span data-path-to-node="9,5,0,2">`./adb -s [ID_DO_ZEBRA] shell dpm set-device-owner mobi.pulsus/.messaging.DeviceAdminReceiver`</span><span class="" data-path-to-node="9,5,0,3"><sup class="superscript"></sup></span>

---

#### <span data-path-to-node="10,0">**4. Sincronismo e Reinicialização Remota**</span><span class="" data-path-to-node="10,1"><sup class="superscript"></sup></span>

- <span data-path-to-node="11,0,0,0">Imediatamente após rodar os comandos de 1 a 7 no terminal, acesse o **Painel Web do Pulsus** no navegador</span><span class="" data-path-to-node="11,0,0,1"><sup class="superscript"></sup></span><span data-path-to-node="11,0,0,2">.</span>
- <span data-path-to-node="11,1,0,0">Localize o dispositivo **Zebra TC21** e dispare o comando remoto de **Reiniciar** o aparelho</span><span class="" data-path-to-node="11,1,0,1"><sup class="superscript"></sup></span><span data-path-to-node="11,1,0,2">.</span>

[![Captura de Tela 2026-11-19 às 11.44.41.png](https://kb.illimitar.pro/uploads/images/gallery/2026-11/scaled-1680-/captura-de-tela-2026-11-19-as-11-44-41.png)](https://kb.illimitar.pro/uploads/images/gallery/2026-11/captura-de-tela-2026-11-19-as-11-44-41.png)

<p class="callout success"><span data-path-to-node="12,0,0">**Sucesso:** No retorno da inicialização após o reinício remoto, o loop de localização terá sumido por completo e o equipamento estará estabilizado</span><span data-path-to-node="12,0,1"><sup class="superscript"></sup></span><span data-path-to-node="12,0,2">.</span></p>

---

#### <span data-path-to-node="13,0">**5. Conclusão** </span>

<span data-path-to-node="13,0">Com essas etapas concluídas em bancada, o coletor de dados Zebra TC21 estará devidamente inscrito como *Device Owner* e livre das travas de localização do Android 10</span><span class="" data-path-to-node="13,1"><sup class="superscript"></sup></span><span data-path-to-node="13,2">. O aparelho operará de forma estável, segura e pronto para uso em loja ou logística</span><span class="" data-path-to-node="13,3"><sup class="superscript"></sup></span><span data-path-to-node="13,4">.</span>