Health Connect

  
تسمح للمطوّرين بقراءة سجلّات الصحة واللياقة البدنية للمستخدم أو كتابتها.
التعديل الأخير الإصدار المستقر سحب المرشح الإصدار التجريبي إصدار أولي
10 يناير 2024 - - - 1.1.0-alpha07

طلب الوصول إلى أنواع البيانات

لمساعدتنا في تعزيز خصوصية المستخدمين وأمانهم، على المطوّرين المندمجين مع Health Connect توضيح إذن الوصول للقراءة و/أو الكتابة في أنواع البيانات التي تستخدمها تطبيقاتهم. على المطوّرين تضمين حالات استخدام صالحة لأنواع البيانات التي يستخدمونها استنادًا إلى الغرض من التطبيق. لمزيد من المعلومات، يُرجى الانتقال إلى تقديم معلومات لنموذج بيان تطبيقات الصحة وأذونات تطبيق Health Connect من Android.

إعلان التبعيات

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

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

Groovy

dependencies {
    // Use to implement health connects
    implementation "androidx.health.connect:connect-client:1.1.0-alpha08"
}

Kotlin

dependencies {
    // Use to implement health connects
    implementation("androidx.health.connect:connect-client:1.1.0-alpha08")
}

لمزيد من المعلومات حول العناصر الاعتمادية، يُرجى الاطّلاع على إضافة تبعيات الإصدار.

ملاحظات

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

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

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

الإصدار 1.1

الإصدار 1.1.0-alpha07

10 يناير 2024

تم طرح androidx.health.connect:connect-client:1.1.0-alpha07. يحتوي الإصدار 1.1.0-alpha07 على هذه عمليات التنفيذ.

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

  • يمكنك عرض SDK_UNAVAILABLE عند استدعاء #getSdkStatus من سياق مستخدم الملف الشخصي. (I91df3)
  • إزالة SleepStageRecord (/If6ada)

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

  • يمكنك طرح RemoteException بدلاً من IllegalStateException في حال تعذُّر عملية الربط. (Id2233)

الإصدار 1.1.0-alpha06

18 تشرين الأول (أكتوبر) 2023

تم طرح androidx.health.connect:connect-client:1.1.0-alpha06. يحتوي الإصدار 1.1.0-alpha06 على هذه عمليات التنفيذ.

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

  • يجعل recordingMethod تعريفات علنية. (I401fb)

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

  • أضف وثائق إلى مسار التمرين لتحديد هذا الموقع يجب أن يكون قبل وقت انتهاء الجلسة. (0e51e6)

الإصدار 1.1.0-alpha05

‫4 أكتوبر 2023

تم طرح androidx.health.connect:connect-client:1.1.0-alpha05. يحتوي الإصدار 1.1.0-alpha05 على هذه عمليات التنفيذ.

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

  • تمت إضافة الغرض الذي ينقل إلى شاشة إدارة البيانات في Health Connect. (Ibf591)
  • تمت إزالة الطرق المتوقّفة نهائيًا في AggregationResult. (Idbda9)
  • تمت إضافة واجهة برمجة تطبيقات ملائمة لإنشاء ReadRecordsRequest وحذف السجلات وقراءتها مع استخدام نوع سجلّ محسَّن. (If58a5)

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

  • تم إصلاح خطأ في Android 14 يؤدي إلى عرض حقول التغذية الفارغة على شكل Double.MIN_VALUE. (1aa1d1)
  • تم إصلاح خطأ في Android 14 حيث كان التجميع حسب الفترة الشهرية أو السنوية يؤدي إلى استثناء في الاستجابة بسبب تجميع الحِزم وقت البدء/الانتهاء نفسه. (281313)

الإصدار 1.1.0-alpha04

6 أيلول (سبتمبر) 2023

تم طرح androidx.health.connect:connect-client:1.1.0-alpha04. يحتوي الإصدار 1.1.0-alpha04 على هذه عمليات التنفيذ.

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

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

  • إصلاح الاستثناء الذي يتم طرحه عند إنشاء ExerciseSessionRecord مع ExerciseRoute يحتوي على قائمة فارغة للمواقع الجغرافية (I45c16)
  • يمكنك تعديل مستندات SleepSessionRecord ورمز النموذج الخاص بقراءة جلسات النوم. (Idf0de)

