Health Connect

  
يتيح هذا الإذن للمطوّرين قراءة سجلّات الصحة واللياقة البدنية الخاصة بالمستخدم أو كتابتها.
آخر الأخبار الإصدار الثابت إصدار محتمل الإصدار التجريبي الإصدار الأولي
‫25 مارس 2026 1.1.0 - - 1.2.0-alpha03

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

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

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

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

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

رائع

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

Kotlin

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

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

الملاحظات

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

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

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

الإصدار التجريبي 1.0 من Health Connect

الإصدار ‎1.0.0-alpha03

‫9 أبريل 2025

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

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

  • سيحتفظ Metadata.populatedWithTestValues بالقيم الأصلية في حال عدم توفير عملية إلغاء. (I3ee27)
  • تعديل سجلّات التغيير فقط عند حذف السجلات الحالية (I74a16)

الإصدار ‎1.0.0-alpha02

‫26 فبراير 2025

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

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

  • إضافة MetadataTestHelper#populatedWithTestValues لاستخدامها في الاختبارات بعد إجراء تغييرات على البيانات الوصفية في androidx.health.connect:connect-client:1.1.0-alpha12 (I1f7f1)
  • إزالة التعليق التوضيحي ExperimentalTestingApi في connect-testing (I97a57)
  • إضافة رموز كاملة للسجلات والتغييرات في FakeHealthConnectClient (I15a4c)

الإصدار ‎1.0.0-alpha01

‫4 سبتمبر 2024

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

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

تسهّل مكتبة Health Connect Testing إنشاء اختبارات مبرمَجة. يمكنك استخدام هذه المكتبة للتحقّق من سلوك تطبيقك والتأكّد من أنّه يستجيب بشكل صحيح للحالات غير الشائعة التي يصعب اختبارها يدويًا.

يمكنك استخدام المكتبة لإنشاء اختبارات وحدة محلية تتحقّق عادةً من سلوك الفئات في تطبيقك التي تتفاعل مع عميل Health Connect.

نقطة الدخول إلى المكتبة هي الفئة FakeHealthConnectClient التي تستخدمها في الاختبارات لاستبدال HealthConnectClient. وتتضمّن الميزات التالية:

  • تمثيل السجلّات في الذاكرة، ما يتيح لك إدراجها وإزالتها وحذفها وقراءتها
  • إنشاء رموز مميّزة للتغيير وتتبُّع التغييرات
  • تقسيم السجلّات والتغييرات على صفحات
  • تتوفّر ردود التجميع مع عناصر نائبة
  • يسمح لأي دالة بعرض استثناءات
  • FakePermissionController يمكن استخدامه لمحاكاة عمليات التحقّق من الأذونات

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

  • إضافة FakeHealthConnectClient e8469
  • إضافة عمليات إلغاء Stub لـ FakeHealthConnectClient e8469

الإصدار 1.2

الإصدار ‎1.2.0-alpha03

‫25 مارس 2026

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

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

  • إضافة حقول جديدة إلى ExerciseSessionRecord وExerciseSegment لتوفير إمكانات أفضل لتتبُّع التمارين الرياضية (I3c176)

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

  • أضِف HealthConnectClient#getChanges(changeLogsToken, pageSize) لضبط حدّ أقصى مرن لعدد سجلّات التغيير التي يتم عرضها (I6837d)
  • إتاحة دعم مستوى النشاط في حزمة APK لتطبيق Health Connect (8c7923c)
  • تأجيل عمليات التحقّق من صحة السجلّ إلى النظام الأساسي على Android U+‎ (7682d18)

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

  • إصلاح عملية التجميع لمستوى الجهد عند النشاط واليقظة الذهنية (0b312833)

الإصدار 1.2.0-alpha02

‫8 أكتوبر 2025

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

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

  • إضافة تعدادات جديدة لأنواع الأجهزة (I86ce3)

الإصدار ‎1.2.0-alpha01

‫30 يوليو 2025

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

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

  • إضافة توافق مع الإصدارات السابقة لميزة "درجة حرارة الجلد" (d04b1df)
  • إضافة ميزة التوافق مع الإصدارات السابقة لتطبيق Mindfulness (444eda2)
  • إضافة واجهة برمجة التطبيقات Activity Intensity API لنظام التشغيل Android 14 والإصدارات الأحدث (d10f67b)

الإصدار 1.1

الإصدار 1.1.0

‫8 أكتوبر 2025

