تطبيق Home APIs التجريبي على Android

يعرض تطبيق العينة الإمكانات الأساسية لواجهات برمجة تطبيقات Google Home لنظام Android.

المتطلبات الأساسية

لبناء التطبيق وتثبيته واختباره، ستحتاج إلى تلبية بعض المتطلبات الأساسية:

  • ‫Android Studio، الإصدار 2024.2.1 ("Ladybug") أو الإصدارات الأحدث يُرجى العِلم أنّ الإصدارات الأقدم من ذلك قد لا تعمل بشكل صحيح مع حزمة تطوير البرامج (SDK) لواجهات برمجة التطبيقات Home.

    تنزيل "استوديو Android"

  • أداة تصحيح الأخطاء في Android (adb)

    ثبِّت adb.

    يمكن إجراء ذلك باستخدام SDK Manager.

ولاختبار واجهات برمجة التطبيقات الخاصة بمنصة Home، ستحتاج إلى ما يلي:

  • جهاز Android يعمل بالإصدار 10 أو الإصدارات الأحدث تم إعداده باستخدام حساب Google تنوي استخدامه في عملية التطوير تأكَّد من تثبيت إصدار حديث من Android Studio وتسجيل الدخول إليه باستخدام حساب المطوّر هذا.
  • شبكة Wi-Fi
  • للوصول إلى أجهزة Matter والتحكّم فيها، يجب أن يكون لديك أيضًا مركز تحكّم من Google متوافق مع واجهات برمجة التطبيقات Home APIs. لمزيد من التفاصيل، يُرجى الاطّلاع على الاتصال على أجهزة Android .

  • جهاز واحد على الأقل متوافق في المنزل إذا كان هذا الجهاز (أو أي جهاز آخر تريد اختباره) يستخدم Thread، يجب أن يكون الموزّع أيضًا جهاز توجيه حدود شبكة Thread. تتوافق عيّنة تطبيق Android مع أنواع الأجهزة وسماتها التالية:

    • مصباح درجة حرارة اللون (تشغيل وإيقاف، السطوع)
    • مستشعر الاتصال (حالة منطقية)
    • الإضاءة القابلة للتعتيم (تشغيل وإيقاف، السطوع)
    • ضوء الألوان الممتدة (تشغيل وإيقاف، السطوع)
    • Generic Switch
    • كاميرا Google
    • جهاز استشعار تواجد الأفراد في المنزل (استشعار إشغال المنزل)
    • تشغيل/إيقاف الإضاءة (تشغيل وإيقاف، السطوع)
    • مفتاح تشغيل/إيقاف الإضاءة
    • وحدة المكوّن الإضافي (تشغيل وإيقاف)
    • جهاز استشعار التشغيل/الإيقاف

تنزيل رمز المصدر

يتوفّر الرمز المصدري للتطبيق النموذجي على GitHub.

انتقِل إلى المكان الذي تريد حفظ المشروع فيه، ثم استنسِخه:

git clone https://github.com/google-home/google-home-api-sample-app-android.git

إعداد حزمة تطوير البرامج (SDK)

لا تعد واجهات برمجة التطبيقات الرئيسية لنظام Android في هذه النسخة التجريبية المفتوحة جزءًا من المكتبات القياسية التي توفرها Google للتطوير. لتطوير تطبيقات Android باستخدام واجهات برمجة التطبيقات Home، عليك تنزيل المكتبات واستضافتها محليًا.

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

تسجيل الدخول الآن

إنشاء التطبيق

  1. افتح Android Studio، ثم افتح مجلد المشروع google-home-api-sample-app-android الذي تم استنساخه إلى جهازك المحلي.

  2. أثناء عملية الإعداد الأولى، قد يستغرق تنزيل جميع التبعيات الخاصة بالمشروع وإكمال عملية إنشاء Gradle مدة تصل إلى 10 دقائق.Android Studio

  3. وصِّل الكمبيوتر بهاتف Android حقيقي باستخدام كابل USB وفعِّل تصحيح أخطاء ADB في خيارات المطوّرين. تأكد من أن Android Studio يمكنه الاتصال بهاتف Android عبر ADB.

  4. غيِّر اسم حزمة "التطبيق التجريبي" إلى اسم جديد لم يتم تسجيله من قبل، مثل اسم يستند إلى اسم مؤسستك:

    1. افتح المشروع.
    2. توسيع التسلسل الهرمي للمصدر.
    3. حدد الجزء من الحزمة الذي تريد تغييره - بمعنى آخر، com.example.
    4. انقر بزر الماوس الأيمن على الحزمة واختَر Refactor (إعادة تصميم) > Rename... (إعادة تسمية...) Refactor > Rename menu
    5. أدخِل الاسم الجديد وانقر على إعادة تصميم.
    6. قم بتعديل الملف build.gradle.kts، وتغيير android namespace وapplicationId إلى اسم الحزمة الجديد.

  5. بعد تنزيل جميع المكتبات المطلوبة واكتمال عملية المزامنة في Gradle، انقر على الزر تشغيل لإنشاء التطبيق وتشغيله. وعند تشغيل التطبيق بنجاح على هاتفك، ستظهر لك الصفحة الرئيسية لـ "التطبيق التجريبي".

