رابط کاربری privacysandbox

TODO
آخرین به روز رسانی انتشار پایدار کاندید را آزاد کنید نسخه بتا انتشار آلفا
20 مه 2025 - - - 1.0.0-alpha16

اعلام وابستگی ها

برای افزودن وابستگی به privacysandbox-ui، باید مخزن Google Maven را به پروژه خود اضافه کنید. برای اطلاعات بیشتر، مخزن Maven Google را بخوانید.

وابستگی‌های مصنوعات مورد نیاز خود را در فایل build.gradle برای برنامه یا ماژول خود اضافه کنید:

شیار 

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

    // Use to implement privacysandbox ui-core
    implementation "androidx.privacysandbox.ui:ui-core:1.0.0-alpha16"

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

کاتلین 

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

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

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

    
}

برای اطلاعات بیشتر درباره وابستگی‌ها، به افزودن وابستگی‌های ساخت نگاه کنید.

بازخورد

بازخورد شما به بهتر شدن Jetpack کمک می کند. اگر مسائل جدیدی کشف کردید یا ایده هایی برای بهبود این کتابخانه دارید، به ما اطلاع دهید. لطفاً قبل از ایجاد کتابخانه جدید، به مسائل موجود در این کتابخانه نگاهی بیندازید. با کلیک کردن روی دکمه ستاره می توانید رای خود را به یک موضوع موجود اضافه کنید.

یک شماره جدید ایجاد کنید

برای اطلاعات بیشتر به مستندات ردیاب مشکل مراجعه کنید.

نسخه 1.0

نسخه 1.0.0-alpha16

20 مه 2025

androidx.privacysandbox.ui:ui-*:1.0.0-alpha16 منتشر شد. نسخه 1.0.0-alpha16 حاوی این تعهدات است.

ویژگی های جدید

  • منطقی برای اندازه‌گیری موانع در SandboxedSdkView اضافه شده است، که اگر SandboxedUiAdapterSignalOptions.OBSTRUCTIONS در SessionObserverFactory.signalOptions مرتبط باشد، در SessionObserver.onUiContainerChanged() ارسال می‌شود. انسدادها نسبت به خود نما گزارش می شوند.

تغییرات API

  • SandboxedSdkUi از ui-client به یک کتابخانه جدید ui-client-compose منتقل شد.
  • منطق اضافه شده برای اندازه گیری موانع در کانتینرهای UI. ( I34bea )

رفع اشکال

  • SandboxedSdkView.setAlpha() را برطرف کرد که اکنون آلفای نمای محتوای خود را به روز می کند.

نسخه 1.0.0-alpha15

26 مارس 2025

androidx.privacysandbox.ui:ui-client:1.0.0-alpha15 ، androidx.privacysandbox.ui:ui-core:1.0.0-alpha15 و androidx.privacysandbox.ui:ui-provider:1.0.0-alpha15 منتشر شدند. نسخه 1.0.0-alpha15 حاوی این تعهدات است.

ویژگی های جدید

  • ترتیب Z-پیش‌فرض SandboxedSdkView و SandboxedSdkUi را روی «زیر» تنظیم کنید، که نشان می‌دهد اکنون سطح ارائه‌دهنده زیر پنجره مشتری قرار دارد. پشتیبانی از ارائه‌دهنده رابط کاربری برای دریافت MotionEvents در این حالت پس از دریافت توسط پنجره مشتری اضافه شده است.
  • فیلد signalOptions به رابط SessionObserverFactory اضافه کرد. این می تواند برای تعریف مجموعه ای از گزینه های رشته ای استفاده شود که برای تعیین سیگنال هایی که برای SessionObserver مرتبط جمع آوری می شوند استفاده می شود. مجموعه اولیه سیگنال ها در SandboxedUiAdapterSignalOptions تعریف شده است. اگر هیچ گزینه سیگنالی تنظیم نشده باشد، فقط SessionObserver.onSessionOpened() و SessionObserver.onSessionClosed() فراخوانی خواهند شد.

