ملاحظات حول إصدار حزمة تطوير البرامج (SDK) لنظام التشغيل Android من Home APIs

2025-09-08

تم طرح الإصدار 1.4.1 من تطبيق Sample App لنظام التشغيل Android.

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

  • إنشاء غرفة وإعادة تسميتها وتعديلها وحذفها
  • الربط بشبكة Matter تابعة لجهة خارجية

المشاكل المعروفة التي تم إصلاحها

  • أصبح رابط صفحة إبطال الأذونات يعمل الآن.

2025-08-29

  الإصدار 1.4.1 من الإصدار التجريبي العلني لواجهات برمجة التطبيقات Home APIs  

يحتوي هذا الإصدار على إصلاحات للأخطاء وتحسينات في جودة الإصدار التجريبي من حزمة تطوير البرامج (SDK) لنظام التشغيل Android الخاصة بواجهات برمجة التطبيقات Home.

الحد الأدنى للإصدارات

  • خدمات Google Play: الإصدار 25.33.32
  • الحد الأدنى لإصدارات البرامج الثابتة في Google Hub:
    • Cast: 3.76.495998
    • Fuchsia: 27.20250422.103.3600
  • ‫Android SDK: home.android.sdk_1_4_1
  • تطبيق Google Home: يعمل مع أي إصدار
  • androidx.core المكتبة: تعمل مع أي إصدار
  • إصدار Matter: 1.4.0.0

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

المشاكل المعروفة

  • عند إزالة الجهاز المحوري النشط حاليًا بشكل إجباري، ستكون هناك فترة خمس دقائق لا يمكن خلالها التحكّم في بعض الأجهزة. بعد خمس دقائق، ستتم استعادة إمكانية التحكّم في الأجهزة.

المشاكل المعروفة التي تم حلّها

  • يتعطّل تطبيق Android التجريبي عندما يحاول المستخدم ضبط منظم حرارة على وضع غير متوافق معه.

2025-07-31

  الإصدار التجريبي العلني 1.4.0 من Home APIs  

يحتوي هذا الإصدار على إصلاحات للأخطاء وتحسينات في جودة الإصدار التجريبي من حزمة تطوير البرامج (SDK) لنظام التشغيل Android الخاصة بواجهات برمجة التطبيقات Home.

الحد الأدنى للإصدارات

  • خدمات Google Play: الإصدار 25.28.34
  • الحد الأدنى لإصدارات البرامج الثابتة في Google Hub:
    • الإصدار: 3.76.486931
    • Fuchsia: 27.20250422.103.3600
  • حزمة تطوير البرامج (SDK) لنظام التشغيل Android: home.android.sdk_1_4_0
  • تطبيق Google Home: يعمل مع أي إصدار
  • androidx.core المكتبة: تعمل مع أي إصدار
  • إصدار Matter: 1.4.0.0

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

المشاكل المعروفة

  • بعد تسجيل الخروج من الهاتف ثم تسجيل الدخول مرة أخرى، لا يمكن لتطبيق Home APIs التحكّم في الأجهزة.
    • الحلّ البديل: أغلق التطبيق أو شغِّله في الخلفية، ثم انتظِر 10 ثوانٍ على الأقل قبل إعادة المحاولة.

المشاكل المعروفة التي تم حلّها

  • لا تسجّل أجهزة المكنسة الكهربائية التي تم إرساؤها الحالة "تم الإرساء".

2025-07-08

باستخدام إصدار البرنامج الثابت 3.76.479819 من Cast، يمكن لجهاز Nest WiFi Pro الآن العمل كمركز لواجهات برمجة التطبيقات الخاصة بمنزل Google.

2025-06-26

  الإصدار 1.3.2 من الإصدار التجريبي العام لواجهات برمجة التطبيقات Home APIs  

يحتوي هذا الإصدار على إصلاحات للأخطاء وتحسينات في جودة الإصدار التجريبي من حزمة تطوير البرامج (SDK) لواجهات برمجة التطبيقات الخاصة بمنصة Home على نظام التشغيل Android.

