إعداد إضافة "إعلانات 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 تعديل (Edit) > إعدادات المشروع (Project Settings) > مدير الحزم (Package Manager).

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

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

3. افتح قائمة مدير الحزم من خلال النقر على خيار قائمة Unity النافذة (Window) > مدير الحزم (Package Manager).

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

   

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

إزالة مواد عرض المكوّن الإضافي .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 مواد العرض (Assets) > استيراد حزمة (Import package) > حزمة مخصّصة (Custom Package) واستيراد جميع العناصر.

اختياري: إيقاف "مدير الاعتماديات الخارجية"

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

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

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

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

• نزِّل أحدث ملف .unitypackage من صفحة إصدارات "مدير الاعتماديات الخارجية" لـ Unity وانقر على مواد العرض (Assets) > استيراد حزمة (Import Package) > حزمة مخصّصة (Custom Package).

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

  openupm add com.google.external-dependency-manager

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

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

• بالنسبة إلى Android، انقر على تعديل (Edit) > إعدادات المشروع (Project Settings) > المشغّل (Player) > Android > إعدادات النشر (Publishing Settings) > الإنشاء (Build) وفعِّل نموذج Gradle الرئيسي المخصّص (Custom Main Gradle Template). أضِف المكتبات المطلوبة من الملفَين 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. أضِف وحدات pod المطلوبة من الملفَين GoogleMobileAdsDependencies.xml وGoogleUmpDependencies.xml إلى الملف Podfile في مجلد المشروع الذي تم تصديره:

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

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

  pod install --repo-update