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

لبدء تطوير التطبيقات لنظام Android XR، استخدِم أحدث إصدار Canary من استوديو Android، الذي يتضمّن أدوات وتحديثات جديدة محسّنة لنظام Android XR.

ملاحظة: تأكَّد من استخدام أحدث إصدار من قناة Canary في "استوديو Android". قد لا تتضمّن الإصدارات الأخرى أدوات Android XR.

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

• Android XR Emulator
• إضافة دعم الواقع المختلط في "أداة فحص التنسيق"
• نموذج مشروع الواقع الممتد

متطلبات النظام لمحاكي Android XR

في نظام التشغيل macOS:

• نظام التشغيل: الإصدار 13.3 أو الإصدارات الأحدث من نظام التشغيل macOS
• وحدة المعالجة المركزية/وحدة معالجة الرسومات: Apple Silicon (شريحة M1 أو أحدث)
• ذاكرة الوصول العشوائي (RAM) / ذاكرة الوصول العشوائي المرئية (VRAM): 16 غيغابايت أو أكثر

على أجهزة Windows:

• نظام التشغيل: Windows 11 أو إصدار أحدث
• وحدة المعالجة المركزية: معالج Intel من الجيل التاسع أو الإصدارات الأحدث، أو معالج AMD Ryzen من السلسلة 1000 أو الإصدارات الأحدث
• ذاكرة الوصول العشوائي (RAM): 16 غيغابايت أو أكثر
• وحدة معالجة الرسومات: السلسلة 10 من NVIDIA GeForce أو إصدار أحدث، أو السلسلة 5000 من AMD Radeon RX أو إصدار أحدث
• ذاكرة الوصول العشوائي للفيديو (VRAM): 8 غيغابايت أو أكثر
• إعدادات BIOS: يجب تفعيل إضافات VMX لوحدة المعالجة المركزية (CPU) في BIOS على جهاز الكمبيوتر

ملاحظة: يمكنك التحقّق مما إذا كانت إضافات VMX لوحدة المعالجة المركزية مفعّلة من خلال محاولة تشغيل "محاكي Android ثنائي الأبعاد". إذا تم تشغيله بنجاح، لن تحتاج إلى إجراء أي تغييرات في نظام BIOS.

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

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

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

2. نزِّل أحدث إصدار Canary من استوديو Android، واستخرِجه إلى الموقع الجغرافي الذي تفضّله، ثم شغِّل التطبيق.

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

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

   

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

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

   

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

6. ضمن علامة التبويب منصات حزمة SDK، اتّبِع الخطوات التالية:

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

   

   1. انقر على تطبيق لإجراء التعديلات، ثم انقر على موافق.
   2. اسمح بإكمال جميع خطوات التثبيت، ثم انقر على إنهاء.

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

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

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

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

   

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

   

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

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

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

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

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

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

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

   

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

   

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

   

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

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

   

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

   

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

   

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

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

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

لتفعيل "إحصاءات الاستخدام"، اتّبِع الخطوات التالية:

1. انقر على الإعدادات > المظهر والسلوك > إعدادات النظام > مشاركة البيانات.

2. انقر على إرسال إحصاءات الاستخدام إلى Google.