Ankulua - Primeiro exemplo com aplicação real

Aqui está um exemplo muito simples de como usar o ankulua


Lembre-se de desactivar as notificações e os registos do Superuser
As notificações de Superuser irão aparecer no momento que capturar a tela, isto pode criar um resultado incorrecto.
Os registos de Superuser criam muitos ficheiros de registo, isto consome muitos "inodes". A longo prazo pode vir a ter muitos problemas !




Passo 1: Instalação da calculadora e o script

---

Neste exemplo iremos precisar de instalar a "Calculator Plus Free".
Entre no link acima para instalar

Em seguida faça o download do zip que contem o script .

Para quem usa emuladores
Se o ficheiro zip está com a extenção .bin deve renomear para .zip
Pode usar uma aplicação par ao efeito ou use o ES File Explorer que vem instalado por defeito, longo click no ficheiro zip(bin) e escolha rename.

No sistema Android , descompacte o ficheiro calculator_plus.zip para a pasta /sdcard/AnkuLua
- Se não tem nenhuma aplicação para descompactar tente o winzip.
- Se estiver a usar o winzip descompacte  os ficheiros para Storage-->SD Card-->AnkuLua.
- Usando o ES File Explorer longo clique no ficheiro zip, clique na opção "more" que se encontra no canto inferior direito , na nova janela escolha "uncompress" ou "extract to" dependendo da versão do ES File Explorer


Passo 2: Escolher e carregar o script

---

Agora inicie o Ankulua.
Depois da verificação do "root/deamon" o seu ankulua deve ser semelhante ao da foto



Clique no botão "carregar script" para abrir o explorador de ficheiros



Entre na pasta calculator_plus  e escolha o script example1.lua.
O seu ecrã deve ser idêntico ao da foto



Agora inicie o serviço do ankulua, clique no botão iniciar serviço que se encontra na barra do topo!
Se tudo estiver a funcionar corretamente, um botão translúcido com um play irá aparecer no canto inferior esquerdo.






Se o botão translúcido play não aparecer.
Deve mudar as seguintes opções em MIUI: Settings-->installed app-->AnkuLua-->Permission manager-->Display pop-up window-->Accept

Verifique também se existe duas opções de "USB debugging" nas opções de programador, se sim deve habilitar as duas



Passo 3: Inicie o script

---

Agora inicie a "calculator plus" e mantenha o seu dispositivo na horizontal (landscape), depois clique no botão play (do ankulua) que se encontra no canto inferior esquerdo.

O bot começou, nesse momento deve conseguir visualizar a sequência de cliques , 6 + 9 - 7 =




Se o bot terminar , a mensagem "Hello World!" aparecer, mas não foi efectuado nenhum clique nos números da calculadora, deve habilitar Solution¡GTurn nas opções de programador!
Enquanto esta opção estiver habilitada, MIUI pode mostrar vários avisos , deve confirmar todos eles!


Calculator_plus.zip e o seu conteúdo

---

Estrutura do "Calculator_plus.zip"

•  Calculator_plus.zip
  
  •  calculator_plus
    
    •  image
      
      •  -.png
      •  +.png
      •  =.png
      •  0.png
      •  1.png
      •  2.png
        
      •  3.png
        
      •  4.png
        
      •  5.png
      •  6.png
      •  7.png
      •  8.png
      •  9.png
      •  AC.png
      •  add.png
      •  C.png
      •  divide.png
      •  percent.png
      •  point.png
      •  x.png
      
      
    •  example1.lua
    •  highlightCalculator.lua

Indo directo ao assunto , dentro da pasta "image" vai encontrar uma imagem para cada botão da aplicação Calculator Plus App, o script usa estas imagens quando faz a procura no ecrã.

Existe ainda mais dois ficheiros "example1.lua" e "highlightCalculator.lua" , ambos trabalham da mesma maneira, com a diferença do highlightCalculator, que destaca as imagens e regiões, funciona como um debugger

A seguinte imagem ilustra o código.
Tenha em mente ao numero das linhas de codigo, iremos usa-las como referências.



O script está escrito em lua na versão 5.1.
Para mais informações sobre lua veja lua 5.1 reference manual.

- Linha 1 e 5 são comentários , na linguagem lua todas a linhas comentadas comecem com (--) e acaba no fim da linha

- Linha 2 insira a largura do ecrã de onde as imagens foram recortadas

- Linha 3 insira a largura do ecrã de acordo com a qual o seu script foi escrito 

A linha 2 e 3 são muito importantes. Elas permitem que o script funcione em dispositivos com diferentes resoluções

- Da linha 6 até a 11 são funções basicas de clique, a função click() irá procurar pela imagem e de seguida clicar no objecto!

- Linha 12 messagem "Hello World" como a tradição manda 

Nota: Usando a função print(), todas as mensagens só serão impressas quando o bot terminar

E é isto , temos o nosso primeiro exemplo usando uma aplicação

[Seguinte]: Ankulua - Ferramentas de desenvolvimento
[Anterior]: Ankulua - Deamon/Root
[Inicio]: AnkuLua - Introdução