privacysandbox ui

الإعلان عن التبعيات

لإضافة تبعية على privacysandbox-ui، يجب إضافة مستودع Google Maven إلى مشروعك. اطّلِع على مستودع Maven من Google لمزيد من المعلومات.

أضِف التبعيات للعناصر التي تحتاج إليها في ملف build.gradle ل تطبيقك أو وحدتك:

dependencies {
    // Use to implement privacysandbox ui
    implementation "androidx.privacysandbox.ui:ui:1.0.0-alpha09"

    // Use to implement privacysandbox ui-core
    implementation "androidx.privacysandbox.ui:ui-core:1.0.0-alpha09"
   
    // Use to implement privacysandbox ui-core
    implementation "androidx.privacysandbox.ui:ui-provider:1.0.0-alpha09"
}

dependencies {
    // Use to implement privacysandbox ui
    implementation("androidx.privacysandbox.ui:ui:1.0.0-alpha09")

    // Use to implement privacysandbox ui-core
    implementation("androidx.privacysandbox.ui:ui-core:1.0.0-alpha09")

    // Use to implement privacysandbox ui-provider
    implementation("androidx.privacysandbox.ui:ui-provider:1.0.0-alpha09")

    
}

لمزيد من المعلومات عن العناصر الاعتمادية، اطّلِع على مقالة إضافة عناصر الاعتماد الخاصة بالإنشاء.

ملاحظات

تساعدنا ملاحظاتك في تحسين Jetpack. يُرجى إعلامنا إذا واجهت مشاكل جديدة أو كان لديك أفكار لتحسين هذه المكتبة. يُرجى الاطّلاع على المشاكل الحالية في هذه المكتبة قبل إنشاء مكتبة جديدة. يمكنك إضافة صوتك إلى مشكلة حالية عن طريق النقر على زر النجمة.

إنشاء مشكلة جديدة

اطّلِع على مستندات أداة تتبُّع المشاكل لمزيد من المعلومات.

الإصدار 1.0

الإصدار 1.0.0-alpha12

11 كانون الأول (ديسمبر) 2024

تم إصدار androidx.privacysandbox.ui:ui-client:1.0.0-alpha12 وandroidx.privacysandbox.ui:ui-core:1.0.0-alpha12 وandroidx.privacysandbox.ui:ui-provider:1.0.0-alpha12. يتضمّن الإصدار 1.0.0-alpha12 عمليات الربط هذه.

الميزات الجديدة

• تم استبدال StateChangedListener بـ SandboxedSdkViewEventListener. يمكن استخدام أداة معالجة الأحداث هذه لرصد أحداث واجهة المستخدم المعروضة وأحداث إغلاق الجلسة وأحداث أخطاء الجلسة.

تغييرات واجهة برمجة التطبيقات

• تضيف SandboxedSdkViewEventListener للاستماع إلى أحداث واجهة المستخدم داخل SandboxedSdkView. يزيل هذا الإصدار أيضًا StateChangedListener. (Id71ea)

إصلاح الأخطاء

• تمت إزالة منطق حدود الاقتصاص من SandboxedSdkView. سيؤدي ذلك إلى حدوث مشاكل في تجربة المستخدم في حال وضع SandboxedSdkView في حاوية قابلة للتقديم أو الإيقاف ولم يتم استدعاء orderProviderUiAboveClientUi(false) (إلى أن يتم إصلاح الخطأ في إطار العمل الأساسي). (Id420d)
• تم إصلاح RemoteException الذي يمكن أن يحدث إذا توقّفت العملية البعيدة أثناء استخدام DelegatingSandboxedUiAdapter.

الإصدار 1.0.0-alpha11

13 تشرين الثاني (نوفمبر) 2024

تم إصدار androidx.privacysandbox.ui:ui-client:1.0.0-alpha11 وandroidx.privacysandbox.ui:ui-core:1.0.0-alpha11 وandroidx.privacysandbox.ui:ui-provider:1.0.0-alpha11. يتضمّن الإصدار 1.0.0-alpha11 عمليات الربط هذه.

الميزات الجديدة

• تمّ تقديم واجهة برمجة تطبيقات تجريبية، وهي DelegatingSandboxedUiAdapter، التي توفّر SandboxedUiAdapter ويمكن استخدامها لتفويض SandboxedUiAdapters مختلفة. عند ضبط هذا المحوِّل على حاوية عميل مثل SandboxedSdkView، يمكن للمحوِّل المفوَّض تغيير المحوِّل المفوَّض باستخدام updateDelegate. سيؤدي ذلك إلى إغلاق الجلسة الحالية وإنشاء SandboxedUiAdapter.Session جديد للمندوب الجديد. يتيح ذلك الانتقال بسلاسة بين المفوَّضين. (I5f1c5، I9e3e7)
• تمت إضافة تحسينات على SandboxedSdkView لإضافة مسافة بين العناصر. (Ic414f)

