تحديد المشاكل وحلّها

نموذج التطبيق

إذا واجهت أي مشاكل عند استخدام واجهات برمجة التطبيقات Home، يمكنك جمع السجلات لتحديد المشاكل وحلّها بشكلٍ أكبر. يتطلّب جمع السجلات من الجهاز الجوّال استخدام Xcode. إذا كنت بحاجة إلى مساعدة من Google، عليك جمع السجلّات من جهاز iOS ومن المحور، ثم فتح طلب دعم في أداة تتبُّع المشاكل مع تضمين المعلومات والسجلّات ذات الصلة.

جمع سجلّات iOS

يجب أن يكون جهازك الجوّال متصلاً بجهازك المحلي في جميع الخطوات التي تتضمّن Xcode.

يتم عرض سجلّات التطبيقات وسجلّات حِزم SDK ويمكن جمعها مباشرةً من داخل وحدة تحكّم Xcode. عندما يكون جهازك الجوّال متصلاً بجهازك المحلي وتشغّل التطبيق من خلال Xcode، تسجّل وحدة التحكّم تلقائيًا سجلّات الإخراج العادي (stdout) والخطأ العادي (stderr) وتنقلهما من طبقة التطبيق وحزمة Home SDK المدمجة. يوفّر ذلك طريقة مباشرة لمراقبة عمليات الإعداد في الوقت الفعلي وتفاعلات واجهة برمجة التطبيقات وأحداث حزمة تطوير البرامج (SDK) أثناء التطوير وتحديد المشاكل وحلّها.

جمع سجلّات الإضافة من Xcode

إذا واجهت أي مشاكل عند استخدام واجهات برمجة التطبيقات الخاصة بمنصة Home، يمكنك جمع السجلات لتحديد المشاكل وحلّها.

  1. في Xcode، انتقِل إلى Debug (تصحيح الأخطاء) في شريط القوائم العلوي، ثم انقر على Attach to Process by PID or Name (ربط عملية حسب رقم تعريف العملية أو اسمها).

    تصحيح أخطاء نموذج التطبيق

  2. ضمن رقم التعريف أو اسم العملية، اختَر MatterExtension وانقر على إرفاق.

    مثال على إضافة "استخدام التطبيق بدون تثبيت"

  3. ستظهر الرسالة في انتظار الإرفاق بـ MatterAddDeviceExtension على iPhone إذا نقرت على أعلى يسار الشاشة.

    حالة انتظار نموذج التطبيق

  4. انقر على علامة التبويب واختَر MatterAddExtension.

    نموذج تطبيق يضيف إضافة Matter

  5. ستسجّل وحدة التحكّم سجلّ الإضافة.

‫Sherlog: تتبُّع الأحداث على مستوى جميع حِزم البرامج

‫Sherlog هي خدمة تتبُّع في الوقت الفعلي تقدّم نظرة شاملة على التفاعلات بين البنية التحتية من Google وخدمات الشركاء السحابية.

شرط أساسي: يتطلّب التتبُّع استخدام حساب مشترك منسَّق من Google (مثل حساب مسجَّل في GReg أو حساب تجريبي).

الغرض الأساسي: تصحيح الأخطاء الوظيفية ومشاكل التكامل بين السحابة الإلكترونية والسحابة الإلكترونية (C2C) (مثل حالات تعذُّر ربط الحساب أو حالات الجهاز غير الصحيحة) بدون الحاجة إلى إجراء تغييرات على الرمز البرمجي للإنتاج

الإمكانات: توفّر هذه الأداة رسومات بيانية كاملة لطلبات RPC، وحِزم البيانات الخاصة بالطلبات والاستجابات، والبيانات الوصفية الخاصة بأهداف SYNC وEXECUTE وQUERY وAccount Linking.

سجلّات أجهزة مركز Fuchsia

يمكنك جمع السجلات من مراكز Fuchsia التالية باستخدام هذه الطريقة: * Google Nest Hub (الجيل الثاني) * Google Nest Hub Max

