رابط کاربری privacysandbox

TODO
آخرین به روز رسانی انتشار پایدار کاندید را آزاد کنید نسخه بتا انتشار آلفا
13 نوامبر 2024 - - - 1.0.0-alpha11

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

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

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

شیار 

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

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

کاتلین

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

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

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

    
}

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

بازخورد

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

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

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

نسخه 1.0

نسخه 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 (ارائه‌دهنده) را میزبانی کند.