إصلاح الأخطاء

• تم إصلاح NullPointerException التي يمكن أن تحدث في حدث تنسيق شامل.

الإصدار 1.0.0-alpha10

18 أيلول (سبتمبر) 2024

تم إصدار androidx.privacysandbox.ui:ui-client:1.0.0-alpha10 وandroidx.privacysandbox.ui:ui-core:1.0.0-alpha10 وandroidx.privacysandbox.ui:ui-provider:1.0.0-alpha10. يتضمّن الإصدار 1.0.0-alpha10 عمليات الربط هذه.

الميزات الجديدة

• تم تعديل منطق فتح الجلسات لفتح جلسة داخل SandboxedSdkView فقط إذا كانت النافذة التي تحتوي على SandboxedSdkView مرئية.
• تم تعديل منطق SessionObserver لإرسال onUiContainerChanged عند تغيير مستوى رؤية النافذة التي تحتوي على SandboxedSdkView.

إصلاح الأخطاء

• استدعاء onUiContainerChanged عند تغيير مستوى رؤية النافذة (I541cf)
• تمت إزالة التحديد اليدوي للوصول إلى واجهات برمجة تطبيقات المنصة الجديدة لأنّ ذلك يحدث تلقائيًا من خلال وضع نماذج لواجهات برمجة التطبيقات عند استخدام R8 مع AGP 7.3 أو إصدار أحدث (مثل R8 الإصدار 3.3) ولجميع الإصدارات عند استخدام AGP 8.1 أو إصدار أحدث (مثل D8 الإصدار 8.1). ننصح العملاء الذين لا يستخدمون AGP بالتحديث إلى الإصدار 8.1 من D8 أو إصدار أحدث. يُرجى مراجعة هذه المقالة للاطّلاع على مزيد من التفاصيل. (If6b4c، b/345472586)

الإصدار 1.0.0-alpha09

26 حزيران (يونيو) 2024

تم إصدار androidx.privacysandbox.ui:ui-client:1.0.0-alpha09 وandroidx.privacysandbox.ui:ui-core:1.0.0-alpha09 وandroidx.privacysandbox.ui:ui-provider:1.0.0-alpha09. يتضمّن الإصدار 1.0.0-alpha09 عمليات الربط هذه.

الميزات الجديدة

• تمّت إضافة فئتَي AbstractSandboxedUiAdapter وAbstractSandboxedUiAdapter.AbstractSession المجردة اللتين يمكن لمزوّدي واجهات المستخدم استخدامهما لتجنُّب تنفيذ واجهات SandboxedUiAdapter أو Session بالكامل. ننصح موفّري واجهة المستخدم باستخدام هذه الفئات المجردة.
• تمت إضافة منطق registerObserverFactory الذي يسمح بإرفاق SessionObserverFactory بـ SandboxedUiAdapter. عند إرفاق SessionObserverFactory بمحوِّل، سيتم إنشاء SessionObserver لكل جلسة واجهة مستخدم جديدة يتم إنشاؤها لهذا المحوِّل. سيتلقّى SessionObserver الذي تم إنشاؤه مكالمة onSessionOpened عند فتح جلسة واجهة المستخدم. عند تغيير عرض واجهة المستخدم لعرض Session، سيتمّ استدعاء SessionObserver.onUiContainerChanged. يتمّ الحدّ من معدّل تكرار onUiContainerChanged، وسيتمّ استدعاؤه كل 200 ملي ثانية كحدّ أقصى.
• تمت إضافة SandboxedSdkViewUiInfo التي يمكن إنشاؤها من Bundle المُرسَلة في SessionObserver.onUiContainerChanged. يمثّل هذا العنصر حالة واجهة المستخدم لـ SandboxedSdkView التي تستضيف جلسة واجهة المستخدم. يحتوي على معلومات الارتفاع والعرض، وRect يمثّل شكل العارض الظاهر على الشاشة، وإشارة إلى مستوى الشفافية التي تمثّل مستوى شفافية العارض.

تغييرات واجهة برمجة التطبيقات

• أضِف تلميحًا بشأن الشفافية إلى SandboxedSdkViewUiInfo. (I093ac)
• أضِف SessionObserver.onUiContainerChanged وSandboxedSdkViewUiInfo. (Ie98bc)
• أضِف واجهة SessionObserver ومنطق التسجيل. (I047dc)
• أضِف AbstractSandboxedUiAdapter وAbstractSession. (I3617a)

المشاكل المعروفة

• عندما يكون مقدّم واجهة المستخدم في العملية نفسها التي يجريها تطبيق العميل، لا يتم إرسال SessionObserver.onUiContainerChanged عند الانتقال للأعلى أو للأسفل في الحاوية.

