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 derivanti dall'utilizzo di Google Play Services per la tua app.

Imposta

Prima di iniziare a creare la tua app, completa i passaggi nelle sezioni seguenti.

Crea un account Google

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

Installa Google Play Services

Scarica 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

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

Aggiungere 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.2.0")
}

DSL alla moda

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.2.0'
}

In questo modo, Gradle scarica automaticamente l'SDK per l'attività fisica quando crea l'app.

Crea e testa la tua app

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

Ottieni le autorizzazioni Android necessarie

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

Ottieni autorizzazioni OAuth

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

Creare un client API

Crea un client API e aggiungi i tipi di dati necessari all'app per accedere per scrivere o leggere i dati. Sono disponibili i seguenti endpoint:

• SensorsClient: accedi a diverse fonti di dati su salute e benessere dai sensori hardware nel dispositivo locale e nei dispositivi associati.
• RecordingClient: per la raccolta di dati dei sensori in background a basso consumo e con modalità sempre attiva.
• HistoryClient: inserisci, elimina e leggi i dati storici in Google Fit.
• SessionsClient: crea e gestisci sessioni di attività utente.
• GoalsClient: leggi gli obiettivi di punti cardio 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 API Fitness.

Flusso di autorizzazione utente risultante

Di seguito viene mostrato il flusso di autorizzazione risultante che viene riscontrato dagli utenti quando vengono richieste le autorizzazioni:

Figura 1.Il flusso di autorizzazione per gli utenti.

1. Autorizzazioni Android: gli utenti possono visualizzare le autorizzazioni Android richieste dall'app prima di scaricarla. Dopo averla scaricata, l'app richiede le autorizzazioni di runtime necessarie e gli utenti concedono o negano queste autorizzazioni.
2. Controlla e connetti: la tua app verifica se sono state concesse le autorizzazioni prima di richiedere l'accesso ad altri tipi di dati.
3. Richiesta ambiti OAuth: Google chiede all'utente di concedere all'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 la tua app, devi richiedere la verifica con diversi livelli di giustificazione necessari per gli ambiti sensibili e con restrizioni.