Salute

Dichiara le dipendenze

Per aggiungere una dipendenza da Health, devi aggiungere il repository Maven di Google al tuo progetto. Per saperne di più, consulta il repository Maven di Google.

Aggiungi le dipendenze per gli artefatti necessari nel file build.gradle per la tua app o il tuo modulo:

dependencies {
    implementation "androidx.health:health-services-client:1.1.0"
}

dependencies {
    implementation("androidx.health:health-services-client:1.1.0")
}

Feedback

Il tuo feedback ci aiuta a migliorare Jetpack. Facci sapere se riscontri nuovi problemi o hai idee per migliorare questa raccolta. Prima di segnalare un nuovo problema, dai un'occhiata ai problemi esistenti in questa raccolta. Puoi aggiungere il tuo voto a un problema esistente facendo clic sul pulsante a forma di stella.

Crea un nuovo problema

Per saperne di più, consulta la documentazione di Issue Tracker.

Health-Services-Client

Versione 1.1

Versione 1.1.0

23 settembre 2026

androidx.health:health-services-client:1.1.0, androidx.health:health-services-client-external-protobuf:1.1.0 e androidx.health:health-services-client-proto:1.1.0 sono stati rilasciati. La versione 1.1.0 contiene questi commit.

Modifiche importanti dalla versione 1.0.0:

Nuove funzionalità

• Obiettivi di rimbalzo: è stato aggiunto il supporto per gli obiettivi di rimbalzo, consentendo alle condizioni di richiedere una soglia sostenuta per una durata specificata prima dell'attivazione.
• Eventi di allenamento: è stato aggiunto un framework basato sugli eventi per le occorrenze discrete di allenamento, inclusa la classificazione dello swing di golf (GolfShotEvent).
• Dinamica di corsa: sono stati aggiunti tipi di dati e statistiche aggregate per lunghezza passo, tempo di contatto con il suolo, oscillazione verticale e rapporto verticale.
• Monitoraggio delle vasche di nuoto: è stato aggiunto il supporto per l'aggregazione del conteggio cumulativo delle vasche di nuoto (SWIMMING_LAP_COUNT_TOTAL).

Versione 1.1.0-rc02

6 maggio 2026

androidx.health:health-services-client:1.1.0-rc02, androidx.health:health-services-client-external-protobuf:1.1.0-rc02 e androidx.health:health-services-client-proto:1.1.0-rc02 sono stati rilasciati. La versione 1.1.0-rc02 contiene questi commit.

Aspetti importanti:

• Rilassa il requisito di lunghezza della piscina solo quando richiedi la distanza (2dc7a2e)

Versione 1.1.0-rc01

25 febbraio 2026

androidx.health:health-services-client:1.1.0-rc01, androidx.health:health-services-client-external-protobuf:1.1.0-rc01 e androidx.health:health-services-client-proto:1.1.0-rc01 sono stati rilasciati. La versione 1.1.0-rc01 non contiene modifiche rispetto alla versione beta precedente.

Versione 1.1.0-beta01

11 febbraio 2026

androidx.health:health-services-client:1.1.0-beta01, androidx.health:health-services-client-external-protobuf:1.1.0-beta01 e androidx.health:health-services-client-proto:1.1.0-beta01 sono stati rilasciati. La versione 1.1.0-beta01 non contiene modifiche rispetto alla versione alpha precedente.

Versione 1.1.0-alpha05

11 dicembre 2024

androidx.health:health-services-client:1.1.0-alpha05, androidx.health:health-services-client-external-protobuf:1.1.0-alpha05 e androidx.health:health-services-client-proto:1.1.0-alpha05 sono stati rilasciati. La versione 1.1.0-alpha05 contiene questi commit.

Nuove funzionalità

• Ora include regole proguard per evitare che le classi necessarie vengano rimosse. (65d0c3f)

Correzioni di bug

