ve geri yükleme

  
Geliştiricilerin kullanıcının sağlık ve fitness kayıtlarını okumasına veya yazmasına olanak tanır.
Son Güncelleme Kararlı Sürüm Sürüm Adayı Beta Sürümü Alfa Sürümü
15 Ocak 2025 - - - 1.1.0-alpha11

Veri türlerine erişim isteğinde bulunma

Kullanıcı gizliliğini ve güvenliğini güçlendirmemize yardımcı olmak için Health Connect ile entegrasyon yapan geliştiricilerin, uygulamalarının kullandığı veri türleri için okuma ve/veya yazma erişimini belirtmesi gerekir. Geliştiriciler, uygulamanın amacına göre kullandıkları veri türleri için geçerli kullanım alanları eklemelidir. Daha fazla bilgi için Sağlık uygulamaları beyan formu için bilgi sağlama ve Android'den Health Connect İzinleri sayfalarını ziyaret edin.

Bağımlılıkları bildirme

Sağlıkla ilgili bir bağımlılık eklemek için Google Maven deposunu projenize eklemeniz gerekir. Daha fazla bilgi için Google'ın Maven deposunu okuyun.

Uygulamanızın veya modülünüzün build.gradle dosyasına ihtiyacınız olan yapıların bağımlılıklarını ekleyin:

Eski

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

Bağımlılıklar hakkında daha fazla bilgi için Derleme bağımlılıkları ekleme başlıklı makaleyi inceleyin.

Geri bildirim

Geri bildiriminiz Jetpack'in iyileştirilmesine yardımcı olur. Yeni sorunlar keşfederseniz veya bu kitaplığı iyileştirmek için fikirleriniz varsa lütfen bize bildirin. Yeni bir kitaplık oluşturmadan önce lütfen bu kitaplıktaki mevcut sorunlara göz atın. Yıldız düğmesini tıklayarak mevcut bir soruna oy verebilirsiniz.

Yeni sorun oluşturma

Daha fazla bilgi için Sorun İzleyici belgelerine bakın.

Health Connect Testi Sürümü 1.0

Sürüm 1.0.0-alpha01

4 Eylül 2024

androidx.health.connect:connect-testing:1.0.0-alpha01 yayınlanır. 1.0.0-alpha01 sürümü bu taahhütleri içerir.

Yeni Özellikler

Health Connect Testing kitaplığı, otomatik testlerin oluşturulmasını kolaylaştırır. Uygulamanızın davranışını doğrulamak ve manuel olarak test edilmesi zor olan yaygın olmayan durumlara doğru şekilde yanıt verdiğini doğrulamak için bu kitaplığı kullanabilirsiniz.

Kitaplığı kullanarak yerel birim testleri oluşturabilirsiniz. Bu testler genellikle uygulamanızda Health Connect istemciyle etkileşime geçen sınıfların davranışını doğrular.

Kütüphanenin giriş noktası, HealthConnectClient sınıfını değiştirmek için testlerde kullandığınız FakeHealthConnectClient sınıfıdır. Aşağıdaki özelliklere sahiptir:

  • Kayıtları ekleyebilmeniz, kaldırabilmeniz, silebilmeniz ve okuyabilmeniz için kayıtların bellek içi temsili
  • Değişiklik jetonu oluşturma ve değişiklik izleme
  • Kayıtlar ve değişiklikler için sayfalara ayırma
  • Toplama yanıtları, taslaklarla desteklenir
  • Herhangi bir işlevin istisna atmasına izin verir
  • İzin kontrollerini taklit etmek için kullanılabilen bir FakePermissionController

API Değişiklikleri

  • FakeHealthConnectClient e8469 ekleyin
  • FakeHealthConnectClient e8469 için Stub geçersiz kılma ekleme

Sürüm 1.1

Sürüm 1.1.0-alpha11

15 Ocak 2025

androidx.health.connect:connect-client:1.1.0-alpha11, androidx.health.connect:connect-client-external-protobuf:1.1.0-alpha11 ve androidx.health.connect:connect-client-proto:1.1.0-alpha11 yayınlandı. 1.1.0-alpha11 sürümü bu taahhütleri içerir.

Yeni Özellikler

  • Arka plan ve geçmiş okuma izinleri, Android 13 ve önceki sürümleri desteklemek için güncellendi.

API Değişiklikleri

  • HealthPermission.getReadPermission ve HealthPermission.getWritePermission için satır içi yeniden oluşturulmuş aşırı yüklemeler eklendi (I59a2e)