الإصدار 1.1.0-alpha03

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

تم طرح androidx.health.connect:connect-client:1.1.0-alpha03. يحتوي الإصدار 1.1.0-alpha03 على هذه عمليات التنفيذ.

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

  • واجهة برمجة التطبيقات لقراءة وكتابة مسارات التمارين الرياضية:
    • تمّت إضافة ExerciseRouteResult إلى ExerciseSessionRecord.
    • تمّت إضافة "ExerciseRouteRequestContract"

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

  • تمت إضافة ExerciseRouteResult وفئاته الفرعية: Data وNoData وConsentRequiredStates.
  • تمت إضافة "ExerciseRoute" كفئة مستقلة تحتفظ ببيانات الموقع الجغرافي للمسار. (I22eed)
  • تمت إضافة "PERMISSION_WRITE_EXERCISE_ROUTE". (I92fc4)
  • تمت إضافة "ExerciseRouteRequestContract" و"HealthPermissionsRequestContract". (Ief0e5)

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

  • إصلاح بناء الطاقة بالكيلوجول (Ie8791)

الإصدار 1.1.0-alpha02

‫21 حزيران (يونيو) 2023

تم طرح androidx.health.connect:connect-client:1.1.0-alpha02. يحتوي الإصدار 1.1.0-alpha02 على عمليات التنفيذ هذه.

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

  • تم إصلاح تسرّب HealthDataSdkService (Ia3ba5)
  • عليك إعادة التوجيه دائمًا إلى برنامج HealthConnect الصحيح عند طلب الأذونات على Android U.(I6415a)

الإصدار 1.1.0-alpha01

7 حزيران (يونيو) 2023

تم طرح androidx.health.connect:connect-client:1.1.0-alpha01. تم تطوير هذا الإصدار في فرع داخلي.

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

  • يتوافق مع إصدار إطار عمل Android 14 من Health Connect. حزمة تطوير البرامج (SDK) هذه هي أحد المتطلّبات الأساسية لنظام التشغيل Android 14. لن يمكن دمج التطبيقات مع Health Connect على الإصدار 14 من نظام التشغيل Android بدونه.
  • تمت إضافة طريقة تسجيل لتسجيل البيانات الوصفية.

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

  • التغييرات في واجهة برمجة التطبيقات للجلسة:
    • تمت إضافة مراحل نوم مختلفة إلى "SleepSessionRecord" وإزالة "SleepStageRecord".
    • تمت إضافة ExerciseLap وExerciseSegment إلى ExerciseSessionRecord.
  • حدود المعدل الدورية واليومية (بما في ذلك حدود الذاكرة)، لعمليات القراءة وسجلّ التغييرات والإدراج والحذف.
  • تمت إضافة عملية التحقّق من جميع الحقول البالغ عددها NutritionRecord.
  • تمت إضافة عملية التحقّق من صحة HeartRateVariabilityRmssdRecord.
  • تمت إزالة واجهتَي برمجة تطبيقات متوقفتَين: HealthConnectClient#isProviderAvailable وHealthConnectClient#isApiSupported.

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

  • تم تثبيت وحدات المساواة بين الوحدات لجميع أنواع الوحدات، ولم تعُد تلك المساواة تعتمد على النوع المستخدَم في إعداد الوحدة. مثلاً: Mass.grams(1000) يساوي الآن Mass.kilograms(1).

الإصدار 1.0

الإصدار 1.0.0-alpha11

22 شباط (فبراير) 2023

تم طرح androidx.health.connect:connect-client:1.0.0-alpha11. يحتوي الإصدار 1.0.0-alpha11 على هذه عمليات التنفيذ.

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

  • إضافة نية لاستخدامها في فتح Health Connect. (Ic8055)
  • إزالة بعض أنواع التمارين. استخدِم EXERCISE_TYPE_STRENGTH_TRAINING أو EXERCISE_TYPE_HIGH_INTENSITY_INTERVAL_TRAINING أو EXERCISE_TYPE_CALISTHENICS بدلاً من الأنواع التي تمت إزالتها. (I7291c)
  • إضافة واجهة برمجة تطبيقات sdkStatus() جديدة تجمع بين واجهتَي برمجة التطبيقات isSdkSupported() وisProviderAvailable() المتوقفتَين حاليًا (Iac89d)
  • تغيير واجهات برمجة التطبيقات التي تقبل providerPackageName لقبول سلسلة واحدة بدلاً من قائمة (I67e0f)