الإصدار 1.0.0-alpha08

14 أيار (مايو) 2024

تم إصدار androidx.privacysandbox.ui:ui-client:1.0.0-alpha08 وandroidx.privacysandbox.ui:ui-core:1.0.0-alpha08 وandroidx.privacysandbox.ui:ui-provider:1.0.0-alpha08. يحتوي الإصدار 1.0.0-alpha08 على عمليات الربط هذه.

الميزات الجديدة

• تمت إضافة إمكانية استخدام SandboxedSdkView داخل PoolingContainer، مثل RecyclerView. عندما يكون SandboxedSdkView تابعًا لعنصر PoolingContainer، سيتمّ مواءمة دورة حياة جلسات واجهة المستخدم مع دورة حياة PoolingContainer لضمان استمرار الجلسة خلال عملية فصل النافذة.

تغييرات واجهة برمجة التطبيقات

• واجهات برمجة تطبيقات النشاط في "مبادرة حماية الخصوصية" التي سيتم إيقافها نهائيًا يمكنك الآن العثور على واجهات برمجة التطبيقات هذه في "مكتبة الأنشطة" المخصّصة androidx.privacysandbox.activity بدلاً من ذلك. (I68beb)

إصلاح الأخطاء

• تم إصلاح خطأ في العرض عند عرض محتوى عن بُعد داخل حاويات التجميع. (I804df)
• تم إصلاح خطأ كان يتسبب في مشاكل في عرض ViewGroups في وضع التوافق مع الإصدارات الأقدم. (I8de92)
• عندما يكون أحد والدَي "SandboxedSdkView" هو PoolingContainer، أغلِق جلسة واجهة المستخدم عندما يشير PoolingContainer إلى أنّه يمكن تحرير الموارد، بدلاً من فصل النافذة. (I2046b)

المساهمة الخارجية

• تم إيقاف GestureDetectorCompat نهائيًا لأنّ GestureDetector متوفّر من minSdk. (Icc4cd)

الإصدار 1.0.0-alpha07

18 تشرين الأول (أكتوبر) 2023

تم إصدار androidx.privacysandbox.ui:ui-client:1.0.0-alpha07 وandroidx.privacysandbox.ui:ui-core:1.0.0-alpha07 وandroidx.privacysandbox.ui:ui-provider:1.0.0-alpha07. يحتوي الإصدار 1.0.0-alpha07 على هذه المراجعات.

الميزات الجديدة

• تمت إضافة ميزة التوافق مع الإصدارات السابقة للمكتبة. في الإصدار 33 من واجهة برمجة التطبيقات والإصدارات الأقدم، سيتم عرض عرض الموفِّر داخل عملية التطبيق، في أداة تحميل فئة مختلفة. (If0b7a)
• تمت إضافة منطق يسمح بتغيير حجم حاويات المضيف والموفّر في الإطار نفسه لتجنّب حدوث تقطُّع في واجهة المستخدم. (Ic2cd9)

تغييرات واجهة برمجة التطبيقات

• تم تحديث MinSdk للمكتبة إلى الإصدار 21 من واجهة برمجة التطبيقات. (I474b8)

الإصدار 1.0.0-alpha06

20 أيلول (سبتمبر) 2023

تم إصدار androidx.privacysandbox.ui:ui-client:1.0.0-alpha06 وandroidx.privacysandbox.ui:ui-core:1.0.0-alpha06 وandroidx.privacysandbox.ui:ui-provider:1.0.0-alpha06. يحتوي الإصدار 1.0.0-alpha06 على هذه المراجعات.

الميزات الجديدة

• تمت إضافة منطق إلى المقطع SandboxedSdkView في عرض "العنصر الرئيسي المحدود" الذي يمكنه التمرير خلاله. يضمن ذلك عدم حجب محتوى SandboxedSdkView لعروض أخرى أو أيّ مكوّنات لواجهة مستخدِم خارج عرض المحتوى الجذر. (I9ea94)

تغييرات واجهة برمجة التطبيقات

• إعادة تسمية SandboxedSdkView.setZOrderOnTopAndEnableUserInteraction إلى orderProviderUiAboveClientUi (Iecb7e)

إصلاح الأخطاء

• أرسِل القيمة الصحيحة لترتيب Z إلى المضيف. (Ib0ddf)
• نقل التركيز باللمس إلى عمليات التمرير/الرمي العمودية فقط (I0528c)

الإصدار 1.0.0-alpha05

9 آب (أغسطس) 2023

تم إصدار androidx.privacysandbox.ui:ui-client:1.0.0-alpha05 وandroidx.privacysandbox.ui:ui-core:1.0.0-alpha05 وandroidx.privacysandbox.ui:ui-provider:1.0.0-alpha05. يحتوي الإصدار 1.0.0-alpha05 على هذه المراجعات.

