privacysandbox ui

  
TODO
העדכון האחרון גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסת אלפא
20 במאי 2025 - - - 1.0.0-alpha16

הצהרת יחסי תלות

כדי להוסיף תלות ב-privacysandbox-ui, צריך להוסיף את מאגר Google Maven לפרויקט. מידע נוסף זמין במאגר Maven של Google.

מוסיפים את יחסי התלות של הארטיפקטים הנדרשים בקובץ build.gradle של האפליקציה או המודול:

Groovy

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"
}

Kotlin

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")

    
}

מידע נוסף על יחסי תלות זמין במאמר הוספת יחסי תלות ל-build.

משוב

המשוב שלכם עוזר לנו לשפר את Jetpack. אם נתקלתם בבעיות חדשות או שיש לכם רעיונות לשיפור הספרייה הזו, נשמח לשמוע מכם. לפני שיוצרים בעיה חדשה, כדאי לעיין בבעיות הקיימות בספרייה הזו. כדי להצביע על בעיה קיימת, לוחצים על לחצן הכוכב.

דיווח על בעיה חדשה

מידע נוסף זמין במסמכי התיעוד של Issue Tracker.

גירסה 1.0

גרסה 1.0.0-alpha16

20 במאי 2025

androidx.privacysandbox.ui:ui-*:1.0.0-alpha16 משוחרר. הגרסה 1.0.0-alpha16 מכילה את ההוספות האלה.

תכונות חדשות

  • נוספה לוגיקה למדידת חסימות ב-SandboxedSdkView, שיישלח ב-SessionObserver.onUiContainerChanged() אם SandboxedUiAdapterSignalOptions.OBSTRUCTIONS נכלל ב-SessionObserverFactory.signalOptions המשויך. הדיווח על חסימות מתבצע ביחס לתצוגה עצמה.

שינויים ב-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

  • השם של SessionConstants השתנה ל-SessionData ב-SandboxedUiAdapter.openSession().

בעיות מוכרות

  • כשה-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

  • הוספנו ל-SharedUiContainer ממשקי API לניהול סשנים ולרישום נכסים. ניהול הסשנים מיושם באמצעות SharedUiAdapter, שהוצג באותה גרסה. (Ic60b0)
  • נוספה SharedUiContainer שיכולה לארח ממשק משתמש בבעלות הלקוח ובבעלות הספק. כל תצוגות הצאצאים ממוקמות בפינה הימנית העליונה. (Ia7310)
  • הוספנו תמיכה בתאימות לאחור ל-SharedUiAdapter. (I56d7a)
  • הוספנו את SharedUiAdapter לניהול סשנים של קונטיינרים של תצוגות שיכולים לארח ממשק משתמש בבעלות הלקוח ובבעלות הספק. הלוגיקה של ניהול הסשנים דומה לזו של SandboxedUiAdapter. (I501f6)

תיקוני באגים

  • חישוב החשיפה כאשר onVisibilityAggregated נקרא. (I91c69)

בעיות מוכרות

  • כשהקוד SharedUiContainer מופיע בתוך PoolingContainer, הוא סוגר את הסשן כשהחלון מנותק.

גרסה 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. האובייקט הזה משתמש במושגים קיימים של SandboxedSdkView לניהול סשנים ול-event listeners. (I009cf)
  • שינינו את החתימה SandboxedUiAdapter.openSession כך שתכלול פרמטר SessionConstants חדש שמחליף את windowInputToken הקודם. הפרמטר הזה משמש להעברת ערכים שתמיד יהיו זהים במהלך כל תקופת החיים של SandboxedUiAdapter.Session. (Ibc0df, ‏ I28435)

בעיות מוכרות

  • אירועי SessionObserver לא נשלחים עבור SandboxedSdkUi כשגוללים בו.
  • התצוגה SandboxedSdkUi לא חתוכה על ידי תצוגות הורה כשהיא במצב Z-above.