Hata Düzeltmeleri

  • Eski izin yöntemlerini kaldırma (Ifd080)
  • Bu kitaplıkta artık tür kullanımı olan JSpecify nullness ek açıklamaları kullanılmaktadır. Kotlin geliştiricileri, doğru kullanımı zorunlu kılmak için aşağıdaki derleyici bağımsız değişkenlerini kullanmalıdır: -Xjspecify-annotations=strict, -Xtype-enhancement-improvements-strict-mode (Iaf73a, b/326456246)
  • HealthPermission.READ_HEALTH_DATA_HISTORY dokümanları düzeltildi. Özellikle, bu izin olmadan yapılan okuma işlemlerinin yalnızca tek bir veri noktası okunmaya çalışılırken başarısız olduğu belirtildi. (Id5b5a)

Sürüm 1.1.0-alpha10

16 Ekim 2024

androidx.health.connect:connect-client:1.1.0-alpha10, androidx.health.connect:connect-client-external-protobuf:1.1.0-alpha10 ve androidx.health.connect:connect-client-proto:1.1.0-alpha10 yayınlandı. 1.1.0-alpha10 sürümü bu taahhütleri içerir.

Yeni Özellikler

  • SkinTemperature toplama türleri eklendi. (Ibe123)
  • FEATURE_PLANNED_EXERCISE sabit değeri (Ie02a3) eklendi
  • Geçmişi Okuma izinleri eklendi. (I5cf41)
  • Eğitim planları API'si eklendi (If5be1)
  • SkinTemperatureRecord API'si eklendi. (I5605d)

Güvenlik Düzeltmeleri

  • Bu değişiklik itibarıyla androidx, CVE-2024-7254'ü gidermek için protobuf 4.28.2 ile derlenir. Güvenlik açığı riskini gidermek için androidx.health:connect:connect-client-proto ve androidx.health:connect:connect-client-external-protobuf bağımlılığınızı en son 1.1.0-alpha10 sürümüne yükseltin.

Sürüm 1.1.0-alpha09

18 Eylül 2024

androidx.health.connect:connect-client:1.1.0-alpha09, androidx.health.connect:connect-client-external-protobuf:1.1.0-alpha09 ve androidx.health.connect:connect-client-proto:1.1.0-alpha09 yayınlandı. 1.1.0-alpha09 sürümü bu taahhütleri içerir.

Yeni Özellikler

  • Özellik kullanılabilirliğiyle korunan arka planda okuma izni ekleyin. (I01036, I44db9)

Sürüm 1.1.0-alpha08

4 Eylül 2024

androidx.health.connect:connect-client:1.1.0-alpha08, androidx.health.connect:connect-client-external-protobuf:1.1.0-alpha08 ve androidx.health.connect:connect-client-proto:1.1.0-alpha08 yayınlandı. 1.1.0-alpha08 sürümü bu taahhütleri içerir.

API Değişiklikleri

  • HealthConnectClient dosyasında features değişkeni için varsayılan değeri ayarlayın. (I788dc)
  • Özellik kullanılabilirliğini kontrol etmek için bir API ekleyin. (Iedd43)

Hata Düzeltmeleri

  • U+ 5802f içinde HealthConnectManager boş olduğunda HealthConnectClient.getSdkStatus() içinde SDK_UNAVAILABLE döndürme
  • RecordClasses aa5dc alanına toString geçersiz kılma kuralı ekleme
  • Yeni platform API'lerine erişim, AGP 7.3 veya sonraki sürümlerle (ör. R8 3.3 sürümü) R8 kullanıldığında ve AGP 8.1 veya sonraki sürümlerle (ör. D8 8.1 sürümü) tüm derlemelerde API modelleme aracılığıyla otomatik olarak gerçekleştiğinden, yeni platform API'lerine erişimin manuel olarak ana hatlarıyla belirtilmesi kaldırıldı. AGP kullanmayan istemcilerin D8 8.1 veya sonraki bir sürüme güncellemeleri önerilir. Daha fazla bilgi için bu makaleye göz atın. (If6b4c, b/345472586)

Sürüm 1.1.0-alpha07

10 Ocak 2024

androidx.health.connect:connect-client:1.1.0-alpha07 yayınlanır. 1.1.0-alpha07 sürümü bu taahhütleri içerir.

API Değişiklikleri

  • #getSdkStatus, profil kullanıcı bağlamından çağrıldığında SDK_UNAVAILABLE döndürülür. (I91df3)
  • SleepStageRecord öğesini kaldırın. (/If6ada)

Hata Düzeltmeleri

  • Bağlantı hataları için IllegalStateException yerine RemoteException atma. (Id2233)

Sürüm 1.1.0-alpha06

18 Ekim 2023

