تثبيت حِزم Google لنظام التشغيل Unity

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

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

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

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

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

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

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

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

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

استيراد حزم 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. احفظ الملف البيان.json.

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

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

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

3. يمكنك تعديل ملف البيان.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. افتح نافذة Package Manager (مدير الحزمة في Unity).

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

   

3. اختر tarball المطلوب في متصفح الملفات.

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

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

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

   

   ملاحظة: يضع Unity 2018 رمز + في أسفل يمين جزء قائمة الحزمة.

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

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

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

1. مدير التبعية الخارجية (com.google.external-dependency-manager)
2. Firebase Core (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 إلى تثبيت الحزم ضمن مجلد Assets (مواد العرض).

احرص على إزالة جميع حِزم Google من Unity Package Manager باستخدام إحدى الطريقتين التاليتين:

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

1. افتح نافذة Package Manager (مدير الحزمة في Unity).

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

   

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

   

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

manifest.json

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

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

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

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

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

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

1. تأكد من إزالة جميع حزم Google من مجلد Assets.

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

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

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

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