تثبيت حزم Google للعبة Unity

يتم توزيع حزم Google لـ Unity بتنسيقين مختلفين:

• حِزم مواد العرض:
  • استخدام إضافة .unitypackage
  • ثبِّت في دليل Assets لمشروعك.
  • يمكن استيراده في Unity 5 والإصدارات الأحدث.
  • تتضمّن بشكل عام الحِزم التابعة.
• حِزم Unity Package Manager (UPM):
  • استخدام إضافة .tgz
  • ثبِّت في دليل Packages لمشروعك.
  • يمكن استيراده في Unity 2018.4 والإصدارات الأحدث.
  • الحزم التابعة التي يجب تثبيتها بشكل منفصل

تحتوي صفحة الحِزم على أحدث ملفات .unitypackage لجميع الحِزم المتوفّرة.

تحتوي صفحة الأرشيف على ملفات .unitypackage و.tgz لجميع إصدارات الحِزم.

يمكنك العثور أدناه على تعليمات حول كيفية تثبيت كل من نوعي الحِزم، بالإضافة إلى تعليمات نقل البيانات للانتقال من نوع إلى آخر.

بعد أن تتعرّف على خيارات التثبيت هذه، احرص على الرجوع إلى تعليمات إضافية خاصة بالمنتج لبرنامج Firebase.

جارٍ استيراد حِزم مواد العرض التي تتضمّن .unitypackage ملفات

يمكنك استيراد ملف .unitypackage عن طريق تحديد خيار قائمة Unity Assets > Import package > Custom Package واستيراد جميع العناصر. يؤدي هذا الإجراء إلى إضافة محتوى الحزمة إلى مشروعك ضمن "دليل مواد العرض".

ملاحظة: إذا سبق لك تثبيت الحزمة باستخدام نافذة Package Manager (مدير الحزم) في Unity، عليك إلغاء تثبيت الإصدار القديم من الحزمة قبل استيراد الحزمة الجديدة. اطّلِع على أدناه للحصول على التعليمات.

استيراد حزم UPM مع ملفات .tgz (2018.4+)

يمكنك استيراد .tgz ملفات إلى مشروعك باستخدام إحدى الطرق التالية:

ملف manifest.json

1. أنشئ مجلدًا جديدًا بجانب مجلد مشروعك باسم Packages وحدِّد اسمه GooglePackages.
2. ضع ملفات .tgz في هذا المجلد.
3. استخدِم محرِّر نصوص لفتح Packages/manifest.json ضمن مجلد مشروع Unity.

4. أضِف إدخالاً لكل حزمة تريد تثبيتها، مع ربط اسم الحزمة بالموقع على القرص، بالنسبة إلى ملف Packages/manifest.json. تأكَّد من إلحاق file: بمسار الملف .tgz. على سبيل المثال، إذا كنت تثبّت com.google.firebase.storage وعناصره التابعة، سيظهر ملف manifest.json على النحو التالي:

   {
     "dependencies": {
       "com.google.external-dependency-manager": "file:../GooglePackages/com.google.external-dependency-manager-1.2.164.tgz",
       "com.google.firebase.app": "file:../GooglePackages/com.google.firebase.app-7.1.0.tgz",
       "com.google.firebase.auth": "file:../GooglePackages/com.google.firebase.auth-7.1.0.tgz",
       "com.google.firebase.storage": "file:../GooglePackages/com.google.firebase.storage-7.1.0.tgz",
       // com.unity package entries...
     }
   }
   

5. احفظ ملف manifest.json.

6. عندما يستعيد Unity التركيز، ستتم إعادة تحميل ملف manifest.json واستيراد الحزم المضافة حديثًا.

لا تتوافق بعض الإصدارات القديمة من Unity مع ملفات .tgz في ملف manifest.json. في هذه الحالة، عليك:

1. فك ضغط ملفات .tgz.
2. ضَع المجلد المُستخرج في المجلد GooglePackages.

3. عدِّل ملف manifest.json لاستخدام المسار إلى المجلد المُستخرج، بدلاً من ملف .tgz، على النحو التالي:

   {
     "dependencies": {
       "com.google.external-dependency-manager": "file:../GooglePackages/com.google.external-dependency-manager-1.2.164",
       "com.google.firebase.app": "file:../GooglePackages/com.google.firebase.app-7.1.0",
       "com.google.firebase.auth": "file:../GooglePackages/com.google.firebase.auth-7.1.0",
       "com.google.firebase.storage": "file:../GooglePackages/com.google.firebase.storage-7.1.0",
       // com.unity package entries...
     }
   }
   

واجهة مستخدم "مدير الحزمة"

1. افتح نافذة مدير الحزم Unity's.

2. انقر على رمز + في أعلى يمين نافذة Package Manager (مدير الحزمة) واختَر Add package from tarball لفتح متصفّح الملف.

   

