بدلاً من تنزيل ملف .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.
بعد التنزيل، للاستيراد:
في مشروع 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 الأساسية (
com.google.firebase.app
) - منتجات Firebase المستخدمة في مشروعك. إذا كنت تستخدم Realtime Database أو Cloud Storage، فاستورد المصادقة (
com.google.firebase.auth
) أولاً.
- مدير التبعية الخارجية (
بعد التنزيل، قم باستيراد ملفات .tgz
إلى مشروعك باستخدام إحدى الطرق التالية:
واجهة مستخدم مدير الحزم
- افتح نافذة مدير الحزم الخاصة بـ Unity.
- انقر فوق أيقونة
+
في الزاوية العلوية اليسرى من نافذة Package Manager وحددAdd package from tarball
لفتح متصفح الملفات. - حدد كرة القطران المطلوبة في متصفح الملفات.
لا تدعم بعض الإصدارات الأقدم من Unity 2019 إضافة كرات القطران مباشرةً. في هذه الحالة، سوف تحتاج إلى:
- قم بفك ضغط ملف
.tgz
. - انقر فوق أيقونة
+
في الزاوية العلوية اليسرى من نافذة Package Manager وحددAdd package from disk
لفتح متصفح الملفات. - حدد المجلد المستخرج في متصفح الملفات.
البيان.json
- قم بإنشاء مجلد جديد بجوار مجلد
Packages
الخاص بمشروعك وقم بتسميتهGooglePackages
. - ضع ملفات
.tgz
في هذا المجلد. - استخدم محرر النصوص لفتح
Packages/manifest.json
ضمن مجلد مشروع Unity الخاص بك. أضف إدخالاً لكل حزمة تريد استيرادها، وقم بتعيين اسم الحزمة إلى الموقع على القرص. تأكد من إلحاق
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
.عندما تستعيد Unity التركيز، ستقوم بإعادة تحميل
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 الحالية في مشروعك وقم بإزالتها.
- من قائمة النافذة ، حدد مدير الحزم . في نافذة مدير الحزم ، تأكد من تحديد "الحزم: في المشروع".
- لاحظ إصدارات حزم Firebase المستوردة.
- انقر فوق اسم كل حزمة، ثم انقر فوق إزالة . تأكد من إزالة حزمة مدير التبعية الخارجية (
.com.google.external-dependency-manager
) بالإضافة إلى حزم Firebase.
قم بتنزيل واستيراد ملفات
.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:
تأكد من إزالة جميع حزم 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، كما هو موضح أعلاه في هذه الصفحة.