Connessione Salute

  
Consente agli sviluppatori di leggere o scrivere i dati relativi a salute e attività fisica dell'utente.
Ultimo aggiornamento Release stabile Candidato per la release Versione beta Versione alpha
15 gennaio 2025 - - - 1.1.0-alpha11

Richiesta di accesso ai tipi di dati

Per aiutarci a rafforzare la privacy e la sicurezza degli utenti, gli sviluppatori che eseguono l'integrazione con Connessione Salute devono dichiarare l'accesso in lettura e/o scrittura per i tipi di dati utilizzati dalle loro app. Gli sviluppatori devono includere casi d'uso validi per i tipi di dati che utilizzano in base alla finalità dell'app. Per ulteriori informazioni, consulta Fornire informazioni per il modulo di dichiarazione relativo alle app per la salute e Autorizzazioni di Connessione Salute di Android.

Dichiarazione delle dipendenze

Per aggiungere una dipendenza da health, devi aggiungere il repository Maven di Google al tuo progetto. Per ulteriori informazioni, consulta il repository Maven di Google.

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

Alla moda

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")
}

Per ulteriori informazioni sulle dipendenze, consulta Aggiungere dipendenze di compilazione.

Feedback

Il tuo feedback ci aiuta a migliorare Jetpack. Facci sapere se riscontri nuovi problemi o hai idee per migliorare questa raccolta. Prima di crearne uno nuovo, 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.

Creare un nuovo problema

Per ulteriori informazioni, consulta la documentazione del Monitoraggio problemi.

Test di Connessione Salute versione 1.0

Versione 1.0.0-alpha01

4 settembre 2024

androidx.health.connect:connect-testing:1.0.0-alpha01 viene rilasciato. La versione 1.0.0-alpha01 contiene questi commit.

Nuove funzionalità

La libreria Health Connect Testing semplifica la creazione di test automatici. Puoi utilizzare questa libreria per verificare il comportamento della tua applicazione e convalidare che risponda correttamente a casi insoliti, difficili da testare manualmente.

Puoi utilizzare la libreria per creare test delle unità locali, che in genere verificano il comportamento delle classi nella tua app che interagiscono con il client Health Connect.

Il punto di contatto della libreria è la classe FakeHealthConnectClient, che viene utilizzata nei test per sostituire HealthConnectClient. Offre le seguenti funzionalità:

  • Una rappresentazione in memoria dei record, in modo da poterli inserire, rimuovere, eliminare e leggere
  • Generazione di token di modifica e monitoraggio delle modifiche
  • Paginazione per record e modifiche
  • Le risposte di aggregazione sono supportate con gli stub
  • Consente a qualsiasi funzione di generare eccezioni
  • Un FakePermissionController che può essere utilizzato per emulare i controlli delle autorizzazioni

Modifiche all'API

  • Aggiungi FakeHealthConnectClient e8469
  • Aggiungi sostituzioni di stub per FakeHealthConnectClient e8469

Versione 1.1

Versione 1.1.0-alpha11

15 gennaio 2025

androidx.health.connect:connect-client:1.1.0-alpha11, androidx.health.connect:connect-client-external-protobuf:1.1.0-alpha11 e androidx.health.connect:connect-client-proto:1.1.0-alpha11 vengono rilasciati. La versione 1.1.0-alpha11 contiene questi commit.

Nuove funzionalità

  • Sono state aggiornate le autorizzazioni di lettura in background e della cronologia per supportare Android 13 e versioni precedenti.

Modifiche all'API

  • Sono stati aggiunti sovraccarichi con valori reificati in linea per HealthPermission.getReadPermission e HealthPermission.getWritePermission (I59a2e)

Correzioni di bug

  • Rimuovere i metodi di autorizzazione legacy (Ifd080)
  • Questa libreria ora utilizza le annotazioni di nullità JSpecify, che sono di tipo di utilizzo. Gli sviluppatori Kotlin devono utilizzare i seguenti argomenti del compilatore per applicare l'utilizzo corretto: -Xjspecify-annotations=strict, -Xtype-enhancement-improvements-strict-mode (Iaf73a, b/326456246)
  • È stata corretta la documentazione per HealthPermission.READ_HEALTH_DATA_HISTORY, in particolare è stato sottolineato che le letture senza questa autorizzazione non vanno a buon fine solo quando si tenta di leggere un singolo punto dati. (Id5b5a)

