إعداد إضافة "إعلانات Google على الأجهزة الجوّالة" في Unity

OpenUPM-CLI

إذا كان لديك OpenUPM CLI مثبّتًا، يمكنك تثبيت سجلّ OpenUPM باستخدام الأمر التالي:

openupm add com.google.ads.mobile

إزالة مادتَي عرض (.unitypackage) للإضافات

إذا كنت بصدد نقل البيانات من استخدام .unitypackage إلى استخدام OpenUPM، عليك إلغاء تثبيت مواد العرض يدويًا من الموقع القديم. أزِل الأدلة التالية التي تم استيرادها من .unitypackage:

• Assets/ExternalDependencyManager
• Assets/GoogleMobileAds
• Assets/Plugins/Android/googlemobileads-unity.aar
• Assets/Plugins/Android/GoogleMobileAdsPlugin
• Assets/Plugins/iOS/GADUAdNetworkExtras
• Assets/Plugins/iOS/unity-plugin-library.a

‫OpenUPM مع واجهة مستخدم

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

2. أضِف OpenUPM كسجلّ محدد النطاق إلى نافذة "مدير الحزم" (Package Manager):

   Name: OpenUPM
   URL: https://package.openupm.com
   Scopes: com.google
   

3. افتح قائمة إدارة الحِزم من خلال تحديد خيار قائمة Unity‏ Window > Package Manager.

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

   

5. اختَر حزمة "إعلانات Google على الأجهزة الجوّالة" في Unity من قائمة الحزم، ثم انقر على تثبيت.

إزالة مادتَي عرض (.unitypackage) للإضافات

إذا كنت بصدد نقل البيانات من استخدام .unitypackage إلى استخدام OpenUPM، عليك إلغاء تثبيت مواد العرض يدويًا من الموقع القديم. أزِل الأدلة التالية التي تم استيرادها من .unitypackage:

• Assets/ExternalDependencyManager
• Assets/GoogleMobileAds
• Assets/Plugins/Android/googlemobileads-unity.aar
• Assets/Plugins/Android/GoogleMobileAdsPlugin
• Assets/Plugins/iOS/GADUAdNetworkExtras
• Assets/Plugins/iOS/unity-plugin-library.a

OpenUPM

1. استرجِع علامة الإصدار الأخير. العلامة التي تم عرضها، باستثناء البادئة v، هي الإصدار Google Mobile Ads Unity Plugin.

   • نظاما التشغيل macOS وLinux

     curl -sS https://api.github.com/repos/googleads/googleads-mobile-unity/releases/latest | jq -r '.tag_name'

   • Windows PowerShell

     (Invoke-RestMethod -Uri "https://api.github.com/repos/googleads/googleads-mobile-unity/releases/latest").tag_name
     

2. عدِّل ملف Packages/manifest.json لإضافة سجلّ OpenUPM المحدود النطاق والتبعية باستخدام الإصدار الذي تم الحصول عليه من الأمر السابق:

   {
     "scopedRegistries": [
       {
         "name": "google",
         "url": "https://package.openupm.com",
         "scopes": [
           "com.google"
         ]
       }
     ],
     "dependencies": {
       "com.google.ads.mobile": "11.6.0"
     }
   }
   

إزالة مادتَي عرض (.unitypackage) للإضافات

إذا كنت بصدد نقل البيانات من استخدام .unitypackage إلى استخدام OpenUPM، عليك إلغاء تثبيت مواد العرض يدويًا من الموقع القديم. أزِل الأدلة التالية التي تم استيرادها من .unitypackage:

• Assets/ExternalDependencyManager
• Assets/GoogleMobileAds
• Assets/Plugins/Android/googlemobileads-unity.aar
• Assets/Plugins/Android/GoogleMobileAdsPlugin
• Assets/Plugins/iOS/GADUAdNetworkExtras
• Assets/Plugins/iOS/unity-plugin-library.a

الاستيراد من GitHub

1. نزِّل إصدار .unitypackage من GitHub.
2. استورِد ملف .unitypackage من خلال تحديد خيار قائمة Unity مواد العرض > استيراد الحزمة > حزمة مخصّصة واستيراد جميع العناصر.

اختياري: إيقاف أداة External Dependency Manager

إذا كنت تدير مكتبات Android وiOS باستخدام أدوات الإنشاء الخاصة بك، يمكنك إيقاف حزمة com.unity.external-dependency-manager:

في Unity Editor، اختَر Window > Package Manager وأزِل حزمة External Dependency Manager (com.unity.external-dependency-manager). تؤدي إزالة هذه الحزمة إلى محو تفعيل مدير التبعية الخارجية في مواد العرض > إعلانات Google على الأجهزة الجوّالة > الإعدادات.

تثبيت الإصدار القديم من "مدير التبعيات الخارجية"

إذا كان مشروعك يستخدم الإصدار 2022.2 من Unity أو إصدارًا أقدم، يمكنك تثبيت حزمة com.google.external-dependency-manager القديمة من Google بعد إيقاف حزمة Unity:

• نزِّل أحدث ملف .unitypackage من صفحة إصدارات "مدير التبعيات الخارجية" في Unity واختَر مواد العرض > استيراد حزمة > حزمة مخصّصة.

• نفِّذ أمر OpenUPM CLI التالي:

  openupm add com.google.external-dependency-manager

ضبط التبعيات الأصلية يدويًا

إذا كنت لا تستخدم حزمة "مدير التبعيات الخارجية"، أضِف المكتبات المطلوبة من ملفَي Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml وAssets/GoogleMobileAds/Editor/GoogleUmpDependencies.xml إلى ملفات الإصدار:

• بالنسبة إلى Android، اختَر تعديل > إعدادات المشروع > المشغّل > Android > إعدادات النشر > إنشاء وفعِّل نموذج Gradle الرئيسي المخصّص. أضِف المكتبات المطلوبة من ملفَي GoogleMobileAdsDependencies.xml وGoogleUmpDependencies.xml إلى قسم dependencies في ملف Assets/Plugins/Android/mainTemplate.gradle:

  implementation 'com.google.android.gms:play-services-ads:25.5.0'
  implementation 'com.google.android.ump:user-messaging-platform:4.0.0'
  

  أضِف أيضًا حِزم androidx.constraintlayout:constraintlayout وandroidx.lifecycle:lifecycle-process وandroidx.fragment:fragment باستخدام الإصدارات في ملف GoogleMobileAdsDependencies.xml.

• بالنسبة إلى iOS، عليك تصدير مشروع Xcode. أضِف مجموعات الإعلانات المتسلسلة المطلوبة من ملفَي GoogleMobileAdsDependencies.xml وGoogleUmpDependencies.xml إلى ملف Podfile في مجلد المشروع الذي تم تصديره:

  pod 'Google-Mobile-Ads-SDK'
  pod 'GoogleUserMessagingPlatform'
  

  بعد ذلك، نفِّذ الأمر التالي في مجلد مشروع iOS الذي تم تصديره:

  pod install --repo-update