إعداد بيئة التطوير

لبدء تطوير التطبيقات المتوافقة مع Android XR، عليك استخدام IDE Android Studio Meerkat | 2024.3.1 Canary 5 الذي يتضمّن أدوات وتعديلات جديدة محسّنة لأجهزة Android XR.

في ما يلي الميزات الجديدة المضمّنة في هذا الإصدار من Android Studio:

• محاكي Android XR
• إتاحة ميزة الواقع المعزّز في "أداة فحص التنسيق"
• نموذج مشروع الواقع المعزّز

متطلبات الأجهزة الأساسية في "استوديو Android" لتطوير تطبيقات الواقع المعزّز

• ذاكرة الوصول العشوائي (RAM): 16 غيغابايت أو أكثر
• إعدادات النظام المتاحة حاليًا والتي تم اختبار ثباتها:
  • نظام التشغيل macOS على Apple Silicon (شريحة M1 أو إصدار أحدث)
  • نظام التشغيل Windows 11 مع بطاقة الرسومات NVIDIA (سلسلة GeForce 10 أو إصدار لاحق). يتوافق كل من وحدات معالجة الرسومات للكمبيوتر المكتبي والمحمول.

تثبيت "استوديو Android" وضبطه لتطوير تطبيقات الواقع المعزّز

أكمِل الخطوات التالية لتنزيل Android Studio وإعداد بيئة التطوير:

1. احرص على إغلاق أي إصدارات من Android Studio سبق أن ثبّتها.

2. نزِّل Android Studio Meerkat | 2024.3.1 Canary 5، وقم باستخراجه في الموقع الذي تفضّله، ثم افتح التطبيق.

3. اتّبِع تعليمات التثبيت الواردة في المعالج.

4. في مربّع الحوار مرحبًا بك في "استوديو Android"، انقر على المزيد من الإجراءات، ثم على مدير حِزم SDK.

   

5. في صفحة حزمة تطوير البرامج (SDK) لنظام التشغيل Android، انقر على علامة التبويب أدوات حزمة SDK واختَر الأدوات التالية لتثبيتها:

   • أدوات إنشاء حزمة تطوير البرامج (SDK) لنظام التشغيل Android
   • محاكي Android
   • أدوات حزمة تطوير البرامج (SDK) لنظام التشغيل Android
   • أداة فحص التنسيق لواجهات برمجة التطبيقات من 31 إلى 36

   

   ملاحظة: إذا كان لديك إصدار سابق من Android Studio مثبّتًا، قد تحتاج إلى إعادة وضع علامة في مربّعات الاختيار هذه، ثم النقر على تطبيق لتنزيل أحدث التحديثات.

6. ضمن علامة التبويب منصّات حِزم تطوير البرامج (SDK)، نفِّذ ما يلي:

   1. ضَع علامة في مربّع الاختيار إظهار تفاصيل الحزمة للاطّلاع على كل الخيارات.
   2. اختَر صورة نظام Google Play XR ARM (macOS) أو Google Play XR Intel x86_64 (Windows).

   

7. انقر على تطبيق لإجراء التعديلات، ثم انقر على حسنًا.

8. انتظر حتى تكتمل جميع خطوات التثبيت، ثم انقر على إنهاء.

إنشاء مشروع Android XR

اتّبِع الخطوات التالية لإنشاء مشروع Android XR في Android Studio أو توسيع نطاق مشروع حالي ليشمل الواقع المعزّز.

1. في نافذة مرحبًا بك في Android Studio، نفِّذ أحد الإجراءات التالية:

   1. إذا كنت بصدد إنشاء تطبيق واقع ممحوِّر جديد، انقر على مشروع جديد وانتقِل إلى الخطوة التالية.
   2. إذا كنت بصدد إضافة ميزة "الواقع المكاني" إلى تطبيق حالي، انقر على فتح لاختيار مشروعك، ثم انتقِل إلى الخطوة التالية "إنشاء جهاز Android افتراضي جديد" لتطبيق محاكي Android. (للحصول على مساعدة بشأن إضافة ميزة العرض المكاني إلى تطبيقك الحالي ليعمل على Android XR، يُرجى الاطّلاع على مقالة تحويل تطبيق Android إلى تطبيق ثلاثي الأبعاد باستخدام تقنية الواقع المعزّز).

   

2. في فئة الواقع المعزّز، اختَر نموذج نشاط أساسي لسماعة الرأس وانقر على التالي.

   

3. في الشاشة التالية، يمكنك اختيار اسم لمشروعك. يمكنك إبقاء الإعدادات التلقائية كما هي. بعد ذلك، انقر على إنهاء.

4. اطّلِع على الرمز المقدَّم في النموذج. يمكنك الاطّلاع على دليل التطوير ومستندات المراجع.

إنشاء جهاز Android افتراضي جديد لمحاكي Android

‫Android XR Emulator هو إصدار مخصّص من محاكي Android مصمّم لتطوير تطبيقات الواقع المعزّز. يتيح لك هذا الإصدار اختبار تطبيقات الواقع الموسّع وتصحيح أخطائها ضمن بيئة Android Studio المألوفة.

تحذير: في بعض الحالات النادرة، قد يؤدي استخدام المحاكي إلى تجميد النظام أو تعطُّله في بعض إعدادات Windows. يُرجى التأكّد من حفظ جميع البيانات قبل تشغيل المحاكي. كحل بديل، يمكنك تفعيل WHPX. راجِع ملاحظات الإصدار لمعرفة المزيد من المشاكل المعروفة.

لاستخدام Android XR Emulator، عليك إنشاء جهاز افتراضي جديد. اتّبِع الخطوات التالية لإجراء ذلك:

1. في Android Studio، انقر على الأدوات > مدير AVD واتّبِع التعليمات لإنشاء جهاز Android افتراضي (AVD) جديد.

   

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

   

3. في علامة التبويب التالية (ضبط الجهاز الافتراضي)، ضمن صورة النظام، اختَر أحدث صورة لنظام Android XR متوافقة مع نظامك.

   

4. انقر على إنهاء.

5. لبدء المحاكي، انقر على الزر تشغيل في "مدير الأجهزة".

   

   يتم فتح المحاكي في نافذة منفصلة.

   

6. لتشغيل تطبيقك في المحاكي، انقر على رمز التشغيل في Android Studio.

   

   للاطّلاع على تفاصيل عن استخدام المحاكي والأدوات الجديدة الأخرى للواقع الممتد، يُرجى قراءة مقالة أدوات "استوديو Android" للواقع الممتد.

تفعيل "إحصاءات الاستخدام" للمساعدة في تحسين "استوديو Android"

بما أنّ هذا الإصدار هو إصدار معاينة للمطوّرين من Android Studio، لا تزال العديد من هذه الميزات قيد التطوير. ننصحك بتفعيل إحصاءات الاستخدام وإرسال ملاحظاتك لمساعدتنا في تحسين هذه الأدوات.

لتفعيل "إحصاءات الاستخدام":

1. انقر على الإعدادات > المظهر والسلوك > إعدادات النظام > مشاركة البيانات.
2. انقر على إرسال إحصاءات الاستخدام إلى Google.