privacysandbox ui

  
สิ่งที่ต้องทำ
อัปเดตล่าสุด รุ่นที่เสถียร รุ่นที่อาจได้รับการเผยแพร่ รุ่นเบต้า เวอร์ชันอัลฟ่า
11 ธันวาคม 2024 - - - 1.0.0-alpha12

การประกาศทรัพยากร Dependency

หากต้องการเพิ่มทรัพยากร Dependency ของ 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")

    
}

ดูข้อมูลเพิ่มเติมเกี่ยวกับการพึ่งพาได้ที่เพิ่มการพึ่งพิงบิวด์

ความคิดเห็น

ความคิดเห็นของคุณช่วยปรับปรุง Jetpack ได้ โปรดแจ้งให้เราทราบหากพบปัญหาใหม่หรือมีแนวคิดในการปรับปรุงคลังนี้ โปรดดูปัญหาที่มีอยู่ในคลังนี้ก่อนสร้างปัญหาใหม่ คุณสามารถเพิ่มการโหวตให้กับปัญหาที่มีอยู่ได้โดยคลิกปุ่มดาว

สร้างปัญหาใหม่

ดูข้อมูลเพิ่มเติมในเอกสารประกอบของเครื่องมือติดตามปัญหา

รุ่น 1.0

เวอร์ชัน 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 แล้ว Listener เหตุการณ์นี้สามารถใช้เพื่อฟัง UI ที่แสดง เซสชันที่ปิด และเหตุการณ์ข้อผิดพลาดของเซสชัน

การเปลี่ยนแปลง API

  • เพิ่ม SandboxedSdkViewEventListener เพื่อฟังเหตุการณ์ UI ภายใน SandboxedSdkView เวอร์ชันนี้จะนํา StateChangedListener ออกด้วย (Id71ea)

การแก้ไขข้อบกพร่อง

  • นําตรรกะขอบเขตการตัดออกจาก SandboxedSdkView แล้ว ซึ่งจะทำให้เกิดปัญหา UX หากวาง 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 มีการคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • เปิดตัว DelegatingSandboxedUiAdapter ซึ่งเป็น API เวอร์ชันทดลองที่ขยาย 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) และสำหรับบิลด์ทั้งหมดเมื่อใช้ 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 ที่ผู้ให้บริการ UI สามารถใช้เพื่อหลีกเลี่ยงการติดตั้งใช้งานอินเทอร์เฟซ SandboxedUiAdapter หรือ Session ทั้งหมด เราขอแนะนำให้ผู้ให้บริการ UI ใช้คลาสนามธรรมเหล่านี้
  • เพิ่มตรรกะ registerObserverFactory ที่อนุญาตให้แนบ SessionObserverFactory กับ SandboxedUiAdapter เมื่อต่อSessionObserverFactoryเข้ากับอะแดปเตอร์ ระบบจะสร้างSessionObserverสำหรับเซสชัน UI ใหม่แต่ละรายการที่สร้างสำหรับอะแดปเตอร์นั้น SessionObserver ที่สร้างขึ้นจะได้รับการเรียกกลับ onSessionOpened เมื่อเปิดเซสชัน UI เมื่อการนำเสนอ UI ของมุมมอง Session เปลี่ยนแปลง ระบบจะเรียก SessionObserver.onUiContainerChanged onUiContainerChanged ถูกจํากัดและจะเรียกใช้ทุกๆ 200 มิลลิวินาทีเป็นอย่างช้าที่สุด
  • เพิ่ม SandboxedSdkViewUiInfo ซึ่งสร้างได้จาก Bundle ที่ส่งใน SessionObserver.onUiContainerChanged ออบเจ็กต์นี้แสดงสถานะ UI ของ SandboxedSdkView ที่โฮสต์เซสชัน UI โดยจะมีข้อมูลความสูงและความกว้าง, Rect ที่แสดงเรขาคณิตของมุมมองที่มองเห็นบนหน้าจอ และคำแนะนำระดับความทึบแสงที่แสดงระดับความทึบแสงของมุมมอง