3. اختَر كرة tarball المطلوبة في متصفِّح الملفات.

لا تتوافق بعض الإصدارات القديمة من Unity مع إضافة tarballs مباشرةً. في هذه الحالة، ستحتاج إلى:

1. فك ضغط ملف .tgz.

2. انقر على رمز + في أعلى يمين نافذة "إدارة الحزمة" واختَر Add package from disk لفتح متصفح الملفات.

   

   ملاحظة: يضع Unity 2018 رمز + في الزاوية السفلية اليمنى من لوحة قائمة الحِزم.

3. اختَر المجلد الذي تم استخراجه في متصفِّح الملفات.

يجب أيضًا التأكّد من استيراد ملفات .tgz للاعتماديات الخاصة بالحزمة والتي يمكنك العثور عليها في صفحة الأرشيف ضمن قسم "الحزمة المطلوبة".

على سبيل المثال، إذا كنت تثبِّت com.google.firebase.storage، يمكنك تثبيت ملفات .tgz هذه بالترتيب التالي:

1. مدير المهام الخارجية (com.google.external-dependency-manager)
2. نظام Firebase الأساسي (com.google.firebase.app)
3. مصادقة Firebase (com.google.firebase.auth)
4. مساحة تخزين Firebase (com.google.firebase.storage)

إذا كنت تفضّل إضافة جميع ملفات .tgz في آنٍ واحد، بدون القلق بشأن الطلب، يمكنك اتباع التعليمات الواردة في علامة التبويب manifest.json.

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

التحكُّم في الإصدار

إذا كنت تستخدم برامج للتحكم في الإصدارات لإدارة ملفات مشروعك، ننصحك بإضافة ملفات .tgz ذات الصلة إلى أداة التحكّم في الإصدارات. يمكنك تعديل manifest.json مشروعك يدويًا (اطّلِع على التعليمات أعلاه) والإشارة إلى ملفات .tgz المحلية باستخدام المسارات النسبية.

في حال كنت تستخدم تطبيق git، ننصحك بما يلي: Git Big File Storage (LFS) لإدارة ملفات .tgz الكبيرة الحجم.

نقل البيانات من حِزم UPM إلى حزم مواد العرض

في بعض الحالات، قد تحتاج إلى التبديل من استخدام Unity Package Manager (إدارة الحزم) إلى إدارة حِزم Google وصولاً إلى تثبيت الحِزم ضمن مجلد مواد العرض.

التأكّد من إزالة كلّ حِزم Google من Unity Package Manager باستخدام إحدى الطريقتَين التاليتَين:

واجهة مستخدم "مدير الحزمة"

1. افتح نافذة مدير الحزم Unity's.

2. اختَر In Project من القائمة المنسدلة في أعلى يمين الصفحة.

   

3. اكتب com.google في شريط البحث لفلترة حِزم Google.

   

4. انقر على كل اسم حزمة ثم انقر على Remove.

ملف manifest.json

1. استخدِم محرِّر نصوص لفتح Packages/manifest.json ضمن مجلد مشروع Unity.
2. تحقّق من توفّر أي حِزم من Google ضمن &;;;;;dependences". ويجب أن يبدأ اسم الحزمة بـ "com.google"على سبيل المثال "com.google.firebase.app".
3. احذف هذه الأسطر واحفظ ملف json.
4. عندما يستعيد Unity التركيز، سيعيد تحميل ملف manifest.json ويزيل الحِزم المحذوفة.

بعد إلغاء تثبيت هذه الحِزم من Unity Package Manager، يمكنك تنزيل ملفات .unitypackage البديلة واستيرادها من صفحة الأرشيف.

نقل البيانات من حِزم مواد العرض إلى حِزم UPM

في بعض الحالات، ننصحك بالتبديل من تثبيت المنتجات ضمن العرض التدرّجي لمواد العرض إلى تثبيت المنتجات وتتبّعها باستخدام Unity Package Manager (مدير حزمة الوحدات).

إذا لم تكن متأكدًا من طريقة التثبيت التي تستخدمها، في واجهة مستخدم Unity، تحقَّق مما إذا كانت حِزم Google المطلوبة تظهر في علامة التبويب "المشروع"، ضمن مواد العرض.

لنقل البيانات إلى حزم UPM:

1. تأكد من إزالة كل حزم Google من مجلد مواد العرض.

   • لإلغاء تثبيت حِزم Firebase، اتّبِع هذه التعليمات.
   • لإلغاء تثبيت المكوّنات الإضافية في Play لـ Unity، احذف مجلد GooglePlayPlugins ضمن Assets.

2. يمكنك تثبيت الحِزم باستخدام Unity Package Manager، على النحو الموضّح أعلاه.

تعليمات النقل الخاصة بالمنتج

يمكنك الاطّلاع هنا على تعليمات Firebase.