Versione 1.1.0-alpha10

16 ottobre 2024

androidx.health.connect:connect-client:1.1.0-alpha10, androidx.health.connect:connect-client-external-protobuf:1.1.0-alpha10 e androidx.health.connect:connect-client-proto:1.1.0-alpha10 vengono rilasciati. La versione 1.1.0-alpha10 contiene questi commit.

Nuove funzionalità

  • Sono stati aggiunti SkinTemperature tipi di aggregazione. (Ibe123)
  • Costante FEATURE_PLANNED_EXERCISE aggiunta (Ie02a3)
  • Sono state aggiunte le autorizzazioni Lettura della cronologia. (I5cf41)
  • È stata aggiunta l'API Training plans (If5be1)
  • È stata aggiunta l'API SkinTemperatureRecord. (I5605d)

Correzioni relative alla 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:connect:connect-client-proto e androidx.health:connect:connect-client-external-protobuf all'ultima versione 1.1.0-alpha10 per risolvere il rischio di vulnerabilità.

Versione 1.1.0-alpha09

18 settembre 2024

androidx.health.connect:connect-client:1.1.0-alpha09, androidx.health.connect:connect-client-external-protobuf:1.1.0-alpha09 e androidx.health.connect:connect-client-proto:1.1.0-alpha09 vengono rilasciati. La versione 1.1.0-alpha09 contiene questi commit.

Nuove funzionalità

  • Aggiungi l'autorizzazione di lettura in background, protetta dalla disponibilità della funzionalità. (I01036, I44db9)

Versione 1.1.0-alpha08

4 settembre 2024

androidx.health.connect:connect-client:1.1.0-alpha08, androidx.health.connect:connect-client-external-protobuf:1.1.0-alpha08 e androidx.health.connect:connect-client-proto:1.1.0-alpha08 vengono rilasciati. La versione 1.1.0-alpha08 contiene questi commit.

Modifiche all'API

  • Imposta il valore predefinito per la variabile features in HealthConnectClient. (I788dc)
  • Aggiungi un'API per controllare la disponibilità delle funzionalità. (Iedd43)

Correzioni di bug

  • Restituisce SDK_UNAVAILABLE in HealthConnectClient.getSdkStatus() quando HealthConnectManager è nullo in U+ 5802f
  • Aggiungi le sostituzioni toString a RecordClasses aa5dc
  • È stato rimosso il riepilogo manuale dell'accesso alle nuove API di piattaforma, poiché questo avviene automaticamente tramite la definizione del modello API quando si utilizza R8 con AGP 7.3 o versioni successive (ad es. R8 versione 3.3) e per tutte le build quando si utilizza AGP 8.1 o versioni successive (ad es. D8 versione 8.1). Agli utenti che non utilizzano AGP è consigliato di eseguire l'aggiornamento alla versione 8.1 o successive di D8. Consulta questo articolo per ulteriori dettagli. (If6b4c, b/345472586)

Versione 1.1.0-alpha07

10 gennaio 2024

androidx.health.connect:connect-client:1.1.0-alpha07 viene rilasciato. La versione 1.1.0-alpha07 contiene questi commit.

Modifiche all'API

  • Restituisce SDK_UNAVAILABLE quando #getSdkStatus viene chiamato da un contesto utente del profilo. (I91df3)
  • Rimuovi SleepStageRecord. (/If6ada)

Correzioni di bug

  • Lanciando RemoteException anziché IllegalStateException in caso di errori di associazione. (Id2233)

Versione 1.1.0-alpha06

18 ottobre 2023

androidx.health.connect:connect-client:1.1.0-alpha06 viene rilasciato. La versione 1.1.0-alpha06 contiene questi commit.

Modifiche all'API

  • Rendi pubbliche le definizioni recordingMethod. (I401fb)

