الصحة

تحديد الاعتماديات

لإضافة اعتمادية على Health، يجب تضمين مستودع Google Maven في مشروعك. اطّلِع على مستودع Maven من Google لمزيد من المعلومات.

أضِف الاعتماديات الخاصة بالعناصر التي تحتاج إليها في ملف build.gradle لتطبيقك أو وحدتك:

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

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

الملاحظات

تساعدنا ملاحظاتك في تحسين Jetpack. يُرجى إعلامنا إذا اكتشفت مشاكل جديدة أو كانت لديك أفكار لتحسين هذه المكتبة. يُرجى الاطّلاع على المشاكل الحالية في هذه المكتبة قبل إنشاء مشكلة جديدة. يمكنك إضافة صوتك إلى مشكلة حالية من خلال النقر على زر النجمة.

إنشاء مشكلة جديدة

يُرجى الاطّلاع على مستندات Issue Tracker للحصول على مزيد من المعلومات.

الإصدار 1.0 من Health Connect Client

الإصدار ‎1.0.0-alpha04

‫24 أغسطس 2022

اعتبارًا من الإصدار ‎1.0.0-alpha04، تم نقل androidx.health:health-connect-client إلى androidx.health.connect:connect-client. في ما يتعلّق بالإصدارات المستقبلية، يُرجى استخدام androidx.health.connect:connect-client وملاحظات الإصدار ذات الصلة على صفحة Health Connect.

لإجراء عملية النقل، ما عليك سوى تغيير عملية استيراد التبعية من androidx.health:health-connect-client:1.0.0-alpha03 إلى androidx.health.connect:connect-client:1.0.0-alpha04.

الإصدار ‎1.0.0-alpha03

‫27 يوليو 2022

تم طرح androidx.health:health-connect-client:1.0.0-alpha03. يتضمّن الإصدار 1.0.0-alpha03 هذه التعديلات.

الميزات الجديدة

• ملخّص للتغييرات الجديدة في واجهة برمجة التطبيقات: تمت إضافة مجموعة من الوحدات إلى واجهات برمجة التطبيقات للقراءة والكتابة والتجميع. يمكن للتطبيقات الآن استرداد السجلات أو كتابتها باستخدام وحدة القياس التي تختارها، مثل الغرام أو الملّيغرام لعناصر NutritionRecord الغذائية.

تغييرات واجهة برمجة التطبيقات

• إصلاح List<DataOrigin> ليكون Set<DataOrigin> في مختلف عناصر الرد على الطلبات (I42342)
• إصلاح وحدة إجمالي السعرات الحرارية الأساسية من "الطاقة" > "الطاقة" (I0b429)
• نقل فئات العيّنات من السلسلة إلى داخل سجلّات السلسلة (Ica9bb):
  • CyclingPedalingCadence -> CyclingPedalingCadenceRecord.Sample
  • HeartRate -> HeartRateRecord.Sample
  • StepsCadence -> StepsCadenceRecord.Sample
• إيقاف الفئة HealthDataRequestPermission نهائيًا واستخدام PermissionController.createRequestPermissionActivityContract بدلاً منها، ما يساهم في تحسين قابلية الاكتشاف وتوحيد المعلمات (I81e7f)
• تمت إضافة أونصة سائلة أمريكية إلى "الحجم". (I5f03d)
• تمت إضافة نوع وحدة السرعة (I1d574)
• تمت إضافة نوع وحدة النسبة المئوية (I08f23)
• تمت إضافة نوع وحدة الضغط (Ifb01f)
• تمت إضافة نوع وحدة الكتلة المضافة (Ifd81a)
• تمت إضافة نوع وحدة مستوى الصوت (I59ad1)
• تمت إضافة نوع وحدة الطاقة. تم نقل عيّنة سلسلة Power إلى الصف PowerRecord. (I5b1e5)
• تمت إضافة نوع وحدة الطاقة (I983ae)
• تمت إضافة نوع وحدة درجة الحرارة (I4cdb5)
• إعادة تسمية مراجع "النشاط" لتكون خاصة بـ "التمرين"، بما في ذلك (I3f936):
  • تمت إعادة تسمية ActivityLap إلى ExerciseLapRecord
  • تمت إعادة تسمية ActivityEvent إلى ExerciseEventRecord
  • تمت إعادة تسمية Repetitions إلى ExerciseRepetitionsRecord
  • تمت إعادة تسمية ActivitySession إلى ExerciseSessionRecord
