Panoramica
Per utilizzare Google Fit per Android, devi disporre di un ID client OAuth 2.0 per le applicazioni Android.
Tutte le app per Android sono firmate con un certificato digitale di cui possiedi la chiave privata. Per saperne di più sui certificati digitali, consulta la guida di Android alla firma delle applicazioni.
Gli ID client OAuth per Android sono collegati a coppie specifiche di certificati/pacchetti. Ti serve un solo ID per ogni certificato, indipendentemente dal numero di utenti dell'app.
Per ottenere un ID per la tua app sono necessari diversi passaggi. Questi passaggi sono descritti di seguito.
- Trova le informazioni sul certificato della tua app.
- Crea o modifica un progetto nella console API di Google.
- Richiedi un ID client OAuth 2.0.
Trovare le informazioni sul certificato dell'app
La chiave API si basa su una forma breve del certificato digitale della tua app, nota come impronta SHA-1. Per visualizzare l'impronta SHA-1 del tuo certificato, assicurati innanzitutto di utilizzare il certificato corretto. Potresti avere due certificati:
- Un certificato di debug: gli strumenti Android SDK generano automaticamente questo certificato quando esegui una build di debug. Utilizza questo certificato solo con le app che stai testando. Non tentare di pubblicare un'app firmata con un certificato di debug. Il certificato di debug è descritto in modo più dettagliato nella sezione Firma in modalità di debug della documentazione per gli sviluppatori di Android.
- Un certificato di rilascio: gli strumenti dell'SDK Android generano
questo certificato quando crei una build di rilascio. Puoi anche generare questo
certificato utilizzando il programma
keytool
. Utilizza questo certificato quando sei pronto a rilasciare la tua app al mondo.
Segui questi passaggi per visualizzare l'impronta SHA-1 di un certificato utilizzando
il programma keytool
con il parametro -v
. Per ulteriori
informazioni su Keytool, consulta la
documentazione Oracle.
Visualizzazione dell'impronta del certificato di debug
Individua il file del keystore di debug. Il nome del file è
debug.keystore
e viene creato la prima volta che crei il progetto. Per impostazione predefinita, viene archiviato nella stessa directory dei file del dispositivo virtuale Android (AVD):- macOS e Linux:
~/.android/
- Windows Vista e Windows 7:
C:\Users\your_user_name\.android\
- macOS e Linux:
Elenca l'impronta SHA-1:
Per Linux o macOS, apri una finestra del terminale e inserisci quanto segue:
keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android
Per Windows Vista e Windows 7, esegui:
keytool -list -v -keystore "%USERPROFILE%\.android\debug.keystore" -alias androiddebugkey -storepass android -keypass android
Dovresti visualizzare un output simile a questo:
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
È visualizzata l'impronta del certificato di rilascio
-
Individua il file dell'archivio chiavi del certificato di rilascio. Non esiste una posizione o un nome predefinito per il keystore di rilascio. Se non ne specifichi uno quando crei la tua app per la release, la build non verrà firmata e dovrai firmarla prima di poterla pubblicare.
.apk
Per il certificato di rilascio, devi disporre anche dell'alias del certificato e delle password dell'archivio chiavi e del certificato. Puoi elencare gli alias di tutte le chiavi in un archivio chiavi inserendo:keytool -list -keystore your_keystore_name
Sostituisci
your_keystore_name
con il nome e il percorso completo dell'archivio chiavi, compresa l'estensione.keystore
. Ti verrà chiesta la password del keystore. Poikeytool
mostra tutti gli alias nel keystore. -
Inserisci quanto segue in un terminale o in un prompt dei comandi:
keytool -list -v -keystore your_keystore_name -alias your_alias_name
Sostituisci
your_keystore_name
con il nome e il percorso completo dell'archivio chiavi, compresa l'estensione.keystore
. Sostituisciyour_alias_name
con l'alias assegnato al certificato durante la creazione.
Dovresti visualizzare un output simile a questo:
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
La riga che inizia con SHA1
contiene l'impronta SHA-1 del certificato. L'impronta è la sequenza di 20 numeri esadecimali a due cifre
separati da due punti.
Richiedere un ID client OAuth 2.0 nella console API di Google
Segui questi passaggi per creare o modificare un progetto per la tua app nella console API di Google, attivare l'API Fitness e richiedere un ID client OAuth 2.0.
Se vuoi essere guidato nella procedura e attivare l'API Fitness automaticamente, fai clic su
In alternativa, segui questi passaggi per abilitare l'API Fitness nella console API di Google e ottenere un ID client OAuth 2.0.
- Vai alla console dell'API di Google.
- Seleziona un progetto o creane uno nuovo. Utilizza lo stesso progetto per le versioni Android e REST della tua app.
- Fai clic su Continua per abilitare l'API Fitness.
- Fai clic su Vai alle credenziali.
- Fai clic su Nuove credenziali, poi seleziona ID client OAuth.
- In Tipo di applicazione, seleziona Android.
Nella finestra di dialogo risultante, inserisci l'impronta SHA-1 e il nome del pacchetto dell'app. Ad esempio:
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
Fai clic su Crea. Il nuovo ID client e il nuovo client secret OAuth 2.0 per Android vengono visualizzati nell'elenco degli ID per il tuo progetto. Un ID client OAuth 2.0 è una stringa di caratteri, ad esempio:
780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com