Health Connect

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

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

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

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

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

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

رائع

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

Kotlin

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

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

ملاحظات

تساعدنا ملاحظاتك في تحسين 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 على نظام Android 14 بدونه.
  • تمت إضافة طريقة التسجيل لتسجيل البيانات الوصفية.

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

  • التغييرات في واجهة برمجة التطبيقات للجلسة:
    • تمت إضافة مراحل نوم مختلفة إلى "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)
  • تم تغيير حقول Record التي تشبه التعداد باستخدام Strings إلى Integers للحصول على أداء أفضل. (I3b295)
  • تم تغيير حقول ExerciseSession وExerciseRepetitions وSleepStage من الحقول التي تشبه التعداد من السلسلة إلى أنواع الأعداد الصحيحة. (Id32a9)
  • تمت إعادة تسمية ExerciseSessionRecord.ACTIVE_TIME_TOTAL->EXERCISE_DURATION_TOTAL. (I5d7bd)
  • إضافة "غير معتاد" إلى CervicalMucus من التعدادات. أعد تسمية "Clear" (مسح) إلى "Eggwhite" (البيضاء) لمزيد من الدقة. تم تغيير CervicalMucus#appearance و #sensation من StringDefs إلى IntDefs. (I3ac51)
  • تم الآن نقل StringDef من إجمالي DeviceTypes تعداد إلى IntDefs ضمن "الجهاز". (I3abf3)
  • تضيف السمة HealthConnectClient.isApiSupported()، التي تعرض القيمة "false" في إصدارات حزمة 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 Connect، يُرجى الانتقال إلى صفحة 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. (الرابط)

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

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