Repolode
Enviar
MaaXYZ

MaaXYZ/MaaFramework

Framework C++ sob LGPL-3.0 para criar ferramentas de automação baseada em reconhecimento de imagem e testes black-box no Windows, Linux, macOS e Android.

Ver no GitHubSite
Estrelas
5,036
Forks
579
Issues abertas
124
Último commit
ontem

O que é?

O MaaFramework é um framework de testes de automação black-box que localiza elementos na tela por reconhecimento de imagem e interage com a interface usando entradas simuladas. Escrito em C++, ele permite descrever uma tarefa como um pipeline de etapas de reconhecimento e ação, em vez de programar cada interação manualmente.

O projeto oferece um protocolo de pipeline low-code para definir tarefas e uma API de integração que permite incorporar o framework a aplicações. Há bindings e pacotes oficiais para Python, C#, Node.js, Go e Rust, e o README descreve um protocolo ProjectInterface para empacotar projetos reutilizáveis.

O README lista Windows, Linux, macOS e Android como plataformas compatíveis. Há também diversas interfaces gráficas, ferramentas de depuração, analisadores de logs e assistentes específicos para jogos, criados pela comunidade com base no framework.

Recursos principais

  • 01Localiza elementos da interface por reconhecimento de imagem e interage com eles usando entradas simuladas.
  • 02Define tarefas de automação por meio de um protocolo de pipeline low-code.
  • 03Oferece APIs de integração e bindings oficiais para várias linguagens.
  • 04Funciona no Windows, Linux, macOS e Android.
  • 05Permite empacotar projetos reutilizáveis por meio do protocolo ProjectInterface.

Casos de uso

  • Automatizar ações repetitivas em um jogo ou aplicação sem API.
  • Executar testes de interface black-box em softwares sem hooks disponíveis no código-fonte.
  • Criar um projeto de automação reutilizável que outras pessoas possam executar por uma GUI ou CLI.

Início rápido

  1. 1

    Abra o guia de início rápido na pasta docs

  2. 2

    Escolha um binding de linguagem (Python, Node, Go, Rust, C#) e instale-o pelo registro de pacotes indicado no README

Antes de usar

  • Licenciado sob LGPL-3.0, uma licença copyleft cujos termos se aplicam às modificações da biblioteca.

Tópicos

#automation#computer-vision#image-recognition#black-box-testing#cpp#gui-automation

Perguntas frequentes

O que é MaaFramework?
Framework C++ sob LGPL-3.0 para criar ferramentas de automação baseada em reconhecimento de imagem e testes black-box no Windows, Linux, macOS e Android. O MaaFramework é um framework de testes de automação black-box que localiza elementos na tela por reconhecimento de imagem e interage com a interface usando entradas simuladas. Escrito em C++, ele permite descrever uma tarefa como um pipeline de etapas de reconhecimento e ação, em vez de programar cada interação manualmente.
MaaFramework é gratuito? Qual é a licença?
MaaFramework é open source sob a licença LGPL-3.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
MaaFramework ainda é mantido?
Manutenção ativa. O último commit de MaaFramework foi em 19 de out. de 2026.
Para que posso usar MaaFramework?
Automatizar ações repetitivas em um jogo ou aplicação sem API. Executar testes de interface black-box em softwares sem hooks disponíveis no código-fonte. Criar um projeto de automação reutilizável que outras pessoas possam executar por uma GUI ou CLI.
Como instalar MaaFramework?
Abra o guia de início rápido na pasta docs Escolha um binding de linguagem (Python, Node, Go, Rust, C#) e instale-o pelo registro de pacotes indicado no README
Onde consigo MaaFramework?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/MaaXYZ/MaaFramework

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

Projetos relacionados