تمت ترقية الإصدار التجريبي androidx.health.connect:connect-client:1.1.0 وandroidx.health.connect:connect-client-external-protobuf:1.1.0 وandroidx.health.connect:connect-client-proto:1.1.0 إلى أول إصدار ثابت بدون أي تغييرات منذ إصدار RC السابق.

الإصدار ‎1.1.0-rc03

‫16 يوليو 2025

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

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

  • تم إصلاح IllegalArgumentException لعمليات التجميع على مستوى حدود التوقيت الصيفي. (Ic9e4f)

الإصدار ‎1.1.0-rc02

‫4 يونيو 2025

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

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

  • تمت إضافة دعم لأنواع الأجهزة غير المتوفّرة (Ied486)
  • تم تعديل سلسلة أذونات جلسات الاسترخاء (I13ab5)

الإصدار ‎1.1.0-rc01

‫23 أبريل 2025

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

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

  • أضفنا علامة توفّر ميزة "الوعي التام" للمطوّرين. (I936a8)

الإصدار 1.1.0-beta02

‫9 أبريل 2025

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

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

  • تمت إضافة واجهات برمجة تطبيقات تجريبية لسجلّ الصحة الشخصي (PHR) لقراءة البيانات الطبية وكتابتها، استنادًا إلى تنسيق Fast Healthcare Interoperability Resources (FHIR®). تشمل واجهات برمجة التطبيقات لسجلات الصحة الشخصية ما يلي:
    • ثابت FEATURE_PERSONAL_HEALTH_RECORD للتحقّق مما إذا كانت سجلات الصحة الشخصية متاحة من خلال واجهة برمجة التطبيقات الخاصة بتوفُّر الميزات
    • واجهات برمجة التطبيقات الخاصة بالتطبيقات التي تكتب مصادر البيانات والسجلات الطبية
    • واجهات برمجة التطبيقات للتطبيقات التي تقرأ مصادر وسجلات البيانات الطبية استنادًا إلى الأذونات التي يمنحها المستخدم
  • تمت إضافة واجهات برمجة تطبيقات تجريبية لسجلّ جلسات اليقظة (I51c13)، بما في ذلك:
    • واجهات برمجة التطبيقات الخاصة بالتطبيقات التي تكتب بيانات جلسات اليقظة والوعي التام
    • واجهات برمجة التطبيقات الخاصة بالتطبيقات التي تقرأ بيانات جلسات التأمّل الذهني استنادًا إلى الأذونات التي يمنحها المستخدم

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

  • في الإصدار U من نظام التشغيل Android والإصدارات الأحدث، تم استبدال عملية التحقّق من صحة القيم ElevationGainedRecord وFloorsClimbedRecord وHeartRateVariabilityRmssdRecord وHeightRecord وHydrationRecord وLeanBodyMassRecord وNutritionRecord وOxygenSaturationRecord وRespiratoryRateRecord وRestingHeartRateRecord وStepsRecord وTotalCaloriesBurnedRecord وVo2MaxRecord وWeightRecord وWheelchairPushesRecord التي كانت تجريها Jetpack بعملية التحقّق التي تجريها المنصة. (I0f40d)

الإصدار 1.1.0-beta01

‫12 مارس 2025

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

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

  • تفعيل عملية الاحتساب لجميع أنواع التجميع على جميع إصدارات Android (I8edf)

الإصدار ‎1.1.0-alpha12