إنشاء شهادة توقيع

عند تشغيل تطبيق أو تصحيح أخطائه في Android Studio، يتم تلقائيًا إنشاء شهادة تصحيح أخطاء مخصّصة للتطوير وتصحيح الأخطاء. راجِع مقالة استوديو Android: توقيع إصدار تصحيح الأخطاء للحصول على شرح كامل.

  1. أنشئ شهادة توقيع تطبيق تصحيح الأخطاء من خلال تشغيل التطبيق في Android Studio. عند تشغيل تطبيق أو تصحيح أخطائه في Android Studio، تنشئ Android Studio تلقائيًا شهادة توقيع تطبيق مخصّصة للتطوير وتصحيح الأخطاء. راجِع مقالة استوديو Android: توقيع الإصدار التصحيحي للحصول على شرح كامل.

    ربط جهازك الجوّال بجهازك المحلي ستعرض Android Studio الأجهزة المتصلة حسب رقم الطراز. اختَر جهازك من القائمة، ثم انقر على تشغيل المشروع. يؤدي هذا إلى إنشاء تطبيق العينة وتثبيته على جهازك المحمول.

    للحصول على تعليمات أكثر تفصيلاً، يمكنك الاطّلاع على تشغيل التطبيقات على جهاز على موقع "مطوّرو تطبيقات Android" الإلكتروني.

    أوقِف الآن التطبيق الذي يتم تشغيله.

  2. احصل على الملف المرجعي SHA-1 لشهادة تصحيح الأخطاء باتّباع التعليمات المفصّلة في إدارة عملاء OAuth / أنواع التطبيقات / التطبيقات الأصلية / Android على موقع "مساعدة Google Cloud Console".

  1. في Google Cloud Console، انتقِل إلى لوحة بيانات اختيار المشروع واختَر المشروع الذي تريد استخدامه لإنشاء بيانات اعتماد OAuth.
  2. انتقِل إلى صفحة واجهات برمجة التطبيقات والخدمات، ثم انقر على بيانات الاعتماد في قائمة التنقّل.

  3. إذا لم تكن قد ضبطت شاشة طلب الموافقة لمشروع Google Cloud هذا، سيظهر الزر ضبط شاشة طلب الموافقة. في هذه الحالة، اضبط شاشة طلب الموافقة باتّباع الإجراء التالي. بخلاف ذلك، انتقِل إلى القسم التالي.

    1. انقر على إعداد شاشة الموافقة. ستظهر صفحة شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth.
    2. استنادًا إلى حالة الاستخدام، اختَر داخلي أو خارجي، ثم انقر على إنشاء. يظهر جزء شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth.
    3. أدخِل المعلومات في صفحة معلومات التطبيق وفقًا للتعليمات الظاهرة على الشاشة، ثم انقر على حفظ ومتابعة. يتم عرض جزء النطاقات.
    4. لست بحاجة إلى إضافة أي نطاقات، لذا انقر على حفظ ومتابعة. يتم عرض لوحة المستخدمون التجريبيون.
    5. انقر على شريحة الجمهور، ثمّ انقر على الزرّ + إضافة مستخدمين.
    6. أدخِل عنوان البريد الإلكتروني للمستخدم التجريبي وانقر على الزر حفظ.
    7. انقر على حفظ ومتابعة. يتم عرض جزء الملخّص.
    8. راجِع معلومات شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth، ثم انقر على الرجوع إلى لوحة البيانات.

يمكنك الاطّلاع على إعداد شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth على الموقع الإلكتروني "مساعدة Google Cloud Console" لمعرفة التفاصيل الكاملة. احرص على إضافة مستخدم اختبار واحد على الأقل قبل المتابعة.

إعداد بيانات اعتماد OAuth

  1. قم بتسجيل تطبيق العينة لـ OAuth 2.0 وقم بإنشاء بيانات اعتماد OAuth من خلال اتباع الإرشادات المقدمة في إعداد OAuth 2.0.
    1. حدِّد نوع التطبيق، وهو تطبيق أصلي/تطبيق Android.
    2. أضف بصمة SHA-1 إلى عميل OAuth باتباع الإرشادات الواردة في إعداد OAuth 2.0 / التطبيقات الأصلية / Android على موقع مساعدة Google Cloud Console. يجب إنشاء مفتاح SHA-1 من مفتاح Android Studio التلقائي طوال عملية التطوير.

تشغيل التطبيق

  1. بعد توصيل جهازك المحمول بالجهاز المحلي، انقر فوق تشغيل المشروع مرة أخرى لتشغيل تطبيق العينة على جهازك المحمول.

بمجرد تثبيته، يصبح التطبيق متاحًا على جهازك المحمول باعتباره تطبيق عينة واجهة برمجة التطبيقات الرئيسية.