• Questa libreria ora utilizza le annotazioni di nullabilità JSpecify, che sono di tipo use. Gli sviluppatori Kotlin devono utilizzare il seguente argomento del compilatore per imporre l'utilizzo corretto: -Xjspecify-annotations=strict (questo è il valore predefinito a partire dalla versione 2.1.0 del compilatore Kotlin). (Iaf73a, b/326456246)

Versione 1.1.0-alpha04

16 ottobre 2024

androidx.health:health-services-client:1.1.0-alpha04, androidx.health:health-services-client-external-protobuf:1.1.0-alpha04 e androidx.health:health-services-client-proto:1.1.0-alpha04 sono stati rilasciati. La versione 1.1.0-alpha04 contiene questi commit.

Correzioni di sicurezza

• A partire da questa modifica, androidx viene compilato in base a protobuf 4.28.2 per risolvere il problema CVE-2024-7254. Esegui l'upgrade della dipendenza da androidx.health:health-services-client all'ultima versione 1.1.0-alpha04 per risolvere il rischio di vulnerabilità.

Versione 1.1.0-alpha02

13 dicembre 2023

androidx.health:health-services-client:1.1.0-alpha02 è stato rilasciato. La versione 1.1.0-alpha02 contiene questi commit.

Modifiche alle API

• Utilizza una singola fonte attendibile per i 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 è stato rilasciato. La versione 1.1.0-alpha01 contiene questi commit.

Nuove funzionalità

• Sono state aggiunte le API ExerciseEvent insieme al primo evento concreto: GolfShotEvent. Le primitive ExerciseEvent consentono agli sviluppatori di eseguire query per verificare il supporto e richiedere di ricevere una notifica quando l'orologio rileva un evento. GolfShotEvent, ad esempio, consente agli sviluppatori di ricevere una notifica quando l'utente tira una pallina da golf, oltre a ricevere il tipo di swing riconosciuto.

Modifiche alle API

• Consente ai client SDK WHS di utilizzare le funzionalità di GolfShotEvent. (I76b03)

Correzioni di bug

• Invece di generare in modo aggressivo eccezioni quando vengono rilevate funzionalità di eventi di allenamento sconosciute, filtrale dall'elenco. (I06afc)

Versione 1.0

Versione 1.0.0

7 maggio 2025

androidx.health:health-services-client:1.0.0 è stato rilasciato. La versione 1.0.0 contiene questi commit.

Funzionalità principali della versione 1.0.0

• Si tratta della promozione della versione 1.0.0-rc02 come release stabile di Health Services Client. Non sono state apportate modifiche rispetto alla versione 1.0.0-rc02.

Versione 1.1.0-alpha03

14 maggio 2024

androidx.health:health-services-client:1.1.0-alpha03 è stato rilasciato. La versione 1.1.0-alpha03 contiene questi commit.

Nuove funzionalità

• Sono state introdotte le API DebouncedGoal che consentono di monitorare un obiettivo per il tipo di dati campione o il tipo di dati campione delle statistiche durante l'allenamento con funzionalità di eliminazione dei rimbalzi(initialDelay e durationAtThreshold). (I09be9)
• È stato aggiunto il seguente esempio di metriche avanzate per la corsa e DataTypes statistiche. (I0b8b5):
  • Ground Contact Time
  • Vertical Oscillation
  • Vertical Ratio
  • Stride Length

Modifiche alle API

• ELEVATION_GAIN_DAILY aggiunto: DataType. (I059d1)
• Aggiunto SWIM_LAP_COUNT_TOTAL DataType come DataType aggregato per SWIM_LAP_COUNT. (I0beeb)

Correzioni di bug

• Sono stati risolti vari problemi per migliorare l'affidabilità della comunicazione interprocesso.

Versione 1.0.0-rc02

3 aprile 2024

androidx.health:health-services-client:1.0.0-rc02 è stato rilasciato. La versione 1.0.0-rc02 contiene questi commit. Questa release include solo correzioni di bug e non contiene modifiche alle API.

