Health Connect
Actualización más reciente | Versión estable | Versión potencial | Versión beta | Versión alfa |
---|---|---|---|---|
10 de enero de 2024 | - | - | - | 1.1.0-alpha07 |
Solicita acceso a tipos de datos
Para ayudarnos a fortalecer la privacidad y la seguridad de los usuarios, los desarrolladores que se integran con Health Connect deben declarar el acceso de lectura o escritura para los tipos de datos que usan sus apps. Los desarrolladores deben incluir casos de uso válidos para los tipos de datos que usan en función del propósito de la app. Si quieres obtener más información, consulta Cómo proporcionar información para el formulario de declaración de apps de salud y Permisos para Health Connect de Android.
Cómo declarar dependencias
Para agregar una dependencia en Health, debes agregar el repositorio de Maven de Google a tu proyecto. Lee el repositorio de Maven de Google para obtener más información.
Agrega las dependencias de los artefactos que necesites en el archivo build.gradle
de tu app o módulo:
Groovy
dependencies { // Use to implement health connects implementation "androidx.health.connect:connect-client:1.1.0-alpha08" }
Kotlin
dependencies { // Use to implement health connects implementation("androidx.health.connect:connect-client:1.1.0-alpha08") }
Para obtener más información sobre las dependencias, consulta Cómo agregar dependencias de compilación.
Comentarios
Tus comentarios ayudan a mejorar Jetpack. Avísanos si descubres nuevos errores o tienes ideas para mejorar esta biblioteca. Consulta los errores existentes de esta biblioteca antes de crear uno nuevo. Puedes agregar tu voto a un error existente haciendo clic en el botón de la estrella.
Consulta la documentación sobre la Herramienta de seguimiento de errores para obtener más información.
Versión 1.1
Versión 1.1.0-alpha07
10 de enero de 2024
Lanzamiento de androidx.health.connect:connect-client:1.1.0-alpha07
. La versión 1.1.0-alpha07 contiene estas confirmaciones.
Cambios en la API
- Muestra
SDK_UNAVAILABLE
cuando se llama a#getSdkStatus
desde un contexto de usuario de perfil. (I91df3). - Se quita
SleepStageRecord
. (/If6ada).
Correcciones de errores
- Se arroja
RemoteException
en lugar deIllegalStateException
en fallas de vinculación. (Id2233).
Versión 1.1.0-alpha06
18 de octubre de 2023
Lanzamiento de androidx.health.connect:connect-client:1.1.0-alpha06
. La versión 1.1.0-alpha06 contiene estas confirmaciones.
Cambios en la API
- Hace públicas las definiciones de
recordingMethod
. (I401fb).
Correcciones de errores
- Se agregó documentación a la ruta de ejercicio en la que se especifique que la ubicación debe ser anterior a la hora de finalización de la sesión. (0e51e6).
Versión 1.1.0-alpha05
4 de octubre de 2023
Lanzamiento de androidx.health.connect:connect-client:1.1.0-alpha05
. La versión 1.1.0-alpha05 contiene estas confirmaciones.
Cambios en la API
- Se agregó un intent que navega a la pantalla de administración de datos de Health Connect. (Ibf591).
- Se quitaron los métodos obsoletos en
AggregationResult
. (Idbda9). - Se agregó una API conveniente para crear
ReadRecordsRequest
, además de borrar y leer registros, con un tipo de registro reificado. (If58a5).
Correcciones de errores
- Se corrigió un error en Android 14 por el que los campos de nutrición nulos se mostraban como
Double.MIN_VALUE
. (1aa1d1). - Se corrigió un error en Android 14 por el que la agregación por período mensual o anual arrojaba una excepción en la respuesta debido a que los buckets tenían la misma hora de inicio y finalización. (281313).
Versión 1.1.0-alpha04
6 de septiembre de 2023
Lanzamiento de androidx.health.connect:connect-client:1.1.0-alpha04
. La versión 1.1.0-alpha04 contiene estas confirmaciones.
Cambios en la API
- Solo para Java: Cambia el nombre del campo
getHasMore()
deChangesResponse
ahasMore()
. (I80695). - Verifica la alineación
HealthPermissionsRequestContract#createIntent
en todas las versiones de Android. El contrato verifica que todos los permisos estén relacionados con el estado. (I143fc).
Correcciones de errores
- Corrige la excepción que se arroja cuando se crea
ExerciseSessionRecord
con unExerciseRoute
que contiene una lista vacía de ubicaciones. (I45c16). - Se actualizó la documentación y el código de muestra de
SleepSessionRecord
para leer sesiones de sueño. (Idf0de).
Versión 1.1.0-alpha03
26 de julio de 2023
Lanzamiento de androidx.health.connect:connect-client:1.1.0-alpha03
. La versión 1.1.0-alpha03 contiene estas confirmaciones.
Nuevas funciones
- API para leer y escribir rutas de ejercicio:
- Se agregó
ExerciseRouteResult
aExerciseSessionRecord
- Se agregó
ExerciseRouteRequestContract
- Se agregó
Cambios en la API
- Se agregó
ExerciseRouteResult
y sus subclases:Data
,NoData
yConsentRequiredStates
. - Se agregó
ExerciseRoute
como una clase independiente, que contiene datos de ubicación de la ruta. (I22eed). - Se agregó
PERMISSION_WRITE_EXERCISE_ROUTE
. (I92fc4). - Se agregó
ExerciseRouteRequestContract
, se agregóHealthPermissionsRequestContract
. (Ief0e5).
Correcciones de errores
- Construcción fija de energía en kilojulios (Ie8791)
Versión 1.1.0-alpha02
21 de junio de 2023
Lanzamiento de androidx.health.connect:connect-client:1.1.0-alpha02
. La versión 1.1.0-alpha02 contiene estas confirmaciones.
Correcciones de errores
- Se corrigió la fuga de
HealthDataSdkService
. (Ia3ba5) - Siempre redirecciona al cliente de
HealthConnect
correcto cuando solicites permisos en Android U (I6415a).
Versión 1.1.0-alpha01
7 de junio de 2023
Lanzamiento de androidx.health.connect:connect-client:1.1.0-alpha01
. Esta versión se desarrolla en una rama interna.
Nuevas funciones
- Compatibilidad con la versión del framework de Android 14 de Health Connect Este SDK es un requisito previo para Android 14. Sin esta opción, las apps no podrán integrarse con Health Connect en Android 14.
- Se agregó un método de grabación para registrar metadatos.
Cambios en la API
- Cambios en la API de la sesión:
- Se agregaron varias fases del sueño a
SleepSessionRecord
y se quitóSleepStageRecord
. - Se agregaron
ExerciseLap
yExerciseSegment
aExerciseSessionRecord
.
- Se agregaron varias fases del sueño a
- Límites de frecuencia diarios y periódicos (incluidos los límites de memoria) para las operaciones de lectura, registro de cambios, inserción y eliminación.
- Se agregó la validación para todos los campos
NutritionRecord
. - Se agregó la validación para
HeartRateVariabilityRmssdRecord
. - Se quitaron dos APIs obsoletas:
HealthConnectClient#isProviderAvailable
yHealthConnectClient#isApiSupported
.
Correcciones de errores
- Igualdad de unidades fijas para todos los tipos de unidades, ya no depende del tipo que se use en la inicialización de unidades P.ej., Mass.grams(1000) ahora es igual a Mass.kilograms(1).
Versión 1.0
Versión 1.0.0-alpha11
22 de febrero de 2023
Se lanzó androidx.health.connect:connect-client:1.0.0-alpha11
. La versión 1.0.0-alpha11 contiene estas confirmaciones.
Cambios en la API
- Se agregó un intent que se usa para abrir Health Connect (Ic8055).
- Se quitaron algunos tipos de ejercicio. En su lugar, usa
EXERCISE_TYPE_STRENGTH_TRAINING
,EXERCISE_TYPE_HIGH_INTENSITY_INTERVAL_TRAINING
oEXERCISE_TYPE_CALISTHENICS
(I7291c). - Se agregó la nueva API de
sdkStatus()
que combina las dos APIs obsoletas deisSdkSupported()
yisProviderAvailable()
(Iac89d). - Se cambiaron las APIs que aceptan
providerPackageName
para aceptar una sola string en lugar de una lista (I67e0f).
Versión 1.0.0-alpha10
25 de enero de 2023
Se lanzó androidx.health.connect:connect-client:1.0.0-alpha10
. La versión 1.0.0-alpha10 contiene estas confirmaciones.
Cambios en la API
ExerciseEventRecord
,ExerciseLapRecord
,ExerciseRepititionRecord
ySwimmingStrokesRecord
ya no se admiten comoRecordTypes
. Ya no se pueden escribir ni leer desdeHealthConnect
. Quita cualquier referencia a estos tipos de datos de la integración deHealthConnect
(If7ca2).- Se realizaron cambios en las APIs de permisos para aceptar permisos en un formato nuevo basado en cadenas. Este cambio también requiere que se cambie la declaración de permisos al formato de permisos estándar de Android (Ib0a2f).
Versión 1.0.0-alpha09
11 de enero de 2023
Lanzamiento de androidx.health.connect:connect-client:1.0.0-alpha09
. La versión 1.0.0-alpha09 contiene estas confirmaciones.
Nuevas funciones
- Se agregaron 2 nuevos tipos de datos de salud femenina para Health Connect:
IntermenstrualBleedingRecord
yMenstruationPeriodRecord
.MenstruationFlow.ENUMs
son ligero, intermedio, intenso y desconocido.
Cambios en la API
- Se agregó
IntermenstrualBleedingRecord
(Idc470). - Se agregó el tipo de registro
MenstruationPeriodRecord
(Iea545).
Versión 1.0.0-alpha08
7 de diciembre de 2022
Lanzamiento de androidx.health.connect:connect-client:1.0.0-alpha08
. La versión 1.0.0-alpha08 contiene estas confirmaciones.
Cambios en la API
- Se agregó
BodyWaterMass
yHeartRateVariabilityRmssdRecord
como nuevos tipos de registro compatibles (Ifd58f). - Se quitó
HipCircumferenceRecord
,WaistCircumferenceRecord
, según se admiteRecordTypes
(I62fb9). - Se cambió
MenstruationFlowRecord.flow
destringdef
aintdefs
(I0369f). - Se cambiaron los campos de registro de tipo de enumeración de
Strings
aIntegers
para lograr un mejor rendimiento (I3b295). - Se cambiaron los campos de tipo de enumeración
ExerciseSession
,ExerciseRepetitions
ySleepStage
de tipo string a número entero (Id32a9). - Se cambió el nombre de
ExerciseSessionRecord.ACTIVE_TIME_TOTAL->EXERCISE_DURATION_TOTAL
(I5d7bd). - Se agregó "Inusual" a enumeraciones
CervicalMucus
. Se cambió el nombre de "Clear" a "Eggwhite" para brindar más especificidad. Se cambióCervicalMucus#appearance
y #sensation deStringDefs
a IntDefs (I3ac51). - La enumeración
StringDef
deDeviceTypes
ahora se trasladó aIntDefs
en Dispositivo (I3abf3). - Se agregó
HealthConnectClient.isApiSupported()
, que muestra "falso" como valor en versiones de SDK sin implementaciones compatibles. Se cambió el nombre deHealthConnectClient.isAvailable->isProviderAvailable
(I3674e).
Correcciones de errores
- No se permiten valores
HeartRate beatsPerMinute
menores que 1 (I6052f). - Se agregó la anotación
@JvmDefaultWithCompatibility
(I8f206).
Versión 1.0.0-alpha07
24 de octubre de 2022
Lanzamiento de androidx.health.connect:connect-client:1.0.0-alpha07
. La versión 1.0.0-alpha07 contiene estas confirmaciones.
Cambios en la API
- Los argumentos de registros sin valores predeterminados se colocan antes de los argumentos con valores predeterminados. Para mantener la coherencia, los argumentos
Instant
yZoneOffset
siempre se colocan al principio (Id618c). - Se cambió el nombre de
HealthConnectClient.getOrCreate#packageNames
porproviderPackageNames
(Id81e4).
Correcciones de errores
- Se agregaron validaciones de valor del campo Record. Los valores muy incorrectos arrojarán
IllegalArgumentExceptions
cuando el valor proporcionado esté fuera de los límites razonables (Ie171d). - Se valida que la hora de inicio del registro sea anterior a la hora de finalización cuando esto resulte relevante (I02460).
Versión 1.0.0-alpha06
5 de octubre de 2022
Lanzamiento de androidx.health.connect:connect-client:1.0.0-alpha06
. La versión 1.0.0-alpha06 contiene estas confirmaciones.
Correcciones de errores
- Mejora el ciclo de vida de la conexión de servicio (If2bd5).
- Se corrigió un error de falla de NPE que se producía cuando se generaba una excepción en la conexión de servicio (I13546).
Versión 1.0.0-alpha05
21 de septiembre de 2022
Lanzamiento de androidx.health.connect:connect-client:1.0.0-alpha05
. La versión 1.0.0-alpha05 contiene estas confirmaciones.
Cambios en APIs
- Se cambió el nombre de
Metadata.uid
aMetadata.id
y se usó la terminologíarecordId
de manera coherente en todas las APIs de CRUD relacionadas (I3d1d2). - Se convirtió a
PermissionController.createRequestPermissionActivityContract
en un método estático en lugar de un método de instancia. Se cambió el nombre aPermissionController.createRequestPermissionResultContract
(Icd2fe). - Se agregó el tipo de unidad
BloodGlucose
paraBloodGlucoseRecord
(I97678). - Se cambió el nombre de
MenstruationRecord
aMenstruationFlowRecord
(I3b88e).
Correcciones de errores
- Se corrigió el comportamiento no deseado que no propagaba las estadísticas de primer plano del proceso del cliente (Ifb44c).
Versión 1.0.0-alpha04
24 de agosto de 2022
Lanzamiento de androidx.health.connect:connect-client:1.0.0-alpha04
. La versión 1.0.0-alpha04 contiene estas confirmaciones.
Migración a `androidx.health.connect
A partir de la versión 1.0.0-alpha04, se migró androidx.health:health-connect-client
a androidx.health.connect:connect-client
. Si deseas obtener versiones anteriores de Health Connect, visita la página de androidx.health.
Para migrar, simplemente cambia la importación de dependencias de androidx.health:health-connect-client:1.0.0-alpha03
a androidx.health.connect:connect-client:1.0.0-alpha04
.
Nuevas funciones
- Se incluyeron los registros de depuración opcionales integrados para las llamadas a la API (vínculo).
Cambios en APIs
- Se cambió el nombre de los metadatos
clientId
aclientRecordId
, declientVersion
aclientRecordVersion
(vínculo). - El UID de metadatos ahora es más fácil de usar para los lectores y ya no es anulable (vínculo).
- Se agregaron libras a la unidad de masa (vínculo).
- Se cambió el nombre de
DeletionChange.deleteUid
por uid (vínculo). - Se cambió el nombre del permiso -> HealthPermission. Esto evita la ambigüedad en los permisos del framework de Android (vínculo).
Correcciones de errores
- Se corrigieron problemas de regresión con la unidad de calorías incorrecta con energía (vínculo).
- Se corrigió un problema de regresión relacionado con la agregación de pocos tipos de registro (vínculo).