Sağlık
Son Güncelleme | Kararlı Sürüm | Sürüm Adayı | Beta Sürümü | Alfa Sürümü |
---|---|---|---|---|
11 Aralık 2024 | - | 1.0.0-rc02 | - | 1.1.0-alpha05 |
Bağımlılıkları beyan etme
Health bağımlılığı eklemek için projenize Google Maven deposunu eklemeniz gerekir. Daha fazla bilgi için Google'ın Maven deposunu inceleyin.
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 { implementation "androidx.health:health-services-client:1.1.0-alpha03" }
Kotlin
dependencies { implementation("androidx.health:health-services-client:1.1.0-alpha03") }
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.
Daha fazla bilgi için Sorun İzleyici belgelerine bakın.
Health Connect İstemci 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
alanına taşındı. Gelecekteki sürümler için lütfen androidx.health.connect:connect-client
'ü ve Health Connect sayfamızdaki ilgili sürüm notlarını kullanın.
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.
Sürüm 1.0.0-alpha03
27 Temmuz 2022
androidx.health:health-connect-client:1.0.0-alpha03
yayınlanır. 1.0.0-alpha03 sürümü bu taahhütleri 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 kendi seçtikleri birimle kayıt alabilir ya da yazabilir.
API Değişiklikleri
- Çeşitli istek yanıtı nesnelerinde
List<DataOrigin>
değeriniSet<DataOrigin>
olarak düzeltin. (I42342) - Güç->Enerji bölümünden bazal toplam kalori birimini düzeltin. (I0b429)
- Seri örnek sınıfları, seri kayıtlarının içine taşındı (Ica9bb):
CyclingPedalingCadence
->CyclingPedalingCadenceRecord.Sample
HeartRate
->HeartRateRecord.Sample
StepsCadence
->StepsCadenceRecord.Sample
HealthDataRequestPermission
sınıfı için desteği sonlandırıpPermissionController.createRequestPermissionActivityContract
sınıfını desteklemeye başlayacağız. Bu sayede daha iyi bulunabilirlik ve birleşik parametrelendirme sağlanacaktır. (I81e7f)- Hacim bölümüne ABD sıvı onsları eklendi. (I5f03d)
- Hız birimi türü eklendi (I1d574)
- Yüzde birimi türü eklendi (I08f23)
- Basınç birimi türü eklendi (Ifb01f)
- Eklenmiş Kütle birimi türü (Ifd81a)
- Ses düzeyi birimi türü eklendi (I59ad1)
- Güç birimi türü eklendi. Power serisi örnek sınıfı
PowerRecord
sınıfına taşındı. (I5b1e5) - Enerji birimi türü eklendi (I983ae)
- Sıcaklık birimi türü eklendi (I4cdb5)
- Aşağıdakiler dahil olmak üzere Etkinlik referanslarını Egzersiz'e özgü olacak şekilde yeniden adlandırın (I3f936):
ActivityLap
->ExerciseLapRecord
olarak yeniden adlandırıldıActivityEvent
->ExerciseEventRecord
olarak yeniden adlandırıldıRepetitions
->ExerciseRepetitionsRecord
olarak yeniden adlandırıldıActivitySession
->ExerciseSessionRecord
olarak yeniden adlandırıldı
- Paket meta verileri, kayıtların altına yerleştirildi. (Ie0835)
- Kalan tüm kayıtlarda kullanılan uzunluk birimi (Ib10dd):
ActivityLapRecord
ElevationGainedRecord
HeightRecord
HipCircumferenceRecord
WaistCircumferenceRecord
- Uzunluk birim türü eklendi (Idae39)
CervicalMucus
açıklaması terminolojisini güncelleme (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, release aromasıyla ve
minifyEnabled
doğru olarak derlendiğinde proguard sorunlarını düzeltme. (I78933) - Herkese açık kullanıma yönelik olmayan dokümanları gizler. (I7a08f)
- Kendi protobuf bağımlılıkları olabilecek istemcilerdeki 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
yayınlanır. 1.0.0-alpha02 sürümü bu taahhütleri içerir.
API Değişiklikleri
AggregationResult
'dehasMetric
vegetMetric
için desteği sonlandırıldı, contains ve get operatörleri eklendi (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
yayınlanır. 1.0.0-alpha01 sürümü bu taahhütleri içerir.
Yeni Özellikler
- Diğer uygulamalar tarafından paylaşılan fitness ve sağlık kayıtlarını okumak için API.
- Diğer uygulamalarla paylaşmak için fitness ve sağlık kayıtları yazma API'si.
- Erişilebilir kayıtlar için toplu metrikleri almak üzere kullanılan API.
- Diğer uygulamalar tarafından yapılan kayıtlardaki artımlı değişiklikleri (ekle, güncelle veya sil) almak için kullanılan API.
- Kullanıcılardan sağlık izinleri isteyecek API.
- İzinleri kontrol etmek veya verilen sağlık izinlerini iptal etmek için API.
Sağlık Hizmetleri İstemci Sürümü 1.1
Sürüm 1.1.0-alpha05
11 Aralık 2024
androidx.health:health-services-client:1.1.0-alpha05
, androidx.health:health-services-client-external-protobuf:1.1.0-alpha05
ve androidx.health:health-services-client-proto:1.1.0-alpha05
yayınlandı. 1.1.0-alpha05 sürümü bu taahhütleri içerir.
Yeni Özellikler
- Artık gerekli sınıfların kaldırılmasını önlemek için ProGuard kuralları içeriyor. (65d0c3f)
Hata Düzeltmeleri
- 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)
Sürüm 1.1.0-alpha04
16 Ekim 2024
androidx.health:health-services-client:1.1.0-alpha04
, androidx.health:health-services-client-external-protobuf:1.1.0-alpha04
ve androidx.health:health-services-client-proto:1.1.0-alpha04
yayınlandı. 1.1.0-alpha04 sürümü bu taahhütleri içerir.
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:health-services-client
bağımlılığınızı en son 1.1.0-alpha04 sürümüne yükseltin.
Sürüm 1.1.0-alpha02
13 Aralık 2023
androidx.health:health-services-client:1.1.0-alpha02
yayınlanır. 1.1.0-alpha02 sürümü bu taahhütleri içerir.
API Değişiklikleri
- Desteklenen
ExerciseEvent
için tek bir doğru kaynak kullanın. (I03308)
Hata Düzeltmeleri
- Küçük hata düzeltmeleri ve dokümanlar üzerinde iyileştirmeler.
Sürüm 1.1.0-alpha01
9 Ağustos 2023
androidx.health:health-services-client:1.1.0-alpha01
yayınlanır. 1.1.0-alpha01 sürümü bu taahhütleri içerir.
Yeni Özellikler
- İlk somut etkinlik olan
GolfShotEvent
ile birlikteExerciseEvent
API'leri eklendi.ExerciseEvent
ilkelleri, geliştiricilerin destek ekibine sorgu göndermesine ve kol saati bir şey algıladığında bildirim almasını istemesine olanak tanır.GolfShotEvent
, geliştiricilerin kullanıcı golf vuruşu yaptığında bildirim almasına ve tanınan vuruş türünü almasına olanak tanır.
API Değişiklikleri
- WHS SDK istemcilerinin
GolfShotEvent
işlevlerini kullanmasına izin verin. (I76b03)
Hata Düzeltmeleri
- Bilinmeyen egzersiz etkinliği özelliklerini gördüğünüzde agresif bir şekilde istisnalar atamak yerine bu özellikleri listeden filtreleyin. (I06afc)
Sağlık Hizmetleri İstemci Sürümü 1.0
Sürüm 1.1.0-alpha03
14 Mayıs 2024
androidx.health:health-services-client:1.1.0-alpha03
yayınlanır. 1.1.0-alpha03 sürümü bu taahhütleri içerir.
Yeni Özellikler
- Hata ayıklama özellikleri(
initialDelay
vedurationAtThreshold
) ile egzersiz sırasında örnek veri türü veya istatistik örnek veri türü için bir hedefin izlenmesine olanak tanıyanDebouncedGoal
API'leri kullanıma sunuldu. (I09be9) - Aşağıdaki gelişmiş çalışma metrikleri örneği ve istatistiksel
DataTypes
eklendi. (I0b8b5):Ground Contact Time
Vertical Oscillation
Vertical Ratio
Stride Length
API Değişiklikleri
ELEVATION_GAIN_DAILY
DataType
eklendi. (I059d1)SWIM_LAP_COUNT
için topluDataType
olarakSWIM_LAP_COUNT_TOTAL
DataType
eklendi. (I0beeb)
Hata Düzeltmeleri
- IPC güvenilirliğini iyileştirmek için çeşitli sorunlar düzeltildi.
Sürüm 1.0.0-rc02
3 Nisan 2024
androidx.health:health-services-client:1.0.0-rc02
yayınlanır. 1.0.0-rc02 sürümü bu taahhütleri içerir. Bu sürüm yalnızca hata düzeltmeleri içerdiğinden API değişiklikleri içermez.
Hata Düzeltmeleri
- IPC güvenilirliğini artırmak için çeşitli sorunlar düzeltildi
prepareExercise
ile aynı andastartExercise
numaralı telefondan arama yapılmasınınConcurrentModificationException
'ye neden olabileceği sorun düzeltildi (4e37773)- İyileştirilmiş dokümanlar
Sürüm 1.0.0-rc01
26 Temmuz 2023
androidx.health:health-services-client:1.0.0-rc01
yayınlanır. 1.0.0-rc01 sürümü bu taahhütleri içerir.
Yeni Özellikler
- Health Services, beta sürümünde istikrara kavuştuktan sonra 1.0.0-rc01 sürümüne geçti.
API Değişiklikleri
- h- ile m-yolları için herkese açık ve deneysel API dosyalarının birleştirilmesi. (Ic4630, b/278769092)
- Geçerli değil. API dosyası değişiklikleri yalnızca yeniden sıralama yöntemleridir. (I5fa95)
Sürüm 1.0.0-beta03
5 Nisan 2023
androidx.health:health-services-client:1.0.0-beta03
yayınlanır. 1.0.0-beta03 sürümü bu taahhütleri içerir.
Yeni Özellikler
BatchingMode
artık etkin bir egzersiz sırasında varsayılan yerine yapılandırılmış aralıkta toplu egzersiz verileri gönderecek şekilde yapılandırılabilir. Bu işlem, ExerciseConfig
aracılığıyla egzersizin başında veya geçersiz kılma yöntemiyle egzersiz sırasında yapılabilir. Bu özellik için destek, Google Play Store'da yakında kullanıma sunulacak Sağlık Hizmetleri sürümünde etkinleştirilecek ve egzersiz özellikleri aracılığıyla kontrol edilebilir. Not: Gruplandırma modları, cihaz etkileşimli olmayan bir güç durumundayken geçerli olur ve güç tüketiminin artmasına neden olur.
API Değişiklikleri
overrideBatchingModesForActiveExercise
işlevi askıya alındığındaHealthServicesException
atılıyor (Ifd387)- Eşzamansız
overrideBatchingModesForActiveExercise
API için askıya alma işlevleri kullanıma sunuldu. Bu işlevler, Kotlin'e daha uygun hale getirildi (I7dd15) BatchingMode
,ExerciseConfig
'daki isteğe bağlı özelliği geçersiz kılar (Id22e9)
Hata Düzeltmeleri
DataType
veExerciseUpdate
için küçük düzeltmeler (5e185f)
Sürüm 1.0.0-beta02
11 Ocak 2023
androidx.health:health-services-client:1.0.0-beta02
yayınlanır. 1.0.0-beta02 sürümü bu taahhütleri içerir.
Yeni Özellikler
- Daha iyi Kotlin desteği için
ExerciseClient
,PassiveMonitoringClient
veMeasureClient
'teki mevcut asenkronListenableFuture
API'leri içinsuspend
uzantı işlevleri eklendi. (Iadea4) - Devam eden bir egzersiz sırasında güncelleme yapılmasına olanak tanıyan
ExerciseTypeConfig
API eklendi. Golf egzersizleri sırasındaExerciseTypeConfig
değerinin güncellenmesini desteklemek içinGolfExerciseTypeConfig
eklendi. (I4c539)
API Değişiklikleri
- Askıya alma işlevlerinde
HealthServicesException
atma (I5e509) - Geriye dönük uyumluluk için başka bir kurucu ekleyin (Iddeda)
- Askıya alma işlevlerinde
RuntimeException
atma (I53bca) - İstisna atma işleminin varsayılan uygulamasını kaldırın (Id947f)
@JvmDefaultWithCompatibility
ek açıklaması (I8f206) ekleniyor
Hata Düzeltmeleri
- Daha net olması için kdoc'a ekleyin (Ide285)
- Hedefler için yalnızca aynı veri türleri de izleniyorsa pasif izlemeye izin ver (Ibed8d)
Sürüm 1.0.0-beta01
24 Ekim 2022
androidx.health:health-services-client:1.0.0-beta01
yayınlanır. 1.0.0-beta01 sürümü bu taahhütleri içerir.
Yeni Özellikler
İlk etkinlik
HealthEvent.FALL_DETECTED
olacak şekildePassiveMonitoringClient
aracılığıyla sağlık etkinliklerini dinleme özelliği eklendi.Yeni ExerciseTypes:
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 modellenmesi güncellendi: Veri modeli ve
DataType
,DataPoint
öğelerinin ve temel değerlerinin nasıl temsil edildiği tamamen değiştirildi. En üst düzeyde etki, API'lerin artık çok daha açık ve tür açısından güvenli olmasıdır. - Konum
DataPoint
'leri artıkDoubleArray
olarak değil, güçlü şekilde yazılmış birLocationData
nesnesi olarak temsil edilir. - Yeni bir pasif dinleyici API'si grubuna taşındı:
- Yayın,
PassiveListenerService
ile değiştirildi. - Mevcut dinleyiciler tek bir dinleyiciyle değiştirildi:
PassiveListenerCallback
.
- Yayın,
- Uygulamaların artık kendi manifest dosyalarında belirtmesi gerekmemesi için Health Services manifest dosyasına
<queries>
etiketi eklendi (derleme sistemlerinde manifest birleştirme özelliğinin etkin olması gerekir). - Egzersizin bittiğini / bittiğini göstermek için birçok
ExerciseState
yerine yeni egzersiz durumlarıENDING
veENDED
eklendi. Bunlar artık önceki durumların tüm yelpazesini temsil etmek içinExerciseEndReason
ile birleştirilir. - Yalnızca günlük pasif hedefleri desteklediğimizi daha iyi yansıtmak için
PassiveListenerConfig
setPassiveGoals
adısetDailyGoals
olarak değiştirildi. PassiveGoal
artık her zamanREPEATED
, pasifTriggerFrequency
kaldırıldı.- Tüm
Long
veDouble
parametreleri@FloatRange
ile ek açıklamaya tabi tutuldu. - Havuz yüzme mesafesi hesaplamalarını iyileştirmek için isteğe bağlı olarak belirtilebilecek
swimmingPoolLengthMeters
mülküExerciseConfig
özelliğine eklendi. ExerciseUpdate.activeDuration
özelliği kullanımdan kaldırıldı. Bunun yerineExerciseUpdate.activeDurationCheckpoint
politikasını kullanın.ExerciseClient
'deflushExerciseAsync()
API'siflushAsync()
olarak yeniden adlandırıldı.Measure.registerCallback
,Measure.registerMeasureCallback
olarak yeniden adlandırıldı.- Genel adlandırma değişiklikleri:
- Mesafe mülkleri artık
meters
son ekiyle bitiyor. - Geri çağırma yöntemi adları artık geçmiş zaman kipindedir.
- Çoğu kısaltma kaldırıldı (
HrAccuracy
artıkHeartRateAccuracy
). enableFoo
desenini izleyen mülkler artıkisFooEnabled
olarak adlandırılıyor.
- Mesafe mülkleri artık
- Taşıma işleminin kaynağı
Double
ile temsil edilen saatler artıkDuration
ile temsil ediliyor.ListenableFuture<Void?>
döndüren işlevler artıkListenableFuture<Void>
döndürüyor.- Geri çağırma işlevini kabul eden işlevlerde geri çağırma işlevi artık her zaman son parametre olarak görünür.
- Oluşturucu içeren sınıflarda artık her zaman herkese açık yapıcılar da bulunur.
- Kayıt işlevleri artık bir
ListenableFuture
döndürmez ve bunun yerine kayıt durumunu sağlanan geri çağırma işlevine iletir. - KDocs iyileştirildi.
- Herkese açık sınıflar artık
ProtoParcelable
'ü uzatmaz.
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
yayınlanır. 1.0.0-alpha03 sürümü bu taahhütleri içerir.
Yeni Özellikler
- SDK, Health Services APK ile IPC bağlantısının kesilmesi durumunda ölçüm, egzersiz dinleyici ve pasif izleme geri çağırma kayıt isteklerini otomatik olarak yeniden kaydeder.
API Değişiklikleri
- Sağlık Hizmetleri İstemcisi şu anda yalnızca Wear3'te desteklendiğinden SDK kitaplığının minSdkVersion değeri API düzeyi 30'a yükseltildi.
Sürüm 1.0.0-alpha02
29 Eylül 2021
androidx.health:health-services-client:1.0.0-alpha02
yayınlanır. 1.0.0-alpha02 sürümü bu taahhütleri içerir.
API Değişiklikleri
ExerciseClient
artık egzersiz hazırlamayı destekliyor. Bu sayede istemciler, egzersize başlamadan önce sensörleri ısıtabilir ve GPS düzeltmesi gibi işlemleri bekleyebilir.- Etkin bir egzersiz sırasında izlenen toplu metrikleri daha iyi modellemek için CumulativeDataPoints ve StatisticalDataPoints AggregateDataPoint sınıflarını kullanıma sunar. CumulativeDataPoints, birleştirilmiş aralık veri türlerinin kümülatif değerlerini (ör. egzersiz sırasındaki toplam mesafe) tutarken StatisticalDataPoints, örneklenmiş veri noktalarının toplamlarını modeller (ör. minimum, maksimum ve ortalama HeartRateBpm). Bu, önceki
AGGREGATE_*
veri türlerinin yerini alır ve ExerciseUpdate'tegetLatestAggregateMetrics()
aracılığıyla erişilebilir.AGGREGATE_*
Veri türleri artık desteklenmiyor. PassiveMonitoring
Etkinlikler, günlük metrikler (ör. DAILY_STEPS) gibi veri türleri için hedef belirlemeyi ve bu hedefler karşılandığında bildirim almayı destekleyenPassiveGoals
olarak yeniden adlandırıldı.- Yeni HrAccuracy, LocationAccuracy ve LocationAvailability sınıflarının kullanıma sunulması sayesinde kalp atış hızı ve konum doğruluğu ile kullanılabilirliğinin modellenmesi iyileştirildi.
ExerciseConfig
alanının adı iyileştirildi, yeniPassiveMonitoringConfig
alanları eklendi ve GPS destekli veriler istemek içinExerciseConfig.shouldEnableGps
alanı kullanıma sunuldu
Hata Düzeltmeleri
- Daha iyi geriye dönük uyumluluk desteği için proto destekli IPC aktarımına geçiş
Sürüm 1.0.0-alpha01
18 Mayıs 2021
androidx.health:health-services-client:1.0.0-alpha01
yayınlanır. 1.0.0-alpha01 sürümü bu taahhütleri içerir.
İlk sürümün özellikleri
Sağlık Hizmetleri kitaplığı, geliştiricilerin cihaza özel sensör uygulamalarını entegre edebilmesi için tek tip bir API grubu sağlar. Wear OS 3 emülatörleri ve yakında kullanıma sunulacak cihazlarla birlikte çalışır. Gelecekte daha fazla platform desteklenecektir. Bu ilk sürüme üç üst düzey API yüzeyi dahil edilmiştir: ExerciseClient
, PassiveMonitoringClient
ve MeasureClient
.
ExerciseClient
ExerciseClient
, yürüyüş ve koşudan dansa ve su topuna kadar 82'ye kadar farklı ExerciseType
ile aktif egzersizleri izleyen uygulamalar için tasarlanmıştır. Bu egzersizleri izlerken egzersiz türüne ve cihazdaki donanıma bağlı olarak 50 farklı DataType
seçeneğinden yararlanabilirsiniz. Başlamak için ExerciseConfig
dosyanızda ilgili bilgileri belirtin, exerciseClient.startExercise
numarasını arayın ve güncelleme dinleyicisinin ilerleme durumunu dinleyin.
PassiveMonitoringClient
Uygulamanız kullanıcının gün içindeki etkinliğini izliyorsa PassiveMonitoringClient
mükemmel bir seçimdir. Bir PendingIntent
'ü bir DataType
grubuyla kaydedebilir ve toplu değişiklikleri işlemek için uyandırılabilir. Alternatif olarak, belirli bir adım sayısına ulaşmak gibi bir Event
belirtebilirsiniz.
MeasureClient
Bazen kullanıcının, örneğin nabzını egzersiz sırasında veya gün boyunca değil, o anda ölçmesi gerekir. Bu gibi durumlarda MeasureClient
mükemmel bir seçimdir.Veri akışı almak için geri çağırma işlevinizi desteklenen DataType
'lara kaydettirmeniz ve artık gerekli olmadığında geri çağırma işlevinizi kaydını silmeniz yeterlidir.