Sağlık

Bağımlılıkları bildirme

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

Uygulamanız veya modülünüz için build.gradle dosyasına ihtiyaç duyduğunuz yapıların bağımlılıklarını ekleyin:

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

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

Geri bildirim

Geri bildirimleriniz Jetpack'i iyileştirmemize yardımcı olur. Yeni sorunlar görürseniz veya bu kitaplığı geliştirme fikirleriniz varsa bize bildirin. Yeni sorun oluşturmadan önce lütfen bu kitaplıktaki mevcut sorunlara göz atın. Yıldız düğmesini tıklayarak mevcut bir soruna oyunuzu ekleyebilirsiniz.

Yeni sayı oluşturma

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

Health Connect İstemcisi Sürüm 1.0

Sürüm 1.0.0-alpha04

24 Ağustos 2022

1.0.0-alpha04 sürümünden itibaren androidx.health:health-connect-client, androidx.health.connect:connect-client sürümüne taşındı. Gelecekteki sürümler için lütfen Health Connect sayfamızda androidx.health.connect:connect-client ve ilişkili sürüm notlarını kullanın.

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

Sürüm 1.0.0-alpha03

27 Temmuz 2022

androidx.health:health-connect-client:1.0.0-alpha03 serbest bırakıldı. 1.0.0-alpha03 sürümü bu kayıtları içerir.

Yeni Özellikler

• Yeni API değişikliklerinin özeti: Okuma, yazma ve toplama API'lerine bir dizi birim eklendi. Uygulamalar artık NutritionRecord besin maddeleri için gram veya miligram gibi tercih ettikleri birimlerle kayıt alabilir veya yazabilir.

API Değişiklikleri

• Çeşitli istek yanıt nesnelerinde List<DataOrigin> Set<DataOrigin> olacak şekilde düzeltildi. (I42342)
• Güç->Enerji bölümündeki bazal toplam kalori birimini düzeltin. (I0b429)
• Seri kayıtları için seri örnek sınıfları taşındı (Ica9bb):
  • CyclingPedalingCadence -> CyclingPedalingCadenceRecord.Sample
  • HeartRate -> HeartRateRecord.Sample
  • StepsCadence -> StepsCadenceRecord.Sample
• HealthDataRequestPermission sınıfını kullanımdan kaldırıp PermissionController.createRequestPermissionActivityContract sınıfını kullanın. Bu sayede, daha kolay bulunabilir ve birleştirilmiş parametre kullanımını artırabilirsiniz. (I81e7f)
• Hacme ABD sıvı ons eklendi. (I5f03d)
• Eklenen Hız birimi türü (I1d574)
• Yüzde birim türü eklendi (I08f23)
• Eklenen Basınç birimi türü (Ifb01f)
• Eklenen kitle birimi türü (Ifd81a)
• Eklenen birim türü (I59ad1)
• Güç birimi türü eklendi. Güç serisi örnek sınıfı PowerRecord sınıfın içine taşındı. (I5b1e5)
• İlave Enerji birimi türü (I983ae)
• İlave Sıcaklık birim türü (I4cdb5)
• Etkinlik referanslarını Egzersiz'e özel olacak şekilde yeniden adlandırın (I3f936):
  • ActivityLap yeniden adlandırıldı -> ExerciseLapRecord
  • ActivityEvent yeniden adlandırıldı -> ExerciseEventRecord
  • Repetitions yeniden adlandırıldı -> ExerciseRepetitionsRecord
  • ActivitySession yeniden adlandırıldı -> ExerciseSessionRecord
• Kayıtlar altında iç içe yerleştirilmiş paket meta verileri taşındı. (Ie0835)
• Kalan tüm kayıtlarda kullanılan Uzunluk birimi (Ib10dd):
  • ActivityLapRecord
  • ElevationGainedRecord
  • HeightRecord
  • HipCircumferenceRecord
  • WaistCircumferenceRecord
• Uzunluk birim türü eklendi (Idae39)
• CervicalMucus açıklama terminolojisini güncelleyin (I25a2b):
  • CervicalMucus.Amount -> CervicalMucusRecord.Texture
  • CervicalMucus.Appearance -> CervicalMucusRecord.Sensation
