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

بدلا من تحميل كبير .zip ملف يحتوي على جميع .unitypackage الملفات على حد سواء. NET 3.X و. NET 4.X، يمكنك تنزيل حزم الفردية من واجهات برمجة التطبيقات لموقع الوحدة .

يوفر الموقع:

  • فرد. NET 4.X .unitypackage الملفات لتثبيت شكل حزم الأصول.
  • الفردية .tgz المحفوظات لتثبيت باستخدام الوحدة مدير الحزم.

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

توفر هذه الصفحة إرشادات تتعلق الوحدة مدير الحزم، حتى انها فكرة جيدة للتعرف على أداة من وثائق الوحدة .

تثبيت حزم Firebase كأصول

عند تثبيت منتجات Firebase من .unitypackage الملفات التي تم تحميلها من واجهات برمجة التطبيقات لموقع الوحدة ، والحفاظ على ما يلي في الاعتبار:

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

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

بعد التنزيل ، للتثبيت:

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

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

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

عند تثبيت منتجات Firebase من .tgz الملفات التي تم تحميلها من واجهات برمجة التطبيقات من Google للأرشيف الوحدة ، والحفاظ على ما يلي في الاعتبار:

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

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

في بعض الحالات، قد ترغب في التحول من استخدام الوحدة مدير الحزم لتتبع المنتجات Firebase، إلى تثبيت المنتجات تحت Assets المجلد.

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

للانتقال إلى حزم الأصول:

  1. لاحظ إصدارات حزمة Firebase الحالية في مشروعك وقم بإزالتها.

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

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

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

في بعض الحالات، قد ترغب في التحول من تركيب المنتجات تحت Assets المجلد لتثبيت وتتبع المنتجات مع الوحدة مدير الحزم.

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

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

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

    مدير الحزم UI

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

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

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

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