CristianoSFMothe / maestro

Um guia passo a passo para instalar o Maestro no Windows

Configuração do Maestro no Windows

Um guia passo a passo para instalar o Maestro no Windows

O Maestro Mobile é uma ferramenta poderosa para teste de aplicativos mobile em plataformas Android e iOS, e funciona excepcionalmente bem em computadores, Windows. No entanto, a configuração no Windows requer algumas etapas específicas que precisam ser seguidas para garantir o funcionamento correto do software. Este guia técnico detalhado irá orientá-lo por todas as etapas necessárias, desde a instalação até a configuração final, para que você possa começar a usar o Maestro Mobile em sua máquina Windows de maneira eficiente.

📋 Pré-Requisitos

1. O PowerShell está instalado no seu sistema Windows.
2. Instale o Android Studio em sua máquina Windows.
1. Baixe o Android Studio acessando o link https://developer.android.com/studio?hl=pt-br
2. Aceite os termos de compromisso para inicializar o download




---

3. Ter a permissão para a a instalação do Android Studio




---

4. Nas próximas etapas é só clicar em next como nas imagens abaixo




---

5. Agora clicar em Install para realizar a instalação do Android Studio




---




---

6. Instalação completa, clicar em Next




---

7. Finalizar a instalação e inicializar o Android Studio para realizar configurações




---

8. Para uma instalação inicial ou sem importar configurações anteriores, selecione a opção como na imagem abaixo




---

9. No próximos passo só clicar em Next como nas imagens abaixo




---

10. Aceite as licenças






11. Finalizar a instalação do Android Studio




---

12. Criar um emulador virtual




---




---

13. Por padrão a instalação do Android Studio já criar um emulador virtual


3. Adicione ANDROID_HOME à sua variável de ambiente do Windows.
Geralmente estará em C:\Users\SEU USUÁRIO\AppData\Local\Android\Sdk


A pasta AppData é uma pasta oculta necessário liberar sua visualização



1. Cópia o caminho da pasta Android/Sdk
2. Acessa as configurações de Variáveis de Ambiente do Windows




---

3. Em Variáveis do sistema clicar em Novo




---

4. Em Nome da variável colocar ANDROID_HOME e no Valor da da variável o caminho




---

5. Depois só clicar em OK até fechar as janelas


6. Para verificar a configuração do ANDROID_HOME, abra um terminal do PowerShell e execute os comandos: echo %ANDROID_HOME% e adb --version.


4. Instale o Java JDK 17 e configure JAVA_HOME.
1. Acessa a página da Oracle https://www.oracle.com/java/technologies/downloads/#jdk17-windows




---




---

2. No próximos passo basta clicar em Next




---

3. Por fim, clique em Close




---

4. Acesse a pasta de instalação do Java é cópia o caminho da pasta para configurar a variável de ambiente do Java




---

5. Assim como nas configurações do variável de ambiente do ANDROID_HOME acessar as configurações de variáveis e criar a variável JAVA_HOME




---

6. Para verificar se o Java está instalado corretamentejava --version



5. Por fim, ainda nas variáveis de ambiente, aponte o caminho das variáveis para ANDROID_HOME/platform-tools e também para JAVA_HOME/bin, conforme demonstrado na imagem abaixo.

Passos 🚶

1. Instalar o WSL2 (Window Subsystem para Linux)
2. Instalar o Java 21
3. Instale o Maestro

1. Instale o WSL 2 ⚙️

Com o recente Windows 11, a Microsoft tornou muito fácil instalar o Windows Subsystem para Linux, também conhecido como WSL.

Para instalar o WSL, abra o PowerShell como administrador e execute o seguinte comando:

menu Iniciar > PowerShell > clique com o botão direito do mouse > Executar como Administrador

wsl --install

---

---

---

---

---

Habilitar o Subsistema do Windows para Linux - WSL2 🐧

É recomendável passar para a etapa 2, de atualização para o WSL 2

Executar o comando:

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

Habilitar o recurso de Máquina Virtual 🖥️

Abra o PowerShell como administrador e execute:

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

Baixar o pacote de atualização do kernel do Linux 📦

O pacote de atualização do kernel do Linux instala a versão mais recente do kernel do Linux WSL 2 para executar o WSL dentro da imagem do sistema operacional Windows

1. Baixar o pacote mais recente:
   • Paconte de atualização do kernel do Linux do WSL2 para computadores x64
2. Execute o pacote de atualização baixado

Definir o WSL 2 como a sua versão padrão 🛠️

Abra o PowerShell e execute este comando para definir o WSL 2 como a versão padrão ao instalar uma nova distribuição do Linux:

wsl --set-default-version 2

Depois de executar o comando acima, siga as instruções e reinicie o computador.

Instalar Terminal Windows aplicação para experiência terminal refrescante.

Defina seu nome de usuário e senha do Linux (Algo que você não esquecerá).

Execute os dois comandos a seguir para atualizar seu sistema Ubuntu. Digite a senha quando solicitado.

sudo apt update

sudo apt upgrade

2. Instale o Maestro 📱

Instalar o Maestro executar o comando.

curl -Ls "https://get.maestro.mobile.dev" | bash

Verifique sua versão Maestro usando o seguinte comando:

maestro --version

Configurá-lo para usar o Android em seu WSL2 🧩

