A primeira macro Android que falha nem sempre tem um problema de lógica. O toque pode estar correto, a condição por imagem pode fazer sentido e, ainda assim, o fluxo não roda porque o aparelho não foi preparado para automação.
O EmuloMobile roda dentro do Android. Por isso, ele precisa dos recursos do próprio sistema que permitem observar a tela e executar os gestos que você configurou. Preparar essas permissões antes de criar uma rotina longa evita uma primeira execução confusa e deixa os testes mais fáceis de interpretar.
Este guia explica o que ativar, por que cada permissão existe e como testar a primeira automação sem dar responsabilidade demais para a macro cedo demais.
Automatize apenas rotinas que você tem autorização para automatizar. As permissões do aparelho permitem que o EmuloMobile execute o fluxo configurado; elas não mudam regras de uso de aplicativos ou serviços de terceiros.
Comece pelas duas responsabilidades obrigatórias
Uma macro Android tem dois trabalhos:
- ler a tela atual para que condições por imagem, texto ou cor decidam se um passo deve rodar;
- executar a ação configurada, como toque, deslize, botão do sistema, captura de tela ou passagem para outra automação.
O EmuloMobile separa esses trabalhos. A captura de tela fornece o quadro visual usado pela detecção. O serviço de acessibilidade executa toques, deslizes, ações do sistema e o overlay de controle. Essa separação importa porque uma macro pode falhar de formas diferentes dependendo da camada que está ausente.
Se a captura de tela não estiver disponível, passos por imagem, cor, OCR e captura não conseguem usar uma tela atual. Se a acessibilidade estiver desativada, o EmuloMobile não consegue injetar gestos nem mostrar os controles de execução por cima do app alvo.
Ative a acessibilidade com a explicação do app
Abra Configurações dentro do EmuloMobile e encontre a opção Serviço de acessibilidade. Ao ativá-la, o app mostra uma explicação antes de abrir as configurações de acessibilidade do Android.
Leia essa explicação com atenção. Ela informa que o serviço de acessibilidade é usado para executar as automações que você cria: tocar, deslizar, usar ações do sistema e manter o controle flutuante disponível enquanto outro app está na tela. Também informa o que o serviço não faz: o EmuloMobile não usa acessibilidade para ler o conteúdo textual de outros aplicativos.
Depois de confirmar, o Android abre as configurações do sistema. Ative EmuloMobile ali e volte ao app. A tela de Configurações deve indicar que o serviço está conectado.
Essa é a camada que torna as ações possíveis. Um toque fixo, um deslize, os controles flutuantes de Play, Pausa e Stop e ações do sistema Android dependem dela.
Autorize a captura de tela antes da primeira execução
Ainda nas Configurações do EmuloMobile, use a opção Captura de tela. O Android mostra o pedido de consentimento do próprio sistema. Ao aprovar, o EmuloMobile pode manter uma sessão de captura disponível para capturas no construtor e execução da macro.
A captura de tela é a camada de visão. Ela permite que a macro inspecione pixels para:
- condições por imagem e clique em imagem;
- condições por cor;
- condições de OCR e toque em texto;
- ações de captura que salvam a tela atual.
Em versões mais novas do Android, o app também pode usar o caminho de captura do serviço de acessibilidade para algumas capturas do construtor, mas a execução depende de uma sessão de captura atual. Se o Android encerrar essa sessão depois, prepare a execução novamente e aprove o pedido outra vez.
A regra prática é simples: se a macro precisa reconhecer algo na tela, configure a captura antes de testar o fluxo.
Confira o modo do aparelho antes de editar ou rodar
O EmuloMobile guarda a resolução e a orientação usadas quando a macro é criada. Isso protege coordenadas, regiões e referências capturadas contra uso em outro formato de tela.
Antes de criar a primeira automação, coloque o celular ou emulador no modo em que a rotina realmente vai rodar. Decida se o fluxo é em retrato ou paisagem, ajuste a janela do emulador ou a orientação do aparelho e evite mudar esse modo depois de salvar a macro.
Se depois aparecer uma mensagem dizendo que a automação foi criada em outra resolução ou modo, não trate isso como uma falha aleatória. Volte o aparelho ao modo original ou recrie a macro no modo que você pretende usar.
Isso é especialmente importante para condições por imagem e cor, porque as regiões estão ligadas à geometria da tela. Uma condição pode estar bem configurada e ainda falhar se a macro estiver rodando em outro layout.
Monte uma macro pequena para conferir as permissões
Antes de criar uma automação longa, monte um fluxo curto que prove que as duas camadas funcionam juntas.
Use uma tela segura, onde um toque acidental não envia, compra, exclui ou confirma nada importante. Uma tela de configurações, um app de teste ou um menu inofensivo é melhor do que uma tela de produção.
Crie uma macro com esta estrutura:
- adicione um toque simples em um ponto seguro;
- adicione uma espera curta ou um segundo passo que permita observar o resultado;
- se precisar de visão, adicione uma condição fácil de reconhecer na tela atual;
- salve a automação explicitamente;
- prepare a execução;
- pressione Play pelo controle flutuante;
- pare a execução assim que confirmar o comportamento.
O objetivo ainda não é automatizar um processo real. O objetivo é confirmar que o EmuloMobile consegue capturar a tela, avaliar a condição, injetar o gesto e mostrar a bolha de controle sobre o app alvo.
Se você ainda precisa entender o fluxo geral de criação, leia o guia de automação Android sem PC, ADB ou root antes de adicionar mais passos.
Entenda o que cada falha significa
Quando a primeira execução falhar, separe problemas de permissão de problemas de desenho da macro.
Se o EmuloMobile pedir para ativar acessibilidade, a camada de ação está ausente. Volte às Configurações, ative o serviço e tente novamente.
Se a mensagem disser que não foi possível obter a captura de tela, a camada de visão está ausente ou o Android encerrou a sessão de captura. Prepare a execução novamente e aprove o pedido de captura.
Se a execução for cancelada por resolução ou modo, a macro salva não combina com a geometria atual da tela. Use a orientação e a resolução originais ou reconstrua a macro no modo atual.
Se a macro roda, mas nenhuma ação dispara, as permissões podem estar corretas. Teste a condição na tela atual. Uma condição falsa por imagem, texto, cor ou variável bloqueia a ação de propósito. Para esse caso, o próximo passo é o guia de teste passo a passo sem apagar ações.
Mantenha as permissões dentro da rotina
Preparar permissões não significa automatizar qualquer tela. Mantenha a primeira macro real estreita e observável.
Use um estado inicial claro. Prefira uma condição visual antes de uma ação sensível. Adicione uma anotação aos passos que existem por segurança ou preparação. Pare a macro quando a tela entrar em um estado que você não desenhou.
Em fluxos que guardam evidência, use a ação de captura apenas quando uma condição precisa estiver verdadeira. O guia de captura automática mostra como evitar capturas repetidas ou desnecessárias.
Em fluxos que dependem de rótulos legíveis, limite o OCR à menor região útil. O guia de tocar em texto com OCR explica por que uma área de busca focada reduz ambiguidade.
Checklist prático antes da primeira execução
Use este checklist antes da primeira execução séria:
- o serviço de acessibilidade do EmuloMobile está conectado;
- a captura de tela está autorizada ou será autorizada durante a preparação;
- o celular ou emulador está na mesma resolução e orientação usadas pela macro;
- a macro foi salva depois da última edição;
- o app alvo já está na tela inicial esperada;
- a primeira ação é segura para teste;
- a bolha de controle está visível antes de deixar a macro rodando;
- você sabe qual condição deve bloquear, pausar ou encerrar o fluxo.
Se algum item estiver incerto, corrija antes de adicionar mais passos. Macros longas escondem erros de preparação; verificações curtas expõem esses problemas rapidamente.
Prepare uma vez, depois construa com confiança
Uma boa automação Android começa antes da primeira ação. A acessibilidade dá ao EmuloMobile um caminho controlado para executar os gestos que você escolhe. A captura de tela dá à macro um quadro visual atual. O modo correto do aparelho mantém coordenadas e regiões com sentido.
Depois que essa base está preparada, a depuração fica mais limpa: as falhas restantes normalmente estão no fluxo, não na configuração do aparelho.
Conheça o EmuloMobile e prepare sua primeira macro Android no próprio aparelho.