Health Connect

  
Umożliwia deweloperom odczytywanie i zapisywanie danych o zdrowiu i aktywności fizycznej użytkowników.
Najnowsza aktualizacja Wersja stabilna Kandydat do publikacji Wersja Beta Wersja alfa
10 stycznia 2024 r. - - - 1.1.0-alfa07

Prośby o dostęp do typów danych

Aby chronić prywatność i bezpieczeństwo użytkowników, deweloperzy integrujący się z Health Connect muszą poprosić o uprawnienia do odczytu lub zapisu typów danych, wypełniając ten formularz deklaracji dewelopera. W prośbie uwzględnij prawidłowe przypadki użycia związane z potrzebnymi typami danych w zależności od przeznaczenia aplikacji. Więcej informacji znajdziesz na stronach z najczęstszymi pytaniami na temat zasad Health Connect oraz uprawnieniami Health Connect by Android.

Deklarowanie zależności

Aby dodać zależność od stanu, musisz dodać do projektu repozytorium Google Maven. Więcej informacji znajdziesz w repozytorium Google Maven.

W pliku build.gradle aplikacji lub modułu dodaj zależności artefaktów, których potrzebujesz:

Odlotowy

dependencies {
    // Use to implement health connects
    implementation "androidx.health.connect:connect-client:1.1.0-alpha07"
}

Kotlin

dependencies {
    // Use to implement health connects
    implementation("androidx.health.connect:connect-client:1.1.0-alpha07")
}

Więcej informacji o zależnościach znajdziesz w artykule Dodawanie zależności kompilacji.

Opinia

Twoja opinia pomoże nam ulepszyć Jetpack. Daj nam znać, jeśli znajdziesz nowe wydania lub masz pomysły na ulepszenie tej biblioteki. Zanim utworzysz nową bibliotekę, przejrzyj problemy z tą biblioteką. Możesz oddać głos w ramach istniejącego problemu, klikając przycisk gwiazdki.

Utwórz nowy numer

Więcej informacji znajdziesz w dokumentacji narzędzia Issue Tracker.

Wersja 1.1

Wersja 1.1.0-alfa07

10 stycznia 2024 r.

Aplikacja androidx.health.connect:connect-client:1.1.0-alpha07 została zwolniona. Wersja 1.1.0-alpha07 zawiera te zatwierdzenia.

Zmiany w interfejsie API

  • Zwracaj wartość SDK_UNAVAILABLE, gdy funkcja #getSdkStatus jest wywoływana z kontekstu użytkownika profilu. (I91df3)
  • Usuń SleepStageRecord. (/If6ada)

Poprawki błędów

  • W przypadku błędów wiązania zgłaszaj zasadę RemoteException zamiast IllegalStateException. (Id2233)

Wersja 1.1.0-alfa06

18 października 2023 r.

Aplikacja androidx.health.connect:connect-client:1.1.0-alpha06 została zwolniona. Wersja 1.1.0-alpha06 zawiera te zatwierdzenia.

Zmiany w interfejsie API

  • Ustawia recordingMethod definicje jako publiczne. (I401fb)

Poprawki błędów

  • Dodaj dokumentację do trasy ćwiczenia określającą, gdzie powinna się znajdować przed zakończeniem sesji. (0e51e6)

Wersja 1.1.0-alfa05

4 października 2023 r.

Aplikacja androidx.health.connect:connect-client:1.1.0-alpha05 została zwolniona. Wersja 1.1.0-alpha05 zawiera te zatwierdzenia.

Zmiany w interfejsie API

  • Dodano intencję, która przekierowuje do ekranu zarządzania danymi w Health Connect. (Ibf591)
  • Usunięto wycofane metody w zadaniu AggregationResult. (Idbda9).
  • Dodano wygodny interfejs API do tworzenia ReadRecordsRequest, a także usuwania i odczytywania rekordów o odnowionym typie rekordu. (If58a5)

