Instalação Pulsus - Totem Sunmi K2 Mini
Essa é uma opção que permite instalar, 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 launcherutilitário nativoproprietário da fabricante (PMUtils) e o launcher nativo (com.woyou.launcher), éa necessárioimplantação aplicardeve comandosser realizada em bancada via protocolocabo deUSB depuraçãoutilizando comandos ADB para forçarinstalar o sistemaaplicativo, operacionalconceder aprivilégios e delegar o controle da tela inicial exclusivamente ao Pulsus.
1. Objetivo
Orientar na configuração preventiva no painel web, preparação do equipamento, instalação do agente Pulsus e execução dos comandos via ADB no Totem Sunmi K2 Mini. Este procedimento elimina o loop de carregamento inicial ("Tentando aplicar o launcher" / "Demorando muito?"), blinda o botão Home e estabelece o protocolo padrão de manutenção remota.
2. Pré-requisitos e Restrições do Sistema
Acesse o menu lateral "Configurações" e selecione o perfil de configuração que será aplicado ao totem.
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.
Ambiente no Computador:
Certifique-se de que o SDK Platform-Tools (ADB) esteja configurado e aloque o arquivo APK do agente Pulsus (latest-pulsus.apk) no mesmo diretório do terminal.
Identificação do Equipamento:
Obtenha o número de série/ID do dispositivo conectado (exemplo: KM27228Q40039) através do comando ./adb devices para direcionar os scripts corretamente.
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):Atenção: Não utilize o comandopm 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 devices para direcionar os scripts corretamente.
3. Sequência de Comandos novia 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:
1- Instalar o pacote base do agente Pulsus MDM:
./adb -s [SERIAL_DO_TOTEM] install latest-pulsus.apk
2- Instalar o pacote base do agente Pulsus MDM:
./adb -s [SERIAL_DO_TOTEM] install latest-pulsus.apk
3- Injetar o privilégio máximo de Device Owner (D.O.) no agente:
./adb -s [SERIAL_DO_TOTEM] 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_TOTEM] shell pm grant mobi.pulsus android.permission.SYSTEM_ALERT_WINDOW
5- Desativar o launcher de fábrica da Sunmi (congela o pacote nativo no usuário padrão):nativo)
./adb -s [ID_DO_TOTEM]SERIAL_DO_TOTEM] shell pm disable-user --user 0 com.woyou.launcher
Desativar6- 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çaForça o Android a reavaliar e delegar a tela inicial ao Pulsus):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 oso launcherslauncher denativo retaguardada foramfabricante desativados,foi desativado, o acionamento local do "Modo Manutenção" por senha não exibirá uma área de trabalho tradicional.tradicional. Utilize os procedimentos abaixo sempre que precisar realizar ajustes no totem: 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 emsegundos.segundos. Após concluir os ajustes locais, remova o pacote do layout web para ocultá-lo novamente do usuáriofinal.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,provisionado como Device Owner, livre do conflito de launchers do Sunmi OS e operando em Modo Quiosque blindado pelo Pulsus MDM.MDM. O equipamento está homologado e pronto para operar de forma contínua e segura no ambiente de loja.loja.


