واجهة مستخدم privacysandbox

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

لإضافة تبعية إلى 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-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. لن يتم إشعار موفِّر واجهة المستخدم بشكل صريح في حال تغيير الترتيب 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 بحيث يتم إشعار موفِّر واجهة المستخدم بجميع التغييرات ذات الترتيب Z

الإصدار 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 على عمليات التنفيذ هذه.

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

• غير مفعَّل تقشر testchangeSandboxedSdkViewLayoutChangesChildLayout اختبار

الإصدار 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).