privacysandbox ui

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

Kotlin

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

    
}

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

משוב

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

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

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

גירסה 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 למעטפת. (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 מכילה את ההצהרות האלה על ביצוע שינויים (commits).

תכונות חדשות

  • נוספה תמיכה בתאימות לאחור בספרייה. ב-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 מכילה את ההצהרות האלה על ביצוע שינויים (commits).

תכונות חדשות

  • מציגים את 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 (הספק).