الإصدار 1.0.0-alpha10

25 كانون الثاني (يناير) 2023

تم طرح androidx.health.connect:connect-client:1.0.0-alpha10. يحتوي الإصدار 1.0.0-alpha10 على هذه عمليات التنفيذ.

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

  • لم تعُد ExerciseEventRecord وExerciseLapRecord وExerciseRepititionRecord وSwimmingStrokesRecord متاحة باسم RecordTypes. لم يعُد من الممكن كتابتها أو قراءتها من "HealthConnect". أزِل أي إشارة إلى أنواع البيانات هذه من عملية دمج "HealthConnect". (If7ca2)
  • تغييرات في واجهات برمجة التطبيقات للأذونات لقبول الأذونات بتنسيق جديد يستند إلى سلسلة. يتطلّب هذا التغيير أيضًا تغيير بيان الأذونات إلى التنسيق العادي لأذونات Android. (Ib0a2f)

الإصدار 1.0.0-alpha09

11 كانون الثاني (يناير) 2023

تم طرح androidx.health.connect:connect-client:1.0.0-alpha09. يحتوي الإصدار 1.0.0-alpha09 على هذه عمليات التنفيذ.

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

  • تمت إضافة نوعَين جديدَين من البيانات الصحية للإناث إلى تطبيق Health Connect: IntermenstrualBleedingRecord وMenstruationPeriodRecord. MenstruationFlow.ENUMs هي خفيفة ومتوسطة وثقيلة وغير معروفة.

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

  • تمت إضافة IntermenstrualBleedingRecord (Idc470)
  • تمت إضافة نوع السجلّ MenstruationPeriodRecord (Iea545).

الإصدار 1.0.0-alpha08

7 كانون الأول (ديسمبر) 2022

تم طرح androidx.health.connect:connect-client:1.0.0-alpha08. يحتوي الإصدار 1.0.0-alpha08 على هذه عمليات التنفيذ.

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

  • تتم إضافة BodyWaterMass وHeartRateVariabilityRmssdRecord كأنواع سجلات متوافقة جديدة. (Ifd58f)
  • تتم إزالة HipCircumferenceRecord وWaistCircumferenceRecord على أنّها RecordTypes متوافقة. (I62fb9)
  • تم تغيير "MenstruationFlowRecord.flow" من stringdef إلى intdefs. (I0369f)
  • تم تغيير حقول السجلّ المشابهة للتعداد من خلال Strings إلى Integers لتحقيق أداء أفضل. (I3b295)
  • تم تغيير الحقول التي تشبه التعداد ExerciseSession وExerciseRepetitions وSleepStage من سلسلة إلى أنواع أعداد صحيحة. (Id32a9)
  • تمت إعادة تسمية "ExerciseSessionRecord.ACTIVE_TIME_TOTAL->EXERCISE_DURATION_TOTAL". (I5d7bd)
  • إضافة "غير عادي" إلى CervicalMucus تعدادًا. أعد تسمية "محو" إلى "البياض الأبيض" لمزيد من التحديد. تم تغيير CervicalMucus#appearance و #sensation من StringDefs إلى IntDefs. (I3ac51)
  • تم الآن نقل StringDef من إجمالي تعداد واحد (DeviceTypes) إلى IntDefs ضمن "الجهاز". (I3abf3)
  • تتم إضافة السمة HealthConnectClient.isApiSupported()، ما يؤدي إلى عرض خطأ في إصدارات حزمة تطوير البرامج (SDK) بدون عمليات تنفيذ متوافقة. تمت إعادة تسمية "HealthConnectClient.isAvailable->isProviderAvailable". (I3674e)

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

  • عدم السماح بقيم HeartRate beatsPerMinute الأقل من 1 (I6052f)
  • إضافة تعليق توضيحي @JvmDefaultWithCompatibility (I8f206)

الإصدار 1.0.0-alpha07

24 تشرين الأول (أكتوبر) 2022