Poprawki błędów

  • Naprawiliśmy błąd w Androidzie 14, w wyniku którego puste pola odżywiania były zwracane jako Double.MIN_VALUE. (1aa1d1).
  • Naprawiliśmy błąd w Androidzie 14, w wyniku którego agregacja według okresu miesięcznego/rokowego generowała wyjątek w odpowiedzi z powodu tych samych zasobników czasu rozpoczęcia i zakończenia. (281313).

Wersja 1.1.0-alfa04

6 września 2023 r.

Aplikacja androidx.health.connect:connect-client:1.1.0-alpha04 została zwolniona. Wersja 1.1.0-alpha04 zawiera te zatwierdzenia.

Zmiany w interfejsie API

Poprawki błędów

Wersja 1.1.0-alfa03

26 lipca 2023 r.

Aplikacja androidx.health.connect:connect-client:1.1.0-alpha03 została zwolniona. Wersja 1.1.0-alpha03 zawiera te zatwierdzenia.

Nowe funkcje

  • Interfejs API do odczytu i zapisywania tras ćwiczeń:
    • Element ExerciseRouteResult został dodany do listy ExerciseSessionRecord
    • Dodano: ExerciseRouteRequestContract

Zmiany w interfejsie API

  • Dodano zajęcia ExerciseRouteResult i ich podklasy: Data, NoData i ConsentRequiredStates.
  • Dodano ExerciseRoute jako samodzielną klasę, która przechowuje dane o lokalizacji trasy. (I22eed)
  • Dodano PERMISSION_WRITE_EXERCISE_ROUTE. (I92fc4)
  • Dodano ExerciseRouteRequestContract i HealthPermissionsRequestContract. (Ief0e5)

Poprawki błędów

  • Stała konstrukcja energii w kilodżulach (Ie8791)

Wersja 1.1.0-alfa02

21 czerwca 2023 r.

Aplikacja androidx.health.connect:connect-client:1.1.0-alpha02 została zwolniona. Wersja 1.1.0-alpha02 zawiera te zatwierdzenia.

Poprawki błędów

  • Usunięto wyciek danych z HealthDataSdkService (Ia3ba5)
  • Gdy prosisz o uprawnienia na Androidzie U, zawsze przekierowuj do odpowiedniego klienta HealthConnect (I6415a)

Wersja 1.1.0-alfa01

7 czerwca 2023 r.

Aplikacja androidx.health.connect:connect-client:1.1.0-alpha01 została zwolniona. Ta wersja została opracowana w gałęzi wewnętrznej.

Nowe funkcje

  • Obsługa aplikacji Health Connect w ramach platformy Android 14. Ten pakiet SDK jest wymagany w przypadku Androida 14. Bez niej aplikacje nie będą mogły integrować się z Health Connect na Androidzie 14.
  • Dodano metodę nagrywania podczas rejestrowania metadanych.

Zmiany w interfejsie API

  • Zmiany interfejsu Session API:
    • Dodano różne fazy snu do: SleepSessionRecord i usunięto SleepStageRecord.
    • Dodano ExerciseLap i ExerciseSegment do ExerciseSessionRecord.
  • Okresowe i dzienne limity liczby żądań (w tym limity pamięci) operacji odczytu, historii zmian, wstawiania i usuwania.
  • Dodano weryfikację wszystkich pól (NutritionRecord).
  • Dodano weryfikację: HeartRateVariabilityRmssdRecord.
  • Usunięto 2 wycofane interfejsy API: HealthConnectClient#isProviderAvailable i HealthConnectClient#isApiSupported.

Poprawki błędów

  • Stała równość jednostek dla wszystkich typów jednostek. Równość nie zależy już od typu użytego do inicjowania jednostki. Na przykład wartość Mass.grams(1000) równa się mas.kg(1).

Wersja 1.0

Wersja 1.0.0-alfa11

22 lutego 2023 roku

Aplikacja androidx.health.connect:connect-client:1.0.0-alpha11 została zwolniona. Wersja 1.0.0-alpha11 zawiera te zatwierdzenia.

