Resolución de problemas

Esta página lista los síntomas más comunes al ejecutar el SDK Demo App y cómo resolver cada uno.

Síntoma	Resolución
`Unsupported class file major version` en la sincronización	El JDK de Gradle no es 21. Consulta el Paso 2 del Inicio rápido.
`Could not find com.pagonxt.sdk:brazil-hml`	Falta el repositorio Maven local incluido para la variante. Confirma que `apolo-sdk-local-maven/brazil/<buildType>` existe — por ejemplo `brazil/hml` para la variante `brazilHml`.
El código QR sigue con las credenciales de ejemplo	La preview de Compose no se reconstruyó después de que editaste el payload. Abre `MandatoryCredentialsQrCode_Preview` o `FullCredentialsQrCode_Preview` y haz clic en Build & Refresh. Consulta el Paso 4 del Inicio rápido.
Las credenciales se guardaron, pero el warm-up falla y el menú principal no aparece	El código de estado del warm-up indica la causa: `401` para `clientId` o `clientSecret` no válidos, `404` para un terminal no registrado, `400` o `422` para los valores de `terminalCode` o del sub-merchant. Consulta los errores de warm-up en la Referencia de códigos de error.
La pantalla Setup no aparece y la aplicación mantiene las credenciales anteriores	Persisten en la base de datos de la aplicación después del primer guardado. Bórralas con el botón de reset en el encabezado de la pantalla Home, en Settings → Apps → Apolo DevKit → Storage → Clear data, o reinstalando la aplicación.
La aplicación abre, pero la venta, el reembolso o la impresión fallan	El terminal no está listo. Revisa el POS y los servicios Platform y Middleware en Requisitos previos.
Los colores o los recibos no cambian	Son personalizaciones de tiempo de build. Dispara un `reinitialize(…)` — un ciclo de `shutdown()` y `setup(…)` — para aplicarlas.

Siguientes pasos

Inicio rápido — los pasos de build y ejecución referenciados arriba.
Referencia de códigos de error — los códigos de resultado del SDK y sus categorías de causa.