# Resolução de problemas

Esta página lista os sintomas mais comuns ao executar o SDK Demo App e como resolver cada um.

| Sintoma | Resolução |
| :--- | :--- |
| `Unsupported class file major version` na sincronização | O JDK do Gradle não é 21. Consulte o Passo 2 do [Início rápido](/pt/getnet-toolbox/sdk-demo-app/first-steps-demo/quickstart). |
| `Could not find com.pagonxt.sdk:brazil-hml` | Falta o repositório Maven local incluído para a variante. Confirme que `apolo-sdk-local-maven/brazil/<buildType>` existe — por exemplo `brazil/hml` para a variante `brazilHml`. |
| O QR Code continua com as credenciais de exemplo | O preview do Compose não foi reconstruído depois que você editou o payload. Abra `MandatoryCredentialsQrCode_Preview` ou `FullCredentialsQrCode_Preview` e clique em **Build & Refresh**. Consulte o Passo 4 do [Início rápido](/pt/getnet-toolbox/sdk-demo-app/first-steps-demo/quickstart). |
| As credenciais foram salvas, mas o warm-up falha e o menu principal não aparece | O código de status do warm-up indica a causa: `401` para `clientId` ou `clientSecret` inválidos, `404` para um terminal não cadastrado, `400` ou `422` para os valores de `terminalCode` ou do sub-merchant. Consulte os erros de warm-up na [Referência de códigos de erro](/pt/getnet-toolbox/sdk-white-label/reference-sdk/error-codes). |
| A tela Setup não aparece e o aplicativo mantém as credenciais anteriores | Elas persistem no banco de dados do aplicativo depois do primeiro salvamento. Limpe-as com o botão de reset no cabeçalho da tela **Home**, em **Settings → Apps → Apolo DevKit → Storage → Clear data**, ou reinstalando o aplicativo. |
| O aplicativo abre, mas a venda, o estorno ou a impressão falham | O terminal não está pronto. Verifique o POS e os serviços Platform e Middleware em [Pré-requisitos](/pt/getnet-toolbox/sdk-demo-app/first-steps-demo/prerequisites). |
| As cores ou os recibos não mudam | São personalizações de tempo de build. Dispare um `reinitialize(…)` — um ciclo de `shutdown()` e `setup(…)` — para aplicá-las. |

## Próximos passos

* [Início rápido](/pt/getnet-toolbox/sdk-demo-app/first-steps-demo/quickstart) — os passos de build e execução referenciados acima.
* [Referência de códigos de erro](/pt/getnet-toolbox/sdk-white-label/reference-sdk/error-codes) — os códigos de resultado do SDK e suas categorias de causa.