Iniziare a usare 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 di Google Play Services per la tua app.

Configurazione

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

Crea un account Google

Per usare le API di Google Fit devi avere un Account Google. Puoi creare un nuovo account o utilizzare un account esistente. Potresti creare un account separato per testare la tua app dal punto di vista dell'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, trova Google Play Services.
3. Se lo stato di questi pacchetti non è Installato, selezionali entrambi e fai clic su Installa pacchetti.

Ottieni 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 maggiori dettagli su come creare e configurare un nuovo progetto in Android Studio, consulta la pagina Creare un progetto.

Aggiungere la libreria client di Google Play Services

In Android Studio, apri il file build.gradle per il 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.1.0")
        implementation("com.google.android.gms:play-services-auth:20.7.0")
}

DSL trendy

apply plugin: 'com.android.application'

...

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

In questo modo, Gradle scarica automaticamente l'SDK per l'attività fisica quando crea 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 l'app può archiviare 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 è autorizzata ad accedere corrispondono agli ambiti di autorizzazione. Per richiedere queste autorizzazioni, devi aggiungere i tipi di dati a cui deve accedere la tua app in un'istanza FitnessOptions. Quando l'app chiede di utilizzare uno dei tipi di dati Google Fit, l'SDK Android controlla automaticamente gli ambiti a cui appartengono e richiede l'autorizzazione dell'utente a tali ambiti.

Crea un client API

Crea un client API e aggiungi i tipi di dati a cui deve accedere la tua app 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 del dispositivo locale e dei dispositivi complementari.
• RecordingClient: per una raccolta di dati dei sensori sempre attiva e a basso consumo.
• HistoryClient: inserisci, elimina e leggi dati storici in Google Fit.
• SessionsClient: crea e gestisci le Sessioni di attività utente.
• GoalsClient: leggi gli obiettivi di Punto cardio e passi creati dagli utenti in Google Fit.
• ConfigClient: accedi a tipi di dati e impostazioni personalizzati nella piattaforma Google Fit.

Vedi un esempio di come creare un client API per il fitness.

Flusso di autorizzazione dell'utente risultante

Di seguito è riportato il flusso di autorizzazione risultante che gli utenti riscontrano quando vengono richieste le autorizzazioni:

Figura 1.Il flusso di autorizzazione per gli utenti.

1. Autorizzazioni Android: gli utenti vedono quali autorizzazioni Android hanno richiesto prima di scaricare l'app. Una volta scaricata, l'app richiede le autorizzazioni di runtime necessarie e gli utenti le concedono o negano.
2. Controlla e connetti: la tua 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 concede le autorizzazioni, l'app può accedere ai tipi di dati che appartengono agli ambiti per cui 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 per gli ambiti sensibili e con restrizioni.