بدلاً من تنزيل ملف .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.
بعد التنزيل ، للاستيراد:
في مشروع Unity المفتوح ، انتقل إلى Assets > Import Package > Custom Package .
في نافذة استيراد حزمة الوحدة ، انقر فوق استيراد .
استيراد حزم Firebase باستخدام Unity Package Manager
عند استيراد منتجات Firebase من ملفات .tgz
التي تم تنزيلها من أرشيف Google APIs for Unity ، ضع في اعتبارك ما يلي:
هذه الطريقة متاحة فقط في 2018.3+.
إذا كنت تستخدم العديد من منتجات Firebase في مشروعك ، فيجب عليك تنزيل جميع منتجات Firebase وترقيتها إلى الإصدار نفسه.
لا تخلط طرق الاستيراد في مشروع واحد. أي لا تستورد منتجات Firebase من خلال تدفق حزمة الأصول ومع تدفق Unity Package Manager.
ترتبط التبعيات لكل ملف
.tgz
للمنتج جنبًا إلى جنب في ملفات.tgz
الخاصة بهم. يجب تنزيل واستيراد ملف.tgz
الخاص بالمنتج وملفات التبعية.tgz
بالترتيب الصحيح:- مدير التبعية الخارجية (
com.google.external-dependency-manager
) - Firebase Core (
com.google.firebase.app
) - منتجات Firebase المستخدمة في مشروعك. إذا كنت تستخدم Realtime Database أو Cloud Storage ، فاستورد المصادقة (
com.google.firebase.auth
) أولاً.
- مدير التبعية الخارجية (
بعد التنزيل ، قم باستيراد ملفات .tgz
إلى مشروعك باستخدام إحدى الطرق التالية:
مدير الحزم UI
- افتح نافذة مدير الحزم في الوحدة.
- انقر فوق الرمز
+
في الزاوية العلوية اليسرى من نافذة مدير الحزم وحددAdd package from tarball
لفتح متصفح الملفات. - حدد كرة السلة المطلوبة في متصفح الملفات.
بعض الإصدارات القديمة من Unity 2019 لا تدعم إضافة كرات القطران مباشرة. في هذه الحالة ، سوف تحتاج إلى:
- قم بفك ضغط ملف
.tgz
. - انقر فوق الرمز
+
في الزاوية العلوية اليسرى من نافذة مدير الحزم وحددAdd package from disk
لفتح متصفح الملفات. - حدد المجلد المستخرج في متصفح الملفات.
بيان. json
- أنشئ مجلدًا جديدًا بجوار مجلد
Packages
في مشروعك وقم بتسميتهGooglePackages
. - ضع ملفات
.tgz
في هذا المجلد. - استخدم محرر نصوص لفتح
Packages/manifest.json
ضمن مجلد مشروع الوحدة. قم بإضافة إدخال لكل حزمة تريد استيرادها ، مع تعيين اسم الحزمة إلى الموقع الموجود على القرص. تأكد من إلحاق
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... } }
احفظ ملف
manifest.json
.عندما تستعيد الوحدة التركيز ، ستعيد تحميل ملف
manifest.json
واستيراد الحزم المضافة حديثًا.
لا تدعم بعض الإصدارات القديمة من Unity ملفات .tgz
في ملف manifest.json
. في هذه الحالة ، يجب عليك:
- قم بفك ضغط ملف
.tgz
. قم بتحرير
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 للاستيراد.
للانتقال إلى حزم الأصول:
لاحظ إصدارات حزمة Firebase الحالية في مشروعك وقم بإزالتها.
- من قائمة Window ، حدد Package Manager . في نافذة مدير الحزم ، تأكد من تحديد "الحزم: في المشروع".
- لاحظ إصدارات حزم Firebase المستوردة.
- انقر فوق اسم كل حزمة ، ثم انقر فوق إزالة . تأكد من إزالة حزمة إدارة التبعية الخارجية (
.com.google.external-dependency-manager
) وكذلك حزم Firebase.
تنزيل واستيراد ملفات
.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:
تأكد من إزالة جميع حزم Firebase وحزمة External Dependency Manager من مجلد
Assets
، باستخدام إحدى الطرق التالية.واجهة مستخدم EDM4U
- في مشروع Unity المفتوح ، انتقل إلى الأصول> مدير التبعية الخارجية> معالج الإصدار> إلغاء تثبيت الحزم المُدارة .
- حدد جميع حزم Firebase ومدير التبعية الخارجية.
- انقر فوق إلغاء تثبيت الحزمة المحددة .
الإزالة اليدوية
باستخدام أدوات نظام الملفات ، احذف المجلدات التالية يدويًا:
-
Assets/Editor Default Resources/Firebase
-
Assets/ExternalDependencyManager
-
Assets/Firebase
-
Assets/Parse
-
Assets/Plugins/iOS/Firebase
قم باستيراد الحزم باستخدام Unity Package Manager ، كما هو موضح أعلاه في هذه الصفحة.