การเปลี่ยนแปลง API

  • เพิ่มคำแนะนำเกี่ยวกับความทึบแสงลงใน SandboxedSdkViewUiInfo (I093ac)
  • เพิ่ม SessionObserver.onUiContainerChanged และ SandboxedSdkViewUiInfo (Ie98bc)
  • เพิ่มอินเทอร์เฟซ SessionObserver และตรรกะการลงทะเบียน (I047dc)
  • เพิ่ม AbstractSandboxedUiAdapter และ AbstractSession (I3617a)

ปัญหาที่ทราบ

  • เมื่อผู้ให้บริการ UI อยู่ในกระบวนการเดียวกับแอปพลิเคชันไคลเอ็นต์ ระบบจะไม่ส่ง 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

  • Privacy Sandbox Activity API ที่เลิกใช้งานแล้ว ตอนนี้คุณจะเห็น API เหล่านี้ในไลบรารีกิจกรรม androidx.privacysandbox.activity โดยเฉพาะแทน (I68beb)

การแก้ไขข้อบกพร่อง

  • แก้ไขข้อบกพร่องการแสดงผลเมื่อแสดงเนื้อหาระยะไกลภายในคอนเทนเนอร์การรวม (I804df)
  • แก้ไขข้อบกพร่องที่ทำให้เกิดปัญหาการแสดงผลสำหรับ ViewGroups ในโหมดความเข้ากันได้แบบย้อนหลัง (I8de92)
  • เมื่อรายการหลักของ SandboxedSdkView เป็น PoolingContainer ให้ปิดเซสชัน UI เมื่อ 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 และต่ำกว่า มุมมองของผู้ให้บริการจะแสดงผลภายในกระบวนการของแอปในคลาสโหลดเดอร์อื่น (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 มีการคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • เพิ่มตรรกะในการตัด SandboxedSdkView ไปยังมุมมอง "ขอบเขตระดับบน" ที่อาจเลื่อนอยู่ภายใน วิธีนี้ช่วยให้มั่นใจว่าเนื้อหาของ SandboxedSdkView จะไม่บดบังมุมมองอื่นๆ หรือคอมโพเนนต์ UI ที่อยู่นอกมุมมองเนื้อหารูท (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 ซึ่งช่วยให้ UI ของผู้ให้บริการโฮสติ้งคอนเทนเนอร์แบบเลื่อนได้ของไคลเอ็นต์ตอบสนองต่อการเลื่อนและการปัดได้อย่างถูกต้อง

การเปลี่ยนแปลง API

  • เพิ่มพารามิเตอร์ 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 ตรวจสอบว่าผู้ให้บริการ UI ได้รับแจ้งเกี่ยวกับการเปลี่ยนแปลงลําดับ Z ทั้งหมด ผู้ให้บริการ UI จะไม่ได้รับการแจ้งเตือนอย่างชัดเจนหากมีการเปลี่ยนแปลงลําดับ 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 แจ้งแอปพลิเคชันเกี่ยวกับการเปลี่ยนแปลงในเซสชัน UI

การเปลี่ยนแปลง API

  • เพิ่ม StateChangedListener แทนที่ ErrorConsumer (Icd5d3)

การแก้ไขข้อบกพร่อง

  • แก้ไขnotifyZOrderChangedเงื่อนไขการแข่งขันเพื่อให้ผู้ให้บริการ UI ได้รับการแจ้งเตือนเกี่ยวกับการเปลี่ยนแปลงลําดับ 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 มีการคอมมิตเหล่านี้

การแก้ไขข้อบกพร่อง

  • ปิดใช้การทดสอบการเปลี่ยนแปลงรูปแบบของ 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 มีการคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • ไลบรารีเหล่านี้เป็นไลบรารี Jetpack ใหม่ที่แอปพลิเคชันและ SDK ที่เปิดใช้รันไทม์ (Privacy Sandbox) สามารถใช้เพื่อให้แอปพลิเคชัน (ไคลเอ็นต์) โฮสต์ UI ที่ SDK (ผู้ให้บริการ) ระบุ