androidx.health.connect:connect-client:1.1.0-alpha06 yayınlanır. 1.1.0-alpha06 sürümü bu taahhütleri içerir.

API Değişiklikleri

  • recordingMethod tanımlarını herkese açık hale getirir. (I401fb)

Hata Düzeltmeleri

  • Egzersiz rotasına, konumun seansın bitiş saatinden önce olması gerektiğini belirten dokümanlar ekleyin. (0e51e6)

Sürüm 1.1.0-alpha05

4 Ekim 2023

androidx.health.connect:connect-client:1.1.0-alpha05 yayınlanır. 1.1.0-alpha05 sürümü bu taahhütleri içerir.

API Değişiklikleri

  • Health Connect veri yönetimi ekranına yönlendiren intent eklendi. (Ibf591)
  • AggregationResult sürümünde desteği sonlandırılan yöntemler kaldırıldı. (Idbda9)
  • Yeniden oluşturulmuş bir kayıt türüyle ReadRecordsRequest oluşturmanın yanı sıra kayıtları silme ve okuma için kolaylık API'si eklendi. (If58a5)

Hata Düzeltmeleri

  • Android 14'te, boş beslenme alanlarının Double.MIN_VALUE olarak döndürülmesine neden olan bir hata düzeltildi. (1aa1d1)
  • Android 14'te, Aylık/Yıllık döneme göre toplama işleminin, aynı başlangıç/bitiş zamanına sahip gruplar nedeniyle yanıtta istisna atma sorunu düzeltildi. (281313)

Sürüm 1.1.0-alpha04

6 Eylül 2023

androidx.health.connect:connect-client:1.1.0-alpha04 yayınlanır. 1.1.0-alpha04 sürümü bu taahhütleri içerir.

API Değişiklikleri

Hata Düzeltmeleri

Sürüm 1.1.0-alpha03

26 Temmuz 2023

androidx.health.connect:connect-client:1.1.0-alpha03 yayınlanır. 1.1.0-alpha03 sürümü bu taahhütleri içerir.

Yeni Özellikler

  • Egzersiz rotalarını okumak ve yazmak için API:
    • ExerciseRouteResult varlığı ExerciseSessionRecord koleksiyonuna eklendi
    • ExerciseRouteRequestContract eklendi

API Değişiklikleri

  • ExerciseRouteResult ve alt sınıfları Data, NoData ve ConsentRequiredStates eklendi.
  • Rotanın konum verilerini içeren bağımsız bir sınıf olarak ExerciseRoute eklendi. (I22eed)
  • PERMISSION_WRITE_EXERCISE_ROUTE eklendi. (I92fc4)
  • ExerciseRouteRequestContract eklendi, HealthPermissionsRequestContract eklendi. (Ief0e5)

Hata Düzeltmeleri

  • Kilojoule cinsinden sabit enerji yapısı (Ie8791)

Sürüm 1.1.0-alpha02

21 Haziran 2023

androidx.health.connect:connect-client:1.1.0-alpha02 yayınlanır. 1.1.0-alpha02 sürümü bu taahhütleri içerir.

Hata Düzeltmeleri

  • HealthDataSdkService sızıntısı düzeltildi (Ia3ba5)
  • Android U'da izin isterken her zaman doğru HealthConnect istemciye yönlendirin.(I6415a)

Sürüm 1.1.0-alpha01

7 Haziran 2023

androidx.health.connect:connect-client:1.1.0-alpha01 yayınlanır. Bu sürüm, dahili bir dalda geliştirilmiştir.

Yeni Özellikler

  • Health Connect'in Android 14 çerçeve sürümü için destek. Bu SDK, Android 14 için ön koşuldur. Uygulamalar, bu olmadan Android 14'te Health Connect ile entegre edilemez.
  • Meta verileri kaydetmek için kayıt yöntemi eklendi.

API Değişiklikleri

  • Session API değişiklikleri:
    • SleepSessionRecord'e çeşitli uyku aşamaları eklendi ve SleepStageRecord kaldırıldı.
    • ExerciseLap ve ExerciseSegment, ExerciseSessionRecord'ye eklendi.
  • Okuma, günlük kaydı, ekleme ve silme işlemleri için dönemlik ve günlük ücret sınırları (bellek sınırları dahil).
  • Tüm NutritionRecord alanları için doğrulama eklendi.
  • HeartRateVariabilityRmssdRecord için doğrulama eklendi.
  • Desteği sonlandırılan iki API kaldırıldı: HealthConnectClient#isProviderAvailable ve HealthConnectClient#isApiSupported.

