Comienza en Android

En esta guía, se explica cómo comenzar a desarrollar con Google Fit en Android.

Configuración

Antes de comenzar a compilar tu app, completa los pasos que se indican en las siguientes secciones.

Para usar las APIs de Google Fit, necesitas una Cuenta de Google. Puedes crear una cuenta nueva o usar una existente. Te recomendamos que crees una cuenta independiente para probar tu app desde la perspectiva de un usuario.

Obtén la biblioteca cliente más reciente de los Servicios de Google Play en tu host de desarrollo:

  1. Abre el Android SDK Manager.
  2. En SDK Tools, busca Servicios de Google Play.
  3. Si el estado de estos paquetes no es Instalado, selecciónalos y haz clic en Instalar paquetes.

Para habilitar la API de Fitness, obtén un ID de cliente de OAuth 2.0.

Te recomendamos usar el entorno de desarrollo de Android Studio para compilar una app con la API de Fitness. Para obtener detalles sobre cómo crear un proyecto nuevo y configurarlo en Android Studio, consulta Cómo crear un proyecto.

En Android Studio, abre el archivo build.gradle de tu módulo y agrega la biblioteca cliente de los Servicios de Google Play como dependencia:

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

Esto garantiza que Gradle descargue automáticamente el SDK de fitness cuando compile tu app.

Compila y prueba tu app

Después de completar los pasos de configuración, puedes comenzar a compilar tu app. Para comenzar, obtén información sobre los tipos de datos que tu app puede almacenar y leer. Obtén más información para trabajar con datos en Google Fit.

Para leer y escribir algunos tipos de datos, tu app debe solicitar permisos de Android.

Los tipos de datos a los que tu app tiene permiso para acceder corresponden a los alcances de autorización. Para solicitar estos permisos, debes agregar a qué tipos de datos necesita acceso tu app en una instancia de FitnessOptions. Cuando tu app solicita usar cualquiera de los tipos de datos de Google Fit, el SDK de Android verifica automáticamente a qué permisos pertenecen y le solicita al usuario la autorización para esos permisos.

Crea un cliente de API y agrega los tipos de datos a los que tu app necesita acceder para escribir o leer datos. Los siguientes extremos están disponibles:

  • SensorsClient: Accede a diferentes fuentes de datos de salud y bienestar desde los sensores de hardware en el dispositivo local y en los dispositivos complementarios.
  • RecordingClient: Para la recopilación en segundo plano siempre activa y de bajo consumo de datos del sensor.
  • HistoryClient: Inserta, borra y lee datos históricos en Google Fit.
  • SessionsClient: Crea y administra sesiones de la actividad del usuario.
  • GoalsClient: Lee los objetivos de pasos y puntos cardíacos que crean los usuarios en Google Fit.
  • ConfigClient: Accede a los tipos de datos y la configuración personalizados en la plataforma de Google Fit.

Consulta un ejemplo de cómo compilar un cliente de la API de Fitness.

A continuación, se muestra el flujo de autorización resultante que experimentan los usuarios cuando se les solicitan permisos:

Figura 1: Flujo de autorización para los usuarios.
  1. Permisos de Android: Los usuarios ven los permisos de Android que solicitó tu app antes de descargarla. Después de que se descarga la app, esta solicita los permisos de tiempo de ejecución que necesita, y los usuarios los otorgan o rechazan.
  2. Comprueba y conecta: Tu app verifica si se otorgaron permisos antes de solicitar acceso a otros tipos de datos.
  3. Solicitud de permisos de OAuth: Google le solicita al usuario que otorgue a tu app los permisos de OAuth necesarios para los tipos de datos a los que desea acceder.
  4. Acceso aplicado: Después de que el usuario otorga permisos, tu app puede acceder a los tipos de datos que pertenecen a los permisos que el usuario otorgó.

Solicita la verificación

Después de compilar y probar tu app, debes solicitar la verificación con diferentes niveles de justificación necesarios para los permisos sensibles y restringidos.