Automatizar execução de apps Android com Python e ADB

---

@CanalQb no YouTube

---

Automatize execução de apps Android com Python e ADB

Neste tutorial, você aprenderá como utilizar Python em conjunto com a biblioteca pure-python-adb para interagir com dispositivos Android via ADB. A proposta é automatizar a execução de um pacote de aplicativo instalado no seu dispositivo, tornando o processo rápido e programável para testes, demonstrações ou automação de rotina.

O que o script realiza de forma automatizada

• Importação de bibliotecas: são utilizadas as bibliotecas pure-python-adb e pyautogui. A primeira é usada para comunicação com o Android via ADB, e a segunda, para automação de interface, caso desejado.
• Conexão com o ADB: o script se conecta ao servidor ADB local rodando em 127.0.0.1:5037.
• Leitura dos dispositivos conectados: detecta automaticamente dispositivos Android conectados via USB.
• Listagem de pacotes instalados: executa o comando pm list packages para exibir os aplicativos instalados.
• Filtragem do pacote: localiza o pacote desejado, neste caso com.bragames.goldparty.game, e prepara o comando para execução.
• Execução do app com monkey: utiliza o comando monkey para iniciar o aplicativo como se fosse um clique do usuário.

Requisitos antes de rodar o script no seu PC

Você precisará instalar as bibliotecas Python necessárias com o seguinte comando:

pip install pyautogui pure-python-adb

Além disso:

• Certifique-se de que o ADB esteja instalado no seu sistema.
• O dispositivo Android deve estar com a opção "Depuração USB" ativada.
• Conecte o celular via cabo USB ao computador.

Script Python para executar automaticamente o aplicativo

Segue o exemplo de script, que pode ser adaptado conforme a necessidade:

from ppadb.client import Client as AdbClient

# Conectando ao servidor ADB
client = AdbClient(host="127.0.0.1", port=5037)

# Detectando dispositivos conectados
devices = client.devices()
if not devices:
    print("Nenhum dispositivo encontrado.")
    exit()

device = devices[0]

# Listando pacotes instalados
output = device.shell("pm list packages")
packages = [line.split(":")[-1] for line in output.splitlines()]

# Verificando e executando o pacote desejado
for package in packages:
    if package == "com.bragames.goldparty.game":
        print(f"Executando: {package}")
        command = f"monkey -p {package} -c android.intent.category.LAUNCHER 1"
        device.shell(command)

Cuidados e recomendações ao usar este tipo de automação

• Evite executar comandos ADB sem conhecimento prévio, pois podem afetar o funcionamento do dispositivo.
• Use scripts como esse apenas em dispositivos sob seu controle ou com autorização.
• Valide o nome do pacote do app antes de executar para garantir que está correto.

Aplicações práticas desse tipo de automação

• Testes automatizados de apps Android.
• Execução programada de apps em quiosques e dispositivos embarcados.
• Desenvolvimento de rotinas de demonstração para vídeos ou eventos.

Conclusão

Automatizar a execução de aplicativos Android via Python e ADB é uma tarefa poderosa, especialmente útil para desenvolvedores, testadores e criadores de conteúdo. Com poucas linhas de código, é possível interagir com o sistema Android de forma eficiente e controlada.

Para mais tutoriais como este, inscreva-se no @CanalQb no YouTube.

Gostou deste conteúdo? Deixe um comentário com dúvidas ou sugestões!