Projetos Java
O runner reconhece um projeto Java pelo pom.xml na raiz do repositório e roda:
mvn -B test -DidDatasetRun=<id>
com -Dtest=TestProtonScript quando o projeto tem essa classe.
JDK e Maven
A máquina precisa, para o usuário que roda o runner:
- de um JDK 21 ou mais novo, com o
JAVA_HOMEapontando para ele; - do Maven 3.9 ou mais novo, com o
mvnnoPATH.
- Windows
- Linux
- Instale um JDK 21, como o Eclipse Temurin, e marque a opção que define o
JAVA_HOME. - Baixe o Maven em maven.apache.org (o arquivo
bin.zip) e descompacte, por exemplo, emC:\Program Files\Maven. - Em Variáveis de ambiente, ponha a pasta
bindo Maven noPath.
- Instale um JDK 21 pelo gerenciador de pacotes (no Ubuntu,
sudo apt install openjdk-21-jdk). - Baixe o Maven em maven.apache.org e ponha a pasta
binnoPATH. O pacotemavende algumas distribuições é anterior à 3.9.
Abra um terminal novo e confira:
java -version
mvn -version
Depois de instalar, reinicie o Runner: ele lê o PATH e o JAVA_HOME quando abre.
A Proton Cloud SDK e as dependências
O projeto declara a Proton Cloud SDK e o repositório Maven público da Atomic
(https://maven.protoncloud.com.br) no próprio pom.xml. A máquina não precisa de settings.xml nem de credencial: o
Maven baixa a SDK e as outras dependências na primeira execução e guarda no repositório local (~/.m2).
Se a máquina ainda tem um settings.xml do Proton 4 com token do GitHub Packages, ele não é mais necessário para projetos
do Proton 5.
Por plataforma
| Plataforma do projeto | O que mais a máquina precisa |
|---|---|
| API | Nada além do JDK e do Maven. |
| Web (Playwright) | Nada no Windows: o navegador da Playwright é baixado na primeira execução. No Linux, as bibliotecas do sistema que o navegador usa (abaixo). |
| Mobile (Android) | O adb, o Appium e o aparelho. Ver Mobile (Android). |
| SAP GUI e desktop | Use um projeto Python: ver Projetos Python. |
No Linux, instale uma vez as bibliotecas do navegador, de dentro da pasta do projeto (o comando pede a senha de administrador):
mvn exec:java -e -D exec.mainClass=com.microsoft.playwright.CLI -D exec.args="install-deps chromium"
Rodar na máquina antes do runner
Para conferir a máquina, rode o projeto nela, sem o Proton, como o projeto modelo ensina:
mvn test
Se passar no terminal com o mesmo usuário, vai passar pelo runner.