Sağlık
Son Güncelleme | Kararlı Sürüm | Serbest Bırakma Adayı | Beta Sürümü | Alfa Sürümü |
---|---|---|---|---|
9 Ağustos 2023 | - | 1.0.0-rc01 | - | 1.1.0-alfa01 |
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:
Groovy
dependencies { implementation "androidx.health:health-services-client:1.1.0-alpha01" }
Kotlin
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.
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ıpPermissionController.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ılanhasMetric
vegetMetric
, eklenen içerir ve alma operatörleri (I7cc7c)OvulationTest.Result.HIGH
veOvulationTest.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ğundaHealthServicesException
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
veExerciseUpdate
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
veMeasureClient
dillerindeki mevcut eşzamansızListenableFuture
API'lerinesuspend
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ındaExerciseTypeConfig
güncellemesini desteklemek içinGolfExerciseTypeConfig
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ıkDoubleArray
olarak değil, güçlü türde birLocationData
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
.
- Yayının yerini
- 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
veENDED
eklendi. Bunlar artık önceki eyaletlerin tam gamını temsil etmek içinExerciseEndReason
ile birleştiriliyor. PassiveListenerConfig
setPassiveGoals
, yalnızca günlük pasif hedefleri desteklediğimizi daha iyi yansıtmak içinsetDailyGoals
olarak yeniden adlandırıldı.PassiveGoal
artık her zamanREPEATED
, pasifTriggerFrequency
kaldırıldı.- Tüm
Long
veDouble
parametreleri@FloatRange
ile açıklandı. ExerciseConfig
öğesineswimmingPoolLengthMeters
ö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 yerineExerciseUpdate.activeDurationCheckpoint
politikasını kullanın.flushExerciseAsync()
API'sinin adı,ExerciseClient
konumundaflushAsync()
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ıkHeartRateAccuracy
oldu.) enableFoo
kalıbını izleyen özellikler artıkisFooEnabled
olarak adlandırılıyor.
- Mesafe özelliklerinde artık
- Enum'lardan taşındı.
Double
tarafından temsil edilen saatler artıkDuration
ile temsil edilmektedir.ListenableFuture<Void?>
döndüren işlevler artıkListenableFuture<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ülegetLatestAggregateMetrics()
ü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ı destekleyenPassiveGoals
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 yeniPassiveMonitoringConfig
alanlarının adlandırması iyileştirildi ve GPS destekli veri istemek içinExerciseConfig.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.