Skip to main content

Instalação Pulsus - Sunmi LS2

Essa é uma opção que permite instalar e configurar o agente Pulsus MDM em modo Kiosk (Device Owner) no coletor mobile SUNMI L2s rodando Sunmi OS. É necessário manipular parâmetros do sistema (Android) via linha de comando (ADB) por cabo físico e desativar pacotes na raiz do Android.

  1. Objetivo
    Orientar na preparação, execução de comandos via ADB e configuração preventiva no painel web para provisionar o agente Pulsus MDM no coletor SUNMI L2s
    . Este procedimento mitiga o travamento de interface causado pelo launcher nativo da fabricante e garante que o dispositivo opere de forma estável e segura em modo restrito.


4. Configuração Preventiva no Painel Web Pulsus

    Acesse o menu lateral "Configurações" e selecione a configuração que será utilizada no dispositivo. 

    image.png

      Manter desabilitada a opção "DESABILITAR RECURSOS DE DEPURAÇÃO"

       


       

      image.png


      Perigo: Mantenha esta opção sempre desativada ("Não"). Caso ela esteja ativa quando o dispositivo sincronizar com o grupo, o acesso via ADB será bloqueado pela política. Em caso de looping de interface onde seja necessário ativar a depuração para manutenção, a única solução será resetar o aparelho pelo Pulsus.

       

       

      2. Pré-requisitos e Preparação do Dispositivo

      Atenção (Limpeza Crítica de Segurança): Antes de rodar os comandos, acesse Ajustes → Contas no dispositivo e remova todas as contas ativas (Google, Sunmi ou corporativas). Contas ativas bloqueiam a atribuição de privilégios máximos de Device Owner.

      • Arquivos Necessários: Aloque o arquivo APK do agente Pulsus (ex: latest-pulsus.apk) e o APK do launcher alternativo (nova-launcher.apk) no mesmo diretório dos arquivos adb.

      • Depuração USB: No coletor, acesse Ajustes → Sobre o dispositivo → Versão de compilação, clique 7 vezes consecutivas para liberar o menu de desenvolvedor e ative a opção Depuração USB.

       


      3. Sequência de Comandos no Terminal (Bypass do Loop)

      O launcher nativo da fabricante (com.woyou.launcher) possui uma trava de concorrência persistente no Android que gera um loop infinito (tela piscando) ao tentar rodar o modo quiosque do Pulsus.

      • Conecte o coletor via cabo USB e execute o roteiro de comandos abaixo no terminal conforme a numeração:

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

      ./adb devices

      Exemplo de retorno: L2S123456789   device  - (utilize esse código nos comandos abaixo).

      2- Instalar o pacote base do agente Pulsus MDM: 

      ./adb -s [SERIAL_DO_APARELHO] install latest-pulsus.apk

      3 - Injetar o privilégio máximo de Device Owner (D.O.) no agente: 

      ./adb -s [SERIAL_DO_APARELHO] shell dpm set-device-owner mobi.pulsus/.messaging.DeviceAdminReceiver

      4 - Conceder permissão avançada de sobreposição de tela no Android: 

      ./adb -s [SERIAL_DO_APARELHO] shell pm grant mobi.pulsus android.permission.SYSTEM_ALERT_WINDOW

      5 - Desativar o launcher nativo da Sunmi no usuário para romper o loop de interface: 

      ./adb -s [SERIAL_DO_APARELHO] shell pm disable-user --user 0 com.woyou.launcher

      6 - Instalar o Nova Launcher como interface reserva de segurança: 

      ./adb -s [SERIAL_DO_APARELHO] install nova-launcher.apk

      Por que instalar o Nova Launcher? Como o launcher original da Sunmi (com.woyou.launcher) foi completamente congelado para cessar o loop de tela piscando, o Android perderia a capacidade de renderizar o sistema caso seja necessário entrar no Modo de Manutenção local por senha. O Nova Launcher funciona puramente como um "estepe neutro" e seguro para abrir as configurações quando invocado.

       


      4. Configuração Preventiva no Painel Web Pulsus

        Acesse o menu lateral "Configurações" e selecione a configuração que será utilizada no dispositivo. 

        image.png

          Manter desabilitada a opção "DESABILITAR RECURSOS DE DEPURAÇÃO"

           

          image.png 



          Na guia Segurança / Restrições, certifique-se de que a flag "Bloquear Depuração USB" permaneça desmarcada
          . 

           

           

          [BLOCO DE SUCESSO - VERDE] Sucesso: Com o loop de interface corrigido, o launcher de contingência instalado e o atalho de Configurações disponível no perfil, o coletor está homologado e pronto para uso operacional. 

          Sucesso: 

           


          5. Conclusão

          Com essas etapas concluídas em bancada, o coletor mobile SUNMI L2s estará devidamente provisionado como Device Owner no Pulsus MDM. O dispositivo operará de forma estável, livre do conflito de tela do sistema nativo e preparado para a operação em loja.