Correzioni di bug

  • Aggiungi la documentazione al percorso dell'esercizio specificando che la stazione di ricarica deve trovarsi prima dell'ora di fine della sessione. (0e51e6)

Versione 1.1.0-alpha05

4 ottobre 2023

androidx.health.connect:connect-client:1.1.0-alpha05 viene rilasciato. La versione 1.1.0-alpha05 contiene questi commit.

Modifiche all'API

  • È stata aggiunta un'intent che consente di accedere alla schermata di gestione dei dati di Connessione Salute. (Ibf591)
  • Sono stati rimossi i metodi obsoleti in AggregationResult. (Idbda9)
  • È stata aggiunta un'API di praticità per la creazione di ReadRecordsRequest, nonché per l'eliminazione e la lettura dei record, con un tipo di record reificato. (If58a5)

Correzioni di bug

  • È stato corretto un bug in Android 14 per cui i campi nutrizionali null venivano restituiti come Double.MIN_VALUE. (1aa1d1)
  • È stato corretto un bug in Android 14 per cui l'aggregazione per periodo mensile/annuale generava un'eccezione nella risposta a causa di bucket con la stessa ora di inizio/fine. (281313)

Versione 1.1.0-alpha04

6 settembre 2023

androidx.health.connect:connect-client:1.1.0-alpha04 viene rilasciato. La versione 1.1.0-alpha04 contiene questi commit.

Modifiche all'API

Correzioni di bug

Versione 1.1.0-alpha03

26 luglio 2023

androidx.health.connect:connect-client:1.1.0-alpha03 viene rilasciato. La versione 1.1.0-alpha03 contiene questi commit.

Nuove funzionalità

  • API per la lettura e la scrittura dei percorsi degli esercizi:
    • Elemento ExerciseRouteResult aggiunto alla raccolta ExerciseSessionRecord
    • Opzione ExerciseRouteRequestContract aggiunta

Modifiche all'API

  • Sono stati aggiunti ExerciseRouteResult e le sue sottoclassi: Data, NoData e ConsentRequiredStates.
  • È stata aggiunta ExerciseRoute come classe autonoma, che contiene i dati sulla posizione del percorso. (I22eed)
  • PERMISSION_WRITE_EXERCISE_ROUTE aggiunto. (I92fc4)
  • ExerciseRouteRequestContract aggiunto, HealthPermissionsRequestContract aggiunto. (Ief0e5)

Correzioni di bug

  • Costruzione fissa di energia in kilojoule (Ie8791)

Versione 1.1.0-alpha02

21 giu 2023

androidx.health.connect:connect-client:1.1.0-alpha02 viene rilasciato. La versione 1.1.0-alpha02 contiene questi commit.

Correzioni di bug

  • È stato corretto un problema di perdita di HealthDataSdkService (Ia3ba5)
  • Reindirizza sempre al client HealthConnect corretto quando richiedi le autorizzazioni su Android U.(I6415a)

Versione 1.1.0-alpha01

7 giugno 2023

androidx.health.connect:connect-client:1.1.0-alpha01 viene rilasciato. Questa versione è sviluppata in un ramo interno.

Nuove funzionalità

  • Supporto per la versione del framework di Connessione Salute per Android 14. Questo SDK è un prerequisito per Android 14. Senza questo, le app non potranno integrarsi con Connessione Salute su Android 14.
  • È stato aggiunto il metodo di registrazione per registrare i metadati.

Modifiche all'API

  • Modifiche all'API Session:
    • Sono state aggiunte varie fasi del sonno in SleepSessionRecord e SleepStageRecord è stata rimossa.
    • ExerciseLap e ExerciseSegment sono stati aggiunti a ExerciseSessionRecord.
  • Limiti di frequenza periodici e giornalieri (inclusi i limiti di memoria), per le operazioni di lettura, log delle modifiche, inserimento ed eliminazione.
  • È stata aggiunta la convalida per tutti i campi NutritionRecord.
  • È stata aggiunta la convalida per HeartRateVariabilityRmssdRecord.
  • Sono state rimosse due API deprecate: HealthConnectClient#isProviderAvailable e HealthConnectClient#isApiSupported.

