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

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

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

تحتوي صفحة الحِزم على أحدث .unitypackage ملف. لكل الحِزم المتاحة، و.tgz لبعض الحِزم.

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

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

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

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

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

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

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

ملف البيان.json

  1. أنشِئ مجلدًا جديدًا بجانب مجلد "Packages" الخاص بمشروعك وحدِّد اسمه. GooglePackages
  2. يُرجى وضع الملفات البالغ عددها .tgz في ذلك المجلد.
  3. استخدِم محرِّر نصوص لفتح "Packages/manifest.json" ضِمن مشروع Unity. المجلد.
  4. أضِف إدخالاً لكل حزمة تريد تثبيتها، وحدِّد اسم الحزمة على الموقع على القرص، بالنسبة إلى ملف Packages/manifest.json. تأكَّد من إلحاق file: بمسار الملف .tgz. بالنسبة على سبيل المثال، إذا كنت تثبّت com.google.firebase.storage و المستخدم، فإن ملف robots.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. احفظ ملفian.json.

  6. عندما تستعيد Unity التركيز، ستتم إعادة تحميل ملف الملف robots.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. افتح نافذة "مدير الحزم" في Unity.
  2. انقر على الرمز + في أعلى يمين نافذة "مدير الحزم" اختَر Add package from tarball لفتح متصفِّح الملفات.

    لقطة شاشة لنافذة Unity Package Manager تعرض

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

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

  1. فك ضغط ملف .tgz.
  2. انقر على الرمز + في أعلى يمين صفحة "مدير الحِزم". نافذة واختيار Add package from disk لفتح متصفِّح الملفات.

    لقطة شاشة لنافذة Unity Package Manager تعرض

  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.

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

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

في حال استخدام git، يُنصح باستخدام تخزين الملفات الكبيرة في Git (LFS) لإدارة ملفات .tgz الكبيرة.

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

في بعض الحالات، قد ترغب في التبديل من استخدام مدير حزم Unity إدارة حزم Google إلى تثبيت الحزم ضمن مجلد Assets.

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

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

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

    لقطة شاشة لنافذة Unity Package Manager تعرض

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

    لقطة شاشة لنافذة Unity Package Manager تتضمّن

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

ملف البيان.json

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

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

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

في بعض الحالات، قد ترغب في التبديل من تثبيت المنتجات ضمن شجرة الأصول لتثبيت المنتجات وتتبُّعها باستخدام أداة Unity Package Manager

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

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

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

    • لإلغاء تثبيت حزم Firebase، يُرجى اتّباع الخطوات التالية: هذه التعليمات.
    • لإلغاء تثبيت Play Plugins for Unity، يجب حذف المجلد GooglePlayPlugins. أقل من Assets.
  2. تثبيت الحِزم باستخدام أداة "مدير حزم Unity" على النحو الموضَّح أعلاه.

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

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