يتم توزيع حزم Google لـ Unity بتنسيقين مختلفين:
- حِزم مواد العرض:
- تتوفّر لديك إضافة
.unitypackage
. - يمكنك التثبيت في دليل "
Assets
" لمشروعك. - يمكن استيرادها في إصدار Unity 5 والإصدارات الأحدث.
- تتضمن بشكل عام الحزم التابعة.
- تتوفّر لديك إضافة
- حِزم أداة Unity Package Manager (UPM):
- تتوفّر لديك إضافة
.tgz
. - يمكنك التثبيت في دليل "
Packages
" لمشروعك. - يمكن استيرادها في إصدار Unity 2018.4 والإصدارات الأحدث.
- يمكنك الرجوع إلى الحِزم التابعة التي يجب تثبيتها بشكل منفصل.
- تتوفّر لديك إضافة
تحتوي صفحة الحزم على أحدث ملفات .unitypackage
لجميع الحزم المتاحة.
تتضمن صفحة الأرشيف ملفات .unitypackage
و.tgz
لجميع إصدارات الحزم.
فيما يلي يمكنك العثور على إرشادات حول كيفية تثبيت كلا النوعين من الحزم، إلى جانب تعليمات النقل للانتقال من الكتابة إلى الأخرى.
وبعد التعرّف على خيارات التثبيت هذه، احرص على الرجوع إلى التعليمات الإضافية الخاصة بالمنتج لبرنامج Firebase.
جارٍ استيراد حِزم مواد العرض التي تتضمّن ملفات .unitypackage
.
استورِد ملف .unitypackage
من خلال تحديد خيار قائمة UnityAssets > Import package > Custom Package
واستيراد جميع العناصر.
يؤدي هذا إلى إضافة محتويات الحزمة إلى مشروعك ضمن دليل
Assets.
استيراد حزم UPM باستخدام ملفات .tgz
(2018.4 أو أحدث)
يمكنك استيراد ملفات .tgz
إلى مشروعك باستخدام إحدى الطرق التالية:
manifest.json
- أنشئ مجلدًا جديدًا بجانب مجلد
Packages
لمشروعك وقم بتسميتهGooglePackages
. - ضَع ملفات
.tgz
في ذلك المجلد. - استخدِم محرِّر نصوص لفتح
Packages/manifest.json
ضمن مجلد مشروع Unity. أضِف إدخالاً لكل حزمة تريد تثبيتها، مع ربط اسم الحزمة بالموقع على القرص بالنسبة إلى ملف
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... } }
احفظ الملف البيان.json.
عندما يستعيد Unity التركيز، ستتم إعادة تحميل ملف البيان.json واستيراد الحزم المضافة حديثًا.
لا تتيح بعض الإصدارات الأقدم من Unity إمكانية استخدام ملفات .tgz
في ملف البيان.json.
في هذه الحالة، يجب عليك:
- فك ضغط ملفات
.tgz
. - ضَع المجلد المستخرَج في مجلد
GooglePackages
. يمكنك تعديل ملف البيان.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... } }
واجهة مستخدم مدير الحزم
- افتح نافذة Package Manager (مدير الحزمة في Unity).
انقر على أيقونة
+
في الزاوية العلوية اليمنى من نافذة Package Manager واخترAdd package from tarball
لفتح متصفح الملفات.اختر tarball المطلوب في متصفح الملفات.
لا تتيح بعض الإصدارات القديمة من Unity إضافة الكرات القطنية بشكل مباشر. في هذه الحالة، ستحتاج إلى:
- فك ضغط الملف
.tgz
. انقر على الرمز
+
في أعلى يمين نافذة "مدير الحزم" واختَرAdd package from disk
لفتح متصفّح الملفات.اختَر المجلد المُستخرَج في متصفِّح الملفات.
تأكَّد أيضًا من استيراد ملفات .tgz
الخاصة بتبعيات الحزمة،
والتي يمكنك العثور عليها في صفحة الأرشيف ضمن
قسم الحزمة المطلوبة.
على سبيل المثال، إذا كنت تثبّت com.google.firebase.storage
، يمكنك تثبيت ملفات .tgz
هذه بالترتيب التالي:
- مدير التبعية الخارجية (
com.google.external-dependency-manager
) - Firebase Core (
com.google.firebase.app
) - مصادقة Firebase (
com.google.firebase.auth
) - مساحة التخزين في Firebase (
com.google.firebase.storage
)
إذا كنت تفضّل إضافة جميع ملفات .tgz
دُفعة واحدة، بدون القلق بشأن الترتيب، يمكنك اتّباع التعليمات الواردة في علامة التبويب manifest.json.
التحكم في الإصدارات
إذا كنت تستخدم برنامجًا للتحكم في الإصدار لإدارة ملفات مشروعك،
ننصحك بإضافة ملفات .tgz
ذات الصلة إلى أداة التحكم في الإصدار. يمكنك تعديل manifest.json
لمشروعك يدويًا (راجِع
التعليمات أعلاه) والإشارة إلى ملفات .tgz
المحلية باستخدام المسارات النسبية.
إذا كنت تستخدم git، ننصحك باستخدام
Git big File Storage (LFS)
لإدارة ملفات .tgz
الكبيرة.
نقل البيانات من حِزم UPM إلى حِزم مواد العرض
في بعض الحالات، قد تحتاج إلى الانتقال من استخدام Unity Package Manager لإدارة حزم Google إلى تثبيت الحزم ضمن مجلد Assets (مواد العرض).
احرص على إزالة جميع حِزم Google من Unity Package Manager باستخدام إحدى الطريقتين التاليتين:
واجهة مستخدم مدير الحزم
- افتح نافذة Package Manager (مدير الحزمة في Unity).
اختَر
In Project
من القائمة المنسدلة في أعلى يمين الصفحة.اكتب
com.google
في شريط البحث لفلترة حِزم Google.انقر على كل اسم حزمة ثم انقر على
Remove
.
manifest.json
- استخدِم محرِّر نصوص لفتح
Packages/manifest.json
ضمن مجلد مشروع Unity. - تحقَّق مما إذا كانت Google تتضمّن أي حِزم ضمن قسم "التبعيات". يجب أن يبدأ اسم الحزمة بـ "com.google"، على سبيل المثال "com.google.firebase.app".
- احذف هذه الأسطر واحفظ ملف json.
- عندما يستعيد Unity التركيز، ستتم إعادة تحميل ملف
manifest.json
وإزالة الحزم المحذوفة.
بعد إلغاء تثبيت هذه الحِزم من Unity Package Manager، يمكنك تنزيل ملفات .unitypackage
البديلة واستيرادها من صفحة الأرشيف.
نقل البيانات من حِزم مواد العرض إلى حِزم UPM
في بعض الحالات، قد تحتاج إلى التبديل من تثبيت المنتجات ضمن شجرة مواد العرض إلى تثبيت المنتجات وتتبّعها باستخدام Unity Package Manager.
إذا لم تكن متأكدًا من طريقة التثبيت التي تستخدمها، في واجهة مستخدم Unity، تحقق مما إذا كانت حزم Google المطلوبة تظهر في علامة التبويب "المشروع"، ضمن Assets.
لنقل البيانات إلى حِزم UPM:
تأكد من إزالة جميع حزم Google من مجلد Assets.
- لإلغاء تثبيت حِزم Firebase، اتّبِع هذه التعليمات.
- لإلغاء تثبيت مكوّنات Play الإضافية لنظام Unity، يمكنك حذف المجلد
GooglePlayPlugins
ضمنAssets
.
ثبِّت الحِزم باستخدام Unity Package Manager، كما هو موضّح أعلاه.
تعليمات نقل البيانات الخاصة بالمنتج
يمكنك الاطّلاع هنا على تعليمات Firebase.