الحد الأدنى للإصدارات

  • الإصدار 25.23.31 من "خدمات Google Play"
  • الحد الأدنى لإصدارات البرامج الثابتة في Google Hub:
    • البث:
      • ‫Google Home وGoogle Home Mini وGoogle Nest Mini: الإصدار 3.75.468362
      • ‫Google Nest Audio: 3.75.476451
    • ‫Fuchsia: 26.20250116.103.2900
  • ‫Android SDK: home.android.sdk_1_3_2
  • تطبيق Google Home: يعمل مع أي إصدار
  • androidx.core المكتبة: تعمل مع أي إصدار
  • إصدار Matter: 1.4.0.0

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

  • تم تقسيم عنصر حزمة تطوير البرامج (SDK) إلى عنصرَين منفصلَين:
    • إطار عمل حزمة تطوير البرامج (SDK) لواجهات برمجة التطبيقات الخاصة بالمنزل (play-services-home-17.0.0.aar)
    • سمات حزمة تطوير البرامج (SDK) وأنواع الأجهزة (play-services-home-types-17.0.0.aar)

    اعتبارًا من هذا الإصدار، على المطوّرين تضمين كلتا السمتَين في مسارات مكتبة وقت التشغيل ووقت التجميع الخاصة بمشاريعهم.

نموذج تطبيق Android

  • يمكن للمستخدمين قطع الاتصال وإبطال الأذونات من التطبيق.
  • تم تعديل عناصر حزمة SDK لتشمل play-services-home-17.0.0 وplay-services-home-types-17.0.0.

المشاكل المعروفة

  • لا تسجّل أجهزة المكنسة الكهربائية التي تم إرساؤها الحالة "تم الإرساء".

2025-06-05

  الإصدار 1.3.1 من الإصدار التجريبي العام لواجهات برمجة التطبيقات Home APIs  

يحتوي هذا الإصدار على إصلاحات للأخطاء وتحسينات في جودة الإصدار التجريبي من حزمة تطوير البرامج (SDK) لواجهات برمجة التطبيقات الخاصة بمنصة Home على نظام التشغيل Android.

الحد الأدنى للإصدارات

  • خدمات Google Play: الإصدار 25.19.32
  • الحد الأدنى لإصدارات البرامج الثابتة في Google Hub:
    • Cast: 3.75.468222
    • Fuchsia: 26.20250116.103.2201
  • حزمة تطوير البرامج (SDK) لنظام التشغيل Android: home.android.sdk_202505_EAP_1_3_1_RC06
  • تطبيق Google Home: يعمل مع أي إصدار
  • androidx.core المكتبة: تعمل مع أي إصدار
  • إصدار Matter: 1.4.0.0

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

السمات

  • تتضمّن هذه السمة SyntheticSwitch التي تسهّل التعامل مع الأحداث التي تنشئها أجهزة Matter Switch وتتيح لمفاتيح التحكّم تشغيل أدوات بدء التشغيل التلقائي.
  • تتضمّن السمة ExtendedDoorLock تغييرًا غير متوافق، وهو أنّه تم تغيير نوع بيانات الحقل user_id من String إلى Long. يمكنك الاطّلاع على

    يجب إعادة تجميع التطبيقات التي تستخدم هذه السمة.

نموذج تطبيق Android

تمت إضافة دوال لتسجيل حالة البُنى والأجهزة والأنواع والسمات وعمليات التشغيل الآلي لتسهيل عملية تصحيح الأخطاء.

المشاكل المعروفة

في تطبيق Android التجريبي، يتطلّب الزر إنشاء عملية تشغيل آلي أحيانًا النقر عليه عدة مرات لتشغيله.

المشاكل المعروفة التي تم إصلاحها

  • يتعطّل تطبيق Google Home عند إنشاء عمليات تشغيل آلي إذا لم يتم ضبط الموقع الجغرافي للمنزل في تطبيق Google Home (راجِع مقالة تغيير عنوان المنزل على Google لمعرفة كيفية ضبط الموقع الجغرافي للمنزل).FailedPreconditionException
  • في تطبيق Android التجريبي، كان يتم عرض جهاز يتضمّن connectivityState PARTIALLY_ONLINE للمستخدم على أنّه غير متصل بالإنترنت. ويتم تمثيل هذه الحالة الآن على أنّها متصل.