• تم نقل البيانات الوصفية للحزمة المضمّنة ضمن السجلات. (Ie0835)
• وحدة الطول المستخدَمة في جميع السجلات المتبقية (Ib10dd):
  • ActivityLapRecord
  • ElevationGainedRecord
  • HeightRecord
  • HipCircumferenceRecord
  • WaistCircumferenceRecord
• تمت إضافة نوع وحدة الطول (Idae39)
• تعديل مصطلحات وصف CervicalMucus (I25a2b):
  • CervicalMucus.Amount -> CervicalMucusRecord.Texture
  • CervicalMucus.Appearance -> CervicalMucusRecord.Sensation
• تمت إضافة اللاحقة "Record" إلى جميع أسماء فئات السجلات (I1ffc2)

إصلاح الأخطاء

• تم إصلاح مشاكل Proguard عند إنشاء المكتبة باستخدام إصدار تجريبي و minifyEnabled true. (I78933)
• يخفي هذا الخيار المستندات غير المخصّصة للاستخدام العام. (I7a08f)
• تم إصلاح المشكلة في العملاء الذين قد يكون لديهم تبعيات protobuf خاصة بهم.(https://android-review.googlesource.com/c/platform/frameworks/support/+/2105430)

الإصدار ‎1.0.0-alpha02

‫1 يونيو 2022

تم طرح androidx.health:health-connect-client:1.0.0-alpha02. يتضمّن الإصدار 1.0.0-alpha02 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

• تم إيقاف hasMetric وgetMetric نهائيًا في AggregationResult، وتمت إضافة عاملي التشغيل "يحتوي على" و"الحصول على" (I7cc7c)
• إضافة OvulationTest.Result.HIGH وOvulationTest.Result.INCONCLUSIVE (I9f9c4)

إصلاح الأخطاء

• تقليل متطلبات حزمة تطوير البرامج إلى 26 (I6d201)

الإصدار ‎1.0.0-alpha01

‫11 مايو 2022

تم طرح androidx.health:health-connect-client:1.0.0-alpha01. يتضمّن الإصدار 1.0.0-alpha01 هذه التعديلات.

الميزات الجديدة

• واجهة برمجة التطبيقات لقراءة سجلات اللياقة البدنية والصحة التي تشاركها تطبيقات أخرى
• واجهة برمجة تطبيقات لكتابة سجلات اللياقة البدنية والصحة ومشاركتها مع تطبيقات أخرى
• واجهة برمجة التطبيقات لاسترداد المقاييس المجمّعة للسجلات التي يمكن الوصول إليها
• واجهة برمجة تطبيقات لاسترداد التغييرات المتزايدة (إدراج أو تعديل أو حذف) للسجلات من خلال تطبيقات أخرى
• واجهة برمجة التطبيقات لطلب أذونات الوصول إلى البيانات الصحية من المستخدمين
• واجهة برمجة التطبيقات للتحقّق من الأذونات أو إبطال أذونات الصحة الممنوحة

الإصدار 1.1 من تطبيق "خدمات الصحة"

الإصدار 1.1.0-rc01

‫25 فبراير 2026

تم إصدار androidx.health:health-services-client:1.1.0-rc01 وandroidx.health:health-services-client-external-protobuf:1.1.0-rc01 وandroidx.health:health-services-client-proto:1.1.0-rc01. لم يتم إجراء أي تغييرات في الإصدار 1.1.0-rc01 منذ إصدار الإصدار التجريبي السابق.

الإصدار ‎1.1.0-beta01

‫11 فبراير 2026

تم إصدار androidx.health:health-services-client:1.1.0-beta01 وandroidx.health:health-services-client-external-protobuf:1.1.0-beta01 وandroidx.health:health-services-client-proto:1.1.0-beta01. لا يتضمّن الإصدار 1.1.0-beta01 أي تغييرات منذ إصدار ألفا السابق.

الإصدار ‎1.1.0-alpha05

‫11 ديسمبر 2024

تم إصدار androidx.health:health-services-client:1.1.0-alpha05 وandroidx.health:health-services-client-external-protobuf:1.1.0-alpha05 وandroidx.health:health-services-client-proto:1.1.0-alpha05. يتضمّن الإصدار 1.1.0-alpha05 هذه التعديلات.

الميزات الجديدة

• يتضمّن الآن قواعد Proguard لتجنُّب إزالة الفئات الضرورية. (65d0c3f)

إصلاح الأخطاء

• تستخدم هذه المكتبة الآن تعليقات توضيحية بشأن القيم الخالية في JSpecify، وهي تعليقات توضيحية خاصة بالاستخدام. على مطوّري Kotlin استخدام وسيطة المترجم البرمجي التالية لفرض الاستخدام الصحيح: -Xjspecify-annotations=strict (هذه هي القيمة التلقائية بدءًا من الإصدار 2.1.0 من مترجم Kotlin البرمجي). (Iaf73a، b/326456246)

الإصدار ‎1.1.0-alpha04

‫16 أكتوبر 2024

تم إصدار androidx.health:health-services-client:1.1.0-alpha04 وandroidx.health:health-services-client-external-protobuf:1.1.0-alpha04 وandroidx.health:health-services-client-proto:1.1.0-alpha04. يتضمّن الإصدار 1.1.0-alpha04 هذه التعديلات.

إصلاحات الأمان

• اعتبارًا من هذا التغيير، يتم تجميع androidx مع الإصدار 4.28.2 من protobuf من أجل معالجة CVE-2024-7254. عليك ترقية الإصدار الذي يعتمد عليه تطبيقك من androidx.health:health-services-client إلى أحدث إصدار وهو 1.1.0-alpha04 لمعالجة مخاطر الثغرة الأمنية.

الإصدار ‎1.1.0-alpha02

‫13 ديسمبر 2023

تم طرح androidx.health:health-services-client:1.1.0-alpha02. يتضمّن الإصدار 1.1.0-alpha02 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

• استخدِم مصدرًا واحدًا للمعلومات الموثوقة بشأن ExerciseEvent المتوافقة. (I03308)

إصلاح الأخطاء

• إصلاحات أخطاء بسيطة وتحسينات في المستندات

الإصدار ‎1.1.0-alpha01

‫9 أغسطس 2023

تم طرح androidx.health:health-services-client:1.1.0-alpha01. يتضمّن الإصدار 1.1.0-alpha01 هذه التعديلات.

الميزات الجديدة

• تمت إضافة واجهات برمجة التطبيقات ExerciseEvent إلى جانب الحدث الملموس الأول: GolfShotEvent. تتيح عناصر ExerciseEvent الأساسية للمطوّرين إمكانية طلب معلومات عن التوافق وطلب تلقّي إشعار عندما يرصد الجهاز الذي يعمل بنظام التشغيل Wear OS حدوث شيء ما. GolfShotEvent كمثال، يتيح للمطوّرين تلقّي إشعار عندما يسدّد المستخدم ضربة غولف بالإضافة إلى تلقّي نوع التأرجح الذي تم التعرّف عليه.

تغييرات واجهة برمجة التطبيقات

• فعِّل برامج WHS SDK لتتمكّن من استخدام وظائف GolfShotEvent. (I76b03)

إصلاح الأخطاء

• بدلاً من طرح استثناءات بشكل صارم عند رصد إمكانات غير معروفة لحدث التمرين، يمكنك فلترتها من القائمة. (I06afc)

الإصدار 1.0 من تطبيق "خدمات الصحة"

الإصدار 1.0.0

‫7 مايو 2025

تم طرح androidx.health:health-services-client:1.0.0. يتضمّن الإصدار 1.0.0 هذه التعديلات.

الميزات الرئيسية في الإصدار 1.0.0

• هذه هي عملية ترقية الإصدار 1.0.0-rc02 إلى الإصدار الثابت من "حزمة تطوير البرامج لخدمات الصحة". لم يتم إجراء أي تغييرات مقارنةً بالإصدار 1.0.0-rc02.

الإصدار ‎1.1.0-alpha03

‫14 مايو 2024

تم طرح androidx.health:health-services-client:1.1.0-alpha03. يتضمّن الإصدار 1.1.0-alpha03 هذه التعديلات.

الميزات الجديدة

• تم طرح واجهات برمجة التطبيقات DebouncedGoal التي تتيح تتبُّع هدف لنوع بيانات العيّنات أو نوع بيانات إحصاءات العيّنات أثناء التمرين باستخدام ميزات منع الارتداد(initialDelay وdurationAtThreshold). (I09be9)
• تمت إضافة عيّنة من مقاييس الجري المتقدّمة وDataTypes إحصائية. (I0b8b5):
  • Ground Contact Time
  • Vertical Oscillation
  • Vertical Ratio
  • Stride Length

تغييرات واجهة برمجة التطبيقات

• تمت إضافة ELEVATION_GAIN_DAILY DataType. (I059d1)
• تمت إضافة SWIM_LAP_COUNT_TOTAL DataType كـ DataType مجمّع لـ SWIM_LAP_COUNT. (I0beeb)

إصلاح الأخطاء

• تم إصلاح مشاكل متنوّعة لتحسين موثوقية عملية الاتصال بين العمليات (IPC).

الإصدار ‎1.0.0-rc02

‫3 أبريل 2024

تم طرح androidx.health:health-services-client:1.0.0-rc02. يتضمّن الإصدار 1.0.0-rc02 هذه التعديلات. هذا الإصدار مخصّص لإصلاح الأخطاء فقط ولا يتضمّن أي تغييرات في واجهة برمجة التطبيقات.

إصلاح الأخطاء

• تم إصلاح مشاكل متنوّعة لتحسين موثوقية عملية الاتصال بين العمليات
• تم إصلاح مشكلة قد تؤدي إلى ظهور الخطأ ConcurrentModificationException (4e37773) عند الاتصال بـ startExercise في الوقت نفسه الذي يتم فيه الاتصال بـ prepareExercise.
• مستندات محسّنة

الإصدار ‎1.0.0-rc01

‫26 يوليو 2023

تم طرح androidx.health:health-services-client:1.0.0-rc01. يتضمّن الإصدار 1.0.0-rc01 هذه التعديلات.

الميزات الجديدة

• تم نقل "خدمات الصحة" إلى الإصدار 1.0.0-rc01 بعد أن أصبح الإصدار التجريبي مستقرًا.

تغييرات واجهة برمجة التطبيقات

• تم دمج ملفات واجهات برمجة التطبيقات العامة والتجريبية لمسارات h إلى m. (Ic4630، b/278769092)
• لا ينطبق، لأنّ التغييرات في ملف واجهة برمجة التطبيقات هي مجرد إعادة ترتيب للطرق. (I5fa95)

الإصدار 1.0.0-beta03

‫5 أبريل 2023

تم طرح androidx.health:health-services-client:1.0.0-beta03. يتضمّن الإصدار 1.0.0-beta03 هذه التعديلات.

الميزات الجديدة

يمكن الآن ضبط BatchingMode لعرض بيانات التمارين الرياضية المجمّعة في الفاصل الزمني الذي تم ضبطه بدلاً من الفاصل الزمني التلقائي أثناء ممارسة نشاط بدني، إما عند بدء النشاط البدني من خلال ExerciseConfig أو أثناء النشاط البدني باستخدام طريقة إلغاء. سيتم إتاحة هذه الميزة من خلال إصدار قادم من "خدمات الصحة" في "متجر Google Play"، ويمكن التحقّق من توفّرها من خلال إمكانات التمارين الرياضية. ملاحظة: تسري أوضاع التجميع عندما يكون الجهاز في حالة طاقة غير تفاعلية، وسيؤدي ذلك إلى زيادة استهلاك الطاقة.

تغييرات واجهة برمجة التطبيقات

• عرض الخطأ HealthServicesException عند تعذُّر تنفيذ دالة التعليق overrideBatchingModesForActiveExercise (Ifd387)
• تم تقديم وظائف تعليق لواجهة برمجة التطبيقات غير المتزامنة overrideBatchingModesForActiveExercise، ما يجعلها أكثر توافقًا مع لغة Kotlin (I7dd15)
• BatchingMode تجاوزات اختيارية في ExerciseConfig (Id22e9)

إصلاح الأخطاء

• إصلاحات صغيرة في DataType وExerciseUpdate (5e185f)

الإصدار ‎1.0.0-beta02

‫11 يناير 2023

تم طرح androidx.health:health-services-client:1.0.0-beta02. يتضمّن الإصدار 1.0.0-beta02 هذه التعديلات.

الميزات الجديدة

• تمت إضافة دوال الإضافة suspend لواجهات برمجة التطبيقات غير المتزامنة الحالية ListenableFuture في ExerciseClient وPassiveMonitoringClient وMeasureClient لتوفير دعم أفضل للغة Kotlin. (Iadea4)
• تمت إضافة واجهة برمجة التطبيقات ExerciseTypeConfig التي تتيح إجراء التحديثات أثناء ممارسة التمارين. تمت إضافة GolfExerciseTypeConfig للسماح بتعديل ExerciseTypeConfig أثناء تمارين الغولف. (I4c539)

تغييرات واجهة برمجة التطبيقات

• عرض HealthServicesException في دوال التعليق (I5e509)
• إضافة أداة إنشاء أخرى للتوافق مع الأنظمة القديمة (Iddeda)
• طرح RuntimeException على دوال التعليق (I53bca)
• إزالة التنفيذ التلقائي لإنشاء استثناء (Id947f)
• جارٍ إضافة التعليق التوضيحي @JvmDefaultWithCompatibility (I8f206)

إصلاح الأخطاء

• إضافة kdoc لتوضيح المعنى (Ide285)
• السماح بتتبُّع المراقبة غير النشطة للأهداف فقط في حال تتبُّع أنواع البيانات نفسها أيضًا (Ibed8d)

الإصدار ‎1.0.0-beta01

‫24 أكتوبر 2022

تم طرح androidx.health:health-services-client:1.0.0-beta01. يتضمّن الإصدار 1.0.0-beta01 هذه التعديلات.

الميزات الجديدة

• تمّت إضافة إمكانية الاستماع إلى أحداث الصحة من خلال PassiveMonitoringClient، مع العلم أنّ الحدث الأول هو: HealthEvent.FALL_DETECTED.

• New ExerciseTypes:

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

• New DataTypes:

  • ELEVATION_LOSS
  • GOLF_SHOT_COUNT

تغييرات واجهة برمجة التطبيقات

• تعديل طريقة تصميم البيانات: تم تعديل نموذج البيانات وطريقة تمثيل DataType وDataPoint والقيم الأساسية لهما. والتأثير الأهم هو أنّ واجهات برمجة التطبيقات أصبحت الآن أكثر وضوحًا وأمانًا من حيث النوع.
• لم تعُد المواقع الجغرافية DataPoint تُعرض كـ DoubleArray، بل كعنصر LocationData ذي نوع محدّد.
• تم الانتقال إلى مجموعة جديدة من واجهات برمجة التطبيقات الخاصة بأدوات الاستماع غير النشطة:
  • تم استبدال البث بـ "PassiveListenerService".
  • تم استبدال أدوات المعالجة الحالية بأداة معالجة واحدة: PassiveListenerCallback.
• تمت إضافة العلامة <queries> إلى بيان "خدمات الصحة" لكي لا تحتاج التطبيقات إلى تحديد ذلك في البيان الخاص بها (شرط أن يكون دمج البيانات مفعَّلاً في نظام الإصدار).
• تمت إزالة العديد من ExerciseStates للإشارة إلى أنّ التمرين سينتهي أو انتهى، وتمت إضافة حالتين جديدتين للتمرين ENDING وENDED. يتم الآن دمج هذه القيم مع ExerciseEndReason لتمثيل النطاق الكامل للحالات السابقة.
• تمت إعادة تسمية PassiveListenerConfig setPassiveGoals إلى setDailyGoals لتعكس بشكل أفضل أنّنا لا نتيح سوى الأهداف اليومية غير النشطة.
• PassiveGoals الآن دائمًا REPEATED، تمت إزالة TriggerFrequency السلبية.
• تمت إضافة تعليقات توضيحية إلى جميع المَعلمات Long وDouble باستخدام @FloatRange.
• تمت إضافة السمة swimmingPoolLengthMeters إلى ExerciseConfig التي يمكن تحديدها اختياريًا لتحسين عمليات احتساب المسافة عند السباحة في المسبح.
• تم إيقاف ExerciseUpdate.activeDuration نهائيًا. يمكنك استخدام ExerciseUpdate.activeDurationCheckpoint كبديل.
• تمت إعادة تسمية واجهة برمجة التطبيقات flushExerciseAsync() إلى flushAsync() في ExerciseClient.
• تمت إعادة تسمية Measure.registerCallback إلى Measure.registerMeasureCallback.
• تغييرات عامة في التسمية:
  • تحتوي سمات المسافة الآن على اللاحقة meters.
  • أصبحت أسماء طرق معاودة الاتصال بصيغة الماضي.
  • تمت إزالة معظم الاختصارات (أصبح HrAccuracy الآن HeartRateAccuracy).
  • تمت إعادة تسمية السمات التي تتّبع النمط enableFoo لتصبح isFooEnabled.
• تم نقل البيانات من Enums.
• أصبحت الأوقات التي يمثّلها Double يمثّلها الآن Duration.
• تعرض الدوال التي تعرض ListenableFuture<Void?> الآن ListenableFuture<Void>.
• إنّ الدوال التي تقبل دالة ردّ اتصال تظهر دائمًا كالمَعلمة الأخيرة.
• تتضمّن الفئات التي تتضمّن أدوات إنشاء الآن أيضًا طرق وضع التصميم العامة.
• لم تعُد دوال التسجيل تعرض ListenableFuture، بل تنقل حالة التسجيل إلى دالة رد الاتصال المقدَّمة.
• تم الآن تحسين مستندات KDocs.
• لم تعُد الحصص العلنية تمدّد ProtoParcelable.

إصلاح الأخطاء

• تحسينات عامة على موثوقية IPC (I3b1e2)

الإصدار ‎1.0.0-alpha03

‫3 نوفمبر 2021

تم طرح androidx.health:health-services-client:1.0.0-alpha03. يتضمّن الإصدار 1.0.0-alpha03 هذه التعديلات.

الميزات الجديدة

• ستعيد حزمة تطوير البرامج (SDK) تلقائيًا تسجيل طلبات تسجيل مقياس ومستمع للتمارين الرياضية وتسجيل معاودة الاتصال للمراقبة غير النشطة في حال انقطع الاتصال بين العمليات (IPC) مع حزمة APK لخدمات الصحة.

تغييرات واجهة برمجة التطبيقات

• تمت زيادة minSdkVersion لمكتبة حزمة تطوير البرامج (SDK) إلى المستوى 30 من واجهة برمجة التطبيقات لأنّ "خدمة Health Services Client" لا تتوافق حاليًا إلا مع Wear3.

الإصدار ‎1.0.0-alpha02

‫29 سبتمبر 2021

تم طرح androidx.health:health-services-client:1.0.0-alpha02. يتضمّن الإصدار 1.0.0-alpha02 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

• تتيح لك ميزة "ExerciseClient" الآن إعداد تمرين. يتيح ذلك للعملاء إعداد أجهزة الاستشعار والانتظار إلى أن يتم تحديد الموقع الجغرافي باستخدام نظام تحديد المواقع العالمي (GPS) قبل بدء التمرين.
• تضيف هذه الميزة فئتَي AggregateDataPoint‏ CumulativeDataPoints وStatisticalDataPoints لتحسين نمذجة المقاييس المجمَّعة التي يتم تتبُّعها أثناء ممارسة التمارين النشطة. تحتوي CumulativeDataPoints على قيم تراكمية لأنواع بيانات الفواصل الزمنية المجمَّعة (مثل إجمالي المسافة أثناء التمرين)، بينما تعرض StatisticalDataPoints نماذج لمجموعات من نقاط البيانات التي تم أخذ عيّنات منها (مثل الحد الأدنى والأقصى والمتوسط لـ HeartRateBpm). يحلّ هذا النوع محلّ AGGREGATE_* DataTypes السابق ويمكن الوصول إليه في ExerciseUpdate من خلال getLatestAggregateMetrics(). لم يعُد AGGREGATE_* DataTypes متاحًا.
• PassiveMonitoring تمت إعادة تسمية الأحداث إلى PassiveGoals التي تتيح تحديد الأهداف وتلقّي الإشعارات عند تحقيق هذه الأهداف لأنواع البيانات مثل المقاييس اليومية (أي DAILY_STEPS).
• تحسين نمذجة معدّل ضربات القلب ودقة الموقع الجغرافي ومدى توفّرهما من خلال تقديم الفئات الجديدة HrAccuracy وLocationAccuracy وLocationAvailability
• تحسين تسمية الحقلَين ExerciseConfig وPassiveMonitoringConfig الجديدَين وإضافة الحقل ExerciseConfig.shouldEnableGps لطلب بيانات تستند إلى نظام تحديد المواقع العالمي (GPS)

إصلاح الأخطاء

• نقل البيانات إلى بروتوكول IPC المستند إلى البروتوكول لتحسين التوافق مع الإصدارات السابقة

الإصدار ‎1.0.0-alpha01

‫18 أيار (مايو) 2021

تم طرح androidx.health:health-services-client:1.0.0-alpha01. يتضمّن الإصدار 1.0.0-alpha01 هذه التعديلات.

ميزات الإصدار الأوّلي

توفّر مكتبة "خدمات الصحة" مجموعة موحّدة من واجهات برمجة التطبيقات للمطوّرين لدمجها مع عمليات تنفيذ المستشعرات الخاصة بالأجهزة. ستعمل هذه الميزة فورًا مع محاكيات Wear OS 3 والأجهزة القادمة، وسيتم توفيرها على منصات إضافية في المستقبل. يتضمّن هذا الإصدار الأوّلي ثلاث مساحات عرض لواجهة برمجة التطبيقات على أعلى مستوى، وهي ExerciseClient وPassiveMonitoringClient وMeasureClient.

ExerciseClient

تم تصميم ExerciseClient للتطبيقات التي تتتبّع التمارين النشطة، مع ما يصل إلى 82 ExerciseType مختلفًا، بدءًا من المشي والجري وصولاً إلى الرقص وكرة الماء. أثناء تتبُّع هذه التمارين، تتوفّر مجموعة من 50 DataType مختلفًا حسب نوع التمرين والأجهزة المتوفّرة على الجهاز. للبدء، ما عليك سوى تحديد المعلومات ذات الصلة في ExerciseConfig، ثم الاتصال بـ exerciseClient.startExercise والاستماع إلى مستوى التقدّم في أداة معالجة التحديث.

PassiveMonitoringClient

يُعدّ PassiveMonitoringClient خيارًا رائعًا إذا كان تطبيقك يتتبّع نشاط المستخدم على مدار اليوم. يمكنك تسجيل PendingIntent مع مجموعة من DataTypes وتلقّي إشعار لتنفيذ التغييرات المجمّعة. بدلاً من ذلك، يمكنك تحديد Event، مثل بلوغ عدد معيّن من الخطوات.

MeasureClient

في بعض الأحيان، يحتاج المستخدم إلى قياس معدّل نبضات القلب في لحظة معيّنة، وليس أثناء ممارسة التمارين الرياضية أو على مدار اليوم. في هذه الحالات، يكون MeasureClient هو الخيار الأمثل، إذ ما عليك سوى تسجيل وظيفة رد الاتصال باستخدام DataType المتوافقة لتلقّي مجموعة من البيانات، وإلغاء تسجيل وظيفة رد الاتصال عندما لا تكون هناك حاجة إليها.