تغییرات API

  • در SandboxedUiAdapter.openSession() SessionConstants به SessionData تغییر نام داد.

مسائل شناخته شده

  • هنگامی که SDK در زمان اجرا SDK بارگیری می شود و مرتبه Z SandboxedSdkView یا SandboxedSdkUi "بالا" است، ژست منحصراً توسط پنجره ارائه دهنده دریافت می شود و دیگر به پنجره مشتری منتقل نمی شود.

نسخه 1.0.0-alpha14

26 فوریه 2025

androidx.privacysandbox.ui:ui-client:1.0.0-alpha14 ، androidx.privacysandbox.ui:ui-core:1.0.0-alpha14 و androidx.privacysandbox.ui:ui-provider:1.0.0-alpha14 منتشر شدند. نسخه 1.0.0-alpha14 حاوی این تعهدات است.

ویژگی های جدید

  • اکنون می توانید "واسط کاربری مشترک" ایجاد کنید، یعنی رابط کاربری که می تواند دارای عناصری باشد که متعلق به مشتری و متعلق به ارائه دهنده هستند. رابط کاربری مشترک را می توان با استفاده از SharedUiContainer میزبانی کرد که ViewGroup گسترش می دهد. API های جدید از مفهوم مدیریت جلسه مشابه SandboxedSdkView و SandboxedUiAdapter استفاده می کنند.
  • همه APIهای اضافه شده در این نسخه در پشت پرچم SharedUiPresentationApi @RequiresOptIn قرار دارند.

تغییرات API

  • APIهای مدیریت جلسه و ثبت دارایی به SharedUiContainer اضافه شد. مدیریت جلسه با استفاده از SharedUiAdapter معرفی شده در همان نسخه پیاده سازی می شود. ( IC60b0 )
  • SharedUiContainer اضافه شده است که می تواند میزبان رابط کاربری مشتری و متعلق به ارائه دهنده باشد. همه نماهای فرزند خود را در گوشه بالا سمت چپ قرار می دهد. ( Ia7310 )
  • اضافه شدن پشتیبانی از سازگاری به عقب برای SharedUiAdapter . ( I56d7a )
  • SharedUiAdapter برای مدیریت جلسه کانتینرهای View اضافه شده است که می تواند UI متعلق به مشتری و متعلق به ارائه دهنده را میزبانی کند. منطق مدیریت جلسه مشابه SandboxedUiAdapter است. ( I501f6 )

رفع اشکال

  • محاسبه قابلیت مشاهده زمانی که onVisibilityAggregated فراخوانی می شود. ( I91c69 )

مسائل شناخته شده

  • هنگامی که در داخل یک PoolingContainer قرار می گیرد، SharedUiContainer جلسه را با جدا کردن پنجره می بندد.

نسخه 1.0.0-alpha13

29 ژانویه 2025

androidx.privacysandbox.ui:ui-client:1.0.0-alpha13 ، androidx.privacysandbox.ui:ui-core:1.0.0-alpha13 و androidx.privacysandbox.ui:ui-provider:1.0.0-alpha13 منتشر شدند. نسخه 1.0.0-alpha13 حاوی این تعهدات است.

ویژگی های جدید

  • یک شی Composable به نام SandboxedSdkUi اضافه شده است که می تواند برای نمایش محتوای راه دور در یک Compose UI استفاده شود. این شی از مفاهیم SandboxedSdkView موجود برای مدیریت جلسه و شنوندگان رویداد استفاده می کند. ( I009cf )
  • امضای SandboxedUiAdapter.openSession را برای گنجاندن پارامتر SessionConstants جدید که جایگزین windowInputToken قبلی می‌شود، تغییر داد. این پارامتر قرار است برای ارسال مقادیری استفاده شود که در طول عمر SandboxedUiAdapter.Session ثابت خواهند بود. ( Ibc0df ، I28435 )

