دمج إصدارات الوصول المبكر من "SDK لإعلانات Google على الأجهزة الجوّالة" في تطبيقات Unity

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

اتّبِع الخطوات الواردة في هذه الصفحة لدمج إصدار الوصول المبكر من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" في تطبيق Unity.

المتطلبات الأساسية

• اتّبِع دليل البدء لدمج المكوّن الإضافي "إعلانات Google على الأجهزة الجوّالة" في Unity مع مشروعك على Unity.

• إصدارات الوصول المبكر من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" التي يقدّمها مدير حسابك

تعليمات الدمج

انقر على علامة تبويب لاختيار التعليمات الخاصة بنظام التشغيل Android أو iOS. إذا كنت بصدد دمج إصدارات الوصول المبكر لكلتا المنصّتين، عليك إكمال التعليمات الواردة في كلتا علامتي التبويب.

Android

نزِّل إصدار الوصول المبكر من حزمة تطوير البرامج (SDK) لنظام التشغيل Android من "إعلانات Google على الأجهزة الجوّالة"، واستخرِجه في مكان مناسب.

بعد ذلك، أضِف هذا الموقع الجغرافي كمستودع Maven مخصّص لمكوّن Unity الإضافي الخاص بـ "إعلانات Google على الأجهزة الجوّالة".

تعديل ملف XML الخاص بالتبعيات

عدِّل محتوى ملف XML في Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml إلى ما يلي:

<dependencies>
  <androidPackages>
    <androidPackage spec="com.google.android.gms:play-services-ads:x.y.z">
      <repositories>
        <repository>/path/to/extracted/maven/repo</repository>
        <repository>https://maven.google.com/</repository>
      </repositories>
    </androidPackage>
  </androidPackages>
</dependencies>

يجب استبدال النص البارز، /path/to/extracted/maven/repo، بمسار ملف zip الخاص بمحتوى الإصدار الأولي من حزمة تطوير البرامج (SDK) لخدمة "إعلانات Google على الأجهزة الجوّالة". يمكن تحديد إصدار التبعية، الموضّح بالرمز x.y.z في المقتطف السابق، من خلال العثور على أحدث إصدار متوفّر ضمن الدليل com/google/android/gms/play-services-ads/ في المحتوى المستخرَج من ملف zip الخاص بحزمة تطوير البرامج (SDK) لنظام التشغيل Android من "إعلانات Google على الأجهزة الجوّالة" في برنامج "استخدام الميزات قبل إطلاقها".

فرض حلّ التبعية

في أداة تعديل Unity، اختَر Assets > Play Services Resolver > Android Resolver > Force Resolve. بعد ذلك، تنفّذ مكتبة Unity Play Services Resolver عملية تحديد العناصر التابعة من البداية وتنسخ العناصر التابعة المحدّدة إلى الدليل Assets/Plugins/Android لتطبيق Unity.

عند إنشاء تطبيقك، يتم تشغيل أداة تحليل JAR ثم يتم استيراد جميع العناصر التابعة المطلوبة إلى عملية الإنشاء.

iOS

تأكَّد من أنّ ملف XML الخاص بالتبعيات في Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml لا يتضمّن أي مراجع إلى CocoaPod ‏Google-Mobile-Ads-SDK.

بعد ذلك، أزِل أي نُسخ حالية من GoogleMobileAdsSDK وضعها محلّل JAR في مجلد Assets/Plugins/iOS.

نزِّل إصدار الوصول المبكر من حزمة تطوير البرامج (SDK) لنظام التشغيل iOS من "إعلانات Google على الأجهزة الجوّالة"، وضَع المحتوى الذي تم استخراجه في الدليل Assets/Plugins/iOS لمشروع Unity.

عند إنشاء تطبيقك، يتم نسخ إطار العمل إلى مشروع iOS.