‫26 فبراير 2025

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

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

  • جعل أداة إنشاء البيانات الوصفية داخلية (I1fb8f
  • تمت إزالة التعليق التوضيحي التجريبي لواجهة برمجة التطبيقات الخاصة بمدى توفّر الميزات. (I5b54f)
  • إضافة طرق إنشاء البيانات الوصفية (I8418b)
  • جعل طريقة التسجيل إلزامية عند إنشاء عناصر البيانات الوصفية (I3a13e)
  • جعل نوع الجهاز إلزاميًا عند إنشاء عناصر الجهاز (Ibc325)

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

  • تم إصلاح مشكلة عدم توفّر الأوصاف في خطوات التمارين الرياضية المخطَّط لها والفقرات. (I84039)
  • تعديل مستند Java الخاص بحدود قيم ضغط الدم (I8d3d4)
  • في الإصدار U والإصدارات الأحدث من نظام التشغيل Android، تم استبدال عملية التحقّق من صحة قيم سجلّ ضغط الدم في Jetpack بعملية التحقّق من صحة القيم في النظام الأساسي. (I08bf5)
  • أضِف مصادر البيانات المساهمة للنتائج المصنَّفة في مجموعات على نظام التشغيل Android U والإصدارات الأحدث. (Ie7651)

الإصدار ‎1.1.0-alpha11

‫15 يناير 2025

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

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

  • تم تعديل أذونات قراءة الخلفية والسجلّ لتتوافق مع الإصدار 13 من نظام التشغيل Android والإصدارات الأقدم.

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

  • تمت إضافة عمليات تحميل زائد مضمّنة ومحوّلة إلى كائن لكل من HealthPermission.getReadPermission وHealthPermission.getWritePermission (I59a2e)

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

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

الإصدار ‎1.1.0-alpha10

‫16 أكتوبر 2024

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

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

  • تمت إضافة SkinTemperature نوع من أنواع التجميع. (Ibe123)
  • تمت إضافة الثابت FEATURE_PLANNED_EXERCISE (Ie02a3)
  • تمت إضافة أذونات قراءة السجلّ. (I5cf41)
  • تمت إضافة واجهة برمجة تطبيقات خطط التدريب (If5be1)
  • تمت إضافة واجهة برمجة التطبيقات SkinTemperatureRecord. (I5605d)

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

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

الإصدار ‎1.1.0-alpha09

‫18 سبتمبر 2024

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

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

  • إضافة إذن القراءة في الخلفية، مع حماية هذا الإذن من خلال توفّر الميزة (I01036، I44db9)

الإصدار ‎1.1.0-alpha08

‫4 سبتمبر 2024

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

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

  • ضبط القيمة التلقائية لمتغيّر الميزات في HealthConnectClient (I788dc)
  • أضِف واجهة برمجة تطبيقات للتحقّق من مدى توفّر الميزات. (Iedd43)

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

  • عرض SDK_UNAVAILABLE في HealthConnectClient.getSdkStatus() عندما تكون قيمة HealthConnectManager فارغة في U+ 5802f
  • إضافة عمليات إلغاء toString إلى RecordClasses aa5dc
  • تمت إزالة التحديد اليدوي لإمكانية الوصول إلى واجهات برمجة التطبيقات الجديدة للمنصة لأنّ ذلك يحدث تلقائيًا من خلال تصميم واجهة برمجة التطبيقات عند استخدام R8 مع الإصدار 7.3 أو إصدار أحدث من "المكوّن الإضافي لنظام Gradle المتوافق مع Android" (مثل الإصدار 3.3 من R8)، وجميع عمليات الإنشاء عند استخدام الإصدار 8.1 أو إصدار أحدث من "المكوّن الإضافي لنظام Gradle المتوافق مع Android" (مثل الإصدار 8.1 من D8). ننصح العملاء الذين لا يستخدمون "مكوّن Android الإضافي لبرنامج Gradle" بالترقية إلى الإصدار 8.1 أو إصدار أحدث من D8. يُرجى مراجعة هذه المقالة للاطّلاع على مزيد من التفاصيل. (If6b4c، b/345472586)

الإصدار ‎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 هذه التعديلات.

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

  • في Java فقط: أعِد تسمية الحقل getHasMore() في ChangesResponse إلى hasMore(). (I80695)
  • توفير عملية التحقّق من توافق HealthPermissionsRequestContract#createIntent في جميع إصدارات Android يتحقّق العقد من أنّ جميع الأذونات هي أذونات مرتبطة بالصحة. (I143fc)

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

  • إصلاح الاستثناء الذي يتم طرحه عند إنشاء 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)

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

  • Fixed construction of Energy in kilojoules (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. تم تطوير هذا الإصدار في فرع داخلي.

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

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

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

  • التغييرات في Session API:
    • تمت إضافة مراحل النوم المختلفة إلى 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. أعِد تسمية "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 بشكلٍ متّسق في جميع واجهات برمجة التطبيقات ذات الصلة بإنشاء البيانات وقراءتها وتعديلها وحذفها. (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. (link)
  • أصبحت معرّفات UID الخاصة بالبيانات الوصفية أكثر سهولة بالنسبة إلى القرّاء، ولم تعُد تقبل القيم الفارغة. (link)
  • تمت إضافة الرطل إلى وحدة الكتلة (رابط)
  • تمت إعادة تسمية DeletionChange.deleteUid إلى uid (رابط)
  • أعِد تسمية Permission إلى HealthPermission. يساعد ذلك في تجنُّب الغموض بشأن أذونات Android Framework. (link)

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

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