لتفعيل مركز لاسترداد السجلات المحلية، اتّبِع الخطوات التالية:

  1. أرسِل رسالة إلكترونية تتضمّن الرقم التسلسلي وطراز أجهزتك إلى المدير التقني للحسابات (TAM) في Google. يمكن العثور عليها مكتوبة بأحرف صغيرة أسفل الجهاز.
  2. بعد إضافتك إلى القائمة المسموح بها، عليك تفعيل الميزة باتّباع الخطوات التالية:
    • من "مركز التحكم":
      1. التمرير سريعًا لأسفل الشاشة من أعلاها
      2. انقر على رمز الإعدادات .
      3. العثور على إصدار Fuchsia: على جهاز Nest Hub (الجيل الثاني)، انتقِل إلى معلومات الجهاز > المعلومات الفنية > إصدار Fuchsia
      4. انقر على "إصدار Fuchsia"‏ 7 مرات. سيؤدي ذلك إلى تفعيل خيارات المطوّرين
      5. الرجوع إلى قائمة المستوى الأعلى
      6. انقر على "خيارات المطوّرين".
      7. انقر على "تسجيل الأنشطة مع الشريك".
    • سيتم تفعيل الميزة لمدة 24 ساعة. بعد ذلك، أعِد تفعيل ميزة التسجيل من الخطوة 5 فصاعدًا.
  3. احصل على عنوان IP الخاص بلوحة الوصل:
    • من الجهاز الرئيسي، إذا كان مزوّدًا بشاشة:
      1. التمرير سريعًا لأسفل الشاشة من أعلاها
      2. انقر على رمز الإعدادات .
      3. العثور على عنوان IP الخاص بالجهاز: على Nest Hub (الجيل الثاني)، انتقِل إلى معلومات الجهاز > المعلومات الفنية > عنوان IP
    • من تطبيق Google Home على هاتفك:
    • انقر على الجهاز لعرض صفحة تفاصيله
    • انقر على رمز الإعدادات لفتح صفحة الإعدادات
    • ابحث عن عنوان IP للجهاز: انتقِل إلى معلومات الجهاز > المعلومات الفنية > عنوان IP
  4. لاسترداد السجلات من المحور، عليك إرسال طلب GET HTTP إلى المحور من جهاز كمبيوتر متصل بشبكة Wi-Fi نفسها.
    • سجِّل المنفذ والمسار لنقطة النهاية: 
      curl -k -X GET https://ip-address:8443/setup/get_logs --output output-file
    • يمكن إبقاء الاتصال مفتوحًا لمدة دقيقة واحدة فقط، ولكن عادةً ما تتضمّن البيانات التي يتم استردادها من المخزن المؤقت أحداثًا سابقة لمدة تتراوح بين 20 و30 دقيقة.
      • من المفترض أن يتم استخراج السجلات باستخدام هذه الطريقة فور الانتهاء من إجراء اختبار للتأكّد من أنّ المخزن المؤقت يحتوي على محتوى ذي صلة بالاختبار (على غرار تقارير أخطاء Android).

عمليات التشغيل الآلي

رصد الحواف

تتضمّن عمليات التشغيل الآلي في منظومة Google Home المتكاملة ميزة الرصد على الجهاز، وهي عبارة عن منطق يتحقّق من أنّ أداة التشغيل لا يتم تفعيلها إلا عند حدوث تغيير فعلي في الحالة، وليس عند تحديث الحالة الذي يكرّر ببساطة حالة الجهاز السابقة.

على سبيل المثال، إذا كان تشغيل الضوء هو إجراء بدء، تتحقّق ميزة "رصد الحافة" من أنّ إجراء البدء لا يتم تنفيذه إلا إذا تغيّرت حالة جهاز الإضاءة من "إيقاف" إلى "تشغيل"، وليس من "تشغيل" إلى "تشغيل" (بدون تغيير).

