يتم توزيع حِزم Google لـ Unity بتنسيقَين مختلفَين:
- حِزم مواد العرض:
- امتلاك إضافة
.unitypackage
- ثبِّت التطبيق في دليل
Assets
الخاص بمشروعك. - يمكن استيرادها في Unity 5 والإصدارات الأحدث.
- تشمل بشكل عام الحِزم التابعة.
- امتلاك إضافة
- حِزم Unity Package Manager (UPM):
- امتلاك إضافة
.tgz
- ثبِّت التطبيق في دليل
Packages
الخاص بمشروعك. - يمكن استيرادها في الإصدار 2018.4 من Unity والإصدارات الأحدث.
- الحِزم المرجعية التي تعتمد على حِزم أخرى ويجب تثبيتها بشكل منفصل
- امتلاك إضافة
تحتوي صفحة الحزم على أحدث ملفات .unitypackage
لجميع الحِزم المتاحة وملفات .tgz
لبعض الحِزم.
تحتوي صفحة الأرشيف على ملفات .unitypackage
و.tgz
لجميع إصدارات الحِزم.
يمكنك العثور أدناه على تعليمات حول كيفية تثبيت كلا النوعَين من الحِزم، بالإضافة إلى تعليمات نقل البيانات من نوع إلى آخر.
بعد التعرّف على خيارات التثبيت هذه، احرص على الرجوع إلى التعليمات الإضافية الخاصة بالمنتجات في Firebase.
استيراد الحِزم باستخدام OpenUPM
يمكنك إضافة حِزم خارجية إلى مشروعك على Unity باستخدام قاعدة بيانات OpenUPM. يستضيف OpenUPM العديد من حِزم SDK والإضافات المفيدة، مثل إضافة Google Play Integrity التي تساعد في حماية تطبيقك من الاحتيال وإساءة الاستخدام.
في ما يلي كيفية إضافة المكوّن الإضافي Google Play Integrity باستخدام OpenUPM، على سبيل المثال.
OpenUPM-CLI
إذا كان لديك واجهة برمجة التطبيقات OpenUPM مثبّتة، يمكنك تثبيت قاعدة بيانات المسجّلين OpenUPM باستخدام الأمر التالي:
openupm add com.google.play.integrity
OpenUPM
افتح إعدادات مدير الحِزم من خلال اختيار خيار قائمة Unity تعديل > إعدادات المشروع > مدير الحِزم.
أضِف OpenUPM كسجلّ نطاقي إلى نافذة "مدير الحِزم":
Name: package.openupm.com URL: https://package.openupm.com Scopes: com.google.external-dependency-manager com.google.play.common com.google.play.core com.google.play.integrity
افتح قائمة مدير الحِزم من خلال اختيار خيار قائمة Unity نافذة > مدير الحِزم.
اضبط القائمة المنسدلة لنطاق المدير لاختيار سجلّاتي.
اختَر حزمة Google Play Integrity plugin for Unity من قائمة الحِزم واضغط على تثبيت.
استيراد حِزم مواد العرض باستخدام ملفات .unitypackage
استورِد ملف .unitypackage
من خلال اختيار خيار قائمة Unity
Assets > Import package > Custom Package
واستيراد جميع العناصر.
يؤدي ذلك إلى إضافة محتويات الحزمة إلى مشروعك ضمن ملف موارد
التطبيق.
استيراد حِزم 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... } }
احفظ ملف manifest.json.
عندما يستعيد Unity التركيز، ستتم إعادة تحميل ملف manifest.json واستيراد الحِزم التي تمت إضافتها حديثًا.
لا تتيح بعض الإصدارات القديمة من Unity استخدام ملفات .tgz
في ملف manifest.json.
في هذه الحالة، عليك إجراء ما يلي:
- فكِّ ضغط ملفات
.tgz
. - ضَع المجلد الذي تم استخراجه في مجلد
GooglePackages
. عدِّل ملف 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.
انقر على رمز
+
في أعلى يمين نافذة "مدير الحِزم" و اختَرAdd package from tarball
لفتح متصفّح الملفات.اختَر حزمة tar المطلوبة في متصفّح الملفات.
لا تتيح بعض الإصدارات القديمة من Unity إضافة حِزم tar مباشرةً. في هذه الحالة، عليك تنفيذ ما يلي:
- فك ضغط ملف
.tgz
. انقر على رمز
+
في أعلى يمين نافذة "مدير الحِزم" ، ثم انقر علىAdd package from disk
لفتح متصفّح الملفات.اختَر المجلد الذي تم استخراجه في متصفّح الملفات.
احرص أيضًا على استيراد ملفات .tgz
لملفات الاعتماد الخاصة بالحزمة،
التي يمكنك العثور عليها مُدرَجة في صفحة الأرشيف ضمن
قسم الحزمة المطلوبة.
على سبيل المثال، إذا كنت بصدد تثبيت com.google.firebase.storage
، عليك
تثبيت ملفات .tgz
هذه بالترتيب التالي:
- مدير التبعيات الخارجية (
com.google.external-dependency-manager
) - Firebase Core (
com.google.firebase.app
) - Firebase Auth (
com.google.firebase.auth
) - مساحة تخزين Firebase (
com.google.firebase.storage
)
إذا كنت تفضّل إضافة جميع ملفات .tgz
في آنٍ واحد، بدون القلق بشأن الترتيب، يمكنك اتّباع التعليمات الواردة في علامة التبويب
manifest.json.
التحكم في الإصدارات
إذا كنت تستخدم برنامجًا لإدارة الإصدارات لإدارة ملفات مشروعك، ننصحك
بإضافة ملفات .tgz
ذات الصلة إلى نظام إدارة الإصدارات. يمكنك يدوياً
تعديل ملف manifest.json
الخاص بمشروعك (اطّلِع على التعليمات أعلاه) والإشارة إلى ملفات .tgz
المحلية باستخدام
المسارات النسبية.
إذا كنت تستخدم git، ننصحك باستخدام
Git Large File Storage (LFS)
لإدارة ملفات .tgz
الكبيرة.
نقل البيانات من حِزم UPM إلى حِزم مواد العرض
في بعض الحالات، قد تحتاج إلى التبديل من استخدام Unity Package Manager لإدارة حِزم Google إلى تثبيت الحِزم ضمن مجلد Assets (مواد العرض).
تأكَّد من إزالة جميع حِزم Google من "مدير حِزم Unity" باستخدام إحدى الطريقتَين التاليتَين:
واجهة مستخدم "أداة إدارة الحِزم"
- افتح نافذة "مدير الحِزم" في 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"، يمكنك
تنزيل ملفات .unitypackage
البديلة واستيرادها من صفحة
الأرشيف.
نقل البيانات من حِزم مواد العرض إلى حِزم UPM
في بعض الحالات، قد تحتاج إلى التبديل من تثبيت المنتجات ضمن شجرة الأصول إلى تثبيت المنتجات وتتبُّعها باستخدام "مدير حِزم Unity".
إذا لم تكن متأكّدًا من طريقة التثبيت التي تستخدمها، يمكنك في واجهة مستخدم Unity التحقّق مما إذا كانت حِزم Google المطلوبة تظهر في علامة التبويب "المشروع" ضمن مواد العرض.
لنقل البيانات إلى حِزم UPM:
تأكَّد من إزالة جميع حِزم Google من مجلد "مواد العرض".
- لإلغاء تثبيت حِزم Firebase، اتّبِع هذه التعليمات.
- لإلغاء تثبيت "مكوّنات Play الإضافية لمحرك Unity"، احذف المجلد
GooglePlayPlugins
ضمنAssets
.
ثبِّت الحِزم باستخدام Unity Package Manager كما هو موضّح أعلاه.
تعليمات نقل البيانات الخاصة بالمنتج
يمكنك الاطّلاع على تعليمات Firebase هنا.