التشغيل السريع

يجب إعداد إضافة تطوير ألعاب Android على جهاز كمبيوتر يعمل بنظام التشغيل Windows وتشغيل نموذج لمشروع Visual Studio C++ على جهاز Android أو محاكٍ.

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

اتبع الخطوات الواردة في هذا القسم لإعداد جهاز الكمبيوتر الذي يعمل بنظام التشغيل Windows لتثبيت الإضافة:

1. نزِّل أحد الإصدارات المتوافقة من Visual Studio وثبِّتها:

   • الإصدار 15.4.0 من Visual Studio 2017 (9 تشرين الأول (أكتوبر) 2017) أو الإصدارات الأحدث
   • الإصدار 16.0.0 أو الإصدارات الأحدث من Visual Studio 2019:
   • الإصدار 17.0.0 أو الإصدارات الأحدث من Visual Studio 2022:

2. تنزيل وتثبيت .NET Core SDK 2.2.

3. إنّ الإصدار 3.5 من استوديو Android أو الإصدارات الأحدث هو إجراء اختياري، ولكن يمكن استخدامه بدلاً من إضافة تطوير ألعاب Android لتثبيت حزمة تطوير البرامج (SDK) لنظام التشغيل Android وNDK.

4. نزِّل JDK 17 وثبِّته لنظام AGDE 23.1.82 أو إصدار أحدث، أو JDK 11 حتى AGDE 22.2.71، واضبط متغير بيئة JAVA_HOME.

تثبيت الإضافة

اتّبِع الخطوات الواردة في هذا القسم لتنزيل إضافة تطوير ألعاب Android وتثبيتها:

1. إغلاق جميع نُسخ Visual Studio

2. يمكنك تنزيل أحدث أداة تثبيت للإضافات ونماذج من صفحة عمليات التنزيل.

3. من موقع التنزيل، انقر مرّتين على أداة التثبيت. يستغرق المثبت عدة دقائق لإكماله.

4. إذا كان لديك أكثر من إصدار مثبّت من Visual Studio، اختَر الإصدارات التي تريد تثبيت الإضافة لها.

5. انقر على إنهاء لإكمال عملية التثبيت.

تثبيت Android SDK وNDK

يمكنك تثبيت حزمة تطوير البرامج (SDK) لنظام التشغيل Android ومجموعة أدوات تطوير الألعاب (NDK) لنظام التشغيل Android باستخدام استوديو Android أو إضافة تطوير ألعاب Android. لتثبيت SDK وNDK من الإضافة، استخدِم إدارة SDK في شريط أدوات الإضافات في Visual Studio.

عند تثبيت NDK، تأكد من استخدام مربّع الاختيار NDK (جنبًا إلى جنب) حتى تتمكن الإضافة من تحديد موقعها. يجب تثبيت إصدار NDK الذي يتوافق مع الإضافة (راجع سجل نسخ NDK).

لتثبيت حزمة تطوير البرامج (SDK) في موقع مختلف عن الموقع التلقائي، يجب ضبط متغيّر بيئة ANDROID_SDK_ROOT على جهاز الكمبيوتر:

1. تأكَّد من إغلاق أداة Visual Studio.
2. في بحث Windows، ابحث عن Environment Variables.
3. اختر تعديل متغيرات بيئة النظام.
4. انقر على متغيرات البيئة.
5. ضمن متغيّرات المستخدِمين، انقر على جديد.
6. في مربّع اسم المتغيّر، اكتب ANDROID_SDK_ROOT.
7. في مربّع Variable Value (قيمة المتغيّر)، أدخِل المسار إلى Android SDK.
8. إعادة تشغيل جهاز الكمبيوتر الخاص بك.

لا يمكن تعديل موقع حزمة تطوير البرامج (SDK) باستخدام نافذة "مدير SDK" لأنّ متغيّر البيئة هذا هو مصدر الحقيقة الوحيد لموقع حزمة SDK.

تشغيل العيّنة

اتّبِع الخطوات الواردة في هذا القسم لتشغيل عينة مُقدَّمة على محاكي ثم تشغيل جهاز Android فعلي.

ضبط النظام الأساسي

1. يُرجى فك ضغط نماذج ملف ZIP إلى دليل من اختيارك. يتم تضمين النماذج التالية:

   • نفق لا نهاية له
   • مرحبًاJNI
   • إبريق الشاي (يستخدم دمج إصدار Ninja التجريبي)

2. شغِّل Visual Studio إذا لم يكن قيد التشغيل.

3. افتح دليل النماذج. اختَر File (ملف) > Open (فتح) > Project/Solution (المشروع/الحل) وانتقِل إلى ملف .sln.