Correzioni di bug

• Sono stati risolti vari problemi per migliorare l'affidabilità dell'IPC
• È stato risolto un problema per cui la chiamata di startExercise contemporaneamente a prepareExercise poteva causare un ConcurrentModificationException (4e37773)
• Documentazione migliorata

Versione 1.0.0-rc01

26 luglio 2023

androidx.health:health-services-client:1.0.0-rc01 è stato rilasciato. La versione 1.0.0-rc01 contiene questi commit.

Nuove funzionalità

• Servizi per la salute è passato alla versione 1.0.0-rc01 dopo la stabilizzazione nella versione beta.

Modifiche alle API

• File API pubblici e sperimentali uniti per i percorsi da h a m. (Ic4630, b/278769092)
• N/A, le modifiche ai file API sono solo metodi di riordino. (I5fa95)

Versione 1.0.0-beta03

5 aprile 2023

androidx.health:health-services-client:1.0.0-beta03 è stato rilasciato. La versione 1.0.0-beta03 contiene questi commit.

Nuove funzionalità

Ora BatchingMode può essere configurato per fornire dati di allenamento batch all'intervallo configurato anziché a quello predefinito durante un allenamento attivo, all'inizio dell'allenamento tramite ExerciseConfig o durante con un metodo di override. Il supporto verrà abilitato da una release imminente di Servizi per la salute nel Google Play Store e può essere verificato tramite le funzionalità di allenamento. Nota: le modalità di batching hanno effetto quando il dispositivo è in uno stato di alimentazione non interattivo e causano un aumento del consumo energetico.

Modifiche alle API

• Generazione di HealthServicesException quando la funzione di sospensione overrideBatchingModesForActiveExercise non va a buon fine (Ifd387)
• Sono state introdotte funzioni di sospensione per l'API asincrona overrideBatchingModesForActiveExercise, rendendola più adatta a Kotlin (I7dd15).
• Gli override BatchingMode sono facoltativi in ExerciseConfig (Id22e9)

Correzioni di bug

• DataType e ExerciseUpdate piccole correzioni (5e185f)

Versione 1.0.0-beta02

11 gennaio 2023

androidx.health:health-services-client:1.0.0-beta02 è stato rilasciato. La versione 1.0.0-beta02 contiene questi commit.

Nuove funzionalità

• Sono state aggiunte funzioni di estensione suspend per le API asincrone esistenti ListenableFuture in ExerciseClient, PassiveMonitoringClient e MeasureClient per un migliore supporto di Kotlin. (Iadea4)
• È stata aggiunta l'API ExerciseTypeConfig, che consente gli aggiornamenti durante un allenamento in corso. È stato aggiunto GolfExerciseTypeConfig per supportare l'aggiornamento di ExerciseTypeConfig durante gli allenamenti di golf. (I4c539)

Modifiche alle API

• Genera HealthServicesException sulle funzioni di sospensione (I5e509)
• Aggiungi un altro costruttore per la compatibilità con le versioni precedenti (Iddeda)
• Genera RuntimeException per le funzioni di sospensione (I53bca)
• Rimuovi l'implementazione predefinita del lancio di eccezioni (Id947f)
• Aggiunta dell'annotazione @JvmDefaultWithCompatibility (I8f206)

Correzioni di bug

• Aggiunta al documento per chiarezza (Ide285)
• Consenti 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 è stato rilasciato. La versione 1.0.0-beta01 contiene questi commit.

Nuove funzionalità

• È stata aggiunta la possibilità di ascoltare gli eventi di salute tramite PassiveMonitoringClient con il primo evento: HealthEvent.FALL_DETECTED.

• New ExerciseTypes:

  • ALPINE_SKIING
  • BACKPACKING
  • CROSS_COUNTRY_SKIING
  • HORSE_RIDING
  • INLINE_SKATING
  • MOUNTAIN_BIKING
  • ORIENTEERING
  • ROLLER_SKATING
  • YACHTING