2025-05-12

  الإصدار 1.3 من الإصدار التجريبي العام لواجهات Home APIs  

يحتوي هذا الإصدار على إصلاحات للأخطاء وتحسينات في جودة الإصدار التجريبي من حزمة تطوير البرامج (SDK) لواجهات برمجة التطبيقات الخاصة بمنصة Home على نظام التشغيل Android.

الحد الأدنى للإصدارات

  • خدمات Google Play: الإصدار 25.16.33
  • الحد الأدنى لإصدارات البرامج الثابتة في Google Hub:
    • Cast: 3.75.468222
    • Fuchsia: 26.20250116.103.2201
  • حزمة تطوير البرامج (SDK) لنظام التشغيل Android: home.android.sdk_202504_EAP_1_3_RC00
  • تطبيق Google Home: يعمل مع أي إصدار
  • androidx.core المكتبة: تعمل مع أي إصدار
  • إصدار Matter: 1.4.0.0

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

  • Automation API
    • تمت إضافة إمكانية استخدام مشغّلات الأحداث المجدوَلة المتكرّرة، ما يتيح للمطوّرين إنشاء عمليات تشغيل آلي تعمل بشكل دوري استنادًا إلى الوقت الفعلي والوقت الشمسي والشروط المستندة إلى التقويم، وذلك باستخدام تعبيرات cron.
  • واجهة برمجة التطبيقات الخاصة بالأجهزة
    • تمت إضافة إمكانية إعادة تسمية الأجهزة. اطّلِع على مقالة تغيير اسم جهاز.
  • Structure API

المشاكل المعروفة

يتعطّل تطبيق Google Home عند إنشاء عمليات تشغيل آلي إذا لم يتم ضبط موقع المنزل في تطبيق Google Home (راجِع مقالة تغيير عنوان المنزل على Google لمعرفة كيفية إجراء ذلك).FailedPreconditionException

  • الحل البديل: تأكَّد من توفّر عنوان المنزل باستخدام Discovery API قبل محاولة إنشاء عمليات التشغيل الآلي.

المشاكل المعروفة التي تم إصلاحها

  • قد يزداد وقت استجابة أدوات التحكم بالجهاز عند التبديل من شبكة Wi-Fi إلى شبكة جوّال.
  • بعد إعادة ضبط الجهاز المركزي على الإعدادات الأصلية، قد تظهر الأجهزة على أنّها غير متصلة بالإنترنت.

2025-04-09

  الإصدار التجريبي العلني 1.2.1 من Home APIs  

يحتوي هذا الإصدار على إصلاحات للأخطاء وتحسينات في جودة الإصدار التجريبي من حزمة تطوير البرامج (SDK) لواجهات برمجة التطبيقات الخاصة بمنصة Home على نظام التشغيل Android.

الحد الأدنى للإصدارات

  • خدمات Google Play: الإصدار 25.09.33
  • الحد الأدنى لإصدارات البرامج الثابتة في Google Hub:
    • Cast: 3.75.468222
    • ‫Fuchsia: 24.20241009.103.19006011
  • حزمة تطوير البرامج (SDK) لنظام التشغيل Android: home.android.sdk_202503_EAP_1_2_1_RC02
  • تطبيق Google Home: يعمل مع أي إصدار
  • مكتبة androidx.core: الإصدار 1.10.0
  • إصدار Matter: 1.4.0.0
1. نحن بصدد طرح هذا الإصدار في مرحلة الإنتاج، وسيكون متاحًا على جميع الأجهزة بحلول 22 أبريل 2025.

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

  • تحسين الأداء عند تحميل العناصر من قاعدة بيانات Home Graph
  • Automation API
    • تمت إضافة إمكانية استخدام فلاتر الكيانات، ما يتيح عمليات التشغيل الآلي اختيار الأجهزة ديناميكيًا استنادًا إلى المعايير المحدّدة في عملية التشغيل الآلي.
  • واجهة برمجة التطبيقات الخاصة بالأجهزة
    • تتوفّر الآن معلومات الأجهزة من السحابة الإلكترونية إلى السحابة الإلكترونية في BasicInformationTrait.