تم طرح androidx.health.connect:connect-client:1.0.0-alpha07. يحتوي الإصدار 1.0.0-alpha07 على هذه عمليات التنفيذ.

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

  • يتم وضع وسيطات السجلّ التي لا تحتوي على قيم تلقائية قبل الوسيطات ذات القيم التلقائية. لتحقيق الاتساق، يتم دائمًا وضع وسيطة Instant وZoneOffset في البداية. (Id618c)
  • إعادة تسمية "HealthConnectClient.getOrCreate#packageNames" إلى "providerPackageNames" (Id81e4)

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

  • تتم إضافة عمليات التحقق من صحة قيم حقل السجلّ. ستعرض القيم الخاطئة تمامًا IllegalArgumentExceptions عندما تكون القيمة المقدمة خارج الحدود المعقولة. (Ie171d)
  • تتحقق من وقت بدء السجلّ قبل وقت الانتهاء عند الاقتضاء. (I02460)

الإصدار 1.0.0-alpha06

5 تشرين الأول (أكتوبر) 2022

تم طرح androidx.health.connect:connect-client:1.0.0-alpha06. يحتوي الإصدار 1.0.0-alpha06 على هذه عمليات التنفيذ.

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

  • يحسّن دورة حياة اتصال الخدمة. (If2bd5)
  • إصلاح خطأ تعطّل NPE عند حدوث استثناء في اتصال الخدمة (I13546)

الإصدار 1.0.0-alpha05

21 أيلول (سبتمبر) 2022

تم طرح androidx.health.connect:connect-client:1.0.0-alpha05. يحتوي الإصدار 1.0.0-alpha05 على هذه عمليات التنفيذ.

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

  • تمت إعادة التسمية Metadata.uid -> Metadata.id واستخدمنا المصطلحات recordId بشكل متّسق في واجهات برمجة تطبيقات CRUD ذات الصلة. (I3d1d2)
  • تم إنشاء طريقة PermissionController.createRequestPermissionActivityContract كطريقة ثابتة بدلاً من طريقة مثيل. تغيّر الاسم إلى "PermissionController.createRequestPermissionResultContract". (Icd2fe)
  • تمت إضافة نوع الوحدة BloodGlucose لـ BloodGlucoseRecord (I97678)
  • إعادة تسمية MenstruationRecord -> MenstruationFlowRecord (I3b88e)

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

  • إصلاح السلوك غير المقصود الذي لا يؤدي إلى نشر الإحصاءات التي تعمل في المقدّمة من عملية العميل (Ifb44c)

الإصدار 1.0.0-alpha04

24 آب (أغسطس) 2022 تم طرح androidx.health.connect:connect-client:1.0.0-alpha04. يحتوي الإصدار 1.0.0-alpha04 على عمليات التنفيذ هذه.

نقل البيانات إلى "androidx.health.connect

اعتبارًا من الإصدار 1.0.0 -alpha04، تم نقل androidx.health:health-connect-client إلى androidx.health.connect:connect-client بالنسبة إلى الإصدارات السابقة من Health اتصال، يُرجى الانتقال إلى androidx.health .

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

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

  • تضمين سجلات تصحيح أخطاء اختيارية مدمجة في طلبات البيانات من واجهة برمجة التطبيقات (رابط)

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

  • تمت إعادة تسمية البيانات الوصفية clientId إلى clientRecordId، وclientVersion إلى clientRecordVersion. (الرابط)
  • تم جعل البيانات الوصفية أكثر سهولة في القراءة للقراء، ولم تعُد قابلة للإلغاء. (الرابط)
  • تمت إضافة الرطل إلى الوحدة الكتلة (الرابط)
  • تمت إعادة تسمية DeletionChange.deleteUid إلى uid (الرابط).
  • إعادة تسمية الإذن -> HealthPermission. يساعد ذلك في تجنُّب الغموض في أذونات إطار عمل Android. (الرابط)

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

  • تم إصلاح مشاكل الانحدار المرتبطة بوحدة السعرات الحرارية غير الصحيحة في "الطاقة" (الرابط).
  • تم إصلاح مشكلة الانحدار المرتبطة بالتجميع لبعض أنواع السجلّات (الرابط).