Repolode
Enviar
appeeky

appeeky/expo-healthkit

Módulo para Expo/React Native que ofrece una única API de JavaScript para Apple HealthKit y Android Health Connect.

Alternativa open source a:react-native-healthkit

Ver en GitHub
Estrellas
108
Forks
8
Issues abiertos
1
Último commit
hace 11 días

¿Qué es?

@appeeky/expo-healthkit es un módulo nativo basado en Expo Modules API que ofrece a las aplicaciones Expo y React Native una única API de JavaScript para acceder a datos de salud en ambas plataformas: HealthKit en iOS y Health Connect en Android. El código de la aplicación siempre usa identificadores de tipos de Apple; la capa nativa se encarga de asignar los tipos, así que los tipos compatibles, como pasos, frecuencia cardíaca, sueño, masa corporal y presión arterial, no requieren lógica distinta para cada plataforma.

Las consultas incluyen muestras de cantidad y categoría, entrenamientos, agregados estadísticos y estadísticas por intervalos, además de datos exclusivos de iOS como electrocardiogramas, anillos de actividad, registros clínicos FHIR y rutas GPS de entrenamientos. Se pueden guardar muestras de cantidad y categoría, entrenamientos y correlaciones, como la presión arterial, además de eliminar datos. La sincronización incremental usa un token de anclaje opaco; en Android, comienza con una lectura paginada y luego usa tokens de cambios de Health Connect.

Un plugin de configuración añade los entitlements de HealthKit y las declaraciones de permisos de Health Connect, y eleva minSdk a 26. Requiere Expo SDK 53 o posterior con un development build (Expo Go no es compatible), iOS 16.4 o posterior y Android 8 o posterior.

Funciones clave

  • 01Una API para ambas plataformas: los mismos métodos e identificadores de tipos de Apple funcionan en iOS y Android, con la asignación resuelta de forma nativa.
  • 02Consultas de muestras de cantidad y categoría, entrenamientos y estadísticas, incluidos intervalos mediante queryStatisticsCollection.
  • 03Consultas exclusivas de iOS para electrocardiogramas, anillos de actividad, registros clínicos FHIR, audiogramas, rutas GPS de entrenamientos, series de latidos y correlaciones.
  • 04Sincronización incremental mediante queryAnchored, que devuelve added, deleted, anchor y hasMore para recuperar los cambios por páginas.
  • 05Guardado y eliminación: saveQuantitySample, saveCategorySample, saveWorkout, saveCorrelation y deleteObjects.
  • 06Entrega en segundo plano con observe, addUpdateListener y enableBackgroundDelivery; los tipos observados guardados se vuelven a registrar si la aplicación se reinicia tras cerrarse.
  • 07El plugin de configuración declara las cadenas de uso de HealthKit y las entradas uses-permission de Health Connect, y eleva minSdk a 26.
  • 08Los códigos de error diferenciados (ERR_HEALTHKIT_UNSUPPORTED, ERR_HEALTH_CONNECT_UNSUPPORTED, ERR_HEALTH_CONNECT_ANCHOR_EXPIRED) permiten ocultar la interfaz no compatible sin comprobar Platform.OS.

Casos de uso

  • Consultar los pasos diarios, la frecuencia cardíaca o el sueño desde una aplicación de fitness.
  • Crear paneles de salud para seguir tendencias de peso, presión arterial o composición corporal.
  • Guardar en HealthKit o Health Connect los entrenamientos y las muestras registradas en la aplicación.
  • Sincronizar el historial de salud de un usuario con tu propio backend mediante consultas incrementales ancladas.
  • Mostrar en iOS datos exclusivos de Apple, como electrocardiogramas o anillos de actividad, y ocultarlos en Android.

Inicio rápido

  1. 1

    Instala el paquete con Expo

    npx expo install @appeeky/expo-healthkit
  2. 2

    Añade el config plugin a app.json o app.config.ts

  3. 3

    Vuelve a compilar el código nativo y ejecútalo en un development build

    npx expo prebuild --clean

Antes de usarlo

  • Las API de datos de salud no pueden ejecutarse en Expo Go; se requiere un development build.
  • Se requiere iOS 16.4 o posterior con la capability HealthKit activada, o Android 8 o posterior con Health Connect.
  • El paquete no declara ninguna licencia en sus metadatos (NOASSERTION), así que comprueba la licencia antes de usarlo.
  • En iOS, la autorización de lectura es opaca, por lo que las aplicaciones no pueden saber si se denegaron las lecturas.

En colecciones

Apps para Android y herramientas para el móvil

Temas

#react-native#expo#healthkit#health-connect#ios#android#mobile#typescript#health-data#apple-healthkit

Preguntas frecuentes

¿Qué es expo-healthkit?
Módulo para Expo/React Native que ofrece una única API de JavaScript para Apple HealthKit y Android Health Connect. @appeeky/expo-healthkit es un módulo nativo basado en Expo Modules API que ofrece a las aplicaciones Expo y React Native una única API de JavaScript para acceder a datos de salud en ambas plataformas: HealthKit en iOS y Health Connect en Android. El código de la aplicación siempre usa identificadores de tipos de Apple; la capa nativa se encarga de asignar los tipos, así que los tipos compatibles, como pasos, frecuencia cardíaca, sueño, masa corporal y presión arterial, no requieren lógica distinta para cada plataforma.
¿expo-healthkit es gratuito? ¿Qué licencia tiene?
expo-healthkit es open source bajo la licencia Other. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿expo-healthkit sigue mantenido?
Mantenimiento activo. El último commit de expo-healthkit fue el 26 oct 2026.
¿Para qué puedo usar expo-healthkit?
Consultar los pasos diarios, la frecuencia cardíaca o el sueño desde una aplicación de fitness. Crear paneles de salud para seguir tendencias de peso, presión arterial o composición corporal. Guardar en HealthKit o Health Connect los entrenamientos y las muestras registradas en la aplicación. Sincronizar el historial de salud de un usuario con tu propio backend mediante consultas incrementales ancladas. Mostrar en iOS datos exclusivos de Apple, como electrocardiogramas o anillos de actividad, y ocultarlos en Android.
¿Cómo se instala expo-healthkit?
Instala el paquete con Expo: npx expo install @appeeky/expo-healthkit Añade el config plugin a app.json o app.config.ts Vuelve a compilar el código nativo y ejecútalo en un development build: npx expo prebuild --clean
¿Dónde consigo expo-healthkit?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/appeeky/expo-healthkit

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados