خيارات إضافية لتثبيت Unity

بدلاً من تنزيل ملف .zip كبير يحتوي على جميع ملفات .unitypackage لكل من NET 3.X وNET 4.X، يمكنك تنزيل حزم فردية من موقع Google APIs for Unity.

يوفّر الموقع الإلكتروني ما يلي:

  • ملفات فردية بتنسيق .NET 4.X .unitypackage للاستيراد كحزم مواد عرض.
  • يجب استيراد أرشيفات .tgz الفردية باستخدام أداة Unity Package Manager.

ويكون ذلك مفيدًا بشكلٍ خاص عندما يستخدم تطبيقك منتجًا واحدًا من Firebase، لأنّ ملفات .unitypackage الفردية تحتوي على جميع الاعتماديات المطلوبة، ويتم إدراج ملفات .tgz إلى جانب ملفات .tgz ذات الصلة التي تعتمد عليها.

توفّر هذه الصفحة تعليمات تتضمّن أداة Unity Package Manager، لذا ننصحك بالتعرّف على الأداة من خلال مستندات Unity.

استيراد حِزم Firebase كمواد عرض

عند استيراد منتجات Firebase من ملفات .unitypackage التي تم تنزيلها من Google APIs لموقع Unity، يجب مراعاة ما يلي:

  • إذا كنت تستخدم منتجات متعددة من Firebase في مشروعك، عليك تنزيل جميع منتجات Firebase وترقيتها إلى الإصدار نفسه.

  • لا تخلط بين طرق الاستيراد في مشروع واحد. وهذا يعني عدم استيراد منتجات Firebase من خلال مسار حزمة مواد العرض وباستخدام مسار "مدير حزم Unity".

بعد التنزيل، اتّبِع الخطوات التالية للاستيراد:

  1. في مشروع Unity المفتوح، انتقِل إلى مواد العرض > استيراد حزمة >الحزمة المخصّصة.

  2. في نافذة استيراد حزمة Unity، انقر على استيراد.

استيراد حزم Firebase باستخدام مدير حزم Unity

عند استيراد منتجات Firebase من ملفات .tgz التي تم تنزيلها من أرشيف Google APIs for Unity، يجب أخذ ما يلي في الاعتبار:

  • لا تتوفّر هذه الطريقة إلا في الإصدار 2018.3 والإصدارات الأحدث.

  • إذا كنت تستخدم منتجات متعددة من Firebase في مشروعك، عليك تنزيل جميع منتجات Firebase وترقيتها إلى الإصدار نفسه.

  • لا تخلط بين طرق الاستيراد في مشروع واحد. وهذا يعني عدم استيراد منتجات Firebase من خلال مسار حزمة مواد العرض وباستخدام مسار "إدارة حزم Unity".

  • يتم ربط الملحقات لكل ملف .tgz منتج في ملفات .tgz الخاصة بها. عليك تنزيل واستيراد ملف .tgz للمنتج وملفات .tgz التبعية بالترتيب الصحيح:

    1. مدير التبعية الخارجية (com.google.external-dependency-manager)
    2. حزمة Firebase الأساسية (com.google.firebase.app)
    3. منتجات Firebase المستخدَمة في مشروعك إذا كنت تستخدم قاعدة بيانات الوقت الفعلي أو Cloud Storage، عليك استيراد المصادقة (com.google.firebase.auth) أولاً.

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

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

  1. افتح نافذة "مدير الحزم" في Unity.
  2. انقر على الرمز + في أعلى يمين نافذة "إدارة الحِزم" واختَر Add package from tarball لفتح متصفّح الملفات.
  3. اختَر tarball المطلوب في متصفّح الملفات.

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

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

ملف البيان.json

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

  4. أضف إدخالاً لكل حزمة تريد استيرادها، وقم بتعيين اسم الحزمة إلى الموقع الموجود على القرص. تأكَّد من إلحاق 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. عدِّل 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...
  }
}

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

في بعض الحالات، قد تحتاج إلى التبديل من استخدام "مدير حزم Unity" لتتبُّع منتجات Firebase وإلى استيراد المنتجات ضمن مجلد "Assets".

إذا لم تكن متأكّدًا من طريقة الاستيراد التي تستخدمها، افتح الملف Packages/manifest.json في مجلد مشروع Unity. إذا كان الملف يحتوي على إدخالات تبدأ بـ com.google.firebase، سيستخدم مشروعك Unity Package Manager للاستيراد.

لنقل البيانات إلى حِزم مواد العرض، اتّبِع الخطوات التالية:

  1. دوِّن إصدارات حزمة Firebase الحالية في مشروعك وأزِلها.

    1. من القائمة نافذة، اختَر مدير الحزم. في نافذة مدير الحزم، تأكد من اختيار "الحزم: في المشروع".
    2. دوِّن إصدارات حزم Firebase التي تم استيرادها.
    3. انقر على كل اسم حزمة، ثم انقر على إزالة. يجب إزالة حزمة مدير التبعية الخارجية (.com.google.external-dependency-manager) بالإضافة إلى حزم Firebase.

  2. تنزيل ملفات .unitypackage البديلة واستيرادها لديك خياران:

    • إذا كان بإمكانك الترقية إلى أحدث إصدار من كل حزمة، نزِّل ملف ZIP لحزمة تطوير البرامج (SDK) لمنصة Unity من Firebase واستورِده كما هو موضّح في المقالة إضافة Firebase إلى مشروع Unity.
    • إذا كنت تريد الاحتفاظ بإصدارات .unitypackage الحالية، يمكنك تنزيل حِزم فردية واستيرادها كما هو موضّح أعلاه في هذه الصفحة.

نقل البيانات من حِزم مواد العرض إلى أداة Unity Package Manager

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

إذا لم تكن متأكّدًا من طريقة الاستيراد التي تستخدمها، افتح الملف Packages/manifest.json في مجلد مشروع Unity. إذا كان الملف يحتوي على إدخالات تبدأ بـ com.google.firebase، فإن مشروعك يستخدم حاليًا Unity Package Manager (مدير حزم Unity) للاستيراد.

لنقل البيانات إلى مدير حزم Unity:

  1. احرص على إزالة جميع حِزم Firebase وحزمة "مدير التبعية الخارجية" من مجلد Assets باستخدام أي من الطريقتَين التاليتَين.

    واجهة مستخدم EDM4U

    1. في مشروع Unity المفتوح، انتقِل إلى مواد العرض > مدير التبعية الخارجية > معالج الإصدار > إلغاء تثبيت الحزم المُدارة.
    2. اختَر جميع حِزم Firebase ومدير التبعية الخارجية.
    3. انقر على إلغاء تثبيت الحزمة المحدَّدة.

    الإزالة اليدوية

    باستخدام أدوات نظام الملفات، احذف المجلدات التالية يدويًا:

    • Assets/Editor Default Resources/Firebase
    • Assets/ExternalDependencyManager
    • Assets/Firebase
    • Assets/Parse
    • Assets/Plugins/iOS/Firebase

  2. استيراد الحزم باستخدام مدير حزم Unity، كما هو موضح أعلاه في هذه الصفحة.