Salute

  
Crea applicazioni di integrità ad alte prestazioni in modo indipendente dalla piattaforma.
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.

Crea un nuovo problema

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 sia Set<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 di PermissionController.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
  • 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 e getMetric deprecate in AggregationResult, aggiunti gli operatori "contains" 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 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 primitive ExerciseEvent 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 sospensione overrideBatchingModesForActiveExercise 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 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 viene rilasciato. La versione 1.0.0-beta02 contiene questi commit.

Nuove funzionalità

  • Sono state aggiunte funzioni di estensione suspend per le API asincrone ListenableFuture esistenti in ExerciseClient, PassiveMonitoringClient e MeasureClient per migliorare il 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

  • 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 un DoubleArray, ma come un oggetto LocationData 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.
  • È 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 stati ENDING e ENDED. Ora questi parametri vengono combinati con ExerciseEndReason per rappresentare l'intera gamma di stati precedenti.
  • È stato cambiato il nome di PassiveListenerConfig setPassiveGoals in setDailyGoals per rispecchiare meglio che supportiamo solo gli obiettivi passivi giornalieri.
  • Gli elementi PassiveGoal ora sono sempre REPEATED, il valore passivo TriggerFrequency è stato rimosso.
  • Tutti i parametri Long e Double sono stati annotati con @FloatRange.
  • Proprietà swimmingPoolLengthMeters aggiunta a ExerciseConfig che può essere specificata facoltativamente per migliorare i calcoli della distanza per il nuoto in piscina.
  • Obsoleto ExerciseUpdate.activeDuration. Usa invece il criterio ExerciseUpdate.activeDurationCheckpoint.
  • L'API flushExerciseAsync() è stata rinominata in flushAsync() in ExerciseClient.
  • Measure.registerCallback ridenominato Measure.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 denominate isFooEnabled.
  • Migrazione eseguita da Enum.
  • Gli orari rappresentati da Double sono ora rappresentati da Duration.
  • Le funzioni che restituiscono ListenableFuture<Void?> ora restituiscono un ListenableFuture<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 tramite getLatestAggregateMetrics(). AGGREGATE_* I DataType non sono più supportati.
  • PassiveMonitoring Gli eventi sono stati rinominati in PassiveGoals 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 campi PassiveMonitoringConfig, nonché introduzione di ExerciseConfig.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.