1. Instalar Java

Depois de reiniciar o sistema, abra o aplicativo Terminal do Ubuntu. Digite os seguintes comandos:

sudo apt install openjdk-11-jdk

2. Instalar o Unzip

Execute o comando:

sudo apt install unzip

3. Instalar o sdkmananger

Execute o comando:

sudo apt install sdkmanager

4. Instala o ADB Devices

Execute o comando:

sudo apt install adb

5. Crie e navegue até o diretório Android

mkdir ~/Android

cd ~/Android

6. Baixe o arquivo ZIP das ferramentas de linha de comando do Android

Execute o comando:

wget https://dl.google.com/android/repository/commandlinetools-linux-6858069_latest.zip

7. Descompacte o arquivo ZIP das ferramentas de linha de comando do Android

Execute o comando:

unzip commandlinetools-linux-6858069_latest

8. Crie o diretório de ferramentas e mova os arquivos

Execute o comando:

mkdir tools

mv cmdline-tools/* tools/

9. Adicione variáveis ​​de ambiente a ~/.bashrc

Execute os comandos separadamente:

echo 'export ANDROID_HOME=$HOME/Android' >> ~/.bashrc

echo 'export PATH=$PATH:$ANDROID_HOME/tools/bin/:$PATH' >> ~/.bashrc

echo 'export ANDROID_SDK_ROOT=$HOME/Android' >> ~/.bashrc

10. Recarregar ~/.bashrc

Execute o comando:

source ~/.bashrc

11. Instale ferramentas da plataforma

Execute o comando:

sdkmanager --install "platform-tools"

12. Adicione ferramentas de plataforma a ~/.bashrc

Execute o comando:

echo 'export PATH=$PATH:$ANDROID_HOME/platform-tools/:$PATH' >> ~/.bashrc

13. Recarregar ~/.bashrc

Execute o comando:

source ~/.bashrc

Executando o Maestro no Windows 🚀

Ao executar o Maestro no Windows, é importante manter apenas o emulador ativo. Recomenda-se fechar o Android Studio para evitar conflitos entre ambas as ferramentas durante o teste de aplicativos mobile.

Sever também para o Linux e MAC

1. Abrir o Windows Terminal e executar o comando:

ipconfig

No seu caso, você utilizará o endereço IPv4 da sua rede. Isso é necessário para configurar corretamente as conexões e garantir a comunicação adequada entre os dispositivos e serviços na sua infraestrutura de rede local.

2. Expor a porta do ADB no Windows para ter visibilidade no Linux

Para expor a porta do ADB que está em execução no Windows e torná-la visível no Linux, execute o seguinte comando:

adb -a -P 5037 nodaemon server

Observação Se você receber um erro como o seguinte

Execute o comando abaixo e depois tente novamente o comando anterior:

adb kill-server

3. Conectando o Linux com a porta do Windows

Após configurar a porta do ADB no Windows, você precisa informar ao terminal do Linux para se conectar a essa porta específica. Para isso, execute o seguinte comando no terminal do Linux:

export ADB_SERVER_SOCKET=tcp:00.0.0.00:5037

4. Obtendo o ID do emulador do Android

Para identificar o ID do emulador que está em execução no Windows e garantir que a comunicação está funcionando corretamente, execute o seguinte comando:

adb devices

Excutar um fluxo simples ▶️

1. Download do arquivo de exemplo no Linux

Execute o seguinte comando:

maestro download-samples

2. Acessar a pasta

cd ./samples

3. Instalar o aplicativo de exemplo

adb install samples.apk

Observação Se você receber um erro como o seguinte

Instale o APK manualmente

4. Executando o APK pelo Maestro Após instalar o APK, podemos executar o Maestro no Windows. Lembre-se de incluir a porta do IPV4 da rede no comando de execução. Aqui está como você pode fazer isso:

maestro --host 00.0.0.00 test android-flow.yaml

--host 00.0.0.00: Substitua 00.0.0.00 pelo endereço IP do seu dispositivo na rede.

--port 5037: Especifica a porta onde o ADB está escutando.

Isso garantirá que o Maestro se comunique corretamente com o emulador Android através da rede.

5. Executando o Maestro Studio

maestro --host 00.0.0.00 studio

Referências 🔍

1. Configuração do WSL2 no Windows na própria documentação do WSL
2. Instalação do Maestro dev para o Windows na documentação do Maestro Mobile Dev

---

Sobre mim 🧔

Sou Cristiano da Silva Ferreira, um analista de sistemas com foco em desenvolvimento e teste de software. Desde 2020, venho contribuindo em projetos utilizando diversas tecnologias como Cypress.io, NestJS, MySQL, Robot Framework, Playwright, Selenium, Appium e Maestro Mobile para criar aplicações web e mobile de alta qualidade. Me formei em Sistemas de Informações pela Estácio em 2020, onde adquiri habilidades sólidas em Java, JavaScript e Python, além de certificações em fundamentos da programação, UML e HTML básico. Estou comprometido com o aprendizado contínuo e aprimoramento constante na área de tecnologia.

Contribuição 🌍

Entusiasta da tecnologia focado em teste de software e desenvolvimento. Valorizo contribuições para aprimorar meus projetos e estou sempre aprendendo e explorando novas tecnologias para impulsionar a inovação na área de tecnologia