4. اختيار نظام Android الأساسي:

   1. اختَر إنشاء > مدير الإعداد.
   2. ضمن النظام الأساسي للحلول النشط، اختَر Android-x86_64.

   تم إعداد أنظمة Android الأساسية مسبقًا في النماذج (راجع إضافة المزيد من أنظمة Android الأساسية لإضافة أنظمة أساسية).

   ملاحظة: تستخدم صور المحاكي النموذجية x86 أو x86_64 ABI.

5. تأكد من أن نموذج المشروع يحتوي على خصائص Android SDK وNDK التي تم ضبطها:

   

   الشكل 1. مواقع نظام Android الأساسي

   • في مستكشف الحلول، انقر بزر الماوس الأيمن على المشروع واختَر الخصائص.

   • اختر علامة التبويب "الخصائص العامة" وابحث عن مواقع النظام الأساسي لنظام التشغيل Android.

   ملاحظة: احرِص على اختيار NDK مثبَّت.

6. حدد علامة التبويب خصائص Android Packaging (إنشاء حزمة تطبيقات Android).

   

   الشكل 2. خصائص حزم Android

   يمكنك تغيير اسم ودليل حزمة APK من علامة التبويب هذه. تجدر الإشارة إلى أنّ بعض خصائص إعداد Android يتم تحديدها في صفحات المواقع الإلكترونية ويتم تمريرها إلى Gradle. على سبيل المثال، تُمرِّر خاصية اسم APK MSBUILD_ANDROID_OUTPUT_APK_NAME هذا الاسم إلى ملف build.gradle للتطبيق.

إعداد المحاكي

1. شغِّل "مدير AVD" من شريط أدوات الإضافات في Visual Studio. عليك تهيئة جهاز افتراضي ثم تشغيله في محاكي Android.

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

2. ابدأ تشغيل الجهاز الافتراضي من خلال النقر على الزر تشغيل في مدير الجهاز الافتراضي Android.

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

   
   الشكل 3. عيّنة من إبريق شاي تعمل على محاكي Android

إعداد الجهاز

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

   1. اختَر إنشاء > مدير الإعداد.
   2. ضِمن منصّة الحلول النشطة، اختَر <جديد>.

   3. اكتب واحدًا مما يلي للنظام الأساسي الجديد:

      • Android-armeabi-v7a
      • Android-arm64-v8a
      • Android-x86
      • Android-x86_64

   4. في المربع نسخ الإعدادات من، اختَر نظام Android أساسي آخر حالٍ (أو بدون إذا لم تكن لديك أي أنظمة أساسية متوافقة مع Android حتى الآن). تأكَّد من تفعيل إنشاء منصات مشاريع جديدة.

2. وصِّل جهاز Android بجهاز الكمبيوتر باستخدام كابل USB. يجب أن يظهر نوع الجهاز بجانب زر شريط الأدوات بدء تصحيح الأخطاء.

   
   الشكل 4. جهاز Android متصل يظهر بجانب زر شريط الأدوات بدء تصحيح الأخطاء

   إذا لم يظهر الجهاز، تحقَّق مما يلي:

   • يتطابق اختيار النظام الأساسي مع واجهة التطبيق الثنائية (ABI) في جهازك.
   • خيارات المطوّرين وتصحيح أخطاء USB على الجهاز.
   • يتم توصيل كابل USB من الجهاز بالكمبيوتر.
   • يتوافق كابل USB مع اتصال البيانات (وليس الطاقة فقط).

3. انقر على زر شريط الأدوات بدء تصحيح الأخطاء لتشغيل نموذج التطبيق على الجهاز. قد يستغرق برنامج تصحيح الأخطاء بضع لحظات لإرفاقه بالتطبيق. وبعد إرفاقه، يمكنك التفاعل مع التطبيق على جهازك.

الأسئلة الشائعة

في ما يلي بعض الأسئلة الشائعة حول الإضافة "تطوير ألعاب Android".

أين توجد سجلات المكون الإضافي؟

يمكنك فتح ملف السجلّ للمكون الإضافي باستخدام رمز Open Logs (فتح السجلات) في شريط الأدوات Android Game Development Extension (إضافة تطوير ألعاب Android).

ما متغيرات البيئة التي يستخدمها المكون الإضافي؟

يستخدم المكوّن الإضافي متغيرات البيئة التالية:

• ANDROID_SDK_ROOT
• ANDROID_SDK_HOME
• TEMP
• GOOGLE_ANDROID_LOG_DIR

الخطوات التالية

لاستخدام مشروعك الخاص مع الإضافة، عليك تهيئته وفقًا لدليل ضبط المشروع.