Visão geral
Para usar o Google Fit para Android, você precisa de um ID do cliente OAuth 2.0 para Apps Android.
Todos os apps Android são assinados com um certificado digital para o qual você detém a chave privada. Consulte o guia do Android para assinar aplicativos. para mais informações sobre certificados digitais.
Os IDs de cliente OAuth do Android são vinculados a pares específicos de certificado/pacote. Você precisa de apenas um ID para cada certificado, não importa quantos usuários o app tem.
A obtenção de um ID para o app requer várias etapas. Essas etapas estão descritas a seguir.
- Encontre as informações do certificado do app.
- Crie ou modifique um projeto no Console de APIs do Google.
- Solicite um ID do cliente OAuth 2.0.
Encontrar as informações do certificado do seu app
A chave de API é baseada em uma forma resumida do certificado digital do seu app, conhecida como impressão digital SHA-1. Para exibir o SHA-1 do seu certificado, verifique se você está usando a certificado. Você pode ter dois certificados:
- Um certificado de depuração: as Ferramentas do SDK do Android geram esse certificado automaticamente quando você faz um build de depuração. Use-o apenas com apps em teste. Não tente publicar um aplicativo assinado com um certificado de depuração. Veja mais detalhes sobre esse certificado em Fazer login no modo de depuração, na documentação do desenvolvedor Android.
- Um certificado de lançamento: as Ferramentas do SDK do Android geram esse certificado quando você faz um build de lançamento. Também é possível gerá-lo usando o programa
keytool
. Utilize esse certificado quando tudo estiver pronto para lançar seu app.
Siga as etapas abaixo para exibir a impressão digital SHA-1 do certificado usando o programa keytool
com o parâmetro -v
. Para mais informações sobre o Keytool, consulte a documentação da Oracle.
Exibir a impressão digital do certificado de depuração
Localize o arquivo de keystore de depuração. O nome do arquivo é
debug.keystore
, e ele é gerado no momento em que você cria seu projeto. Por padrão, ele fica armazenado no mesmo diretório que os arquivos do Dispositivo virtual Android (AVD, na sigla em inglês):- macOS e Linux:
~/.android/
- Windows Vista e Windows 7:
C:\Users\your_user_name\.android\
- macOS e Linux:
Liste a impressão digital SHA-1:
Para Linux ou macOS, abra uma janela do terminal e digite o seguinte:
keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android
No Windows Vista e Windows 7, execute este código:
keytool -list -v -keystore "%USERPROFILE%\.android\debug.keystore" -alias androiddebugkey -storepass android -keypass android
Será exibida uma saída semelhante a esta:
Alias name: androiddebugkey Creation date: Jan 01, 2013 Entry type: PrivateKeyEntry Certificate chain length: 1 Certificate[1]: Owner: CN=Android Debug, O=Android, C=US Issuer: CN=Android Debug, O=Android, C=US Serial number: 4aa9b300 Valid from: Mon Jan 01 08:04:04 UTC 2013 until: Mon Jan 01 18:04:04 PST 2033 Certificate fingerprints: MD5: AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6A:AC:F9 SHA1: BB:0D:AC:74:D3:21:E1:43:07:71:9B:62:90:AF:A1:66:6E:44:5D:75 Signature algorithm name: SHA1withRSA Version: 3
Exibir a impressão digital do certificado de lançamento
-
Localize o arquivo de keystore do certificado de lançamento. Não há local nem nome padrão para o keystore de lançamento. Se você não especificar esses itens ao criar seu app,
.apk
ficará sem assinatura, e será preciso assiná-lo antes da publicação. Para o certificado de lançamento, você também precisa do alias do certificado e das senhas do keystore e do certificado. É possível listar os aliases de todas as chaves em um keystore digitando o seguinte:keytool -list -keystore your_keystore_name
Substitua
your_keystore_name
pelo caminho e nome totalmente qualificados do keystore, incluindo a extensão.keystore
. Você precisará inserir a senha do keystore. Em seguida,keytool
exibirá todos os aliases relevantes. -
Digite o seguinte em um terminal ou no prompt de comando:
keytool -list -v -keystore your_keystore_name -alias your_alias_name
Substitua
your_keystore_name
pelo caminho e nome totalmente qualificados do keystore, incluindo a extensão.keystore
. Troqueyour_alias_name
pelo alias que você atribuiu ao certificado quando o criou.
Será exibida uma saída semelhante a esta:
Alias name: <alias_name> Creation date: Feb 02, 2013 Entry type: PrivateKeyEntry Certificate chain length: 1 Certificate[1]: Owner: CN=Android Debug, O=Android, C=US Issuer: CN=Android Debug, O=Android, C=US Serial number: 4cc9b300 Valid from: Mon Feb 02 08:01:04 UTC 2013 until: Mon Feb 02 18:05:04 PST 2033 Certificate fingerprints: MD5: AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6B:AC:F9 SHA1: BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:90:AF:A1:66:6E:44:5D:75 Signature algorithm name: SHA1withRSA Version: 3
A linha que começa com SHA1
inclui a impressão digital SHA-1 do certificado. Essa impressão é a sequência de 20 números hexadecimais de dois dígitos separados por dois pontos.
Solicitar um ID do cliente OAuth 2.0 no Console de APIs do Google
Siga estas etapas para criar ou modificar um projeto para seu app no Console de APIs do Google, ativar a API Fitness e solicitar um ID de cliente OAuth 2.0.
Se quiser ser orientado pelo processo e ativar a API Fitness automaticamente, clique em
Como alternativa, siga estas etapas para ativar a API Fitness no Console de APIs do Google e receber um ID de cliente OAuth 2.0.
- Acesse o Console de APIs do Google.
- Selecione um projeto ou crie um novo. Usar o mesmo projeto para o Android e versões REST do seu app.
- Clique em Continuar para ativar a API Fitness.
- Clique em Acessar credenciais.
- Clique em Novas credenciais e selecione ID do cliente OAuth.
- Em Tipo de aplicativo, selecione Android.
Na caixa de diálogo resultante, digite a impressão digital SHA-1 e o nome do pacote do seu app. Exemplo:
BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75
com.example.android.fit-example
Clique em Criar. O novo ID do cliente OAuth 2.0 do Android e o segredo aparecem na lista de IDs do projeto. Um ID do cliente OAuth 2.0 é uma string de caracteres, como esta:
780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com