Zmiany w interfejsie API

  • Dodaję intencję, która ma być używana do otwierania Health Connect. (IC8055)
  • Usunięcie niektórych typów ćwiczeń. Zamiast usuniętych typów użyj EXERCISE_TYPE_STRENGTH_TRAINING, EXERCISE_TYPE_HIGH_INTENSITY_INTERVAL_TRAINING lub EXERCISE_TYPE_CALISTHENICS. (I7291c)
  • Dodano nowy interfejs API sdkStatus(), który łączy 2 wycofane już interfejsy API isSdkSupported() i isProviderAvailable(). (Iac89d)
  • Zmiana interfejsów API, które akceptują providerPackageName, tak aby akceptowały jeden ciąg zamiast listy. (I67e0f)

Wersja 1.0.0-alfa10

25 stycznia 2023 r.

Aplikacja androidx.health.connect:connect-client:1.0.0-alpha10 została zwolniona. Wersja 1.0.0-alpha10 zawiera te zatwierdzenia.

Zmiany w interfejsie API

  • Kolumny ExerciseEventRecord, ExerciseLapRecord,ExerciseRepititionRecord i SwimmingStrokesRecord nie są już obsługiwane jako RecordTypes. Nie można już ich zapisywać ani odczytywać w usłudze HealthConnect. Usuń wszelkie odwołania do tych typów danych z integracji z usługą HealthConnect. (If7ca2)
  • Zmiany w interfejsach API uprawnień dotyczące akceptowania uprawnień w nowym formacie opartym na ciągu znaków. Ta zmiana wymaga też zmiany deklaracji uprawnień na standardowy format uprawnień Androida. (Ib0a2f)

Wersja 1.0.0-alfa09

11 stycznia 2023 r.

Aplikacja androidx.health.connect:connect-client:1.0.0-alpha09 została zwolniona. Wersja 1.0.0-alpha09 zawiera te zatwierdzenia.

Nowe funkcje

  • Dodano 2 nowe typy danych dotyczących zdrowia kobiet w Health Connect: IntermenstrualBleedingRecord i MenstruationPeriodRecord. MenstruationFlow.ENUMs to lekkie, średnie, ciężkie i nieznane.

Zmiany w interfejsie API

  • Dodano IntermenstrualBleedingRecord (Idc470)
  • Dodano typ rekordu MenstruationPeriodRecord (Iea545)

Wersja 1.0.0-alfa08

7 grudnia 2022 r.

Aplikacja androidx.health.connect:connect-client:1.0.0-alpha08 została zwolniona. Wersja 1.0.0-alpha08 zawiera te zatwierdzenia.

Zmiany w interfejsie API

  • Dodaje BodyWaterMass i HeartRateVariabilityRmssdRecord jako nowe obsługiwane typy rekordów. (Ifd58f)
  • Usuwa wartości HipCircumferenceRecord i WaistCircumferenceRecord, które są obsługiwane przez: RecordTypes. (I62fb9)
  • Zmieniono MenstruationFlowRecord.flow z stringdef na intdefs. (I0369f)
  • Zmieniono pola rekordów podobne do enum z polami Strings na Integers, aby zwiększyć skuteczność. (I3b295)
  • Pola typu ExerciseSession, ExerciseRepetitions i SleepStage typu wyliczenia zostały zmienione z ciągów znaków na liczby całkowite. (Id32a9).
  • Zmieniono nazwę ExerciseSessionRecord.ACTIVE_TIME_TOTAL->EXERCISE_DURATION_TOTAL. (I5d7bd)
  • Dodaje typ „Nietypowy” do CervicalMucus wyliczeń. Aby zwiększyć precyzję, zmień nazwę „Wyczyść” na „Biały biel”. Zmieniono CervicalMucus#appearance i #sensation z StringDefs na IntDefs. (I3ac51).
  • StringDef z DeviceTypes wyliczenia zostały przeniesione do IntDefs w sekcji Urządzenie. (I3abf3)
  • Dodaje właściwość HealthConnectClient.isApiSupported(), która zwraca wartość „false” w przypadku wersji pakietu SDK bez zgodnych implementacji. Zmieniono nazwę HealthConnectClient.isAvailable->isProviderAvailable. (I3674e)

Poprawki błędów

  • Nie zezwalaj na wartości parametru HeartRate beatsPerMinute mniejsze niż 1 (I6052f)
  • Dodawanie adnotacji @JvmDefaultWithCompatibility (I8f206)