Hata Düzeltmeleri

  • Tüm birim türleri için sabit birim eşitliği. Eşitlik artık birim başlatma için kullanılan türe bağlı değildir. Örneğin, Mass.grams(1000) artık Mass.kilograms(1) ile aynıdır.

Sürüm 1.0

Sürüm 1.0.0-alpha11

22 Şubat 2023

androidx.health.connect:connect-client:1.0.0-alpha11 yayınlanır. 1.0.0-alpha11 sürümü bu taahhütleri içerir.

API Değişiklikleri

  • Health Connect'i açmak için kullanılacak bir intent ekleme. (Ic8055)
  • Bazı egzersiz türleri kaldırılıyor. Kaldırılan türlerin yerine EXERCISE_TYPE_STRENGTH_TRAINING, EXERCISE_TYPE_HIGH_INTENSITY_INTERVAL_TRAINING veya EXERCISE_TYPE_CALISTHENICS kullanın. (I7291c)
  • Artık desteği sonlandırılmış isSdkSupported() ve isProviderAvailable() API'lerini birleştiren yeni sdkStatus() API'si eklendi. (Iac89d)
  • providerPackageName kabul eden API'lerin, liste yerine tek bir dize kabul edecek şekilde değiştirilmesi. (I67e0f)

Sürüm 1.0.0-alpha10

25 Ocak 2023

androidx.health.connect:connect-client:1.0.0-alpha10 yayınlanır. 1.0.0-alpha10 sürümü bu taahhütleri içerir.

API Değişiklikleri

  • ExerciseEventRecord, ExerciseLapRecord,ExerciseRepititionRecord ve SwimmingStrokesRecord artık RecordTypes olarak desteklenmiyor. Artık HealthConnect'ten veri yazılamaz veya okunamaz. Bu veri türlerine yapılan tüm referansları HealthConnect entegrasyonundan kaldırın. (If7ca2)
  • İzinleri yeni bir dize tabanlı biçimde kabul etmek için izin API'lerinde yapılan değişiklikler. Bu değişiklik, izin beyanının standart Android izinleri biçimine de değiştirilmesini gerektirir. (Ib0a2f)

Sürüm 1.0.0-alpha09

11 Ocak 2023

androidx.health.connect:connect-client:1.0.0-alpha09 yayınlanır. 1.0.0-alpha09 sürümü bu taahhütleri içerir.

Yeni Özellikler

  • Health Connect için IntermenstrualBleedingRecord ve MenstruationPeriodRecord olmak üzere 2 yeni kadın sağlığı veri türü eklendi. MenstruationFlow.ENUMs Hafif, Orta, Ağır ve Bilinmiyor.

API Değişiklikleri

  • IntermenstrualBleedingRecord (Idc470) eklendi
  • MenstruationPeriodRecord kayıt türü (Iea545) eklendi

Sürüm 1.0.0-alpha08

7 Aralık 2022

androidx.health.connect:connect-client:1.0.0-alpha08 yayınlanır. 1.0.0-alpha08 sürümü bu taahhütleri içerir.

API Değişiklikleri

  • Yeni desteklenen kayıt türleri olarak BodyWaterMass, HeartRateVariabilityRmssdRecord eklendi. (Ifd58f)
  • HipCircumferenceRecord, WaistCircumferenceRecord desteklenen RecordTypes olarak kaldırılır. (I62fb9)
  • stringdef olan MenstruationFlowRecord.flow, intdefs olarak değiştirildi. (I0369f)
  • Daha iyi performans için Strings ile başlayan enum benzeri kayıt alanları Integers ile değiştirildi. (I3b295)
  • ExerciseSession, ExerciseRepetitions, SleepStage liste benzeri alanlar dize türünden tam sayı türlerine değiştirildi. (Id32a9)
  • ExerciseSessionRecord.ACTIVE_TIME_TOTAL->EXERCISE_DURATION_TOTAL olarak yeniden adlandırıldı. (I5d7bd)
  • CervicalMucus enum'lerine "Unusual" (Olağandışı) değerini ekler. Daha net bir adlandırma için "Şeffaf"ı "Beyaz" olarak yeniden adlandırın. CervicalMucus#appearance ve #sensation, StringDefs yerine IntDefs olarak değiştirildi. (I3ac51)
  • DeviceTypes enum'deki StringDef artık Cihaz altındaki IntDefs alanına taşındı. (I3abf3)
  • Uyumlu uygulama içermeyen SDK sürümlerinde yanlış değerini döndüren HealthConnectClient.isApiSupported() değerini ekler. HealthConnectClient.isAvailable->isProviderAvailable olarak yeniden adlandırıldı. (I3674e)