Correzioni di bug

  • Uguaglianza delle unità fissata per tutti i tipi di unità, l'uguaglianza non dipende più dal tipo utilizzato per l'inizializzazione dell'unità. Ad esempio, Mass.grams(1000) ora è uguale a Mass.kilograms(1).

Versione 1.0

Versione 1.0.0-alpha11

22 febbraio 2023

androidx.health.connect:connect-client:1.0.0-alpha11 viene rilasciato. La versione 1.0.0-alpha11 contiene questi commit.

Modifiche all'API

  • Aggiunta di un'intent da utilizzare per aprire Connessione Salute. (Ic8055)
  • Rimozione di alcuni tipi di allenamento. Utilizza EXERCISE_TYPE_STRENGTH_TRAINING, EXERCISE_TYPE_HIGH_INTENSITY_INTERVAL_TRAINING o EXERCISE_TYPE_CALISTHENICS al posto dei tipi rimossi. (I7291c)
  • Aggiunta della nuova API sdkStatus() che combina le due API ora obsolete isSdkSupported() e isProviderAvailable(). (Iac89d)
  • Modificare le API che accettano providerPackageName in modo che accettino una singola stringa anziché un elenco. (I67e0f)

Versione 1.0.0-alpha10

25 gennaio 2023

androidx.health.connect:connect-client:1.0.0-alpha10 viene rilasciato. La versione 1.0.0-alpha10 contiene questi commit.

Modifiche all'API

  • ExerciseEventRecord, ExerciseLapRecord,ExerciseRepititionRecord e SwimmingStrokesRecord non sono più supportati come RecordTypes. Non possono più essere scritti o letti da HealthConnect. Rimuovi qualsiasi riferimento a questi tipi di dati dall'integrazione di HealthConnect. (If7ca2)
  • Modifiche alle API di autorizzazione per accettare le autorizzazioni in un nuovo formato basato su stringhe. Questa modifica richiede anche la modifica della dichiarazione delle autorizzazioni nel formato standard delle autorizzazioni Android. (Ib0a2f)

Versione 1.0.0-alpha09

11 gennaio 2023

androidx.health.connect:connect-client:1.0.0-alpha09 viene rilasciato. La versione 1.0.0-alpha09 contiene questi commit.

Nuove funzionalità

  • Sono stati aggiunti due nuovi tipi di dati relativi alla salute delle donne per Connessione Salute: IntermenstrualBleedingRecord e MenstruationPeriodRecord. MenstruationFlow.ENUMs sono Leggero, Medio, Intenso e Sconosciuto.

Modifiche all'API

  • IntermenstrualBleedingRecord (Idc470) aggiunto
  • Tipo di record MenstruationPeriodRecord aggiunto (Iea545)

Versione 1.0.0-alpha08

7 dicembre 2022

androidx.health.connect:connect-client:1.0.0-alpha08 viene rilasciato. La versione 1.0.0-alpha08 contiene questi commit.

Modifiche all'API

  • Aggiunge BodyWaterMass e HeartRateVariabilityRmssdRecord come nuovi tipi di record supportati. (Ifd58f)
  • Rimuove HipCircumferenceRecord, WaistCircumferenceRecord come supportato da RecordTypes. (I62fb9)
  • Il valore di MenstruationFlowRecord.flow è cambiato da stringdef a intdefs. (I0369f)
  • I campi Record simili a enum con Strings sono stati modificati in Integers per migliorare le prestazioni. (I3b295)
  • I campi enumerati ExerciseSession, ExerciseRepetitions, SleepStage sono stati modificati da stringa a tipi interi. (Id32a9)
  • ExerciseSessionRecord.ACTIVE_TIME_TOTAL->EXERCISE_DURATION_TOTAL rinominato. (I5d7bd)
  • Aggiunge "Inusuale" agli enum CervicalMucus. Rinomina "Trasparenza" in "Albume" per maggiore specificità. Modifica di CervicalMucus#appearance e #sensation da StringDefs a IntDefs. (I3ac51)
  • L'enum StringDef di DeviceTypes è stato spostato in IntDefs in Dispositivo. (I3abf3)
  • Aggiunge HealthConnectClient.isApiSupported(), che restituisce false nelle versioni dell'SDK senza implementazioni compatibili. HealthConnectClient.isAvailable->isProviderAvailable rinominato. (I3674e)