المشاكل المعروفة

  • قد يزداد وقت استجابة أدوات التحكم بالجهاز عند التبديل من شبكة Wi-Fi إلى شبكة جوّال.
  • بعد إعادة ضبط الجهاز المركزي على الإعدادات الأصلية، قد تظهر الأجهزة على أنّها غير متصلة بالإنترنت.

المشاكل المعروفة التي تم حلّها

  • إذا تم استدعاء Discovery API قبل اكتمال عملية التهيئة أو قبل اكتمالها، سيتم عرض HomeException مع code 14: UNKNOWN والرسالة "لم يتم العثور على مسار".
  • في بيئة تحتوي على عدة بنى وعدة مستخدمين، قد يؤدي التبديل بين البنى والمستخدمين إلى عدم عرض أي أجهزة.

2025-03-14

  الإصدار التجريبي العلني 1.2.0 من Home APIs  

يحتوي هذا الإصدار على إصلاحات للأخطاء وتحسينات في جودة الإصدار التجريبي من حزمة تطوير البرامج (SDK) لواجهات برمجة التطبيقات الخاصة بمنصة Home على نظام التشغيل Android.

الحد الأدنى للإصدارات

  • الحد الأدنى لإصدار "خدمات Google Play": 25.06.32
  • الحد الأدنى لإصدارات البرامج الثابتة في Google Hub:
    • إصدار Cast: 3.75.456944
    • الحد الأدنى لإصدار Fuchsia: 24.20241009.103.1900601
  • حزمة تطوير البرامج (SDK) لنظام التشغيل Android: home.android.sdk_1_2_0_RC06
  • الحد الأدنى لإصدار تطبيق Google Home: يعمل مع أي إصدار
  • الحد الأدنى لإصدار مكتبة androidx.core: 1.10.0
  • إصدار Matter: 1.3.0.0
    • ملاحظة: لا تتوفّر أنواع أجهزة Matter المؤقتة ومجموعاتها.

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

  • Automation API:
    • إتاحة النطاقات الزمنية والتواريخ الجزئية في شروط التشغيل الآلي راجِع مقالة استخدام التواريخ مع بين.
    • في الإصدارات السابقة، كانت واجهة Discovery API تعرض NumberSetConstraint لبعض حقول الصور النقطية، بينما كان من المفترض أن تعرض BitmapConstraint. تعرض هذه الحقول الآن BitmapConstraint كما هو متوقّع. يقتصر ذلك على صور نقطية optionsMask وoptionsOverride في أوامر السمة LevelControl.

المشاكل المعروفة

  • قد يزداد وقت استجابة أدوات التحكم بالجهاز عند التبديل من شبكة Wi-Fi إلى شبكة جوّال.
  • بعد إعادة ضبط الجهاز المركزي على الإعدادات الأصلية، قد تظهر الأجهزة على أنّها غير متصلة بالإنترنت.
  • إذا تم استدعاء Discovery API قبل اكتمال عملية التهيئة أو قبل اكتمالها، سيتم عرض HomeException مع code 14: UNKNOWN والرسالة "لم يتم العثور على مسار".
    • الحلّ البديل: لا تستدعِ واجهة برمجة التطبيقات Discovery API إلا عندما تحتاج إلى مرشّحين للأتمتة. لا تجلب مسبقًا الكيانات المرشّحة وتخزّنها مؤقتًا. تحقَّق ممّا إذا كان أحد العناصر متصلاً بالإنترنت قبل استدعاء طرق Discovery API عليه.
  • في بيئة تحتوي على عدة بنى وعدة مستخدمين، قد يؤدي التبديل بين البنى والمستخدمين إلى عدم عرض أي أجهزة.