Wersja 1.0.0-alfa07

24 października 2022 r.

Aplikacja androidx.health.connect:connect-client:1.0.0-alpha07 została zwolniona. Wersja 1.0.0-alpha07 zawiera te zatwierdzenia.

Zmiany w interfejsie API

  • Argumenty rekordu bez wartości domyślnych są umieszczane przed argumentami z wartościami domyślnymi. Aby zachować spójność, argumenty Instant i ZoneOffset są zawsze umieszczane na samym początku. (Id618c)
  • Zmień nazwę społeczności HealthConnectClient.getOrCreate#packageNames na providerPackageNames. (Id81e4).

Poprawki błędów

  • Dodaje weryfikację wartości pola rekordu. Skrajnie błędne wartości powodują zwracanie wartości IllegalArgumentExceptions, gdy podana wartość wykracza poza rozsądne wartości. (IE171d)
  • W stosownych przypadkach sprawdza czas rozpoczęcia rekordu przed czasem zakończenia. (I02460)

Wersja 1.0.0-alfa06

5 października 2022 r.

Aplikacja androidx.health.connect:connect-client:1.0.0-alpha06 została zwolniona. Wersja 1.0.0-alpha06 zawiera te zatwierdzenia.

Poprawki błędów

  • Skraca cykl życia połączenia z usługą. (If2bd5)
  • Naprawa błędu występującego w przypadku zgłoszenia wyjątku w połączeniu usługi. (I13546)

Wersja 1.0.0-alfa05

21 września 2022 r.

Aplikacja androidx.health.connect:connect-client:1.0.0-alpha05 została zwolniona. Wersja 1.0.0-alpha05 zawiera te zatwierdzenia.

Zmiany w interfejsie API

  • Zmieniliśmy nazwę Metadata.uid -> Metadata.id i spójnie używano terminologii recordId w powiązanych interfejsach API CRUD. (I3d1d2)
  • Zamiast metody instancji metoda PermissionController.createRequestPermissionActivityContract została przekształcona w metodę statyczną. Nazwa została zmieniona na PermissionController.createRequestPermissionResultContract. (Icd2fe)
  • Dodano typ jednostki BloodGlucose dla: BloodGlucoseRecord (I97678)
  • Zmień nazwę MenstruationRecord -> MenstruationFlowRecord. (I3b88e)

Poprawki błędów

  • Napraw niezamierzone zachowanie, które nie rozpowszechnia statystyk na pierwszym planie z procesu klienta. (Ifb44c)

Wersja 1.0.0-alfa04

Opublikowano 24 sierpnia 2022 r. androidx.health.connect:connect-client:1.0.0-alpha04. Wersja 1.0.0-alpha04 zawiera te zatwierdzenia.

Migracja do „androidx.health.connect

Od 1.0.0 do alfa04: androidx.health:health-connect-client została przeniesiona do androidx.health.connect:connect-client. Poprzednie wersje Health Connect znajdziesz na stronie androidx.health.

Aby przeprowadzić migrację, po prostu zmień importowanie zależności z androidx.health:health-connect-client:1.0.0-alpha03 na androidx.health.connect:connect-client:1.0.0-alpha04.

Nowe funkcje

  • Dołączone są opcjonalne dzienniki debugowania wbudowane w przypadku wywołań interfejsu API (link).

Zmiany w interfejsie API

  • Nazwa metadanych clientId została zmieniona na clientRecordId, a clientVersion na clientRecordVersion. (link)
  • Zwiększyliśmy przydatność metadanych UID dla czytelników i nie można już używać wartości null. (link)
  • Dodano funty do jednostki masy (link)
  • Zmieniono nazwę DeletionChange.deleteUid na UID (link)
  • Zmień nazwę uprawnienia -> Zdrowie. Pozwala to uniknąć niejasności co do uprawnień Android Framework. (link)

Poprawki błędów

  • Naprawiono problemy z regresją dotyczącą nieprawidłowej jednostki kalorii z wykorzystaniem energii (link)
  • Naprawiony problem z regresją przy agregacji kilku typów rekordów (link)