Inizia su Android

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

Configurazione

Prima di iniziare a creare la tua app, completa i passaggi riportati di seguito sezioni.

Per usare le API Google Fit è necessario un Account Google. Puoi creare un nuovo account oppure usano un account esistente. Consigliamo di creare un account distinto per eseguire test la tua app dal punto di vista dell'utente.

Scarica la libreria client più recente per Google Play Services in relazione al tuo sviluppo host:

  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.

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

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

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

DSL KotlinDSL alla moda
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")
}
 
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 crea la tua app.

Crea e testa la tua app

Dopo aver completato i passaggi di configurazione, puoi iniziare a creare la tua app. Per ottenere hai iniziato, scopri i tipi di dati che la tua app può archiviare lettura. Scopri di più sull'utilizzo di dati in Google Fit.

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

I tipi di dati a cui la tua app può accedere corrispondono ambiti di autorizzazione. Per chiedere per queste autorizzazioni, devi aggiungere i tipi di dati a cui la tua app deve accedere in un FitnessOptions di Cloud Shell. Quando l'app chiede l'utilizzo dei dati di Google Fit di tipi, l'SDK Android controlla automaticamente a quali ambiti appartengono e chiede per l'autorizzazione all'utente.

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

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

Di seguito viene mostrato il flusso di autorizzazione risultante degli utenti quando viene richiesta l'autorizzazione:

Figura 1.Il flusso di autorizzazione per gli utenti.
  1. Autorizzazioni Android: gli utenti vedono quali autorizzazioni Android dà accesso alla tua app richiesto prima di scaricarlo. Una volta scaricata, l'app richiede le autorizzazioni di runtime di cui ha bisogno e gli utenti concedono o negano queste autorizzazioni.
  2. Controlla e connetti: l'app controlla se le autorizzazioni sono state concessi prima di richiedere l'accesso ad altri tipi di dati.
  3. Richiesta ambiti OAuth: Google chiede all'utente di concedere la 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, l'app può consente di accedere ai tipi di dati che appartengono agli ambiti concessi dall'utente per cui disponi dell'autorizzazione di autorizzazione.

Richiedere la verifica

Dopo aver creato e testato l'app, devi richiedere verifica con diverse i livelli di giustificazione necessari ambiti sensibili e con restrizioni.