خيارات إضافية لتثبيت 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، لذا من الجيد للتعرّف على الأداة من خلال مستندات Unity.

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

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

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

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

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

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

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

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

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

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

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

  • لا تخلط بين طرق الاستيراد في مشروع واحد. أي، لا تستورد منتجات Firebase التي تتضمّن مسار حزمة مواد العرض ومع أداة Unity Package Manager التدفق.

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

    1. مدير التبعية الخارجية (com.google.external-dependency-manager)
    2. حزمة Firebase الأساسية (com.google.firebase.app)
    3. منتجات Firebase المستخدَمة في مشروعك إذا كنت تستخدم Realtime Database أو Cloud Storage، قم باستيراد Authentication (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 Package Manager إلى تتبُّع منتجات Firebase وإلى استيراد المنتجات ضمن المجلد Assets

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

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

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

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

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

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

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

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

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

لنقل البيانات إلى مدير حزم 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"، كما هو موضّح أعلاه في هذه الصفحة.