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.
`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.
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.
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.
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 — os passos de build e execução referenciados acima.
Referência de códigos de erro — os códigos de resultado do SDK e suas categorias de causa.