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

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

إذا واجهت أي مشاكل عند استخدام واجهات برمجة التطبيقات 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.

لا يلزم التسجيل في 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.