Skip to main content

Instalação Pulsus - Sunmi LS2

Instalação Pulsus - SUNMI L2s (Android 9) 

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.

     


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

     

    [BLOCO DE AVISO - LARANJA] 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. 

      Ambiente no Computador: Certifique-se de que o SDK Platform-Tools (ADB) esteja instalado e configurado no computador de testes. 

      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 dodos terminalarquivos 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 9 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

        [BLOCO DE INFORMAÇÃO - AZUL] 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 Políticaconfiguração doque Gruposerá →utilizada abano Launchersdispositivo.

        No campo de inclusão manual de pacotes (inferior esquerdo), cadastre as informações abaixo, clique no botão + e posicione o ícone na tela do aparelho simulado: image.png

        • Manter desabilitada a opção Nome"DESABILITAR doRECURSOS pacote:DE DEPURAÇÃO" Configurações 

         

        ID do pacote: com.android.settings 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.

         


        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.