שינויים ב-API

  • הסרת קוד SDKActivityLauncher שהוצא משימוש (I49a4f)
  • הפרדת הלוגיקה של רישום המפעל של משקיף מ-SandboxedUiAdapter על ידי הוספת ממשק SessionObserverFactoryRegistry חדש. (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. אפשר להשתמש ב-event listener הזה כדי להאזין לאירועים של ממשק משתמש מוצג, סשן סגור ואירועי שגיאה בסשן.

שינויים ב-API

  • הוספת 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 מכילה את ההוספות האלה.

תכונות חדשות

  • הוספת ממשק API ניסיוני, 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)
  • הסרנו את התיאור הידני של הגישה לממשקי API חדשים של פלטפורמות, כי הדבר מתבצע באופן אוטומטי באמצעות בניית מודלים של ממשקי API כשמשתמשים ב-R8 עם AGP 7.3 ואילך (למשל, R8 בגרסה 3.3) ובכל גרסאות ה-build כשמשתמשים ב-AGP 8.1 ואילך (למשל, D8 בגרסה 8.1). לקוחות שלא משתמשים ב-AGP מומלצים לעדכן ל-D8 בגרסה 8.1 ואילך. למידע נוסף, מומלץ לעיין במאמר הזה. (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 שנוצר יקבל קריאה חוזרת (callback) מסוג onSessionOpened כשסשן ממשק המשתמש ייפתח. כשהצגת ממשק המשתמש של התצוגה של Session תשתנה, תתבצע קריאה ל-SessionObserver.onUiContainerChanged. הקריאה ל-onUiContainerChanged תוגבל ותתבצע לכל היותר כל 200 אלפיות השנייה.
  • נוספה SandboxedSdkViewUiInfo שאפשר ליצור מ-Bundle שנשלח ב-SessionObserver.onUiContainerChanged. האובייקט הזה מייצג את מצב ממשק המשתמש של ה-SandboxedSdkView שמארח את סשן ממשק המשתמש. הוא מכיל מידע על גובה ורוחב, ערך 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, מחזור החיים של סשנים בממשק המשתמש שלו יתואם למחזור החיים של ה-PoolingContainer כדי להבטיח שהסשן יוכל להימשך גם אחרי ניתוק החלון.

שינויים ב-API

  • ממשקי API של פעילות בארגז החול לפרטיות שהוצאו משימוש. מעכשיו אפשר למצוא את ממשקי ה-API האלה בספריית הפעילות הייעודית 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 מכילה את ההצהרות האלה.

תכונות חדשות

  • נוספה תמיכה בתאימות לאחור בספרייה. ב-API 33 ובגרסאות קודמות, התצוגה של הספק תומרן בתוך תהליך האפליקציה, במטען הכיתות (classloader) אחר. (If0b7a)
  • הוספנו לוגיקה שמאפשרת לשמור את שינוי הגודל של מאגרים של מארחים וספקים באותו פריים, כדי למנוע תנודות גלויות בממשק המשתמש. (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 כוללת את ההצהרות האלה.

תכונות חדשות

  • הוספנו לוגיקה כדי לחתוך את SandboxedSdkView לתצוגה 'הורה מקיף', שבה אפשר לגלול. כך תוכלו לוודא שהתוכן של SandboxedSdkView לא יחסום תצוגות אחרות או רכיבי ממשק משתמש מחוץ לתצוגת התוכן ברמה הבסיסית. (I9ea94)

שינויים ב-API

  • שינוי השם של 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. כך ממשק המשתמש של ספק האירוח בקונטיינר שניתן לגלילה של הלקוח יכול להגיב בצורה נכונה לגלילות ולתנועות זריזות.

שינויים ב-API

  • הוספת הפרמטר windowInputToken אל SandboxedUiAdapter (Ief578)

תיקוני באגים

  • הגדרת סטטוס הסשן ל'פעיל' אחרי ההגרלה הראשונה (I36f3f)
  • פותרים את הבעיה בפריסה באמצעות SandboxedSdkView. (I09cb8)
  • נוספה לוגיקה להעברת המיקוד למגע למארח. (I33b54)
  • מוסיפים את הפרמטר windowInputToken אל SandboxedUiAdapter. כך אפשר לוודא שהאסימון של SurfaceControlViewHost משויך בצורה נכונה למארח של ההיררכיה המוטמעת. (Ief578)
  • מריצים את notifyResized בתוך ה-thread הראשי. (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 מעדכן את האפליקציה על השינויים בסשן של ממשק המשתמש

שינויים ב-API

  • הוספת StateChangedListener כדי להחליף את ErrorConsumer (Icd5d3)

תיקוני באגים

  • תוקן מצב מרוץ (race condition) ב-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 מכילה את ההצהרות האלה.

תיקוני באגים

  • Disabled flaking testChangingSandboxedSdkViewLayoutChangesChildLayout test

גרסה 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 (הספק).