Check out what’s new from Firebase at Google I/O 2022. Learn more

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

بدلاً من تنزيل ملف .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 ، لذلك من الجيد التعرف على الأداة من وثائق الوحدة .

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

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

مدير الحزم UI

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

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

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

البيان. json

  1. أنشئ مجلدًا جديدًا بجوار مجلد Packages في مشروعك وقم GooglePackages .
  2. ضع ملفات .tgz في هذا المجلد.
  3. استخدم محرر نصوص لفتح Packages/manifest.json ضمن مجلد مشروع الوحدة.
  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. عندما تستعيد الوحدة التركيز ، ستعيد تحميل ملف 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. من قائمة Window ، حدد Package Manager . في نافذة مدير الحزم ، تأكد من تحديد "الحزم: في المشروع".
    2. لاحظ إصدارات حزم Firebase المستوردة.
    3. انقر فوق اسم كل حزمة ، ثم انقر فوق إزالة . تأكد من إزالة حزمة إدارة التبعية الخارجية ( .com.google.external-dependency-manager ) وكذلك حزم Firebase.
  2. تنزيل واستيراد ملفات .unitypackage البديلة. لديك خياران:

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

    مدير الحزم UI

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

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

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

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