Salute
Aggiornamento più recente | Release stabile | Candidato di rilascio | Versione beta | Versione alpha |
---|---|---|---|---|
13 dicembre 2023 | - | 1.0.0-rc01 | - | 1.1.0-alpha02 |
Dichiarazione delle dipendenze
Per aggiungere una dipendenza all'integrità, devi aggiungere il Repository Maven di Google al tuo progetto. Per ulteriori informazioni, consulta il Repository Maven di Google.
Aggiungi le dipendenze per gli artefatti necessari nel file build.gradle
per l'app o il modulo:
Trendy
dependencies { implementation "androidx.health:health-services-client:1.1.0-alpha02" }
Kotlin
dependencies { implementation("androidx.health:health-services-client:1.1.0-alpha02") }
Feedback
Il tuo feedback ci aiuta a migliorare Jetpack. Contattaci se scopri nuovi problemi o hai idee per migliorare la libreria. Dai un'occhiata ai problemi esistenti in questa libreria prima di crearne uno nuovo. Puoi aggiungere il tuo voto a un problema esistente facendo clic sul pulsante a forma di stella.
Per ulteriori informazioni, consulta la documentazione di Issue Tracker.
Connessione Salute Client versione 1.0
Versione 1.0.0-alpha04
24 agosto 2022
A partire dalla versione 1.0.0-alpha04, androidx.health:health-connect-client
è stata migrata a
androidx.health.connect:connect-client
. Per le release future, utilizza androidx.health.connect:connect-client
e le note di rilascio associate nella nostra pagina Connessione Salute.
Per eseguire la migrazione, modifica l'importazione delle dipendenze da androidx.health:health-connect-client:1.0.0-alpha03
a androidx.health.connect:connect-client:1.0.0-alpha04
.
Versione 1.0.0-alpha03
27 luglio 2022
androidx.health:health-connect-client:1.0.0-alpha03
viene rilasciato. La versione 1.0.0-alpha03 contiene questi commit.
Nuove funzionalità
- Riepilogo delle nuove modifiche all'API: è stato aggiunto un insieme di unità alle API di lettura, scrittura e aggregazione. Le app ora possono recuperare o scrivere record con l'unità preferita, ad esempio grammi o milligrammi di nutrienti
NutritionRecord
.
Modifiche alle API
- Correggi
List<DataOrigin>
in modo che siaSet<DataOrigin>
in vari oggetti risposta alle richieste. (I42342) - Correggi l'unità di calorie totali basali da Alimentazione->Energia. (I0b429)
- Classi di esempio della serie spostate all'interno dei record della serie (Ica9bb):
CyclingPedalingCadence
->CyclingPedalingCadenceRecord.Sample
HeartRate
->HeartRateRecord.Sample
StepsCadence
->StepsCadenceRecord.Sample
- Ritirare la classe
HealthDataRequestPermission
a favore diPermissionController.createRequestPermissionActivityContract
; ciò favorisce una migliore rilevabilità e una parametrizzazione unificata. (I81e7f) - Aggiunte once liquide statunitensi al volume. (I5f03d)
- Aggiunto tipo di unità di velocità (I1d574)
- Tipo di unità percentuale aggiunta (I08f23)
- Aggiunto tipo di unità di pressione (Ifb01f)
- Aggiunto tipo di unità di massa (Ifd81a)
- Tipo di unità volume aggiunto (I59ad1)
- Tipo di alimentatore aggiunto. Classe di esempio Power Series spostata all'interno della classe
PowerRecord
. (I5b1e5) - Tipo di unità energetica aggiunta (I983ae)
- Aggiunto tipo di unità di temperatura (I4cdb5)
- Rinomina i riferimenti dell'attività in modo che siano specifici per l'allenamento, ad esempio (I3f936):
- Ridenominata
ActivityLap
->ExerciseLapRecord
- Ridenominata
ActivityEvent
->ExerciseEventRecord
- Ridenominata
Repetitions
->ExerciseRepetitionsRecord
- Ridenominata
ActivitySession
->ExerciseSessionRecord
- Ridenominata
- Metadati del pacchetto spostati nidificati sotto i record. (Ie0835)
- Unità di lunghezza utilizzata in tutti i record rimanenti (Ib10dd):
ActivityLapRecord
ElevationGainedRecord
HeightRecord
HipCircumferenceRecord
WaistCircumferenceRecord
- Aggiunto tipo di unità di lunghezza (Idae39)
- Aggiorna la terminologia descrittiva di
CervicalMucus
(I25a2b):CervicalMucus.Amount
->CervicalMucusRecord.Texture
CervicalMucus.Appearance
->CervicalMucusRecord.Sensation
- Aggiunto il suffisso "Record" a tutti i nomi delle classi di record (I1ffc2)
Correzioni di bug
- Risolvi i problemi di ProGuard quando le librerie sono create con la versione di release e
minifyEnabled
true. (I78933) - Nasconde la documentazione non destinata all'uso pubblico. (I7a08f)
- Risolve il problema nei client che potrebbero avere le proprie dipendenze Protobuf (https://android-review.googlesource.com/c/platform/frameworks/support/+/2105430)
Versione 1.0.0-alpha02
1° giugno 2022
androidx.health:health-connect-client:1.0.0-alpha02
viene rilasciato. La versione 1.0.0-alpha02 contiene questi commit.
Modifiche alle API
hasMetric
egetMetric
deprecate inAggregationResult
, aggiunti gli operatori "contains" e "get" (I7cc7c)- Aggiunge
OvulationTest.Result.HIGH
eOvulationTest.Result.INCONCLUSIVE
. (I9f9c4)
Correzioni di bug
- Riduci i requisiti dell'SDK a 26. (I6d201)
Versione 1.0.0-alpha01
11 maggio 2022
androidx.health:health-connect-client:1.0.0-alpha01
viene rilasciato. La versione 1.0.0-alpha01 contiene questi commit.
Nuove funzionalità
- API per la lettura dei record di salute e fitness condivisi da altre app.
- API per la scrittura di record di salute e fitness da condividere con altre app.
- API per recuperare metriche aggregate per record accessibili.
- API per recuperare le modifiche incrementali (inserimento, aggiornamento o eliminazione) dei record da parte di altre app.
- API per richiedere le autorizzazioni relative alle condizioni di salute degli utenti.
- per verificare le autorizzazioni o revocare le autorizzazioni per l'integrità concesse.
Health Services Client versione 1.1
Versione 1.1.0-alpha02
13 dicembre 2023
androidx.health:health-services-client:1.1.0-alpha02
viene rilasciato. La versione 1.1.0-alpha02 contiene questi commit.
Modifiche alle API
- Utilizza un'unica fonte attendibile per gli
ExerciseEvent
supportati. (I03308)
Correzioni di bug
- Correzioni di bug minori e miglioramenti alla documentazione.
Versione 1.1.0-alpha01
9 agosto 2023
androidx.health:health-services-client:1.1.0-alpha01
viene rilasciato. La versione 1.1.0-alpha01 contiene questi commit.
Nuove funzionalità
- Sono state aggiunte
ExerciseEvent
API insieme al primo evento concreto:GolfShotEvent
. Le primitiveExerciseEvent
consentono agli sviluppatori di chiedere assistenza e richiedere di essere avvisati quando lo smartwatch rileva qualcosa.GolfShotEvent
, ad esempio, consente agli sviluppatori di ricevere una notifica quando l'utente effettua un tiro di golf oltre a ricevere il tipo di swing riconosciuto.
Modifiche alle API
- Consenti ai client dell'SDK WHS di utilizzare le funzionalità di
GolfShotEvent
. (I76b03)
Correzioni di bug
- Invece di generare eccezioni in modo aggressivo per la visualizzazione di funzionalità relative agli eventi di allenamento sconosciute, filtrale dall'elenco. (I06afc)
Health Services Client versione 1.0
Versione 1.0.0-rc01
26 luglio 2023
androidx.health:health-services-client:1.0.0-rc01
viene rilasciato. La versione 1.0.0-rc01 contiene questi commit.
Nuove funzionalità
- Health Services è passato a 1.0.0-rc01 dopo la stabilizzazione in versione beta.
Modifiche alle API
- File API pubblici e sperimentali uniti per percorsi h- m. (Ic4630, b/278769092)
- N/D, le modifiche ai file API sono solo metodi di riordinamento. (I5fa95)
Versione 1.0.0-beta03
5 aprile 2023
androidx.health:health-services-client:1.0.0-beta03
viene rilasciato. La versione 1.0.0-beta03 contiene questi commit.
Nuove funzionalità
Ora è possibile configurare BatchingMode
per inviare dati di allenamento in batch all'intervallo configurato anziché all'impostazione predefinita durante un allenamento attivo, all'inizio dell'allenamento tramite ExerciseConfig
o durante con un metodo di override. Il supporto di questa funzionalità verrà attivato da una prossima release di Health Services nel Google Play Store e sarà possibile verificarlo tramite le funzionalità per l'allenamento. Nota: le modalità di raggruppamento hanno effetto quando il dispositivo è in uno stato di alimentazione non interattivo e comporteranno un maggiore consumo di energia.
Modifiche alle API
- Generazione di
HealthServicesException
quando la funzione di sospensioneoverrideBatchingModesForActiveExercise
non va a buon fine (Ifd387) - Introduzione delle funzioni di sospensione per l'API
overrideBatchingModesForActiveExercise
asincrona, che le rende più compatibili con Kotlin (I7dd15) BatchingMode
override facoltativo inExerciseConfig
(Id22e9)
Correzioni di bug
DataType
eExerciseUpdate
piccole correzioni (5e185f)
Versione 1.0.0-beta02
11 gennaio 2023
androidx.health:health-services-client:1.0.0-beta02
viene rilasciato. La versione 1.0.0-beta02 contiene questi commit.
Nuove funzionalità
- Sono state aggiunte funzioni di estensione
suspend
per le API asincroneListenableFuture
esistenti inExerciseClient
,PassiveMonitoringClient
eMeasureClient
per migliorare il supporto di Kotlin. (Iadea4) - È stata aggiunta l'API
ExerciseTypeConfig
che consente gli aggiornamenti durante un allenamento in corso. È stato aggiuntoGolfExerciseTypeConfig
per supportare l'aggiornamento diExerciseTypeConfig
durante gli allenamenti di golf. (I4c539)
Modifiche alle API
- Applica
HealthServicesException
alle funzioni di sospensione (I5e509) - Aggiungi un altro costruttore per la compatibilità con le versioni precedenti (Iddeda)
- Applica
RuntimeException
alle funzioni di sospensione (I53bca) - Rimuovi l'implementazione predefinita dell'eccezione (Id947f)
- Aggiunta dell'annotazione
@JvmDefaultWithCompatibility
(I8f206)
Correzioni di bug
- Aggiungi a kdoc per maggiore chiarezza (Ide285)
- Consentire il monitoraggio passivo per gli obiettivi solo se vengono monitorati anche gli stessi tipi di dati (Ibed8d)
Versione 1.0.0-beta01
24 ottobre 2022
androidx.health:health-services-client:1.0.0-beta01
viene rilasciato. La versione 1.0.0-beta01 contiene questi commit.
Nuove funzionalità
È stata aggiunta la possibilità di ascoltare eventi relativi alla salute tramite
PassiveMonitoringClient
. Il primo evento èHealthEvent.FALL_DETECTED
.Nuovi tipi di esercizi:
ALPINE_SKIING
BACKPACKING
CROSS_COUNTRY_SKIING
HORSE_RIDING
INLINE_SKATING
MOUNTAIN_BIKING
ORIENTEERING
ROLLER_SKATING
YACHTING
Nuovi DataType:
ELEVATION_LOSS
GOLF_SHOT_COUNT
Modifiche alle API
- Aggiornamento delle modalità di modellazione dei dati: il modello dei dati e il modo in cui sono rappresentati i valori
DataType
,DataPoint
e i relativi valori sottostanti sono stati rivisti. L'impatto principale è che le API ora sono molto più esplicite e sicure di digitazione. - I
DataPoint
di località non sono più rappresentati come unDoubleArray
, ma come un oggettoLocationData
di tipo forte. - Passaggio a un nuovo insieme di API listener passive:
- La trasmissione è stata sostituita da
PassiveListenerService
. - I listener esistenti sono stati sostituiti con un singolo listener:
PassiveListenerCallback
.
- La trasmissione è stata sostituita da
- È stato aggiunto un tag
<queries>
al file manifest di Health Services per fare in modo che le applicazioni non debbano più specificarlo nel proprio manifest (a condizione che nel sistema di build sia attivata la unione dei manifest). - Sono stati spostati da molti
ExerciseState
per rappresentare la fine o la fine dell'allenamento e sono stati aggiunti nuovi statiENDING
eENDED
. Ora questi parametri vengono combinati conExerciseEndReason
per rappresentare l'intera gamma di stati precedenti. - È stato cambiato il nome di
PassiveListenerConfig
setPassiveGoals
insetDailyGoals
per rispecchiare meglio che supportiamo solo gli obiettivi passivi giornalieri. - Gli elementi
PassiveGoal
ora sono sempreREPEATED
, il valore passivoTriggerFrequency
è stato rimosso. - Tutti i parametri
Long
eDouble
sono stati annotati con@FloatRange
. - Proprietà
swimmingPoolLengthMeters
aggiunta aExerciseConfig
che può essere specificata facoltativamente per migliorare i calcoli della distanza per il nuoto in piscina. - Obsoleto
ExerciseUpdate.activeDuration
. Usa invece il criterioExerciseUpdate.activeDurationCheckpoint
. - L'API
flushExerciseAsync()
è stata rinominata influshAsync()
inExerciseClient
. Measure.registerCallback
ridenominatoMeasure.registerMeasureCallback
.- Modifiche generali alla denominazione:
- Le proprietà della distanza ora hanno il suffisso
meters
. - I nomi dei metodi di callback sono ora passati.
- La maggior parte delle abbreviazioni è stata rimossa (
HrAccuracy
ora èHeartRateAccuracy
). - Le proprietà che seguono il pattern
enableFoo
ora sono denominateisFooEnabled
.
- Le proprietà della distanza ora hanno il suffisso
- Migrazione eseguita da Enum.
- Gli orari rappresentati da
Double
sono ora rappresentati daDuration
. - Le funzioni che restituiscono
ListenableFuture<Void?>
ora restituiscono unListenableFuture<Void>
. - Per le funzioni che accettano un callback viene ora sempre visualizzato questo parametro come ultimo parametro.
- Ora le classi con costruttori hanno sempre i costruttori pubblici.
- Le funzioni di registrazione non restituiscono più un
ListenableFuture
, ma passano invece lo stato della registrazione al callback fornito. - KDocumenti è stato migliorato.
- I corsi pubblici non estendono più
ProtoParcelable
.
Correzioni di bug
- Miglioramenti generali all'affidabilità IPC (I3b1e2)
Versione 1.0.0-alpha03
3 novembre 2021
androidx.health:health-services-client:1.0.0-alpha03
viene rilasciato. La versione 1.0.0-alpha03 contiene questi commit.
Nuove funzionalità
- L'SDK registrerà automaticamente le richieste di registrazione a callback di misura, listener di esercizi e callback di monitoraggio passivo in caso di interruzione della connessione IPC con l'APK di Health Services.
Modifiche alle API
- La versione minSdkVersion della libreria SDK è passata al livello API 30, poiché al momento il client di Health Services è supportato solo su Wear3.
Versione 1.0.0-alpha02
29 settembre 2021
androidx.health:health-services-client:1.0.0-alpha02
viene rilasciato. La versione 1.0.0-alpha02 contiene questi commit.
Modifiche alle API
ExerciseClient
ora supporta la preparazione di un allenamento. Questo consente ai clienti di riscaldare i sensori e di attendere, ad esempio, un correzione GPS prima di iniziare l'allenamento.- Introduce le classi CumulativeDataPoints e StatisticalDataPoints AggregateDataPoint per modellare meglio le metriche aggregate rilevate durante un allenamento attivo. I valori CumulativeDataPoints contengono valori cumulativi dei tipi di dati di intervalli aggregati (come la distanza totale durante l'allenamento), mentre il modello StatisticalDataPoints aggrega i punti dati campionati (come il valore minimo, massimo e medio di HeartRateB/m). Questo sostituisce i precedenti
AGGREGATE_*
DataType ed è possibile accedervi in ExerciseUpdate tramitegetLatestAggregateMetrics()
.AGGREGATE_*
I DataType non sono più supportati. PassiveMonitoring
Gli eventi sono stati rinominati inPassiveGoals
per supportare l'impostazione di obiettivi e la ricezione di notifiche quando questi obiettivi vengono raggiunti per tipi di dati come le metriche giornaliere (ad es. DAILY_STEPS).- È stata migliorata la modellazione della precisione e della disponibilità della frequenza cardiaca e della posizione grazie all'introduzione delle nuove classi HrAccuracy, LocationAccuracy e LocationAvailability.
- Nome migliorato per
ExerciseConfig
e nuovi campiPassiveMonitoringConfig
, nonché introduzione diExerciseConfig.shouldEnableGps
per richiedere dati supportati da GPS
Correzioni di bug
- Esegue la migrazione al trasporto IPC supportato da protocollo per un migliore supporto della compatibilità con le versioni precedenti
Versione 1.0.0-alpha01
18 maggio 2021
androidx.health:health-services-client:1.0.0-alpha01
viene rilasciato. La versione 1.0.0-alpha01 contiene questi commit.
Funzionalità della release iniziale
La libreria di Health Services fornisce agli sviluppatori una serie uniforme di API da integrare con le implementazioni di sensori specifiche per i dispositivi. Funziona subito con gli emulatori di Wear OS 3 e i dispositivi in arrivo, ma in futuro saranno supportate altre piattaforme. In questa release iniziale sono incluse tre piattaforme API di primo livello: ExerciseClient
, PassiveMonitoringClient
e MeasureClient
.
Cliente allenamento
ExerciseClient
è progettato per le applicazioni che monitorano gli esercizi attivi, con fino a 82 ExerciseType
diversi, per camminata e corsa, danza e pallanuoto. Durante il rilevamento di questi allenamenti, è disponibile una selezione di 50 DataType
diversi a seconda del tipo di allenamento e dell'hardware disponibile sul dispositivo. Per iniziare, specifica le informazioni pertinenti nel tuo ExerciseConfig
, chiama il numero exerciseClient.startExercise
e ascolta l'avanzamento nel listener di aggiornamenti.
PassiveMonitoringClient
PassiveMonitoringClient
è un'ottima scelta se la tua applicazione monitora l'attività dell'utente nell'arco della giornata. Puoi registrare un PendingIntent
con un insieme di DataType
e ricevere la sveglia per gestire le modifiche collettive. In alternativa, puoi specificare un Event
, ad esempio il raggiungimento di un determinato numero di passaggi.
MisuraCliente
A volte l'utente deve misurare, ad esempio, il battito cardiaco in tempo, non durante un allenamento o durante la giornata. In questi momenti, MeasureClient
è la scelta perfetta.Devi solo registrare il callback con i DataType
supportati per ricevere uno stream di dati e annullare la registrazione del callback quando non è più necessario.