• Tüm kayıt sınıfı adlarına "Kayıt" son eki eklendi (I1ffc2)

Hata Düzeltmeleri

• Lib, sürüm aromasıyla ve minifyEnabled true ile oluşturulduğunda ProGuard sorunlarını düzeltin. (I78933)
• Genel kullanıma yönelik olmayan dokümanları gizler. (I7a08f)
• Kendi protobuf bağımlılıkları olan istemcilerde sorunu düzeltir.(https://android-review.googlesource.com/c/platform/frameworks/support/+/2105430)

Sürüm 1.0.0-alpha02

1 Haziran 2022

androidx.health:health-connect-client:1.0.0-alpha02 serbest bırakıldı. 1.0.0-alpha02 sürümü bu kayıtları içerir.

API Değişiklikleri

• AggregationResult içinde kullanımdan kaldırılan hasMetric ve getMetric, eklenen içerir ve alma operatörleri (I7cc7c)
• OvulationTest.Result.HIGH ve OvulationTest.Result.INCONCLUSIVE ekler. (I9f9c4)

Hata Düzeltmeleri

• SDK şartlarını 26'ya indirin. (I6d201)

Sürüm 1.0.0-alpha01

11 Mayıs 2022

androidx.health:health-connect-client:1.0.0-alpha01 serbest bırakıldı. 1.0.0-alpha01 sürümü bu kayıtları içerir.

Yeni Özellikler

• Diğer uygulamalar tarafından paylaşılan fitness ve sağlık kayıtlarını okumaya yönelik API.
• Diğer uygulamalarla paylaşmak üzere fitness ve sağlık kayıtlarını yazma API'si.
• Erişilebilir kayıtlar için toplu metrikleri alma API'si.
• Diğer uygulamalar tarafından kayıtların artımlı değişikliklerini (ekleme, güncelleme veya silme) alan API'si.
• Kullanıcılardan sağlık izinleri isteyecek API.
• İzinleri kontrol etmeye veya verilen durum izinlerini iptal etmeye yarayan API.

Sağlık Hizmetleri İstemci Sürümü 1.1

Sürüm 1.1.0-alpha01

9 Ağustos 2023

androidx.health:health-services-client:1.1.0-alpha01 serbest bırakıldı. 1.1.0-alpha01 sürümü bu kayıtları içerir.

Yeni Özellikler

• İlk somut etkinliğin yanı sıra ExerciseEvent API eklendi: GolfShotEvent. ExerciseEvent temel öğeleri, geliştiricilerin destek almak için destek sorgulamalarına ve saat bir durum algıladığında bildirim alma isteğinde bulunmalarına olanak tanır. Örneğin, GolfShotEvent örneğinde olduğu gibi geliştiriciler, kullanıcı golf atışı yaptığında bildirim almanın yanı sıra salıncak türünü alabiliyor.

API Değişiklikleri

• WHS SDK istemcilerinin GolfShotEvent işlevlerini kullanmasına izin verin. (I76b03)

Hata Düzeltmeleri

• Bilinmeyen egzersiz etkinliği özelliklerini görmek için agresif şekilde istisnalar göndermek yerine bunları listeden filtreleyin. (I06afc)

Sağlık Hizmetleri İstemci Sürümü 1.0

Sürüm 1.0.0-rc01

26 Temmuz 2023

androidx.health:health-services-client:1.0.0-rc01 serbest bırakıldı. 1.0.0-rc01 sürümü bu kayıtları içerir.

Yeni Özellikler

• Sağlık Hizmetleri, beta sürümünde dengelendikten sonra 1.0.0-rc01 sürümüne taşındı.

API Değişiklikleri

• Mobil yollar için herkese açık ve deneysel API dosyaları birleştirildi. (Ic4630, b/278769092)
• Yok. API dosyası değişiklikleri yalnızca yeniden sıralama yöntemlerinden oluşuyor. (I5fa95)

Sürüm 1.0.0-beta03

5 Nisan 2023

androidx.health:health-services-client:1.0.0-beta03 serbest bırakıldı. 1.0.0-beta03 sürümü bu kayıtları içerir.

Yeni Özellikler

BatchingMode artık aktif bir egzersiz sırasında varsayılan yerine yapılandırılmış aralıkta toplu egzersiz verileri sunacak şekilde yapılandırılabilir. Bu ayar, ExerciseConfig aracılığıyla egzersizin başlangıcında veya bir geçersiz kılma yöntemi kullanılarak yapılır. Bu konuyla ilgili destek, Google Play Store'da yayınlanacak olan Sağlık Hizmetleri sürümüyle sunulacak ve egzersiz özellikleriyle kontrol edilebilecek. Not: Toplu işlem modları cihaz etkileşimli olmayan güç durumundayken geçerli olur ve güç tüketiminin artmasına neden olur.

API Değişiklikleri

• Askıya alma işlevi overrideBatchingModesForActiveExercise başarısız olduğunda HealthServicesException mesajı gönderilir (Ifd387)
• Eş zamansız overrideBatchingModesForActiveExercise API'si için askıya alma işlevleri kullanıma sunularak kotlin dostu olma (I7dd15)
• BatchingMode, ExerciseConfig içinde isteğe bağlı ayarları geçersiz kılar (Id22e9)

Hata Düzeltmeleri

• DataType ve ExerciseUpdate küçük düzeltme (5e185f)

Sürüm 1.0.0-beta02

11 Ocak 2023

androidx.health:health-services-client:1.0.0-beta02 serbest bırakıldı. 1.0.0-beta02 sürümü bu kayıtları içerir.

Yeni Özellikler

• Daha iyi Kotlin desteği için ExerciseClient, PassiveMonitoringClient ve MeasureClient dillerindeki mevcut eşzamansız ListenableFuture API'lerine suspend uzantı işlevleri eklendi. (Iadea4)
• Devam eden bir egzersiz sırasında güncellemeleri mümkün kılan ExerciseTypeConfig API'si eklendi. Golf egzersizleri sırasında ExerciseTypeConfig güncellemesini desteklemek için GolfExerciseTypeConfig eklendi. (I4c539)

API Değişiklikleri

• Askıya alma işlevlerinde HealthServicesException kullan (I5e509)
• Geriye dönük uyumluluk için başka bir oluşturucu ekleme (Iddeda)
• Askıya alma işlevlerinde RuntimeException kullan (I53bca)
• İstisna vermenin varsayılan uygulamasını (Id947f) kaldırın
• @JvmDefaultWithCompatibility notu ekleniyor (I8f206)

Hata Düzeltmeleri

• Daha anlaşılır olması için kdoc'a ekleyin (Ide285)
• Hedefler için pasif izleme izlemeye yalnızca aynı veri türleri de izleniyorsa izin verin (Ibed8d)

Sürüm 1.0.0-beta01

24 Ekim 2022

androidx.health:health-services-client:1.0.0-beta01 serbest bırakıldı. 1.0.0-beta01 sürümü bu kayıtları içerir.

Yeni Özellikler

• PassiveMonitoringClient aracılığıyla sağlık etkinliklerini dinleme özelliği eklendi. İlk etkinlik: HealthEvent.FALL_DETECTED.

• Yeni Egzersiz Türleri:

  • ALPINE_SKIING
  • BACKPACKING
  • CROSS_COUNTRY_SKIING
  • HORSE_RIDING
  • INLINE_SKATING
  • MOUNTAIN_BIKING
  • ORIENTEERING
  • ROLLER_SKATING
  • YACHTING

• Yeni Veri Türleri:

  • ELEVATION_LOSS
  • GOLF_SHOT_COUNT

API Değişiklikleri

• Verilerin modellenme şekli güncellendi: Veri modeli ve DataType, DataPoint ve temel değerlerinin gösterilme şekli düzenlendi. Bu durumun en üst düzey etkisi, API'lerin artık çok daha açık ve yazma açısından güvenli olmasıdır.
• Konum DataPoint'leri artık DoubleArray olarak değil, güçlü türde bir LocationData nesnesi olarak temsil ediliyor.
• Yeni bir pasif işleyici API'leri grubuna taşındı:
  • Yayının yerini PassiveListenerService aldı.
  • Mevcut işleyiciler tek bir işleyiciyle değiştirildi: PassiveListenerCallback.
• Uygulamaların bunu kendi manifestlerinde belirtmesine gerek kalmaması için Sağlık Hizmetleri manifestine <queries> etiketi eklendi (derleme sistemlerinde manifest birleştirme özelliğinin etkinleştirilmiş olması sağlanır).
• Egzersizin sona erdiğini / sona erdiğini göstermek için birçok ExerciseState konumundan uzaklaştırıldı ve yeni egzersiz durumları ENDING ve ENDED eklendi. Bunlar artık önceki eyaletlerin tam gamını temsil etmek için ExerciseEndReason ile birleştiriliyor.
• PassiveListenerConfig setPassiveGoals, yalnızca günlük pasif hedefleri desteklediğimizi daha iyi yansıtmak için setDailyGoals olarak yeniden adlandırıldı.
• PassiveGoal artık her zaman REPEATED, pasif TriggerFrequency kaldırıldı.
• Tüm Long ve Double parametreleri @FloatRange ile açıklandı.
• ExerciseConfig öğesine swimmingPoolLengthMeters özelliği eklendi. Bu özellik, havuzda yüzme için mesafe hesaplamalarını iyileştirmek amacıyla isteğe bağlı olarak belirtilebilir.
• ExerciseUpdate.activeDuration kullanımdan kaldırıldı. Bunun yerine ExerciseUpdate.activeDurationCheckpoint politikasını kullanın.
• flushExerciseAsync() API'sinin adı, ExerciseClient konumunda flushAsync() olarak değiştirildi.
• Measure.registerCallback, Measure.registerMeasureCallback olarak yeniden adlandırıldı.
• Genel adlandırma değişiklikleri:
  • Mesafe özelliklerinde artık meters son eki var.
  • Geri çağırma yöntemi adları artık geçmiş zamandır.
  • Çoğu kısaltma kaldırıldı (HrAccuracy artık HeartRateAccuracy oldu.)
  • enableFoo kalıbını izleyen özellikler artık isFooEnabled olarak adlandırılıyor.
• Enum'lardan taşındı.
• Double tarafından temsil edilen saatler artık Duration ile temsil edilmektedir.
• ListenableFuture<Void?> döndüren işlevler artık ListenableFuture<Void> döndürüyor.
• Geri çağırmayı kabul eden işlevler artık geri çağırmayı her zaman son parametre olarak görünür.
• Oluşturucu sınıflarının artık her zaman herkese açık kurucuları da var.
• Kayıt işlevleri artık bir ListenableFuture döndürmez. Bunun yerine, sağlanan geri çağırmaya kayıt durumunu aktarır.
• KDokümanlar iyileştirildi.
• Herkese açık sınıfların kapsamı artık ProtoParcelable ile sınırlı değil.

Hata Düzeltmeleri

• IPC güvenilirliğinde genel iyileştirmeler (I3b1e2)

Sürüm 1.0.0-alpha03

3 Kasım 2021

androidx.health:health-services-client:1.0.0-alpha03 serbest bırakıldı. 1.0.0-alpha03 sürümü bu kayıtları içerir.

Yeni Özellikler

• Sağlık Hizmetleri APK'sı ile IPC bağlantısının kopması durumunda SDK, ölçüm, egzersiz dinleyici ve pasif izleme geri çağırma kaydı isteklerini otomatik olarak yeniden kaydeder.

API Değişiklikleri

• Health Services İstemcisi şu anda yalnızca Wear3'te desteklendiğinden SDK kitaplığının minSdkVersion değeri API düzeyi 30'a düşürüldü.

Sürüm 1.0.0-alpha02

29 Eylül 2021

androidx.health:health-services-client:1.0.0-alpha02 serbest bırakıldı. 1.0.0-alpha02 sürümü bu kayıtları içerir.

API Değişiklikleri

• ExerciseClient artık egzersiz hazırlamayı destekliyor. Bu, müşterilerin egzersize başlamadan önce sensörleri ısıtmasına ve GPS Sabitleme gibi işlemlerin beklemesine olanak tanır.
• Etkin bir alıştırma sırasında izlenen toplu metrikleri daha iyi modellemek için CumulativeDataPoints ve StatisticalDataPoints AggregateDataPoint sınıflarını kullanıma sunar. CumulativeDataPoints, toplanan aralık veri türlerinin (egzersiz toplam mesafe gibi) kümülatif değerlerini barındırırken StatisticalDataPoints modeli, örneklenmiş veri noktalarının verilerini (min., maks. ve ortalama HeartRateBpm gibi) toplar. Önceki AGGREGATE_* DataType'ın yerini alan bu modüle getLatestAggregateMetrics() üzerinden ExerciseUpdate'den erişilebilir. AGGREGATE_* Veri Türleri artık desteklenmiyor.
• PassiveMonitoring Etkinliklerin adı, günlük metrikler (ör. DAILY_STEPS) gibi veri türleri için hedef belirlemeyi ve bu hedeflere ulaşıldığında bildirim almayı destekleyen PassiveGoals olarak yeniden adlandırıldı.
• Yeni HrAccuracy, LocationAccuracy ve LocationAvailability sınıfları sayesinde Nabız ve Konum doğruluğu ve kullanılabilirliği konusunda daha iyi modelleme.
• ExerciseConfig ve yeni PassiveMonitoringConfig alanlarının adlandırması iyileştirildi ve GPS destekli veri istemek için ExerciseConfig.shouldEnableGps kullanıma sunuldu

Hata Düzeltmeleri

• Geriye dönük uyumluluk desteği için proto destekli IPC aktarımına geçiş yapar

Sürüm 1.0.0-alpha01

18 Mayıs 2021

androidx.health:health-services-client:1.0.0-alpha01 serbest bırakıldı. 1.0.0-alpha01 sürümü bu kayıtları içerir.

İlk sürümün özellikleri

Sağlık Hizmetleri kitaplığı, geliştiricilerin cihaza özel sensör uygulamalarıyla entegre olmaları için tek tip API seti sağlar. Wear OS 3 emülatörleri ve kullanıma sunulacak cihazlarda kullanıma hazır olan bu özellik, gelecekte başka platformlar da desteklenecektir. Bu ilk sürüme üç üst düzey API yüzeyi eklenmiştir: ExerciseClient, PassiveMonitoringClient ve MeasureClient.

Egzersiz İstemcisi

ExerciseClient, yürüyüş ve koşudan dansa ve su topuna kadar 82 farklı ExerciseType içeren aktif antrenmanları izleyen uygulamalar için tasarlanmıştır. Bu egzersizleri izlerken, cihazdaki egzersiz türüne ve donanıma bağlı olarak 50 farklı DataType seçeneği vardır. Başlamak için ExerciseConfig uygulamanızda ilgili bilgileri belirtin, exerciseClient.startExercise numaralı telefonu arayın ve güncelleme işleyicinin ilerleme durumunu dinleyin.

PasifMonitoringClient

Uygulamanız gün boyunca kullanıcının etkinliğini izliyorsa PassiveMonitoringClient harika bir seçimdir. PendingIntent için DataType grubunu kaydedebilir ve toplu değişiklikleri yapacak şekilde uyandırabilirsiniz. Alternatif olarak, belirli bir sayıda adıma ulaşma gibi bir Event belirtebilirsiniz.

Ölçüm İstemcisi

Bazen kullanıcının nabzını, egzersiz sırasında değil, gün boyu değil, anında ölçmesi gerekir. Bu gibi durumlarda MeasureClient mükemmel bir seçenektir. Veri akışı almak için geri aramanızı desteklenen DataType ile kaydetmeniz yeterlidir. Böylece, artık gerekli olmadığında geri arama kaydınızı iptal edersiniz.