المشاكل المعروفة التي تم حلّها

  • في المرة الأولى التي يستدعي فيها تطبيق يستخدم واجهات برمجة تطبيقات Home الدالة HomeManager.structures() بعد تشغيله، يتلقّى صفرًا من البُنى، حتى في حال توفّر بنية واحدة أو أكثر. ويؤدي ذلك إلى إعطاء انطباع خاطئ بأنّه لا توجد منازل مرتبطة بحساب Google.
  • عند تحميل عمليات الإعداد التلقائي وإنشائها وتعديلها، قد يواجه المستخدمون أوقات انتظار طويلة.
  • على المستخدمين الذين يبدأون عملية الإعداد من تطبيق "الكاميرا" مسح رمز الاستجابة السريعة ضوئيًا مرتين لإكمال عملية إعداد Matter.
  • في بنية تحتوي على أكثر من 200 جهاز، قد لا تعرض واجهة برمجة التطبيقات Discovery أي أجهزة مرشّحة.

2025-01-29

  الإصدار التجريبي العلني 1.1.0 من واجهات برمجة تطبيقات Home  

يحتوي هذا الإصدار على إصلاحات للأخطاء وتحسينات في جودة الإصدار التجريبي من حزمة تطوير البرامج (SDK) لواجهات برمجة التطبيقات الخاصة بمنصة Home على نظام التشغيل Android.

الحد الأدنى للإصدارات

  • الحد الأدنى لإصدار "خدمات Google Play": 25.02.32
  • الحد الأدنى لإصدارات البرامج الثابتة في Google Hub:
    • إصدار Cast: 3.75.456944
    • الحد الأدنى لإصدار Fuchsia: 24.20241009.103.1900500
  • حزمة تطوير البرامج (SDK) لنظام التشغيل Android: home.android.sdk_202412_EAP_1_1_RC04
  • الحد الأدنى لإصدار تطبيق Google Home: يعمل مع أي إصدار
  • الحد الأدنى لإصدار مكتبة androidx.core: 1.10.0
  • إصدار Matter: 1.3.0.0
    • ملاحظة: لا تتوفّر أنواع أجهزة Matter المؤقتة ومجموعاتها.

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

  • ‫Streaming API:
    • توفّر هذه السمة مصادر بيانات الأحداث التي تُرسل إشعارات بشأن المباني والغرف والأجهزة التي تمت إضافتها أو تغييرها أو إزالتها.
    • اطّلِع على الاشتراك في أحداث علاقة الكيانات.
  • Batching API (تجريبية):

المشاكل المعروفة

  • عند تحميل عمليات الإعداد التلقائي وإنشائها وتعديلها، قد يواجه المستخدمون أوقات انتظار طويلة.
  • على المستخدمين الذين يبدأون عملية الإعداد من تطبيق "الكاميرا" مسح رمز الاستجابة السريعة ضوئيًا مرتين لإكمال عملية إعداد Matter.
  • في بنية تحتوي على أكثر من 200 جهاز، قد لا تعرض واجهة برمجة التطبيقات Discovery أي أجهزة مرشّحة.

المشاكل المعروفة التي تم حلّها

  • قد يتعذّر تبديل حساب Google الذي تم تسجيل الدخول إليه، ما يؤدي إلى حدوث خطأ.
  • قد لا تعمل أجهزة Google TV مع عمليات التشغيل الآلي التي تستخدم السمة MediaPlayback.
  • في بنية تتضمّن مركز Google فقط:
    • قد تظهر أجهزة Matter على أنّها غير متصلة بالإنترنت في تطبيق Google Home.
    • لا يمكن لـ "مساعد Google" التحكّم في أجهزة Matter.
    • لا يمكن للشاشات الذكية التحكّم في أجهزة Matter أو عرض حالة أي جهاز Matter.
  • في بعض الأجهزة، قد لا يعرض التطبيق الحالة الدقيقة دائمًا، وقد يبلغ تطبيقك عن حالة مختلفة عن تلك التي يبلغ عنها تطبيق Google، مثل تطبيق Google Home. ويرجع ذلك عادةً إلى أنّ الأجهزة لا تبلغ Google بالحالة.
    • الحلّ البديل: التحقّق من الولاية باستخدام أحد تطبيقات Google يحلّ مشكلة عدم التطابق.

2025-01-14

