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

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

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

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

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

توفر هذه الصفحة إرشادات تتضمن مدير حزم Unity، لذا من الجيد للتعرّف على الأداة من خلال مستندات Unity.

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

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

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

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

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

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

  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 Core (com.google.firebase.app)
    3. منتجات Firebase المستخدَمة في مشروعك إذا كنت تستخدم Realtime Database أو Cloud Storage، استورِد Authentication (com.google.firebase.auth) أولاً.

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

واجهة مستخدم "أداة إدارة الحِزم"

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

ولا تتيح بعض الإصدارات القديمة من 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.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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