Correzioni di bug

  • Non consentire valori di HeartRate beatsPerMinute inferiori a 1 (I6052f)
  • Aggiunta di un'annotazione @JvmDefaultWithCompatibility (I8f206)

Versione 1.0.0-alpha07

24 ottobre 2022

androidx.health.connect:connect-client:1.0.0-alpha07 viene rilasciato. La versione 1.0.0-alpha07 contiene questi commit.

Modifiche all'API

  • Gli argomenti record senza valori predefiniti vengono posizionati prima degli argomenti con valori predefiniti. Per coerenza, gli argomenti Instant e ZoneOffset vengono sempre posizionati all'inizio. (Id618c)
  • Rinomina HealthConnectClient.getOrCreate#packageNames in providerPackageNames. (Id81e4)

Correzioni di bug

  • Aggiunge le convalide dei valori dei campi Record. I valori estremamente errati generano IllegalArgumentExceptions quando il valore fornito non rientra in limiti ragionevoli. (Ie171d)
  • Convalida l'ora di inizio della registrazione prima dell'ora di fine, se pertinente. (I02460)

Versione 1.0.0-alpha06

5 ottobre 2022

androidx.health.connect:connect-client:1.0.0-alpha06 viene rilasciato. La versione 1.0.0-alpha06 contiene questi commit.

Correzioni di bug

  • Migliora il ciclo di vita della connessione del servizio. (If2bd5)
  • Risolto un bug di arresto anomalo NPE quando viene sollevata un'eccezione nella connessione al servizio. (I13546)

Versione 1.0.0-alpha05

21 settembre 2022

androidx.health.connect:connect-client:1.0.0-alpha05 viene rilasciato. La versione 1.0.0-alpha05 contiene questi commit.

Modifiche all'API

  • È stata rinominata Metadata.uid -> Metadata.id ed è stata utilizzata la terminologia recordId in modo coerente nelle API CRUD correlate. (I3d1d2)
  • PermissionController.createRequestPermissionActivityContract è diventato un metodo statico anziché un metodo di istanza. Rinominato in PermissionController.createRequestPermissionResultContract. (Icd2fe)
  • È stato aggiunto il tipo di unità BloodGlucose per BloodGlucoseRecord (I97678)
  • Rinomina MenstruationRecord in MenstruationFlowRecord. (I3b88e)

Correzioni di bug

  • Correzione di un comportamento imprevisto che non propaga le statistiche in primo piano dal processo del client. (Ifb44c)

Versione 1.0.0-alpha04

24 agosto 2022 androidx.health.connect:connect-client:1.0.0-alpha04 viene rilasciato. La versione 1.0.0-alpha04 contiene questi commit.

Migrazione ad "androidx.health.connect"

A partire dalla versione 1.0.0-alpha04, è stata eseguita la migrazione di androidx.health:health-connect-client a androidx.health.connect:connect-client. Per le versioni precedenti di Connessione Salute, visita la pagina androidx.health.

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.

Nuove funzionalità

  • Sono inclusi i log di debug facoltativi integrati per le chiamate API (link)

Modifiche all'API

  • I metadati clientId sono stati rinominati in clientRecordId e clientVersion in clientRecordVersion. (link)
  • È stato reso più facile per i lettori comprendere l'attributo Metadata uid, che non è più nullable. (link).
  • Sono state aggiunte le libbre all'unità di misura della massa (link)
  • DeletionChange.deleteUid rinominato in uid (link)
  • Rinomina autorizzazione -> HealthPermission. In questo modo si evitano ambiguità con le autorizzazioni del framework Android. (link).

Correzioni di bug

  • Sono stati corretti i problemi di regressione relativi all'unità di misura delle calorie errata con Energia (link)
  • È stato risolto un problema di regressione con l'aggregazione per alcuni tipi di record (link)