Repolode
Enviar
alipay

alipay/SoloPi

Ferramenta open source de automação de testes mobile para gravar, reproduzir, validar e analisar o desempenho de fluxos de UI do Android em dispositivos reais, agora com um harness para agentes.

Ver no GitHub
Estrelas
6,364
Forks
1,272
Issues abertas
140
Último commit
há 3 dias

O que é?

SoloPi é uma ferramenta open source de automação para testes de aplicativos mobile. Ela grava toques, entradas de texto, rolagens e verificações em um dispositivo Android e depois reproduz essas ações no mesmo dispositivo ou em outros. Também coleta dados de desempenho, como CPU, memória, FPS, bateria, temperatura e tráfego de rede, além de medir o tempo de inicialização a frio e a quente dos aplicativos.

O projeto se conecta aos dispositivos via ADB, inclusive por depuração sem fio, e permite controlar vários celulares a partir de um único dispositivo controlador. Os fluxos gravados podem ser convertidos em scripts do Appium ou do Macaca por meio de um projeto conversor separado.

O repositório também inclui o solopi-skill, um harness de linha de comando para agentes de IA. Ele oferece ações dinâmicas tipadas, verificadas em relação à página atual antes da execução, avaliação independente dos resultados com os estados passed, failed e not_tested e execuções gerenciadas sem supervisão em um único host. Há uma versão para HarmonyOS disponível em uma branch separada.

Recursos principais

  • 01Grave e reproduza operações de UI em dispositivos Android sem configurar a gravação em um PC.
  • 02Valide elementos da UI e imagens durante a reprodução.
  • 03Monitore CPU, memória, FPS, bateria, temperatura e rede em tempo real ou por meio de gravações.
  • 04Meça o tempo de inicialização a frio e a quente.
  • 05Controle vários dispositivos secundários a partir de um dispositivo mestre.
  • 06Execute ações tipadas de agentes com verificações do estado da página e avaliação independente dos resultados.

Casos de uso

  • Testar regressões em fluxos de aplicativos Android em um conjunto de celulares físicos.
  • Testar a compatibilidade em vários dispositivos usando um único controlador.
  • Medir o tempo de inicialização e o desempenho dos aplicativos sob limitações de CPU, memória ou rede.
  • Permitir que um agente de IA execute testes em dispositivos, com evidências auditáveis em um fluxo de CI.

Início rápido

  1. 1

    Execute a CLI local a partir do código-fonte para listar as ações (não é necessário um dispositivo).

    ./solopi-skill/scripts/solopi-ai --pretty actions
  2. 2

    Instale a CLI em um ambiente virtual.

    python -m pip install -e ./solopi-skill/scripts/harness
  3. 3

    Compile os APKs de teste e depuração do solopi-app.

    ./solopi-app/gradlew -p solopi-app :app:testDebugUnitTest :agentmodel:testDebugUnitTest :portal:assembleDebug

Antes de usar

  • A implementação de código aberto no dispositivo é compatível apenas com Android.
  • Para executá-la, é necessário um dispositivo Android real autorizado para depuração ADB via USB ou sem fio.
  • A documentação de build tem como alvo toolchains antigos, como Android Studio 4.0, Gradle 6.1.1 e NDK 16.
  • O recurso de controle de vários dispositivos ainda não é de código aberto.

Em coleções

Ferramentas ADB e de limpeza para AndroidApps para Android e ferramentas para celularFrameworks de teste e ferramentas de automação de testes

Tópicos

#android#mobile-testing#ui-testing#test-automation#adb#performance-testing#harmony#arkts#automated-testing#automation

Perguntas frequentes

O que é SoloPi?
Ferramenta open source de automação de testes mobile para gravar, reproduzir, validar e analisar o desempenho de fluxos de UI do Android em dispositivos reais, agora com um harness para agentes. SoloPi é uma ferramenta open source de automação para testes de aplicativos mobile. Ela grava toques, entradas de texto, rolagens e verificações em um dispositivo Android e depois reproduz essas ações no mesmo dispositivo ou em outros. Também coleta dados de desempenho, como CPU, memória, FPS, bateria, temperatura e tráfego de rede, além de medir o tempo de inicialização a frio e a quente dos aplicativos.
SoloPi é gratuito? Qual é a licença?
SoloPi é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
SoloPi ainda é mantido?
Manutenção ativa. O último commit de SoloPi foi em 5 de nov. de 2026.
Para que posso usar SoloPi?
Testar regressões em fluxos de aplicativos Android em um conjunto de celulares físicos. Testar a compatibilidade em vários dispositivos usando um único controlador. Medir o tempo de inicialização e o desempenho dos aplicativos sob limitações de CPU, memória ou rede. Permitir que um agente de IA execute testes em dispositivos, com evidências auditáveis em um fluxo de CI.
Como instalar SoloPi?
Execute a CLI local a partir do código-fonte para listar as ações (não é necessário um dispositivo).: ./solopi-skill/scripts/solopi-ai --pretty actions Instale a CLI em um ambiente virtual.: python -m pip install -e ./solopi-skill/scripts/harness Compile os APKs de teste e depuração do solopi-app.: ./solopi-app/gradlew -p solopi-app :app:testDebugUnitTest :agentmodel:testDebugUnitTest :portal:assembleDebug
Onde consigo SoloPi?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/alipay/SoloPi

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados