صحة

  
إنشاء تطبيقات صحية فعّالة بطريقة لا تتمحور حول النظام الأساسي
آخر تعديل الإصدار المستقر إصدار مرشح الإصدار التجريبي الإصدار الأولي
13 كانون الأول (ديسمبر) 2023 - 1.0.0-rc01 - 1.1.0-alpha02

تعريف التبعيات

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

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

رائع

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

Kotlin

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

ملاحظات

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

إنشاء عدد جديد

راجع مستندات أداة تتبُّع المشاكل للحصول على مزيد من المعلومات.

الإصدار 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)
  • تمت إضافة نوع وحدة الطاقة. تم نقل فئة سلسلة الطاقة داخل فئة 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
  • تمت إضافة لاحقة "السجلّ" إلى جميع أسماء فئات السجلّات (I1ffc2).

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

  • يجب حلّ المشاكل المتعلقة بالاحتياطات عند إنشاء مكتبة بنكهة الإصدار و"minifyEnabled" صحيح. (I78933)
  • لإخفاء المستندات غير المخصّصة للاستخدام العام. (I7a08f)
  • إصلاح المشكلة في العملاء الذين قد يكون لديهم تبعيات خاصة بهم للنموذج الأوّلي.(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)

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

  • يجب تقليل متطلبات حزمة تطوير البرامج (SDK) إلى 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-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 من برنامج Health Services Client

الإصدار 1.0.0-rc01

26 تموز (يوليو) 2023

تم إصدار "androidx.health:health-services-client:1.0.0-rc01". يحتوي الإصدار 1.0.0-rc01 على هذه الالتزامات.

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

  • تم نقل الخدمات الصحية إلى الإصدار 1.0.0-rc01 بعد تثبيتها في الإصدار التجريبي.

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

  • تم دمج ملفات واجهة برمجة التطبيقات العامة والتجريبية لمسارات m-th. (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.

  • أنواع التمارين الجديدة:

    • ALPINE_SKIING
    • BACKPACKING
    • CROSS_COUNTRY_SKIING
    • HORSE_RIDING
    • INLINE_SKATING
    • MOUNTAIN_BIKING
    • ORIENTEERING
    • ROLLER_SKATING
    • YACHTING
  • أنواع البيانات الجديدة:

    • ELEVATION_LOSS
    • GOLF_SHOT_COUNT

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

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

MeasurementClient

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