Firexport / Blog

O erro ApiException: 10 do antigo SDK do Google Sign-In e o [28444] Developer console is not set up correctly do Credential Manager são o mesmo problema de configuração. Eles indicam que o app que pede o login (o nome do pacote e o SHA-1 do certificado que assinou este build) ou o ID do cliente da Web que ele passou não corresponde ao que está registrado no projeto. O que se corrige é o registro, não o código. Comece verificando se o SHA-1 da chave que assinou o build que você está executando está no Firebase.

Como diferenciar os erros

Os três primeiros têm as mesmas causas. A documentação do plug-in do Flutter (google_sign_in_android) aponta como causas comuns de erros de configuração um SHA de assinatura ausente ou incorreto em algum build, um nome de pacote incorreto no lado do servidor e um serverClientId ausente ou incorreto. Verifique nessa ordem.

O SHA-1 da chave que assinou este build

O Google reconhece o app que pede o login pelo nome do pacote e pelo SHA-1 do certificado que assinou o APK. O nome do pacote é o applicationId do build.gradle (incluindo o sufixo que o tipo de build acrescenta), e ele precisa ser igual ao do app Android registrado no Firebase. A assinatura depende de como o app foi instalado.

# Every build variant's signing key, from the project root
./gradlew signingReport

# The debug keystore (password: android)
keytool -list -v -alias androiddebugkey -keystore ~/.android/debug.keystore

# The certificate that signed an APK or AAB you already have
keytool -printcert -jarfile app-release.aab

Adicione o SHA-1 encontrado às impressões digitais do certificado SHA (SHA certificate fingerprints) do app Android em Configurações do projeto (Project settings) > Geral (General) > Seus apps (Your apps), no console do Firebase, e baixe o google-services.json de novo para substituir o seu. O Firebase cria o cliente OAuth do Android para essa impressão digital. Se você registrar todas as chaves que usa, o login funciona seja qual for a forma de instalação do app.

• Se funciona quando você instala direto, mas falha quando o app vem do Google Play, falta a chave de assinatura do app. O Google Play assina o app de novo com a chave de assinatura do app mantida pelo Google, não com a sua chave de upload.
• Apps novos são assinados por padrão pelo Google Play com três chaves (assinatura protegida contra ataques quânticos). Nesse caso, a Ajuda do Play Console orienta a registrar as três impressões digitais nos provedores de API.
• Um par de nome do pacote e SHA-1 só pode ser registrado em um projeto, considerando todos os projetos do Firebase e do Google Cloud. Se você usa projetos separados para desenvolvimento e produção, dê a cada build um nome de pacote próprio.

No serverClientId vai o ID do cliente da Web

O serverClientId recebe o ID do cliente OAuth do aplicativo da Web no seu projeto do Google Cloud. É o valor usado como público-alvo (audience) dos tokens de ID do Google, por isso o ID do cliente Android não serve. Num projeto do Firebase, é a entrada com client_type 3 no google-services.json, que o plug-in google-services transforma em R.string.default_web_client_id.

// Android (Kotlin): the Sign in with Google button
val buttonOption = GetSignInWithGoogleOption.Builder(
    serverClientId = getString(R.string.default_web_client_id),
).build()

// Android (Kotlin): the bottom sheet, offering every account on the device
val sheetOption = GetGoogleIdOption.Builder()
    .setServerClientId(getString(R.string.default_web_client_id))
    .setFilterByAuthorizedAccounts(false)
    .build()

// Flutter (google_sign_in 7), without google-services.json
await GoogleSignIn.instance.initialize(
  serverClientId: 'YOUR_WEB_CLIENT_ID.apps.googleusercontent.com',
);

• O google_sign_in 7 do Flutter lê esse valor mesmo sem serverClientId quando o google-services.json tem uma entrada de cliente da Web. Se não tiver, adicione um app da Web ao projeto do Firebase e baixe o arquivo de novo. No Android, o clientId não é usado.
• Se o 28444 apareceu pela primeira vez depois de atualizar do 6.x para o 7, desconfie do serverClientId. A equipe do Flutter explica que o SDK antigo usado pelo 6.x nem sempre validava esse valor, então um valor errado pode ter funcionado (flutter/flutter #174319).

Ao migrar do SDK antigo para o Credential Manager

As APIs do antigo Google Sign-In for Android foram removidas no play-services-auth 22.0.0 (26 de agosto de 2026). Nessa versão ou em uma posterior, o código de login feito com GoogleSignInClient não compila, então migre para o Credential Manager.

• O valor padrão de setFilterByAuthorizedAccounts é true. Usuários que nunca fizeram login neste app recebem NoCredentialException, então, no cadastro e no primeiro login, use false ou o fluxo do botão.
• No emulador, faça login numa Conta do Google. Use uma imagem do sistema com Google APIs. Sem nenhuma conta no dispositivo, ocorre NoCredentialException.

Fontes

• CommonStatusCodes.DEVELOPER_ERROR, notas da versão do Google Play Services: o significado do 10 e a remoção das APIs do Google Sign-In
• Migrar do antigo Google Sign-In, implementar o Sign in with Google com o Credential Manager, solução de problemas do Credential Manager
• Autenticar com o Google no Android (Firebase), perguntas frequentes sobre problemas do Firebase no Android, o plug-in google-services, impressões digitais SHA e clientes OAuth (Ajuda do Firebase)
• Clientes OAuth (Ajuda do Google Cloud), obter o SHA-1, Assinatura de apps do Google Play, Compartilhamento interno de apps
• google_sign_in_android, flutter/flutter #174319 (relato do 28444), codelab do Sign in with Google