Salute

  
Crea applicazioni per la salute performanti in modo indipendente dalla piattaforma.
Ultimo aggiornamento Release stabile Candidato per la release Release beta Release alpha
11 febbraio 2026 1.0.0 - 1.1.0-beta01 -

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:

Groovy

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

Kotlin

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

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.

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 è 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 Connessione Salute.

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 Potenza -> Energia. (I0b429)
  • Sono state spostate le classi di esempio delle serie all'interno dei record delle serie (Ica9bb):
    • CyclingPedalingCadence -> CyclingPedalingCadenceRecord.Sample
    • HeartRate -> HeartRateRecord.Sample
    • StepsCadence -> StepsCadenceRecord.Sample
  • Deprecate la classe HealthDataRequestPermission a favore di PermissionController.createRequestPermissionActivityContract. In questo modo si promuove una migliore rilevabilità 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à 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)
  • Aggiunta del tipo di unità Energia (I983ae)
  • Aggiunto il tipo di unità di misura della temperatura (I4cdb5)
  • Rinomina i riferimenti ad Attività in modo che siano specifici per Allenamento, tra cui (I3f936):
    • ActivityLap rinominato in ExerciseLapRecord
    • ActivityEvent rinominato in ExerciseEventRecord
    • Repetitions rinominato in ExerciseRepetitionsRecord
    • ActivitySession rinominato in ExerciseSessionRecord
  • I metadati del pacchetto sono stati spostati all'interno 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'utilizzo 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 ottieni (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 record di attività fisica e salute condivisi da altre app.
  • API per scrivere record di attività fisica 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 chiedere agli utenti le autorizzazioni sanitarie.
  • API per verificare le autorizzazioni o revocare le autorizzazioni sanitarie concesse.

Versione 1.1 del client di servizi sanitari

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 release 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 relative alla sicurezza

  • A partire da questa modifica, androidx viene compilato in base a protobuf 4.28.2 per risolvere CVE-2024-7254. Esegui l'upgrade della dipendenza da androidx.health:health-services-client alla versione 1.1.0-alpha04 più recente 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 un'unica 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 esegue un colpo di 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

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

Versione 1.0 del client di servizi sanitari

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)
  • Aggiunta di 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à dell'IPC.

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 contiene solo correzioni di bug e non modifiche all'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à

  • Health Services è 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 al file API consistono solo nel riordinamento dei metodi. (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 in batch all'intervallo configurato anziché a quello predefinito durante un allenamento attivo, all'inizio dell'allenamento tramite ExerciseConfig o durante l'allenamento con un metodo di override. Il supporto verrà attivato 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 riesce (Ifd387)
  • Sono state introdotte funzioni di sospensione per l'API asincrona overrideBatchingModesForActiveExercise, rendendola più adatta a Kotlin (I7dd15).
  • BatchingMode sostituzioni facoltative 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 sulle funzioni di sospensione (I53bca)
  • Rimuovi l'implementazione predefinita del lancio dell'eccezione (Id947f)
  • Aggiunta dell'annotazione @JvmDefaultWithCompatibility (I8f206)

Correzioni di bug

  • Aggiunta a kdoc 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. 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 di dati e il modo in cui vengono rappresentati DataType, 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 località 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.
    • Gli ascoltatori esistenti sono stati sostituiti da un unico ascoltatore: PassiveListenerCallback.
  • È stato aggiunto il tag <queries> al manifest di Health Services in modo che le applicazioni non debbano più specificarlo nel proprio manifest (a condizione che l'unione dei manifest sia attivata nel sistema di build).
  • Sono stati rimossi molti ExerciseState per indicare che l'esercizio sta per terminare / è terminato e sono stati aggiunti nuovi stati dell'esercizio 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.
  • PassiveGoal ora è sempre REPEATED, TriggerFrequency passivo rimosso.
  • 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. Utilizza invece ExerciseUpdate.activeDurationCheckpoint.
  • È stata rinominata l'API flushExerciseAsync() in flushAsync() in ExerciseClient.
  • Measure.registerCallback è stato 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.
  • KDocs è stato migliorato.
  • Le classi pubbliche non si estendono più a 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 modo 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 Health Services.

Modifiche alle API

  • La versione minSdkVersion della libreria SDK è stata aumentata al livello API 30, poiché il client Health Services è 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 esercizio. 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 al minuto minimo, massimo e medio). Sostituisce i precedenti AGGREGATE_* DataTypes ed è accessibile in ExerciseUpdate tramite getLatestAggregateMetrics(). I tipi di dati AGGREGATE_* non sono più supportati.
  • PassiveMonitoring Gli eventi 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 Health Services fornisce un insieme uniforme di API per consentire agli sviluppatori di integrarsi con implementazioni di sensori specifiche per il dispositivo. Funzionerà immediatamente con gli emulatori Wear OS 3 e i dispositivi in arrivo, con il supporto di piattaforme aggiuntive in futuro. In questa release iniziale sono incluse 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 nell'ExerciseConfig, chiama exerciseClient.startExercise e ascolta i progressi nell'aggiornamento.

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, il battito cardiaco in un determinato momento, non durante un allenamento e non durante la 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.