مسائل شناخته شده

  • رویدادهای SessionObserver برای SandboxedSdkUi هنگام پیمایش ارسال نمی‌شوند.
  • SandboxedSdkUi وقتی در حالت Z-above است توسط نماهای والدین بریده نمی شود.

تغییرات API

  • حذف کد SDKActivityLauncher منسوخ شده ( I49a4f )
  • با افزودن یک رابط جدید SessionObserverFactoryRegistry منطق ثبت کارخانه ناظر را از SandboxedUiAdapter جدا کرد. ( I245cc )

نسخه 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 جایگزین شد. از این شنونده رویداد می توان برای گوش دادن به رابط کاربری نمایش داده شده، بسته شدن جلسه و رویدادهای خطای جلسه استفاده کرد.

تغییرات API

  • SandboxedSdkViewEventListener برای گوش دادن به رویدادهای رابط کاربری در داخل SandboxedSdkView اضافه می کند. این نسخه همچنین StateChangedListener حذف می کند. ( ID71ea )

رفع اشکال

  • منطق مرزهای برش از SandboxedSdkView حذف شد. اگر SandboxedSdkView در یک محفظه قابل پیمایش قرار گیرد و orderProviderUiAboveClientUi(false) فراخوانی نشود، مشکلات UX ایجاد می کند (تا زمانی که باگ چارچوب اصلی برطرف نشود). ( 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 حاوی این تعهدات است.

ویژگی های جدید

  • یک API آزمایشی، DelegatingSandboxedUiAdapter معرفی کرد که SandboxedUiAdapter گسترش می‌دهد و می‌تواند برای تفویض اختیار بین SandboxedUiAdapters مختلف استفاده شود. وقتی این آداپتور روی یک محفظه سرویس گیرنده مانند SandboxedSdkView تنظیم می شود، آداپتور واگذارکننده می تواند آداپتور نماینده را با استفاده از updateDelegate تغییر دهد. با این کار جلسه موجود بسته می شود و یک SandboxedUiAdapter.Session جدید برای نماینده جدید ایجاد می شود. این امکان انتقال یکپارچه بین نمایندگان را فراهم می کند. ( I5f1c5 , I9e3e7 )
  • پشتیبانی بهتر SandboxedSdkView برای padding اضافه شده است. ( 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 )
  • طرح دستی دسترسی به APIهای پلتفرم جدید حذف شد زیرا این به طور خودکار از طریق مدلسازی API هنگام استفاده از 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 را معرفی کرد که می‌توانند توسط ارائه‌دهندگان UI برای جلوگیری از پیاده‌سازی کل رابط‌های SandboxedUiAdapter یا Session استفاده شوند. استفاده از این کلاس های انتزاعی به ارائه دهندگان رابط کاربری توصیه می شود.
  • منطق registerObserverFactory اضافه شده است که به SessionObserverFactory اجازه می دهد تا به SandboxedUiAdapter متصل شود. هنگامی که یک SessionObserverFactory به یک آداپتور متصل می شود، یک SessionObserver برای هر جلسه رابط کاربری جدید ایجاد شده برای آن آداپتور ایجاد می شود. SessionObserver ایجاد شده پس از باز شدن جلسه UI، یک پاسخ onSessionOpened دریافت می کند. وقتی نمایش رابط کاربری نمای Session تغییر کرد، SessionObserver.onUiContainerChanged فراخوانی می شود. onUiContainerChanged کاهش می یابد و حداکثر هر 200 میلی ثانیه تماس گرفته می شود.
  • SandboxedSdkViewUiInfo اضافه شد که می تواند از Bundle ارسال شده در SessionObserver.onUiContainerChanged ایجاد شود. این شی نشان دهنده وضعیت رابط کاربری SandboxedSdkView است که میزبان جلسه UI است. این شامل اطلاعات ارتفاع و عرض، یک Rect است که هندسه نمای را نشان می دهد که روی صفحه قابل مشاهده است، و یک اشاره کدورت که نشان دهنده کدورت نما است.

تغییرات API

  • اشاره کدورت را به 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 است، چرخه زندگی جلسات UI آن با PoolingContainer همسو می‌شود تا اطمینان حاصل شود که جلسه می‌تواند از طریق جدا کردن پنجره ادامه پیدا کند.

تغییرات API

  • APIهای منسوخ شده Privacy Sandbox Activity. اکنون می‌توانید این APIها را در کتابخانه اختصاصی Activity 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 حاوی این commit ها است.

ویژگی های جدید

  • پشتیبانی از سازگاری با عقب برای کتابخانه اضافه شده است. در API 33 و پایین‌تر، نمای ارائه‌دهنده در داخل فرآیند برنامه، در کلاس‌لودر دیگری ارائه می‌شود. ( If0b7a )
  • منطق اضافه شده است که اجازه می دهد تا تغییر اندازه کانتینرهای میزبان و ارائه دهنده در یک قاب انجام شود تا از جابجایی UI قابل مشاهده جلوگیری شود. ( IC2cd9 )

تغییرات API

  • MinSdk برای کتابخانه به API 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 حاوی این commit ها است.

ویژگی های جدید

  • منطقی برای کلیپ SandboxedSdkView به نمای "والد محدود" اضافه شده است که ممکن است در آن حرکت کند. این تضمین می‌کند که محتویات SandboxedSdkView سایر نماها یا اجزای رابط کاربری خارج از نمای محتوای اصلی را مسدود نمی‌کند. ( I9ea94 )

تغییرات API

  • تغییر نام SandboxedSdkView.setZOrderOnTopAndEnableUserInteraction به orderProviderUiAboveClientUi ( Iecb7e )

رفع اشکال

  • مقدار Z-order صحیح را برای میزبان ارسال کنید. ( 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 حاوی این commit ها است.

ویژگی های جدید

  • منطق اضافه شده برای انتقال فوکوس لمسی به میزبان در حرکات اسکرول و پرت کردن از SandboxedSdkView . این به رابط کاربری ارائه‌دهنده میزبان کانتینر قابل پیمایش مشتری اجازه می‌دهد به درستی به اسکرول‌ها و flings پاسخ دهد.

تغییرات API

  • پارامتر windowInputToken به SandboxedUiAdapter ( Ief578 ) اضافه شد

رفع اشکال

  • وضعیت جلسه را بعد از اولین قرعه کشی روی Active تنظیم کنید ( 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 حاوی این commit ها است.

ویژگی های جدید

  • SdkActivityLauncher را معرفی کنید. یک رابط برای اجازه دادن به زمان اجرا، SDK ها را قادر می سازد تا فعالیت ها را راه اندازی کنند. ( I5b3dc )

رفع اشکال

  • وضعیت notifyZOrderChanged مسابقه را برطرف کنید. اطمینان حاصل می کند که ارائه دهنده رابط کاربری برای همه تغییرات Z-order مطلع شده است. اگر دستور 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 حاوی این commit ها است.

ویژگی های جدید

  • StateChangedListener به اعمال تغییرات در جلسه UI اطلاع می دهد

تغییرات API

  • اضافه شدن StateChangedListener برای جایگزینی ErrorConsumer ( Icd5d3 )

رفع اشکال

  • وضعیت notifyZOrderChanged race ثابت شد، بنابراین ارائه‌دهنده رابط کاربری برای همه تغییرات Z-order مطلع می‌شود

نسخه 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 حاوی این commit ها است.

رفع اشکال

  • تست پوسته شدن غیرفعال شدChangingSandboxedSdkViewLayoutChangesChildLayout تست

نسخه 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 حاوی این commit ها است.

ویژگی های جدید

  • اینها کتابخانه‌های جدید jetpack هستند که برنامه‌ها و SDK‌های فعال شده در زمان اجرا (جعبه ایمنی حریم خصوصی) می‌توانند از آن‌ها استفاده کنند تا به برنامه (مشتری) اجازه دهند هر UI ارائه شده توسط SDK (ارائه‌دهنده) را میزبانی کند.