Proyectos Java

El runner reconoce un proyecto Java por el pom.xml en la raíz del repositorio y ejecuta:

mvn -B test -DidDatasetRun=<id>

con -Dtest=TestProtonScript cuando el proyecto tiene esa clase.

JDK y Maven

Para el usuario que ejecuta el runner, la máquina necesita:

• un JDK 21 o más reciente, con el JAVA_HOME apuntando a él;
• Maven 3.9 o más reciente, con el mvn en el PATH.

Windows

1. Instala un JDK 21, como Eclipse Temurin, y marca la opción que define el JAVA_HOME.
2. Descarga Maven en maven.apache.org (el archivo bin.zip) y descomprímelo, por ejemplo, en C:\Program Files\Maven.
3. En Variables de entorno, agrega la carpeta bin de Maven al Path.

Linux

1. Instala un JDK 21 con el gestor de paquetes (en Ubuntu, sudo apt install openjdk-21-jdk).
2. Descarga Maven en maven.apache.org y agrega la carpeta bin al PATH. El paquete maven de algunas distribuciones es anterior a la 3.9.

Abre una terminal nueva y comprueba:

java -version

mvn -version

Después de instalar, reinicia el Runner: lee el PATH y el JAVA_HOME al abrirse.

La Proton Cloud SDK y las dependencias

El proyecto declara la Proton Cloud SDK y el repositorio Maven público de Atomic (https://maven.protoncloud.com.br) en su propio pom.xml. La máquina no necesita settings.xml ni credenciales: Maven descarga la SDK y las demás dependencias en la primera ejecución y las guarda en el repositorio local (~/.m2).

Si la máquina todavía tiene un settings.xml de Proton 4 con un token de GitHub Packages, ya no es necesario para los proyectos de Proton 5.

Por plataforma

Plataforma del proyecto	Qué más necesita la máquina
API	Nada más que el JDK y Maven.
Web (Playwright)	Nada en Windows: el navegador de Playwright se descarga en la primera ejecución. En Linux, las bibliotecas del sistema que usa el navegador (abajo).
Mobile (Android)	adb, Appium y el dispositivo. Ver Mobile (Android).
SAP GUI y escritorio	Usa un proyecto Python: ver Proyectos Python.

En Linux, instala una vez las bibliotecas del navegador, desde dentro de la carpeta del proyecto (el comando pide la contraseña de administrador):

mvn exec:java -e -D exec.mainClass=com.microsoft.playwright.CLI -D exec.args="install-deps chromium"

Ejecutar en la máquina antes del runner

Para comprobar la máquina, ejecuta el proyecto en ella, sin Proton, como enseña el proyecto modelo:

mvn test

Si pasa en la terminal con el mismo usuario, va a pasar por el runner.