خيارات تثبيت الوحدة الإضافية

بدلاً من تنزيل ملف .zip كبير يحتوي على جميع ملفات .unitypackage لكل من .NET 3.X و.NET 4.X، يمكنك تنزيل حزم فردية من Google APIs لموقع 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 Package Manager.

بعد التنزيل، للاستيراد:

  1. في مشروع Unity المفتوح، انتقل إلى Assets > Import Package > Custom Package .

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

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

عند استيراد منتجات 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، فاستورد المصادقة ( com.google.firebase.auth ) أولاً.

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

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

  1. افتح نافذة مدير الحزم الخاصة بـ Unity.
  2. انقر فوق أيقونة + في الزاوية العلوية اليسرى من نافذة Package Manager وحدد Add package from tarball لفتح متصفح الملفات.
  3. حدد كرة القطران المطلوبة في متصفح الملفات.

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

  1. قم بفك ضغط ملف .tgz .
  2. انقر فوق أيقونة + في الزاوية العلوية اليسرى من نافذة Package Manager وحدد 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 Package Manager إلى حزم الأصول

في بعض الحالات، قد ترغب في التبديل من استخدام 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 البديلة. لديك خياران:

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

الترحيل من حزم الأصول إلى Unity Package Manager

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

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

للانتقال إلى Unity Package Manager:

  1. تأكد من إزالة جميع حزم Firebase وحزمة External Dependency Manager من مجلد Assets ، باستخدام إحدى الطرق التالية.

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

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

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

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

    • Assets/Editor Default Resources/Firebase
    • Assets/ExternalDependencyManager
    • Assets/Firebase
    • Assets/Parse
    • Assets/Plugins/iOS/Firebase
  2. قم باستيراد الحزم باستخدام Unity Package Manager، كما هو موضح أعلاه في هذه الصفحة.