Instalação Pulsus - Totem Sunmi K2 Mini
Instalação Pulsus - Totem Sunmi K2 Mini
Essa é uma opção que permite configurar e estabilizar o agente Pulsus MDM em modo Kiosk (Device Owner) no Totem Sunmi K2 Mini rodando Android 7.1.2 (Sunmi OS Custom). Devido a disputas de privilégios com o launcher nativo da fabricante (com.woyou.launcher), é necessário aplicar comandos via protocolo de depuração ADB para forçar o sistema operacional a delegar o controle da tela inicial exclusivamente ao Pulsus.
1. Objetivo Orientar na execução dos comandos via ADB para eliminar o loop de inicialização ("Tentando aplicar o launcher" / "Demorando muito?") e estabelecer o protocolo padrão de manutenção remota no Totem Sunmi K2 Mini. Este procedimento garante a blindagem total da interface em Modo Quiosque e impede brechas de saída pelo botão Home.
2. Pré-requisitos e Restrições do Sistema
[BLOCO DE AVISO - LARANJA] Atenção (Abordagens Incompatíveis): Não utilize o comando
pm hide com.woyou.launcher(bloqueado pelo sistema com erro SecurityException), não ative o Pulsus no menu oculto de hardware Lab → Kiosk (gera loop infinito de renderização) e não mantenha o Nova Launcher ativo como intermediário (gera brecha de segurança no botão Home).
-
Ambiente no Computador: Certifique-se de que o SDK Platform-Tools (ADB) esteja configurado e que o totem esteja conectado via cabo de depuração USB.
-
Identificação do Equipamento: Obtenha o número de série/ID do dispositivo conectado (exemplo:
KM27228Q40039) através do comando./adb devicespara direcionar os scripts corretamente.
3. Sequência de Comandos no Terminal (Solução Definitiva) Para interromper a interceptação do utilitário proprietário PMUtils e remover alternativas de interface que impedem o registro da tela inicial (HOME intent), execute os comandos abaixo no terminal (substituindo [ID_DO_TOTEM] pelo serial do aparelho) conforme a numeração:
-
Desativar o launcher de fábrica da Sunmi (congela o pacote nativo no usuário padrão):
./adb -s [ID_DO_TOTEM] shell pm disable-user --user 0 com.woyou.launcher -
Desativar o Nova Launcher (caso tenha sido instalado como contingência inicial, zerando prioridades anteriores):
./adb -s [ID_DO_TOTEM] shell pm disable-user --user 0 com.teslacoilsw.launcher -
Invocar a intenção de inicialização primária (força o Android a reavaliar e delegar a tela inicial ao Pulsus):
./adb -s [ID_DO_TOTEM] shell am start -a android.intent.action.MAIN -c android.intent.category.HOME
[BLOCO DE SUCESSO - VERDE] Sucesso: O agente do Pulsus assumirá imediatamente o topo da hierarquia do sistema, eliminando o loop de carregamento. O acionamento repetido do botão Home físico ou virtual apenas atualizará a tela do quiosque, sem permitir o vazamento para a área de trabalho.
4. Protocolo Operacional para Manutenções Futuras Como os launchers de retaguarda foram desativados, o acionamento local do "Modo Manutenção" por senha não exibirá uma área de trabalho tradicional. Utilize os procedimentos abaixo sempre que precisar realizar ajustes no totem:
-
Manutenção Padrão (Via Nuvem): Acesse o painel web da Pulsus, edite temporariamente o layout do grupo do totem e adicione o aplicativo nativo Configurações (
com.android.settings). O ícone aparecerá na tela em segundos. Após concluir os ajustes locais, remova o pacote do layout web para ocultá-lo novamente do usuário final. -
Manutenção de Rede (Sem Wi-Fi): Caso o totem perca a conexão Wi-Fi ou seja movido de loja, conecte um cabo de rede físico na entrada nativa Ethernet (RJ45) do equipamento. O totem recuperará o acesso à internet instantaneamente, permitindo liberar o ícone de Configurações via nuvem para reconfigurar o Wi-Fi local.
[BLOCO DE INFORMAÇÃO - AZUL] Informação: Graças à entrada nativa RJ45 do Totem Sunmi K2 Mini, manutenções de rede em loja não exigem o uso de cabo ADB ou a reativação de launchers de terceiros.
5. Conclusão Com essas etapas concluídas, o Totem Sunmi K2 Mini estará devidamente estabilizado, livre do conflito de launchers do Sunmi OS e operando em Modo Quiosque blindado pelo Pulsus MDM. O equipamento está homologado e pronto para operar de forma contínua e segura no ambiente de loja.