الميزات الجديدة

• تمت إضافة منطق لنقل التركيز باللمس إلى المضيف عند التمرير السريع وإيماءات التمرير السريع التي تبدأ من SandboxedSdkView. يتيح ذلك لواجهة مستخدم مقدّم خدمة استضافة الحاوية القابلة للتقديم والترجيع لدى العميل الاستجابة بشكل صحيح للتقديم والترجيع.

تغييرات واجهة برمجة التطبيقات

• تمت إضافة المَعلمة windowInputToken إلى SandboxedUiAdapter (Ief578).

إصلاح الأخطاء

• ضبط حالة الجلسة على "نشطة" بعد السحب الأول (I36f3f)
• حلّ مشكلة التنسيق في SandboxedSdkView (I09cb8)
• تمت إضافة منطق لنقل التركيز باللمس إلى المضيف. (I33b54)
• أضِف المَعلمة windowInputToken إلى SandboxedUiAdapter. هذا الإجراء ضروري لضمان ربط الرمز المميّز لـ SurfaceControlViewHost بشكل صحيح بمضيف التسلسل الهرمي المضمّن. (Ief578)
• شغِّل notifyResized داخل سلسلة التعليمات الرئيسية. (I62440)
• إصلاح الأعطال في عملية Session.close() (I5392e)

الإصدار 1.0.0-alpha04

‫21 حزيران (يونيو) 2023

تم إصدار androidx.privacysandbox.ui:ui-client:1.0.0-alpha04 وandroidx.privacysandbox.ui:ui-core:1.0.0-alpha04 وandroidx.privacysandbox.ui:ui-provider:1.0.0-alpha04. يحتوي الإصدار 1.0.0-alpha04 على هذه المراجعات.

الميزات الجديدة

• قدِّم SdkActivityLauncher. واجهة للسماح لحِزم SDK التي يتم تفعيلها في وقت التشغيل ببدء الأنشطة (I5b3dc)

إصلاح الأخطاء

• حلّ مشكلة تعارض notifyZOrderChanged يضمن هذا الإجراء إرسال إشعار إلى موفّر واجهة المستخدم بشأن جميع التغييرات في ترتيب طبقات العناصر. لن يتم إشعار مقدّم واجهة المستخدم بشكل صريح في حال تغيير الترتيب على محور Z لعنصر SandboxedSdkView قبل استدعاء openSession.

الإصدار 1.0.0-alpha03

24 أيار (مايو) 2023

تم إصدار androidx.privacysandbox.ui:ui-client:1.0.0-alpha03 وandroidx.privacysandbox.ui:ui-core:1.0.0-alpha03 وandroidx.privacysandbox.ui:ui-provider:1.0.0-alpha03. يحتوي الإصدار 1.0.0-alpha03 على هذه المراجعات.

الميزات الجديدة

• StateChangedListener إبلاغ التطبيق بالتغييرات في جلسة واجهة المستخدم

تغييرات واجهة برمجة التطبيقات

• تمت إضافة StateChangedListener لاستبدال ErrorConsumer (Icd5d3)

إصلاح الأخطاء

• تم إصلاح notifyZOrderChanged حالة السباق حتى يتم إعلام مقدّم واجهة المستخدم بجميع التغييرات في الترتيب حسب العمق.

الإصدار 1.0.0-alpha02

19 نيسان (أبريل) 2023

تم إصدار androidx.privacysandbox.ui:ui-client:1.0.0-alpha02 وandroidx.privacysandbox.ui:ui-core:1.0.0-alpha02 وandroidx.privacysandbox.ui:ui-provider:1.0.0-alpha02. يحتوي الإصدار 1.0.0-alpha02 على هذه المراجعات.

إصلاح الأخطاء

• اختبار تغييرات التصميم في SandboxedSdkViewLayoutChangesChildLayout الذي تم إيقافه بسبب حدوث أخطاء متكررة

الإصدار 1.0.0-alpha01

8 آذار (مارس) 2023

تم إصدار androidx.privacysandbox.ui:ui-client:1.0.0-alpha01 وandroidx.privacysandbox.ui:ui-core:1.0.0-alpha01 وandroidx.privacysandbox.ui:ui-provider:1.0.0-alpha01. يحتوي الإصدار 1.0.0-alpha01 على هذه المراجعات.

الميزات الجديدة

• هذه هي مكتبات jetpack الجديدة التي يمكن للتطبيقات وحِزم SDK المفعَّلة في وقت التشغيل (مبادرة حماية الخصوصية) استخدامها للسماح للتطبيق (العميل) باستضافة أي واجهة مستخدم يوفّرها حزمة SDK (موفّر الخدمة).