ملاحظات الإصدار

الإصدار	تاريخ الإصدار	ملاحظات
1.5.0	2026-09-24	تمت إضافة واجهات برمجة تطبيقات لإنشاء الإشارات وعرضها بتنسيق SwipeableInterstitialAd. تتوفّر هذه الميزة في إصدار تجريبي خاص. يمكنك التواصل مع مدير حسابك لطلب إذن الوصول. تمت إضافة واجهة برمجة تطبيقات excludedAppIds إلى طلبات الإعلانات على شكل رموز، ما يتيح للناشرين استبعاد قائمة بمعرّفات التطبيقات بشكل اختياري من ردود الإعلانات على شكل رموز.
1.4.0	2026-08-20	تمت إضافة إمكانية استخدام تنسيق PictureInPictureAd. تتوفّر "الإعلانات في وضع نافذة ضمن النافذة" في إصدار تجريبي مفتوح. تمّت إضافة onInitializationFailed(AdError) وإيقاف onInitializationFailed(String) نهائيًا في InitializationCompleteCallback. يمكن لمحوّلات التوسّط الآن إرسال أخطاء إعداد حزمة تطوير البرامج (SDK) التابعة لجهة خارجية إلى حزمة تطوير البرامج (SDK) مع رمز الخطأ ونطاق الخطأ ورسالة الخطأ.
1.3.1	2026-07-29	إصلاح الأخطاء وتحسينات على الأداء لميزة ذات وصول محدود
1.3.0	2026-07-21	تم تغيير AdView.loadAd() لإيقاف المحاولات التلقائية لإعادة إرسال طلبات عرض الإعلانات التي تعذّر تنفيذها مؤقتًا عندما تكون ميزة "إعادة التحميل التلقائي" غير مفعّلة للوحدة الإعلانية. عندما لا يؤدي طلب عرض إعلانات متعدّدة أصلية أو إعلانات رموز إلى توفّر أي إعلانات، ستعرض حزمة SDK الآن الخطأ NO_FILL بدلاً من INTERNAL_ERROR. تمت إضافة علامة بيان لإيقاف "أداة فحص الإعلانات". تمّت إضافة الطريقة Ad.getAdUnitId() لتحديد رقم تعريف الوحدة الإعلانية المستخدَم لطلب الإعلان. تمت إضافة الطريقة InitializationConfig.Builder.disableSdkCrashReporting() التي توفّر خيار إيقاف معالج الأعطال التلقائي يدويًا في GMA Next-Gen SDK. وبشكلٍ تلقائي، تواصل حزمة تطوير البرامج (SDK) تفويض الأعطال إلى معالجات أخرى مسجَّلة (مثل Crashlytics). عند استخدام التوسّط مع مصادر إعلانات الأحداث المخصّصة، تعرض السمة ResponseInfo.getAdapterClassName() الآن اسم فئة الحدث المخصّص بدلاً من com.google.ads.mediation.customevent.CustomEventAdapter.
1.2.1	2026-06-15	بالنسبة إلى التطبيقات التي تستخدم WebView API للإعلانات، تم إصلاح مشكلة كانت تمنع حزمة تطوير البرامج (SDK) من تقديم إشارات إلى علامات الإعلانات المتوافقة (رمز AdSense و"علامة ناشر Google" و"إعلانات الوسائط التفاعلية" بتنسيق HTML5). حدثت هذه المشكلة بسبب استدعاء طرق Webkit بشكل غير صحيح في سلسلة محادثات في الخلفية.
1.2.0	2026-06-11	تم إصلاح خطأ يتسبّب في حدوث java.lang.NullPointerException في androidx.webkit.internal.PrefetchOperationCallbackAdapter. تمت إضافة التنسيق SwipeableInterstitialAd. تتوفّر هذه الميزة في إصدار تجريبي خاص. يمكنك التواصل مع مدير حسابك لطلب إذن الوصول. بالنسبة إلى التطبيقات التي تطلب إعلانات رموز متعددة، تمت إضافة IconAd.load(IconAdRequest, int, IconAdLoadCallback) وإيقاف IconAd.load(IconAdRequest, int, AdLoadCallback<IconAd>) نهائيًا. يتضمّن IconAdLoadCallback طريقة onAdLoadingCompleted() للإشارة إلى وقت انتهاء تحميل جميع الإعلانات. محوّلات التوسّط: تمت إضافة الطريقة RequestConfiguration.getAgeRestrictedTreatment() للسماح للمحوّلات بقراءة إعدادات المعالجة الموجّهة للفئة العمرية. تم تغيير untrackView() إلى قبول View بدلاً من View? للحفاظ على التوافق مع المحوّلات التي تم إنشاؤها باستخدام Google Mobile Ads SDK (Legacy).
1.1.1	2026-05-27	تم إصلاح مشكلة تعذُّر إغلاق المستخدمين لحزم "الإعلانات مقابل مكافأة" بسبب توقّفها مؤقتًا أثناء الانتقالات.
1.1.0	2026-05-18	تمت إضافة RequestConfiguration.Builder.setAgeRestrictedTreatment() وإيقاف الطرق التالية نهائيًا: RequestConfiguration.Builder.setTagForChildDirectedTreatment() RequestConfiguration.Builder.setTagForUnderAgeOfConsent() تمت إضافة destroyAll() وpeekAdResponseInfo() إلى فئات أداة التحميل المُسبق للإعلانات. تمت إضافة طرق load() إلى IconAd التي تتيح تحميل إعلانات رموز متعددة.
1.0.1	2026-04-30	تم إصلاح المشكلة التي كانت تؤدي إلى تعذُّر فتح الصفحات المقصودة للإعلانات التي تستخدم window.open() أو الروابط التي تتضمّن target="_blank".
1.0.0	2026-04-14	التغييرات التي قد تؤدي إلى أعطال: تمت إزالة طريقة AdPreloader.numAdsAvailable() القديمة. استخدِم AdPreloader.getNumAdsAvailable() بدلاً من ذلك. تم تعديل org.chromium.net:cronet-api إلى الإصدار 143.7445.0 لتجنُّب انتهاكات مساحة الاسم الفريدة. تم إصلاح الخطأ الذي كان يتسبّب في أن تعرض الدالتان MediaContent.currentTime وNativeAdMapper.getCurrentTime() القيمة 0 دائمًا.
0.25.0-beta01	2026-03-24	تم إصلاح المشكلة التي كانت تؤدي إلى عدم عرض Ad.getResponseInfo() لبيانات ResponseInfo الوصفية المعدَّلة عند إعادة تحميل إعلان بانر.
0.24.0-beta03	2026-03-07	تم إصلاح مشكلة عدم توقّف AdView.destroy() عن إعادة محاولة تحميل الإعلان بعد تعذُّر تحميله. تمت إضافة دوال إنشاء بدون وسيطات إلى NativeAdMapper وUnifiedNativeAdMapper لتحسين التوافق مع Kotlin. تمت إضافة السمة packageName إلى الواجهة IconAd. تمت إضافة خيار لإجبار حزمة SDK على استخدام Cronet بدلاً من OkHttp في عمليات الشبكة. لحلّ أخطاء وقت التشغيل في المشاريع التي تستخدم OkHttp 5، ننصح بفرض استخدام Cronet في عمليات الشبكة. لفرض استخدام Cronet، اضبط قيمة الإضافة force_use_cronet على true في InitializationConfig.Builder عند استدعاء MobileAds.initialize(): val config = InitializationConfig.Builder() .setExtras(bundleOf("force_use_cronet" to true)) .build() MobileAds.initialize(this, config) تمت إضافة إمكانية استخدام Java 11. لاستخدام Java 11، أضِف الرمز التالي إلى الحزمة android في ملف build.gradle: android { compileOptions { sourceCompatibility JavaVersion.VERSION_11 targetCompatibility JavaVersion.VERSION_11 } kotlinOptions { jvmTarget = '11' } }
0.24.0-beta02	2026-03-03	تم حلّ مشكلة تحميل فئة الاعتمادية التابعة لجهة خارجية والتي أثّرت في إنشاء إشارات طلب عرض الإعلان من الخادم إلى الخادم.
0.24.0-beta01	2026-02-13	تمت إضافة إمكانية عرض "إعلانات بانر تكيُّفية ثابتة" كبيرة الحجم. تم تصميم &quot;إعلانات البانر التكيُّفية الثابتة&quot; الكبيرة لزيادة التفاعل والإيرادات. يمكنك طلب "إعلانات بانر تكيُّفية ثابتة كبيرة" باستخدام الطرق التالية في الفئة AdSize: getLargePortraitAnchoredAdaptiveBannerAdSize() getLargeLandscapeAnchoredAdaptiveBannerAdSize() getLargeAnchoredAdaptiveBannerAdSize() تم إيقاف الطرق التالية نهائيًا في الفئة AdSize: getCurrentOrientationAnchoredAdaptiveBannerAdSize() getLandscapeAnchoredAdaptiveBannerAdSize() getPortraitAnchoredAdaptiveBannerAdSize() تم إصلاح الخطأ الذي قد يؤدي إلى توقّف إعادة تحميل الإعلانات الصورية إذا استدعت المنصة onViewAttachedToWindow() وonViewDetachedFromWindow() بترتيب غير صحيح عند عرض إعلان جديد.
0.23.0-beta01	2026-01-26	تم تعديل الحدّ الأدنى من إصدار "المكوّن الإضافي لنظام Gradle المتوافق مع Android" (AGP) المطلوب إلى 8.3.0. تم إصلاح الخطأ الذي كان يتسبب في عرض الدالة الإنشائية AdView للخطأ java.lang.NoSuchMethodError عند استدعائها من Kotlin. تم إصلاح خطأ لم يتم فيه استدعاء مهايئات الأحداث المخصّصة أثناء تنفيذ "توسّط العرض الإعلاني بدون انقطاع". تم تعديل RtbSignalData لتوفير Activity Context إلى RtbAdapter.collectSignals() عند توفّره. تم تعديل اعتمادية androidx.webkit إلى الإصدار 1.15.0. تم تعديل ملحق حزمة تطوير البرامج (SDK) لمنصة User Messaging Platform إلى الإصدار 4.0.0. تم التراجع عن إيقاف AdPreloader.getConfiguration() وAdPreloader.getConfigurations() نهائيًا.
0.22.0-beta04	2025-12-04	تم إصلاح مشكلة في الإصدار 0.22.0-beta02 من حزمة SDK، حيث تم تضمين البيانات الوصفية الخاصة بمعاينة Java 17 بشكل غير صحيح في ملفات الفئات.
0.22.0-beta03	2025-11-25	تم إصلاح الخطأ الذي كان يتسبّب في عدم ضبط حجم الإعلان المطلوب بشكل صحيح عند استخدام طلبات عرض الإعلانات بين الخوادم باستخدام NativeSignalRequest.Builder.setAdSize().
0.22.0-beta02	2025-11-24	تم إصلاح خطأ في تحميل &quot;إدارة إعلانات Google&quot; حيث تعذّر عرض طلبات الإعلانات من الخادم إلى الخادم التي تستخدم NativeSignalRequest إذا كانت استجابة الإعلان من النوع NativeAd.NativeAdType.BANNER.
0.22.0-beta01	2025-11-20	تعديل واجهة برمجة التطبيقات الخاصة بإعلانات البانر: تمت إضافة الفئة AdView. تم إيقاف BannerAd.load() وBannerAd.loadFromAdResponse(). لتحميل إعلان بانر واحد، استخدِم AdView.loadAd() وAdView.loadFromAdResponse() بدلاً من ذلك. تم إيقاف BannerAd.getView() نهائيًا. لعرض BannerAd محمَّل بـ BannerAdPreloader، أنشئ مثيلاً من AdView واستخدِم AdView.registerBannerAd(). تم إصلاح خطأ في الإعلانات التي يتم عرضها من خلال وسيط، حيث لم يتم الالتزام بـ NativeAdRequest.Builder.setAdChoicesPlacement()، ما أدّى إلى عدم صحة موضع رمز Ad Choices. تم تخفيض الحد الأدنى المطلوب من إصدار المكوّن الإضافي لنظام Gradle المتوافق مع Android (AGP) من 8.2.0 إلى 7.3.1. تم إيقاف AdPreloader.getConfigurations() وAdPreloader.getConfiguration(preloadId). لا يوجد بديل.
0.21.0-beta01	2025-10-08	تمت إضافة طريقة InitializationConfig.Builder.disableMediationAdapterInitialization(). استدعِ هذا الإجراء قبل تهيئة GMA Next-Gen SDK لإيقاف عملية تهيئة وسيط الإعلانات. تحسين استخدام عملية تهيئة WebView لتقليل أخطاء ANR تمت إعادة الإصدار 1.13.0 من التبعية androidx.webkit إلى الإصدار 1.12.1. تمت إزالة الإذن android.permission.RECEIVE_BOOT_COMPLETED المستخدَم من خلال الحزمة androidx.work. تم إصلاح حقل تمت تسميته بشكل خاطئ في الفئة NativeAdMapper.
0.20.0-beta01	2025-09-19	تم إصلاح الخطأ الذي كان يؤدي إلى عدم تشغيل بعض إعلانات الفيديو على المنصات الأصلية تلقائيًا.
0.19.0-beta01	2025-08-14	إصدارات أقدم من حزمتين معتمدتين ‫androidx.work:work-runtime من 2.10.0 إلى 2.7.0 ‫androidx.core:core and androidx.core:core-ktx من 1.15.0 إلى 1.12.0 تمت إعادة تسمية السمة loadedAdSourceResponse في ResponseInfo إلى loadedAdSourceResponseInfo. تم إصلاح الخطأ الذي كان يسمح للمستخدمين بإغلاق بعض الإعلانات بملء الشاشة قبل الأوان باستخدام زر الرجوع. أصبح بإمكان الناشرين الذين يمكنهم استخدام هذه الميزة الاستفادة من أرقام تعريف مواضع الإعلانات لجميع أشكال الإعلانات. تمت إضافة دالة ردّ الاتصال destroy() إلى NativeAdMapper لمحوّلات التوسّط للإعلانات المحلية.
0.18.0-beta01	2025-07-17	تم إصلاح خطأ في التوسّط للإعلانات المدمَجة مع المحتوى كان يؤدي إلى إيقاف عرض الإعلانات للمحوّلات التي كانت تشير إلى com.google.android.gms.ads.NativeAd.MediaView. تمت إضافة تعليق توضيحي إلى MobileAds.registerCustomTabsSession() باستخدام @JvmStatic. تم إصلاح الخطأ الذي كان يؤدي إلى توقّف إعادة تحميل &quot;إعلانات البانر&quot; التي يتم تحميلها باستخدام &quot;التحويل التسلسلي لشبكة AdMob&quot;.
0.17.0-alpha02	2025-06-23	تم إصلاح خطأ في عروض أسعار التوسّط للإعلانات المدمجة مع المحتوى، حيث كانت المحوّلات التي تنفّذ عروض الأسعار ولكن ليس العرض بدون انقطاع (مثل Meta Audience Network) تتعذّر دائمًا في عرض الإعلانات المدمجة مع المحتوى. تم إصلاح عُطل كان يحدث عندما يستدعي محوّل التوسّط طرق MediationAdLoadCallback متعددة لطلب عرض الإعلان واحد.
0.17.0-alpha01	2025-06-18	الإصدار ‎0.17.0-alpha01 هو إصدار تم طرحه عن طريق الخطأ ولا يتضمّن الميزات الجديدة المقصودة. يمكنك استخدام الإصدار 0.17.0-alpha02 بدلاً من ذلك.
0.16.0-alpha01	2025-05-23	لم يعُد من الضروري تفعيل إزالة التجميل اللغوي لواجهات برمجة التطبيقات Java 8 والإصدارات الأحدث. تم تعديل تبعية حزمة User Messaging Platform SDK إلى الإصدار 3.2.0. تم إصلاح خطأ في التوسّط للإعلانات المدمجة مع المحتوى كان يتسبّب في حدوث أعطال في برامج التكييف التي تشير إلى الفئة com.google.android.gms.ads.formats.MediaView. التحميل المُسبَق للإعلان: تمت إضافة getNumAdsAvailable() وإيقاف numAdsAvailable() نهائيًا. تمت إزالة علامة السمة android.adservices.AD_SERVICES_CONFIG من ملف البيان الخاص بالحزمة SDK لمنع حدوث تعارضات في الدمج للتطبيقات التي تضبط "خدمات إعلانية" خاصة بواجهة برمجة التطبيقات.
0.15.1-alpha01	2025-04-28	يجب الآن تفعيل إتاحة استخدام Java 8+ API desugaring. بالنسبة إلى التطبيقات التي تم تطويرها باستخدام Kotlin، تم تخفيض الحد الأدنى من إصدار Kotlin المطلوب من 2.1 إلى 1.9.
0.15.0-alpha01	2025-04-24	الإعلانات المدمجة مع المحتوى: تمت إضافة إمكانية تحميل إعلانات متعدّدة مدمجة مع المحتوى. تمت إضافة طريقة NativeAdLoader.load(NativeAdRequest, numberOfAds, NativeAdLoaderCallback) تطلب عرض إعلانات متعدّدة في الوقت نفسه. تمت إضافة دالة ردّ نداء NativeAdLoaderCallback.onAdLoadingCompleted() يتم تشغيلها عند اكتمال تحميل جميع &quot;الإعلانات المدمجة مع المحتوى&quot;. لإتاحة التحميل غير المتزامن في Kotlin، تمت إضافة طريقة NativeAdLoader.load(NativeAdRequest, numberOfAds) تعرض Flow<NativeAdLoadResult>. تم تعديل اعتمادية kotlinx-coroutines-android من الإصدار 1.7.3 إلى 1.9.0.
0.14.0-alpha01	2025-03-20	لا تنجح طلبات الإعلانات إذا بدأت حزمة SDK باستخدام رقم تعريف تطبيق غير صالح. لم تعُد الطريقة AdPreloader.start() تتطلّب PreloadCallback رد اتصال. يكون السمة bufferSize اختيارية عند إنشاء كائن من خلال فئة البيانات PreloadConfiguration. للسماح لـ Google بتحسين حجم ذاكرة التخزين المؤقت، لا تضبط السمة bufferSize. تمت إزالة السمة maxAdsPerSession في فئة البيانات PreloadConfiguration. تمت إضافة السمتَين shouldRequestMultipleImages وshouldReturnUrlsForImageAssets إلى الفئة NativeAdOptions.
0.13.0-alpha01	2025-02-26	تمت إضافة MediationRewardedAdCallback.onUserEarnedReward() وإيقاف MediationRewardedAdCallback.onUserEarnedReward(RewardItem) نهائيًا. تمت إضافة واجهات برمجة تطبيقات التحميل المُسبَق للإعلان.
0.12.0-alpha01	2025-01-22	تم إصلاح الخطأ الذي تسبَّب في تشويش بعض الطرق داخل AdRequest وAdRequest.Builder وSignalRequest وSignalRequest.Builder. بالنسبة إلى مستخدمي WebView API للإعلانات الذين ليس لديهم معرّف تطبيق في &quot;إدارة الإعلانات&quot;، أضفنا InitializationConfig.WEBVIEW_APIS_FOR_ADS_APPLICATION_ID يمكن تمريره أثناء عملية إعداد حزمة تطوير البرامج (SDK). تمت إضافة إمكانية الجمع بين الإعلانات المدمجة مع المحتوى وإعلانات البانر في طلبات الإعلانات على &quot;إدارة إعلانات Google&quot;.
0.11.0-alpha01	2024-12-12	تم تعديل الاعتمادية على حزمة User Messaging Platform SDK إلى الإصدار 3.1.0. تمت إضافة إمكانية استخدام إيماءات النقر المخصّصة في "الإعلانات المدمجة مع المحتوى". تمت إضافة إمكانية احتساب عدد مرات ظهور الإعلانات البانر يدويًا في حجوزات &quot;مدير إعلانات Google&quot;.
0.10.0-alpha01	2024-11-08	تمت إضافة دوال DSL لـ VideoOptions وRequestConfiguration من أجل توفير توافق أفضل مع Kotlin. تمت إضافة إمكانية استخدام Publisher Privacy Treatment API مع RequestConfiguration.setPublisherPrivacyPersonalizationState(). تمّت إضافة واجهات برمجة تطبيقات Kotlin suspend لتحميل الإعلانات وإنشاء الإشارات. تمت إزالة IconAd.LoadAdResult واستبدالها بـ AdLoadResult. تم إصلاح مشكلة عدم بدء جلسات OMID لإعلانات الفيديو المدمجة مع المحتوى.
0.9.0-alpha01	2024-10-02	تمت إزالة الاعتمادية على واجهات برمجة تطبيقات Java 8 والإصدارات الأحدث المتوفّرة من خلال عملية إزالة التجميل اللغوي من الإصدار 0.6.0-alpha01. لم يعُد على التطبيقات التي تستخدم minSdkVersion أقل من 26 تفعيل إتاحة إزالة التجميل اللغوي لواجهات برمجة التطبيقات Java 8 والإصدارات الأحدث. تمت إضافة إمكانية استخدام "أداة فحص الإعلانات". تمت إضافة إمكانية عرض الفيديو في شكل "الإعلانات المدمجة مع المحتوى" المخصّص. الإصدار الرسمي لواجهات برمجة التطبيقات لجمع الإشارات وعرضها
0.8.0-alpha01	2024-08-22	تم تعديل الاعتمادية على حزمة User Messaging Platform SDK إلى الإصدار 3.0.0. الإعلانات المدمجة مع المحتوى: نسخة الإصدار الرسمية لشكل الإعلان المدمج مع المحتوى تمت إضافة إمكانية عرض الفيديو في مادة العرض MediaContent. تمت إضافة عمليات رد الاتصال لدورة حياة الفيديو. تمت إضافة عناصر تحكّم مخصّصة لتشغيل الفيديو. تم تفعيل "القياس المفتوح" للإعلانات المدمجة مع المحتوى والإعلانات المدمجة مع المحتوى المخصّصة. أصبح حقل signalType مطلوبًا عند إنشاء SignalRequest.
0.6.0-alpha01	2024-06-20	تمت إضافة رمز برمجي يستخدم واجهات برمجة تطبيقات Java 8 والإصدارات الأحدث المتاحة من خلال عملية إزالة التكرار. يجب أن تفعّل التطبيقات التي تستخدم minSdkVersion إصدارًا أقل من 26 إمكانية إزالة التجميل اللغوي لواجهات برمجة التطبيقات Java 8 والإصدارات الأحدث. تمت إضافة إمكانية استخدام أشكال الإعلانات المدمجة مع المحتوى والمخصّصة التي لا تتضمّن مواد عرض فيديو. تمت إضافة دعم الإصدار 3 من MRAID. تمت إضافة الاعتمادية على الإصدار 2.2.0 من حزمة User Messaging Platform SDK. تم تعديل نطاق الخطأ الخاص بأخطاء Google من com.google.android.gms.ads إلى com.google.android.libraries.ads.mobile.sdk. تمت إضافة الطريقة MobileAds.isInitialized() للتحقّق مما إذا كانت حزمة SDK قد تم تهيئتها من قبل. تمت إضافة BannerAd.isCollapsible() للتحقّق مما إذا كان الإعلان البانر الذي تم عرضه قابلاً للتصغير. تمت إضافة MobileAds.registerCustomTabsSession() لتحسين تحقيق الربح من الإعلانات في علامات التبويب المخصّصة. تمت إعادة تسمية OnInitializationCompleteListener إلى OnAdapterInitializationCompleteListener. تمت إعادة تسمية AdapterResponseInfo إلى AdSourceResponseInfo. تمت إعادة تسمية AdRequest.Builder.putAdNetworkExtrasBundle() إلى AdRequest.Builder.putAdSourceExtrasBundle(). تم إصلاح الخطأ الذي كان يتسبّب في عدم إنشاء فئات محوّل عروض الأسعار بشكل صحيح.
0.3.0-alpha01	2024-03-20	الإصدار الأوّلي من GMA Next-Gen SDK تتوافق مع إعلانات البانر والإعلانات البينية والإعلانات مقابل مكافأة والإعلانات البينية مقابل مكافأة والإعلانات على شاشة فتح التطبيق. تتيح التوسّط لجميع أشكال الإعلانات. إنّ برامج التكييف المكتوبة لحزمة "SDK لإعلانات Google على الأجهزة الجوّالة" الحالية متوافقة مع الإصدار GMA Next-Gen SDK. تمت إضافة الاعتمادية على الإصدار 1.4.10 من حزمة SDK للقياس المفتوح.