Hata Düzeltmeleri

  • 1'den küçük HeartRate beatsPerMinute değerlerine izin vermeyin (I6052f)
  • @JvmDefaultWithCompatibility ek açıklaması (I8f206) ekleniyor

Sürüm 1.0.0-alpha07

24 Ekim 2022

androidx.health.connect:connect-client:1.0.0-alpha07 yayınlanır. 1.0.0-alpha07 sürümü bu taahhütleri içerir.

API Değişiklikleri

  • Varsayılan değeri olmayan kayıt bağımsız değişkenleri, varsayılan değeri olan bağımsız değişkenlerden önce yerleştirilir. Tutarlılık için Instant ve ZoneOffset bağımsız değişkenleri her zaman en başa yerleştirilir. (Id618c)
  • HealthConnectClient.getOrCreate#packageNames'ü providerPackageNames olarak yeniden adlandırın. (Id81e4)

Hata Düzeltmeleri

  • Kayıt alanı değer doğrulamaları ekler. Sağlanan değer makul sınırların dışında olduğunda son derece yanlış değerler IllegalArgumentExceptions hatası oluşturur. (Ie171d)
  • Uygun olduğu durumlarda, kaydın başlangıç zamanını bitiş zamanından önce doğrular. (I02460)

Sürüm 1.0.0-alpha06

5 Ekim 2022

androidx.health.connect:connect-client:1.0.0-alpha06 yayınlanır. 1.0.0-alpha06 sürümü bu taahhütleri içerir.

Hata Düzeltmeleri

  • Hizmet bağlantısı yaşam döngüsünü iyileştirir. (If2bd5)
  • Hizmet bağlantısında istisna oluştuğunda NPE kilitlenme hatası düzeltildi. (I13546)

Sürüm 1.0.0-alpha05

21 Eylül 2022

androidx.health.connect:connect-client:1.0.0-alpha05 yayınlanır. 1.0.0-alpha05 sürümü bu taahhütleri içerir.

API Değişiklikleri

  • Metadata.uid -> Metadata.id olarak yeniden adlandırıldı ve ilgili CRUD API'lerinde tutarlı bir şekilde recordId terminolojisi kullanıldı. (I3d1d2)
  • PermissionController.createRequestPermissionActivityContract, örnek yöntemi yerine statik bir yöntem haline getirildi. Adı PermissionController.createRequestPermissionResultContract olarak değiştirildi. (Icd2fe)
  • BloodGlucoseRecord için BloodGlucose birim türü eklendi (I97678)
  • MenstruationRecord -> MenstruationFlowRecord olarak yeniden adlandırın. (I3b88e)

Hata Düzeltmeleri

  • İstemci işleminden ön plan istatistiklerinin yayılmaması nedeniyle oluşan istenmeyen davranışı düzeltme. (Ifb44c)

Sürüm 1.0.0-alpha04

24 Ağustos 2022 androidx.health.connect:connect-client:1.0.0-alpha04 yayınlandı. 1.0.0-alpha04 sürümü bu taahhütleri içerir.

"androidx.health.connect"e taşıma

1.0.0-alpha04 sürümünden itibaren androidx.health:health-connect-client, androidx.health.connect:connect-client alanına taşındı. Health Connect'in önceki sürümleri için lütfen androidx.health sayfasını ziyaret edin.

Taşımak için bağımlılık içe aktarmanızı androidx.health:health-connect-client:1.0.0-alpha03 yerine androidx.health.connect:connect-client:1.0.0-alpha04 olarak değiştirmeniz yeterlidir.

Yeni Özellikler

  • API çağrıları için yerleşik isteğe bağlı hata ayıklama günlükleri dahildir (bağlantı)

API Değişiklikleri

  • Meta veri clientId, clientRecordId olarak, clientVersion ise clientRecordVersion olarak yeniden adlandırıldı. (bağlantı)
  • Meta veri kimliği, okuyucular için daha kullanışlı hale getirildi ve artık boş değer kabul etmiyor. (bağlantı)
  • Kütle birimine pound eklendi (bağlantı)
  • DeletionChange.deleteUid, uid olarak yeniden adlandırıldı (bağlantı)
  • İzni yeniden adlandırın: HealthPermission. Bu sayede Android Framework izinleriyle ilgili belirsizlikler önlenir. (bağlantı)

Hata Düzeltmeleri

  • Enerji ile ilgili yanlış kalori birimi ile ilgili geriye dönük sorunlar düzeltildi (bağlantı)
  • Birkaç kayıt türü için toplama işlemiyle ilgili gerileme sorunu düzeltildi (bağlantı)