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

الإصدار	تاريخ الإصدار	ملاحظات
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	تم إصلاح خطأ في تحميل "مدير إعلانات Google" حيث تعذّر عرض طلبات الإعلانات من الخادم إلى الخادم التي تستخدم 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 لإيقاف عملية بدء محوّل التوسّط. يمكن أن يؤثر استدعاء هذا الإجراء سلبًا في أداء ميزة التوسّط من Google. يجب عدم استدعاء هذه الطريقة إلا إذا كنت تضمِّن برامج التكييف الخاصة بالتوسّط من Google في تطبيقك ولكنّك لا تستخدم ميزة "التوسّط" في AdMob خلال جلسة تطبيق معيّنة، مثل إجراء اختبار توسّط A/B. تحسين استخدام عملية تهيئة WebView لتقليل أخطاء ANR تمت ترقية إصدار التبعية androidx.webkit من 1.13.0 إلى 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. تم إصلاح الخطأ الذي كان يؤدي إلى توقّف إعادة تحميل "إعلانات البانر" التي يتم تحميلها باستخدام "العرض الإعلاني بدون انقطاع" في شبكة AdMob.
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 والإصدارات الأحدث. تم تعديل الاعتمادية على حزمة تطوير البرامج (SDK) لمنصة User Messaging Platform إلى الإصدار 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 والإصدارات الأحدث. بالنسبة إلى التطبيقات التي تم تطويرها باستخدام لغة Kotlin، تم تخفيض الحد الأدنى من إصدار Kotlin المطلوب من 2.1 إلى 1.9.
0.15.0-alpha01	2025-04-24	الإعلانات المدمجة مع المحتوى: تمت إضافة إمكانية تحميل إعلانات مدمجة مع المحتوى متعددة. تمت إضافة طريقة NativeAdLoader.load(NativeAdRequest, numberOfAds, NativeAdLoaderCallback) تطلب إعلانات متعددة في الوقت نفسه. تمت إضافة دالة ردّ نداء NativeAdLoaderCallback.onAdLoadingCompleted() يتم تشغيلها عند اكتمال تحميل جميع الإعلانات المدمجة مع المحتوى. لإتاحة التحميل غير المتزامن في 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 for Ads الذين ليس لديهم معرّف تطبيق في &quot;مدير إعلانات Google&quot;، أضفنا InitializationConfig.WEBVIEW_APIS_FOR_ADS_APPLICATION_ID يمكن تمريره أثناء عملية إعداد حزمة تطوير البرامج (SDK). تمت إضافة إمكانية الجمع بين الإعلانات المدمجة مع المحتوى وإعلانات البانر في طلبات الإعلانات على "مدير إعلانات Google".
0.11.0-alpha01	2024-12-12	تم تعديل الاعتمادية على حزمة تطوير البرامج لمنصة User Messaging Platform إلى الإصدار 3.1.0. تمت إضافة إمكانية استخدام إيماءات نقر مخصّصة في "الإعلانات المدمجة مع المحتوى". تمت إضافة إمكانية احتساب مرات ظهور الإعلانات البانر يدويًا في حجوزات &quot;مدير إعلانات Google&quot;.
0.10.0-alpha01	2024-11-08	تمت إضافة دوال DSL لـ VideoOptions وRequestConfiguration من أجل توفير توافق أفضل مع Kotlin. تمت إضافة دعم Publisher Privacy Treatment API مع RequestConfiguration.setPublisherPrivacyPersonalizationState(). تمّت إضافة واجهات برمجة تطبيقات Kotlin المعلقة لتحميل الإعلانات وإنشاء الإشارات. تمت إزالة 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 إلى الإصدار 3.0.0. الإعلانات المدمجة مع المحتوى: إصدار الإصدار الرسمي لشكل الإعلان المدمج مع المحتوى تمت إضافة إمكانية عرض الفيديو في مادة العرض MediaContent. تمت إضافة عمليات استدعاء في إحدى مراحل نشاط الفيديو. تمت إضافة عناصر تحكّم مخصّصة لتشغيل الفيديو. تم تفعيل Open Measurement للإعلانات المدمجة مع المحتوى والإعلانات المدمجة مع المحتوى المخصّصة. أصبح الحقل signalType مطلوبًا عند إنشاء SignalRequest.
0.6.0-alpha01	2024-06-20	تمت إضافة رمز برمجي يستخدم واجهات برمجة تطبيقات Java 8 والإصدارات الأحدث المتاحة من خلال عملية إزالة التشفير. يجب أن تفعِّل التطبيقات التي تستخدم الإصدار minSdkVersion أو إصدارًا أقدم إمكانية إزالة التجميل اللغوي لواجهات برمجة التطبيقات المتوافقة مع Java 8 والإصدارات الأحدث.26 تمت إضافة إمكانية عرض أشكال الإعلانات الأصلية والإعلانات الأصلية المخصّصة التي لا تتضمّن مواد عرض فيديو. تمّت إضافة إمكانية استخدام الإصدار 3 من MRAID. تمت إضافة تبعية على الإصدار 2.2.0 من حزمة تطوير البرامج (SDK) لمنصة User Messaging Platform. تم تعديل نطاق الخطأ الخاص بأخطاء 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 تتوافق مع إعلانات البانر والإعلانات البينية والإعلانات بمكافأة والإعلانات البينية بمكافأة والإعلانات على شاشة فتح التطبيق. تتيح التوسّط لجميع أشكال الإعلانات. إنّ برامج التكييف المكتوبة لحزمة "SDK لإعلانات الأجهزة الجوّالة" الحالية متوافقة مع الإصدار GMA Next-Gen SDK. تمت إضافة عنصر تابع لإصدار 1.4.10 من حزمة Open Measurement SDK.