تم تعديل الإرشادات المتعلّقة بتهيئة واجهات برمجة التطبيقات في Home.

أوضحنا بشكل أكبر أنّه يجب ضبط مثيل من Home كعنصر فردي في سياق. يضمن ذلك توفير تجربة أكثر سلاسة للمستخدمين في تطبيقك وتجنُّب حدوث أخطاء في الجلسات غير الصالحة.

2025-01-07

  إصدار تجريبي عام لواجهات برمجة التطبيقات Home APIs  

خلال برنامج الإصدار التجريبي المفتوح للمطوّرين، يمكن لجميع المطوّرين البدء في إنشاء تطبيقاتهم واختبارها.

يحتوي هذا الإصدار على إصلاحات للأخطاء وتحسينات على جودة الإصدار التجريبي لحزمة تطوير البرامج (SDK) لواجهات برمجة تطبيقات Home على Android، بما في ذلك تحسين التوافق مع أجهزة Google Nest Audio وGoogle TV.

الحد الأدنى للإصدارات

  • الحد الأدنى لإصدار "خدمات Google Play": 24.45.34
  • الحد الأدنى لإصدارات البرامج الثابتة في Google Hub:
    • إصدار Cast: 3.74.444798
    • الحد الأدنى لإصدار Fuchsia: 22.20240805.103.161
  • حزمة تطوير البرامج (SDK) لنظام التشغيل Android: home.android.sdk_202411_EAP_1_0_1_RC00
  • الحد الأدنى لإصدار تطبيق Google Home (GHA): يعمل مع أي إصدار
  • الحد الأدنى لإصدار مكتبة androidx.core: 1.10.0
  • إصدار Matter: 1.3.0.0
    • ملاحظة: لا تتوفّر أنواع أجهزة Matter المؤقتة ومجموعاتها.

المشاكل المعروفة

  • قد يتعذّر تبديل حساب Google الذي تم تسجيل الدخول إليه، ما يؤدي إلى حدوث خطأ.
    • الحل البديل: أعِد تشغيل عملية منح الأذونات أو أعِد تشغيل التطبيق.
  • قد لا تعمل أجهزة Google TV مع عمليات التشغيل الآلي التي تستخدم السمة MediaPlayback.
  • في بنية تتضمّن مركز Google فقط:
    • قد تظهر أجهزة Matter على أنّها غير متصلة بالإنترنت في تطبيق Google Home.
    • لا يمكن لـ "مساعد Google" التحكّم في أجهزة Matter.
    • لا يمكن للشاشات الذكية التحكّم في أجهزة Matter أو عرض حالة أي جهاز متوافق مع Matter.
  • في بعض الأجهزة، قد لا يعرض التطبيق الحالة بدقة دائمًا، وقد يعرض تطبيقك حالة مختلفة عن الحالة التي يعرضها تطبيق من Google، مثل تطبيق Google Home (GHA). ويحدث ذلك عادةً لأنّ الأجهزة لا تُبلغ Google بالحالة.
    • الحلّ البديل: التحقّق من الولاية باستخدام أحد تطبيقات Google يحلّ مشكلة عدم التطابق.

المشاكل المعروفة التي تم حلّها

  • قد يتعذّر إعداد الجهاز إذا تم تصغير التطبيق أثناء العملية.
  • قد تمنع مشكلة من جهة الخادم عبارات بدء التشغيل "Ok Google" من العمل في عمليات التشغيل الآلي.
  • عند استخدام مركز يعمل بنظام التشغيل Fuchsia ولا يتضمّن أي أجهزة متوافقة مع معيار Matter في البنية، إذا ظل المركز غير نشط لمدة تزيد عن 3 ساعات، سيؤدي إعداد أول جهاز متوافق مع معيار Matter إلى عدم اتصال الجهاز بالإنترنت.
  • بعد إعادة ضبط بيانات أحد المحاور على الإعدادات الأصلية، قد يتعذّر إرسال الأوامر إلى الأجهزة التي تم إعدادها حديثًا، على الرغم من الإبلاغ عن أنّ الجهاز متصل بالإنترنت.