• New DataTypes:

  • ELEVATION_LOSS
  • GOLF_SHOT_COUNT

Modifiche alle API

• Aggiornamento della modellazione dei dati: il modello dei dati e il modo in cui vengono rappresentati gli DataType, i DataPoint e i relativi valori sottostanti sono stati completamente rivisti. L'impatto di primo livello è che le API sono ora molto più esplicite e sicure per i tipi.
• Le posizioni DataPoint non sono più rappresentate come DoubleArray, ma come un oggetto LocationData fortemente tipizzato.
• È stato eseguito il passaggio a un nuovo insieme di API di ascolto passive:
  • La trasmissione è stata sostituita da PassiveListenerService.
  • I listener esistenti sono stati sostituiti da un unico listener: PassiveListenerCallback.
• È stato aggiunto il tag <queries> al manifest di Servizi per la salute in modo che le applicazioni non debbano più specificarlo nel proprio manifest (a condizione che l'unione dei manifest sia attivata nel sistema di compilazione).
• Sono stati rimossi molti ExerciseState per indicare che l'esercizio sta terminando / è terminato e sono stati aggiunti nuovi stati di allenamento ENDING e ENDED. Ora questi stati vengono combinati con ExerciseEndReason per rappresentare l'intera gamma di stati precedenti.
• Abbiamo rinominato PassiveListenerConfig setPassiveGoals in setDailyGoals per riflettere meglio il fatto che supportiamo solo gli obiettivi passivi giornalieri.
• PassiveGoals now always REPEATED, passive TriggerFrequency removed.
• Annota tutti i parametri Long e Double con @FloatRange.
• È stata aggiunta la proprietà swimmingPoolLengthMeters a ExerciseConfig, che può essere specificata facoltativamente per migliorare i calcoli della distanza per le nuotate in piscina.
• ExerciseUpdate.activeDuration deprecato. Usa invece il descrittore ExerciseUpdate.activeDurationCheckpoint.
• È stata rinominata l'API flushExerciseAsync() in flushAsync() in ExerciseClient.
• Measure.registerCallback rinominato in Measure.registerMeasureCallback.
• Modifiche generali ai nomi:
  • Le proprietà di distanza ora hanno il suffisso meters.
  • I nomi dei metodi di callback sono ora al passato.
  • La maggior parte delle abbreviazioni è stata rimossa (HrAccuracy ora è HeartRateAccuracy).
  • Le proprietà che seguono il pattern enableFoo ora si chiamano isFooEnabled.
• Migrazione eseguita da Enums.
• Gli orari rappresentati da Double ora sono rappresentati da Duration.
• Le funzioni che restituiscono un ListenableFuture<Void?> ora restituiscono un ListenableFuture<Void>.
• Le funzioni che accettano un callback ora lo visualizzano sempre come ultimo parametro.
• Le classi con builder ora hanno sempre anche costruttori pubblici.
• Le funzioni di registrazione non restituiscono più un ListenableFuture e passano invece lo stato di registrazione al callback fornito.
• I KDoc sono stati migliorati.
• Le classi pubbliche non estendono più ProtoParcelable.

Correzioni di bug

• Miglioramenti generali all'affidabilità dell'IPC (I3b1e2)

Versione 1.0.0-alpha03

3 novembre 2021

androidx.health:health-services-client:1.0.0-alpha03 è stato rilasciato. La versione 1.0.0-alpha03 contiene questi commit.

Nuove funzionalità

• L'SDK registra nuovamente in automatico le richieste di registrazione di misurazione, listener di allenamento e callback di monitoraggio passivo nel caso in cui la connessione IPC venga interrotta con l'APK di Servizi per la salute.

Modifiche alle API

• minSdkVersion della libreria SDK è stato aumentato al livello API 30, poiché il client Servizi per la salute è attualmente supportato solo su Wear3.

Versione 1.0.0-alpha02

29 settembre 2021

androidx.health:health-services-client:1.0.0-alpha02 è stato rilasciato. La versione 1.0.0-alpha02 contiene questi commit.

Modifiche alle API

• ExerciseClient ora supporta la preparazione di un allenamento. Ciò consente ai clienti di riscaldare i sensori e attendere elementi come la correzione del GPS prima di iniziare l'allenamento.
• Introduce le classi AggregateDataPoint CumulativeDataPoints e StatisticalDataPoints per modellare meglio le metriche aggregate monitorate durante un allenamento attivo. CumulativeDataPoints contiene i valori cumulativi dei tipi di dati a intervalli aggregati (ad esempio la distanza totale durante l'allenamento), mentre StatisticalDataPoints modella gli aggregati dei punti dati campionati (ad esempio battito cardiaco minimo, massimo e medio). Sostituisce i precedenti AGGREGATE_* DataTypes ed è accessibile in ExerciseUpdate tramite getLatestAggregateMetrics(). AGGREGATE_* DataTypes non sono più supportati.
• Gli eventi PassiveMonitoring sono stati rinominati in PassiveGoals, che supporta l'impostazione di obiettivi e la ricezione di notifiche quando questi vengono raggiunti per tipi di dati come le metriche giornaliere (ad es. DAILY_STEPS).
• Miglioramento della modellazione della frequenza cardiaca e della precisione e disponibilità della posizione tramite l'introduzione delle nuove classi HrAccuracy, LocationAccuracy e LocationAvailability.
• Nomenclatura migliorata di ExerciseConfig e nuovi campi PassiveMonitoringConfig e introduzione di ExerciseConfig.shouldEnableGps per richiedere dati basati sul GPS

Correzioni di bug

• Esegue la migrazione al trasporto IPC basato su proto 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 è stato rilasciato. La versione 1.0.0-alpha01 contiene questi commit.

Funzionalità della versione iniziale

La libreria Servizi per la salute fornisce un insieme uniforme di API che consentono agli sviluppatori di integrarsi con le implementazioni dei sensori specifiche del dispositivo. Funzionerà immediatamente con gli emulatori Wear OS 3 e i dispositivi in arrivo, con il supporto di altre piattaforme in futuro. Questa release iniziale include tre superfici API di primo livello: ExerciseClient, PassiveMonitoringClient e MeasureClient.

ExerciseClient

ExerciseClient è pensata per le applicazioni che monitorano gli allenamenti attivi, con un massimo di 82 ExerciseType diversi, dalla camminata e dalla corsa al ballo e alla pallanuoto. Durante il monitoraggio di questi allenamenti, è disponibile una selezione di 50 diversi DataType a seconda del tipo di allenamento e dell'hardware disponibile sul dispositivo. Per iniziare, specifica le informazioni pertinenti nel tuo ExerciseConfig, chiama exerciseClient.startExercise e ascolta i progressi nell'ascoltatore di aggiornamenti.

PassiveMonitoringClient

PassiveMonitoringClient è un'ottima scelta se la tua applicazione monitora l'attività dell'utente durante la giornata. Puoi registrare un PendingIntent con un insieme di DataType e riattivare il dispositivo per gestire le modifiche batch. In alternativa, puoi specificare un Event, ad esempio raggiungere un determinato numero di passi.

MeasureClient

A volte l'utente deve misurare, ad esempio, la frequenza cardiaca in un determinato momento, non durante un allenamento e non nel corso della giornata. In questi casi, MeasureClient è la scelta perfetta.Ti basta registrare il callback con DataType supportati per ricevere un flusso di dati e annullare la registrazione del callback quando non è più necessario.

Client di Health Connect

Versione 1.0

Versione 1.0.0-alpha04

24 agosto 2022

A partire dalla versione 1.0.0-alpha04, androidx.health:health-connect-client è stato migrato a androidx.health.connect:connect-client. Per le versioni future, utilizza androidx.health.connect:connect-client e le note di rilascio associate nella nostra pagina Health Connect.

Per eseguire la migrazione, modifica l'importazione della dipendenza 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 è stato 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. Ora le app possono recuperare o scrivere record con l'unità di misura che preferiscono, ad esempio grammi o milligrammi per i nutrienti di NutritionRecord.

Modifiche alle API

• Correggi List<DataOrigin> in modo che sia Set<DataOrigin> in vari oggetti di risposta alla richiesta. (I42342)
• Correzione dell'unità delle calorie totali basali da Energia. (I0b429)
• Sono stati spostati i corsi di esempio della serie all'interno dei record della serie (Ica9bb):
  • CyclingPedalingCadence -> CyclingPedalingCadenceRecord.Sample
  • HeartRate -> HeartRateRecord.Sample
  • StepsCadence -> StepsCadenceRecord.Sample
• Ritiro della classe HealthDataRequestPermission a favore di PermissionController.createRequestPermissionActivityContract. In questo modo si promuove una migliore visibilità e una parametrizzazione unificata. (I81e7f)
• Aggiunta di once fluide statunitensi al volume. (I5f03d)
• Aggiunta del tipo di unità Velocità (I1d574)
• Aggiunto il tipo di unità Percentuale (I08f23)
• Aggiunta del tipo di unità di pressione (Ifb01f)
• Aggiunto il tipo di unità Massa (Ifd81a)
• Aggiunto il tipo di unità di volume (I59ad1)
• È stato aggiunto il tipo di unità di alimentazione. La classe di esempio della serie Power è stata spostata all'interno della classe PowerRecord. (I5b1e5)
• Aggiunto il tipo di unità Energia (I983ae)
• Aggiunto il tipo di unità di temperatura (I4cdb5)
• Rinomina i riferimenti ad Attività in modo che siano specifici per Allenamento, inclusi (I3f936):
  • Rinomina ActivityLap -> ExerciseLapRecord
  • Rinomina ActivityEvent -> ExerciseEventRecord
  • Rinomina Repetitions -> ExerciseRepetitionsRecord
  • Rinomina ActivitySession -> ExerciseSessionRecord
• I metadati del pacchetto sono stati spostati in un livello inferiore dei record. (Ie0835)
• Unità di lunghezza utilizzata in tutti i record rimanenti (Ib10dd):
  • ActivityLapRecord
  • ElevationGainedRecord
  • HeightRecord
  • HipCircumferenceRecord
  • WaistCircumferenceRecord
• Aggiunto il tipo di unità Lunghezza (Idae39)
• Aggiornamento della terminologia della descrizione 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

• Risolto il problema di Proguard quando la libreria è stata creata con la variante di release e minifyEnabled true. (I78933)
• Nasconde la documentazione non destinata all'uso pubblico. (I7a08f)
• Risolve il problema nei client che potrebbero avere 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 è stato rilasciato. La versione 1.0.0-alpha02 contiene questi commit.

Modifiche alle API

• Deprecati hasMetric e getMetric in AggregationResult, aggiunti gli operatori contiene e get (I7cc7c)
• Aggiunge OvulationTest.Result.HIGH e OvulationTest.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 è stato rilasciato. La versione 1.0.0-alpha01 contiene questi commit.

Nuove funzionalità

• API per la lettura dei dati su salute e attività fisica condivisi da altre app.
• API per scrivere dati di fitness e salute da condividere con altre app.
• API per recuperare le metriche aggregate per i record accessibili.
• API per recuperare le modifiche incrementali (inserimento, aggiornamento o eliminazione) dei record da parte di altre app.
• API per richiedere agli utenti le autorizzazioni sanitarie.
• API per verificare le autorizzazioni o revocare le autorizzazioni sanitarie concesse.