لا تعمل ميزة التشغيل الآلي على النحو المتوقّع

بعد أخذ رصد الحواف في الاعتبار، إذا لم يعمل أحد أنظمة التشغيل الآلي على النحو المتوقّع، اتّبِع الخطوات التالية:

  1. تحقَّق من كل جهاز للتأكّد من أنّه يعمل بشكل سليم بغض النظر عن عملية التشغيل الآلي.

  2. ألقِ نظرة على الرسم البياني للتشغيل الآلي الخاص بك، وقارِنه بلغة DSL الخاصة بالتشغيل الآلي، وذلك للكشف عن أي افتراضات غير صحيحة محتملة من جانبك.

  3. مراقبة حالة الجهاز في تطبيق Google Home أثناء تنفيذ عملية التشغيل الآلي

  4. تأكَّد من أنّ جميع الأجهزة التي تشير إليها عملية التشغيل الآلي متوفّرة في البنية التي تتوقّع أن تكون فيها. قد يؤدي حذف جهاز تعتمد عليه عملية تشغيل آلي إلى حدوث عواقب غير مقصودة. اطّلِع على تأثير حذف الجهاز في عمليات التشغيل الآلي.

بدء عملية التشغيل الآلي في وقت غير مناسب

إذا تم تشغيل عملية التشغيل الآلي في وقت غير مناسب، راجِع معايير البدء. قد يكون من الضروري إضافة منطق إضافي للتأكّد من تسجيل تغيير الحالة مرة واحدة فقط وتشغيل عملية التشغيل الآلي مرة واحدة فقط.

لا يتم تجميع عملية التشغيل الآلي

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

تعذّر التحقّق من صحة عملية إنشاء التشغيل الآلي

إذا لم يتم اجتياز عملية إنشاء التشغيل الآلي، ستوفّر رسالة تحذير أو خطأ معلومات حول المشكلة. لمزيد من المعلومات، راجِع مرجع ValidationIssueType.

OAuth

إذا كان لديك عميل OAuth حالي

إذا كان لديك معرّف عميل OAuth تم إثبات ملكيته لتطبيق منشور، يمكنك استخدام معرّف عميل OAuth الحالي لاختبار واجهات برمجة التطبيقات Home APIs.

لا يلزم التسجيل في Google Home Developer Console لاختبار واجهات برمجة التطبيقات الخاصة بالمنزل واستخدامها. ومع ذلك، سيظلّ عليك الحصول على تسجيل Developer Console معتمَد لنشر تطبيقك، حتى إذا كان لديك عميل OAuth تم التحقّق منه من عملية دمج أخرى.

تنطبق الاعتبارات التالية:

  • يبلغ الحد الأقصى لعدد المستخدمين 100 مستخدم عند استخدام عميل OAuth حالي. للحصول على معلومات حول إضافة مستخدمين تجريبيين، يُرجى الرجوع إلى إنشاء معرّف عميل OAuth. بغض النظر عن عملية التحقّق من OAuth، تفرض واجهات برمجة التطبيقات Home حدًا أقصى يبلغ 100 مستخدم يمكنهم منح الأذونات لتطبيقك. ويتم رفع هذا القيد عند إكمال عملية التسجيل في Developer Console.

  • يجب إرسال طلبDeveloper Console للتسجيل للحصول على الموافقة عندما تكون مستعدًا لحظر منح أذونات حسب نوع الجهاز من خلال OAuth استعدادًا لتعديل تطبيقك باستخدام واجهات برمجة تطبيقات Home.

بالنسبة إلى تطبيقات Google Cloud التي لا تزال في انتظار إكمال عملية التحقّق من OAuth، لن يتمكّن المستخدمون من إكمال عملية OAuth إلى أن تكتمل عملية التحقّق. ستتعذّر محاولات منح الأذونات وسيظهر الخطأ التالي:

Access blocked: <Project Name> has not completed the Google verification process.