Inizia su Android

Questa guida spiega come iniziare a sviluppare con Google Fit su Android.

Nota: Google Fit fa parte di Google Play Services. Scopri i vantaggi che la tua app ottiene dall'utilizzo di Google Play Services.

Configurazione

Prima di iniziare a creare l'app, completa i passaggi descritti nelle seguenti sezioni.

Come procurarsi un account Google

Per utilizzare le API Google Fit, è necessario un Account Google. Puoi creare un nuovo account o utilizzare un account esistente. Ti consigliamo di creare un account separato per testare la tua app dal punto di vista di un utente.

Installa Google Play Services

Ottieni la libreria client più recente per Google Play Services sul tuo host di sviluppo:

1. Apri Android SDK Manager.
2. In Strumenti SDK, individua Google Play Services.
3. Se lo stato di questi pacchetti non è Installato, selezionali entrambi e fai clic su Installa pacchetti.

Ottenere un ID client OAuth 2.0

Per attivare l'API Fitness, richiedi un ID client OAuth 2.0.

Crea e configura il progetto

Ti consigliamo di utilizzare l'ambiente di sviluppo Android Studio per creare un'app con l'API Fitness. Per dettagli su come creare un nuovo progetto e configurarlo in Android Studio, consulta Creare un progetto.

Aggiungi la libreria client di Google Play Services

In Android Studio, apri il file build.gradle del modulo e aggiungi la libreria client di Google Play Services come dipendenza:

DSL Kotlin

plugin {
    id("com.android.application")
}

...

dependencies {
        implementation("com.google.android.gms:play-services-fitness:21.2.0")
        implementation("com.google.android.gms:play-services-auth:21.3.0")
}

Groovy DSL

apply plugin: 'com.android.application'

...

dependencies {
    implementation 'com.google.android.gms:play-services-fitness:21.2.0'
    implementation 'com.google.android.gms:play-services-auth:21.3.0'
}

In questo modo, Gradle scarica automaticamente l'SDK per il fitness quando compila la tua app.

Crea e testa la tua app

Dopo aver completato i passaggi di configurazione, puoi iniziare a creare l'app. Per iniziare, scopri i tipi di dati che la tua app può memorizzare e leggere. Scopri di più sull'utilizzo dei dati in Google Fit.

Ottenere le autorizzazioni Android necessarie

Per leggere e scrivere alcuni tipi di dati, la tua app deve richiedere le autorizzazioni Android.

Ottenere le autorizzazioni OAuth

I tipi di dati a cui la tua app ha l'autorizzazione di accesso corrispondono ai ambiti di autorizzazione. Per richiedere queste autorizzazioni, devi aggiungere i tipi di dati a cui la tua app deve accedere in un'FitnessOptions istanza. Quando la tua app chiede di utilizzare uno dei tipi di dati di Google Fit, l'SDK Android controlla automaticamente a quali ambiti appartengono e chiede all'utente l'autorizzazione per questi ambiti.

Crea un client API

Crea un client API e aggiungi i tipi di dati a cui la tua app deve accedere per scrivere o leggere i dati. Sono disponibili i seguenti endpoint:

• SensorsClient: accedi a diverse origini di dati relativi a salute e benessere dai sensori hardware nel dispositivo locale e nei dispositivi complementari.
• RecordingClient: per la raccolta in background sempre attiva e a basso consumo dei dati dei sensori.
• HistoryClient: inserisci, elimina e leggi i dati storici in Google Fit.
• SessionsClient: crea e gestisci le sessioni di attività utente.
• GoalsClient: leggi gli obiettivi di punti cardiaci e passi creati dagli utenti in Google Fit.
• ConfigClient: accedi a impostazioni e tipi di dati personalizzati nella piattaforma Google Fit.

Guarda un esempio di come creare un client dell'API Fitness.

Flusso di autorizzazione utente risultante

Di seguito è riportato il flusso di autorizzazione che gli utenti sperimentano quando viene chiesto loro di concedere le autorizzazioni:

Figura 1. Il flusso di autorizzazione per gli utenti.

1. Autorizzazioni Android: gli utenti vedono le autorizzazioni Android richieste dalla tua app prima di scaricarla. Una volta scaricata, l'app richiede le autorizzazioni di runtime di cui ha bisogno e gli utenti le concedono o negano.
2. Verifica e connettiti: l'app controlla se le autorizzazioni sono state concesse prima di richiedere l'accesso ad altri tipi di dati.
3. Richiesta di ambiti OAuth: Google chiede all'utente di concedere alla tua app gli ambiti OAuth necessari per i tipi di dati a cui vuole accedere.
4. Accesso applicato: dopo che l'utente ha concesso le autorizzazioni, la tua app può accedere ai tipi di dati che appartengono agli ambiti per i quali l'utente ha concesso l'autorizzazione.

Richiedere la verifica

Dopo aver creato e testato l'app, devi richiedere la verifica con diversi livelli di giustificazione necessari per gli ambiti sensibili e con restrizioni.