الصحة

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

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

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

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

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

الملاحظات

تساعدنا ملاحظاتك في تحسين 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)
• تم إصلاح المشكلة في العملاء الذين قد يعتمدون على بروتوكول buffer الخاص بهم.(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-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 الأساسية للمطوّرين إمكانية طلب تلقّي إشعار عندما ترصد الساعة حدوث أمر ما. 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 إلى الإصدار الثابت من Health Services Client. ما مِن تغييرات مقارنةً بالإصدار 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 هذه التعديلات. هذا الإصدار مخصّص لإصلاح الأخطاء فقط ولا يتضمّن أي تغييرات في واجهة برمجة التطبيقات.

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

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

الإصدار 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 لأنّ "خدمات الصحة" متاحة حاليًا على Wear3 فقط.

الإصدار ‎1.0.0-alpha02

‫29 سبتمبر 2021

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

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

• تتيح لك ميزة "ExerciseClient" الآن إعداد تمرين. يتيح ذلك للعملاء إعداد أجهزة الاستشعار والانتظار إلى أن يتم تحديد الموقع الجغرافي باستخدام نظام تحديد المواقع العالمي (GPS) قبل بدء التمرين.
• تضيف هذه السمة فئتَي CumulativeDataPoints وStatisticalDataPoints AggregateDataPoint لتوفير نموذج أفضل للمقاييس المجمَّعة التي يتم تتبُّعها أثناء ممارسة التمارين النشطة. تحتوي 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 المتوافقة لتلقّي مجموعة من البيانات، وإلغاء تسجيل وظيفة رد الاتصال عندما لا تكون هناك حاجة إليها.