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 a continuación secciones.

Para usar las APIs de Google Fit, necesitas una Cuenta de Google. Puedes crear una cuenta nueva o usar una cuenta existente. Puede crear otra cuenta para probar desde la perspectiva del usuario.

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

  1. Abre Android SDK Manager.
  2. En SDK Tools, busca Servicios de Google Play.
  3. Si el estado de este paquete no es Instalado, seleccione ambos. y haz clic en Instalar paquetes.

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

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

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

DSL de KotlinDSL de Groovy
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 compila tu app.

Compila y prueba tu app

Una vez que completes los pasos de configuración, podrás comenzar a compilar tu app. Para obtener obtén información sobre los tipos de datos que tu app puede almacenar y leer. Obtén más información sobre cómo 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 permisos de autorización. Para preguntar para estos permisos, debes agregar a qué tipos de datos necesita acceder tu app en un FitnessOptions de Compute Engine. Cuando la app solicita usar los datos de Google Fit el SDK de Android comprueba automáticamente a qué ámbitos pertenecen y pregunta al usuario para obtener autorización a esos ámbitos.

Crea un cliente de API y agrega los tipos de datos a los que necesita acceder tu app 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 del dispositivo local y los dispositivos complementarios.
  • RecordingClient: Para la recopilación de datos de sensores en segundo plano y de bajo consumo, que está siempre activa.
  • HistoryClient: Inserta, borra y lee datos históricos en Google Fit
  • SessionsClient: Crea y administra sesiones de actividad del usuario.
  • GoalsClient: Lee los objetivos de Puntos cardio y Pasos creados por usuarios en Google Fit.
  • ConfigClient: Accede a parámetros de configuración y tipos de datos personalizados en la plataforma de Google Fit.

Mira un ejemplo de cómo crear un cliente de la API de Fitness.

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

Figura 1: Flujo de autorización para usuarios.
  1. Permisos de Android: Los usuarios ven los permisos de Android que otorga tu app. solicitado antes de descargarlo. Una vez que se descarga la aplicación, solicita los permisos de tiempo de ejecución que necesite y los usuarios otorgan o deniegan estos permisos.
  2. Verificar y conectarse: La app verifica si se aplicaron los permisos otorgada antes de solicitar acceso a otros tipos de datos.
  3. Solicitud de alcance de OAuth: Google le solicita al usuario que otorgue a tu aplicación. los permisos de OAuth necesarios para los tipos de datos a los que quiere acceder.
  4. Acceso aplicado: Después de que el usuario otorga los permisos, tu app puede acceder a los tipos de datos que pertenecen a los permisos que otorgó el usuario permiso.

Solicitar verificación

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