تثبيت حِزم Google لنظام التشغيل Unity

يتم توزيع حِزم 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

  1. افتح إعدادات مدير الحِزم من خلال اختيار خيار قائمة Unity تعديل > إعدادات المشروع > مدير الحِزم.

  2. أضِف 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

  3. افتح قائمة مدير الحِزم من خلال اختيار خيار قائمة Unity نافذة > مدير الحِزم.

  4. اضبط القائمة المنسدلة لنطاق المدير لاختيار سجلّاتي.

  5. اختَر حزمة Google Play Integrity plugin for Unity من قائمة الحِزم واضغط على تثبيت.

استيراد حِزم مواد العرض باستخدام ملفات .unitypackage

استورِد ملف .unitypackage من خلال اختيار خيار قائمة Unity Assets > Import package > Custom Package واستيراد جميع العناصر. يؤدي ذلك إلى إضافة محتويات الحزمة إلى مشروعك ضمن ملف موارد التطبيق.

استيراد حِزم UPM باستخدام ملفات .tgz (الإصدار 2018.4 والإصدارات الأحدث)

استورِد ملفات .tgz إلى مشروعك باستخدام إحدى الطريقتَين التاليتَين:

manifest.json

  1. أنشئ مجلدًا جديدًا بجانب مجلد Packages الخاص بمشروعك واسمه GooglePackages.
  2. ضَع ملفات .tgz في هذا المجلد.
  3. استخدِم محرِّر نصوص لفتح Packages/manifest.json ضمن مجلد مشروع Unity.

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

  5. احفظ ملف manifest.json.

  6. عندما يستعيد Unity التركيز، ستتم إعادة تحميل ملف manifest.json واستيراد الحِزم التي تمت إضافتها حديثًا.

لا تتيح بعض الإصدارات القديمة من Unity استخدام ملفات .tgz في ملف manifest.json. في هذه الحالة، عليك إجراء ما يلي:

  1. فكِّ ضغط ملفات .tgz.
  2. ضَع المجلد الذي تم استخراجه في مجلد GooglePackages.

  3. عدِّل ملف 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...
  }
}

واجهة مستخدم "أداة إدارة الحِزم"

  1. افتح نافذة "مدير الحِزم" في Unity.

  2. انقر على رمز + في أعلى يمين نافذة "مدير الحِزم" و اختَر Add package from tarball لفتح متصفّح الملفات.

    لقطة شاشة لواجهة Unity Package Manager (مدير حِزم Unity) مع

  3. اختَر حزمة tar المطلوبة في متصفّح الملفات.

لا تتيح بعض الإصدارات القديمة من Unity إضافة حِزم tar مباشرةً. في هذه الحالة، عليك تنفيذ ما يلي:

  1. فك ضغط ملف .tgz.

  2. انقر على رمز + في أعلى يمين نافذة "مدير الحِزم" ، ثم انقر على Add package from disk لفتح متصفّح الملفات.

    لقطة شاشة لواجهة Unity Package Manager مع

  3. اختَر المجلد الذي تم استخراجه في متصفّح الملفات.

احرص أيضًا على استيراد ملفات .tgz لملفات الاعتماد الخاصة بالحزمة، التي يمكنك العثور عليها مُدرَجة في صفحة الأرشيف ضمن قسم الحزمة المطلوبة.

على سبيل المثال، إذا كنت بصدد تثبيت com.google.firebase.storage، عليك تثبيت ملفات .tgz هذه بالترتيب التالي:

  1. مدير التبعيات الخارجية (com.google.external-dependency-manager)
  2. Firebase Core (com.google.firebase.app)
  3. Firebase Auth (com.google.firebase.auth)
  4. مساحة تخزين 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" باستخدام إحدى الطريقتَين التاليتَين:

واجهة مستخدم "أداة إدارة الحِزم"

  1. افتح نافذة "مدير الحِزم" في Unity.

  2. انقر على In Project في القائمة المنسدلة في أعلى يمين الصفحة.

    لقطة شاشة لواجهة Unity Package Manager (مدير حِزم Unity) مع

  3. اكتب com.google في شريط البحث لفلترة حِزم Google.

    لقطة شاشة لواجهة Unity Package Manager (مدير حِزم Unity) مع

  4. انقر على كل اسم حزمة ثم انقر على Remove.

manifest.json

  1. استخدِم محرِّر نصوص لفتح Packages/manifest.json ضمن مجلد مشروع Unity.
  2. تحقَّق مما إذا كانت هناك أي حِزم من Google ضمن "التبعيات". يجب أن يبدأ اسم الحزمة بـ "com.google"، على سبيل المثال "com.google.firebase.app".
  3. احذف هذه الأسطر واحفظ ملف json.
  4. عندما يستعيد Unity التركيز، سيعيد تحميل ملف manifest.json ويزيل الحزم المحذوفة.

بعد إلغاء تثبيت هذه الحِزم من "مدير حِزم Unity"، يمكنك تنزيل ملفات .unitypackage البديلة واستيرادها من صفحة الأرشيف.

نقل البيانات من حِزم مواد العرض إلى حِزم UPM

في بعض الحالات، قد تحتاج إلى التبديل من تثبيت المنتجات ضمن شجرة الأصول إلى تثبيت المنتجات وتتبُّعها باستخدام "مدير حِزم Unity".

إذا لم تكن متأكّدًا من طريقة التثبيت التي تستخدمها، يمكنك في واجهة مستخدم Unity التحقّق مما إذا كانت حِزم Google المطلوبة تظهر في علامة التبويب "المشروع" ضمن مواد العرض.

لنقل البيانات إلى حِزم UPM:

  1. تأكَّد من إزالة جميع حِزم Google من مجلد "مواد العرض".

    • لإلغاء تثبيت حِزم Firebase، اتّبِع هذه التعليمات.
    • لإلغاء تثبيت "مكوّنات Play الإضافية لمحرك Unity"، احذف المجلد GooglePlayPlugins ضمن Assets.

  2. ثبِّت الحِزم باستخدام Unity Package Manager كما هو موضّح أعلاه.

تعليمات نقل البيانات الخاصة بالمنتج

يمكنك الاطّلاع على تعليمات Firebase هنا.