giao diện người dùng privacysandbox

  
VIỆC CẦN LÀM
Bản cập nhật mới nhất Bản phát hành ổn định Bản phát hành dùng thử Bản phát hành beta Bản phát hành alpha
Ngày 20 tháng 5 năm 2025 - - - 1.0.0-alpha16

Khai báo phần phụ thuộc

Để thêm một phần phụ thuộc trên privacysandbox-ui, bạn phải thêm kho lưu trữ Google Maven vào dự án. Đọc nội dung Kho lưu trữ Maven của Google để biết thêm thông tin.

Thêm các phần phụ thuộc cho cấu phần phần mềm bạn cần trong tệp build.gradle cho ứng dụng hoặc mô-đun:

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

    
}

Để biết thêm thông tin về các phần phụ thuộc, hãy xem bài viết Thêm phần phụ thuộc vào bản dựng.

Ý kiến phản hồi

Ý kiến phản hồi của bạn có thể giúp chúng tôi cải thiện Jetpack. Hãy cho chúng tôi biết nếu bạn phát hiện lỗi mới hoặc có ý tưởng cải thiện thư viện này. Vui lòng xem các lỗi hiện có trong thư viện này trước khi báo một lỗi mới. Bạn có thể thêm lượt bình chọn cho lỗi hiện có bằng cách nhấp vào nút dấu sao.

Báo lỗi mới

Xem tài liệu về Công cụ theo dõi lỗi để biết thêm thông tin.

Phiên bản 1.0

Phiên bản 1.0.0-alpha16

Ngày 20 tháng 5 năm 2025

Phát hành androidx.privacysandbox.ui:ui-*:1.0.0-alpha16. Phiên bản 1.0.0-alpha16 bao gồm các thay đổi sau.

Tính năng mới

  • Thêm logic để đo lường các vật cản trên SandboxedSdkView. Logic này sẽ được gửi trong SessionObserver.onUiContainerChanged() nếu SandboxedUiAdapterSignalOptions.OBSTRUCTIONS có trong SessionObserverFactory.signalOptions được liên kết. Các vật cản được báo cáo tương ứng với chính thành phần hiển thị.

Thay đổi về API

  • Di chuyển SandboxedSdkUi từ ui-client sang thư viện ui-client-compose mới.
  • Thêm logic để đo lường các vật cản trên vùng chứa giao diện người dùng. (I34bea)

Sửa lỗi

  • Khắc phục SandboxedSdkView.setAlpha(), hiện cập nhật alpha của thành phần hiển thị nội dung.

Phiên bản 1.0.0-alpha15

Ngày 26 tháng 3 năm 2025

Phát hành androidx.privacysandbox.ui:ui-client:1.0.0-alpha15, androidx.privacysandbox.ui:ui-core:1.0.0-alpha15 và androidx.privacysandbox.ui:ui-provider:1.0.0-alpha15. Phiên bản 1.0.0-alpha15 bao gồm các thay đổi sau.

Tính năng mới

  • Đặt thứ tự Z mặc định của SandboxedSdkView và SandboxedSdkUi thành "bên dưới", cho biết rằng giao diện của nhà cung cấp hiện được đặt bên dưới cửa sổ của ứng dụng. Thêm tính năng hỗ trợ cho trình cung cấp giao diện người dùng để nhận MotionEvents ở chế độ này sau khi cửa sổ ứng dụng nhận được.
  • Thêm trường signalOptions vào giao diện SessionObserverFactory. Bạn có thể dùng phương thức này để xác định một tập hợp các tuỳ chọn Chuỗi sẽ được dùng để xác định tín hiệu nào được thu thập cho SessionObserver được liên kết. Tập hợp tín hiệu ban đầu được xác định trong SandboxedUiAdapterSignalOptions. Nếu bạn không đặt tuỳ chọn tín hiệu nào, thì chỉ SessionObserver.onSessionOpened() và SessionObserver.onSessionClosed() mới được gọi.

Thay đổi về API

  • Đổi tên SessionConstants thành SessionData trong SandboxedUiAdapter.openSession().

Lỗi đã biết

  • Khi SDK được tải trong Thời gian chạy SDK và thứ tự Z của SandboxedSdkView hoặc SandboxedSdkUi là "ở trên", cử chỉ sẽ được cửa sổ nhà cung cấp nhận độc quyền và không còn được chuyển sang cửa sổ ứng dụng nữa.

Phiên bản 1.0.0-alpha14

Ngày 26 tháng 2 năm 2025

Phát hành androidx.privacysandbox.ui:ui-client:1.0.0-alpha14, androidx.privacysandbox.ui:ui-core:1.0.0-alpha14 và androidx.privacysandbox.ui:ui-provider:1.0.0-alpha14. Phiên bản 1.0.0-alpha14 bao gồm các thay đổi sau.

Tính năng mới

  • Giờ đây, bạn có thể tạo "giao diện người dùng dùng chung", tức là giao diện người dùng có thể có các phần tử thuộc sở hữu của ứng dụng và nhà cung cấp. Bạn có thể lưu trữ giao diện người dùng dùng chung bằng SharedUiContainer, mở rộng ViewGroup. Các API mới sử dụng khái niệm quản lý phiên tương tự như SandboxedSdkView và SandboxedUiAdapter.
  • Tất cả API được thêm vào bản phát hành này đều nằm sau cờ SharedUiPresentationApi @RequiresOptIn.

Thay đổi về API

  • Thêm API quản lý phiên và đăng ký tài sản vào SharedUiContainer. Hoạt động quản lý phiên được triển khai bằng SharedUiAdapter được giới thiệu trong cùng một bản phát hành. (Ic60b0)
  • Thêm SharedUiContainer có thể lưu trữ giao diện người dùng do ứng dụng và nhà cung cấp sở hữu. Thành phần này đặt tất cả thành phần hiển thị con ở góc trên cùng bên trái. (Ia7310)
  • Thêm tính năng hỗ trợ khả năng tương thích ngược cho SharedUiAdapter. (I56d7a)
  • Thêm SharedUiAdapter để quản lý phiên của các vùng chứa Khung hiển thị có thể lưu trữ giao diện người dùng do ứng dụng và nhà cung cấp sở hữu. Logic quản lý phiên tương tự như logic của SandboxedUiAdapter. (I501f6)

Sửa lỗi

  • Tính toán khả năng xem khi onVisibilityAggregated được gọi. (I91c69)

Lỗi đã biết

  • Khi được đặt bên trong PoolingContainer, SharedUiContainer sẽ đóng phiên khi tách cửa sổ.

Phiên bản 1.0.0-alpha13

Ngày 29 tháng 1 năm 2025

Phát hành androidx.privacysandbox.ui:ui-client:1.0.0-alpha13, androidx.privacysandbox.ui:ui-core:1.0.0-alpha13 và androidx.privacysandbox.ui:ui-provider:1.0.0-alpha13. Phiên bản 1.0.0-alpha13 bao gồm các thay đổi sau.

Tính năng mới

  • Thêm một đối tượng có khả năng kết hợp có tên là SandboxedSdkUi. Đối tượng này có thể dùng để hiển thị nội dung từ xa trong giao diện người dùng Compose. Đối tượng này sử dụng các khái niệm SandboxedSdkView hiện có để quản lý phiên và trình nghe sự kiện. (I009cf)
  • Thay đổi chữ ký SandboxedUiAdapter.openSession để thêm tham số SessionConstants mới thay thế windowInputToken trước đó. Tham số này được dùng để truyền các giá trị không đổi trong suốt vòng đời của SandboxedUiAdapter.Session. (Ibc0df, I28435)

Lỗi đã biết

  • Sự kiện SessionObserver không được gửi cho SandboxedSdkUi khi cuộn.
  • SandboxedSdkUi không bị các thành phần hiển thị mẹ cắt bớt khi ở chế độ Z-above.

Thay đổi về API

  • Xoá mã SDKActivityLauncher không dùng nữa (I49a4f)
  • Tách logic đăng ký nhà máy của trình quan sát khỏi SandboxedUiAdapter bằng cách thêm giao diện SessionObserverFactoryRegistry mới. (I245cc)

Phiên bản 1.0.0-alpha12

Ngày 11 tháng 12 năm 2024

Phát hành androidx.privacysandbox.ui:ui-client:1.0.0-alpha12, androidx.privacysandbox.ui:ui-core:1.0.0-alpha12 và androidx.privacysandbox.ui:ui-provider:1.0.0-alpha12. Phiên bản 1.0.0-alpha12 bao gồm các thay đổi sau.

Tính năng mới

  • Thay thế StateChangedListener bằng SandboxedSdkViewEventListener. Bạn có thể dùng trình nghe sự kiện này để theo dõi các sự kiện giao diện người dùng hiển thị, phiên bị đóng và lỗi phiên.

Thay đổi về API

  • Thêm SandboxedSdkViewEventListener để theo dõi các sự kiện trên giao diện người dùng bên trong SandboxedSdkView. Phiên bản này cũng xoá StateChangedListener. (Id71ea)

Sửa lỗi

  • Xoá logic giới hạn cắt bớt khỏi SandboxedSdkView. Điều này sẽ gây ra vấn đề về trải nghiệm người dùng nếu SandboxedSdkView được đặt trong vùng chứa có thể cuộn và orderProviderUiAboveClientUi(false) chưa được gọi (cho đến khi lỗi khung cơ bản được khắc phục). (Id420d)
  • Khắc phục RemoteException có thể xảy ra nếu quy trình từ xa bị gián đoạn trong khi sử dụng DelegatingSandboxedUiAdapter.

Phiên bản 1.0.0-alpha11

Ngày 13 tháng 11 năm 2024

Phát hành androidx.privacysandbox.ui:ui-client:1.0.0-alpha11, androidx.privacysandbox.ui:ui-core:1.0.0-alpha11 và androidx.privacysandbox.ui:ui-provider:1.0.0-alpha11. Phiên bản 1.0.0-alpha11 bao gồm các thay đổi sau.

Tính năng mới

  • Ra mắt một API thử nghiệm, DelegatingSandboxedUiAdapter, mở rộng SandboxedUiAdapter và có thể được dùng để uỷ quyền giữa các SandboxedUiAdapters khác nhau. Khi bộ chuyển đổi này được đặt trên vùng chứa ứng dụng như SandboxedSdkView, bộ chuyển đổi uỷ quyền có thể thay đổi bộ chuyển đổi uỷ quyền bằng updateDelegate. Thao tác này sẽ đóng phiên hiện tại và tạo một SandboxedUiAdapter.Session mới cho người được uỷ quyền mới. Điều này cho phép chuyển đổi liền mạch giữa các đại biểu. (I5f1c5, I9e3e7)
  • Thêm tính năng hỗ trợ SandboxedSdkView tốt hơn cho khoảng đệm. (Ic414f)

Sửa lỗi

  • Khắc phục NullPointerException có thể xảy ra trên sự kiện bố cục chung.

Phiên bản 1.0.0-alpha10

Ngày 18 tháng 9 năm 2024

Phát hành androidx.privacysandbox.ui:ui-client:1.0.0-alpha10, androidx.privacysandbox.ui:ui-core:1.0.0-alpha10 và androidx.privacysandbox.ui:ui-provider:1.0.0-alpha10. Phiên bản 1.0.0-alpha10 bao gồm các thay đổi sau.

Tính năng mới

  • Cập nhật logic mở phiên để chỉ mở phiên bên trong SandboxedSdkView nếu cửa sổ chứa SandboxedSdkView hiển thị.
  • Cập nhật logic SessionObserver để gửi onUiContainerChanged khi chế độ hiển thị của cửa sổ chứa SandboxedSdkView thay đổi.

Sửa lỗi

  • Gọi onUiContainerChanged khi chế độ hiển thị cửa sổ thay đổi (I541cf)
  • Xoá phần trình bày quyền truy cập vào API nền tảng mới theo cách thủ công vì việc này diễn ra tự động thông qua tính năng tạo mô hình API khi sử dụng R8 với AGP 7.3 trở lên (ví dụ: R8 phiên bản 3.3) và cho tất cả các bản dựng khi sử dụng AGP 8.1 trở lên (ví dụ: D8 phiên bản 8.1). Những ứng dụng không sử dụng AGP nên cập nhật lên D8 phiên bản 8.1 trở lên. Hãy xem bài viết này để biết thêm thông tin. (If6b4c, b/345472586)

Phiên bản 1.0.0-alpha09

Ngày 26 tháng 6 năm 2024

Phát hành androidx.privacysandbox.ui:ui-client:1.0.0-alpha09, androidx.privacysandbox.ui:ui-core:1.0.0-alpha09 và androidx.privacysandbox.ui:ui-provider:1.0.0-alpha09. Phiên bản 1.0.0-alpha09 bao gồm các thay đổi sau.

Tính năng mới

  • Giới thiệu các lớp trừu tượng AbstractSandboxedUiAdapter và AbstractSandboxedUiAdapter.AbstractSession mà nhà cung cấp giao diện người dùng có thể sử dụng để tránh triển khai toàn bộ giao diện SandboxedUiAdapter hoặc Session. Nhà cung cấp giao diện người dùng nên sử dụng các lớp trừu tượng này.
  • Thêm logic registerObserverFactory cho phép đính kèm SessionObserverFactory vào SandboxedUiAdapter. Khi SessionObserverFactory được đính kèm vào một bộ chuyển đổi, SessionObserver sẽ được tạo cho mỗi phiên giao diện người dùng mới được tạo cho bộ chuyển đổi đó. SessionObserver đã tạo sẽ nhận được lệnh gọi lại onSessionOpened khi phiên giao diện người dùng mở ra. Khi nội dung hiển thị giao diện người dùng của thành phần hiển thị Session thay đổi, SessionObserver.onUiContainerChanged sẽ được gọi. onUiContainerChanged được điều tiết và sẽ được gọi tối đa mỗi 200 mili giây.
  • Thêm SandboxedSdkViewUiInfo có thể được tạo từ Bundle được gửi trong SessionObserver.onUiContainerChanged. Đối tượng này đại diện cho trạng thái giao diện người dùng của SandboxedSdkView đang lưu trữ phiên giao diện người dùng. Thuộc tính này chứa thông tin về chiều cao và chiều rộng, Rect đại diện cho hình học của thành phần hiển thị hiển thị trên màn hình và gợi ý độ mờ đại diện cho độ mờ của thành phần hiển thị.

Thay đổi về API

  • Thêm gợi ý về độ mờ vào SandboxedSdkViewUiInfo. (I093ac)
  • Thêm SessionObserver.onUiContainerChanged và SandboxedSdkViewUiInfo. (Ie98bc)
  • Thêm giao diện SessionObserver và logic đăng ký. (I047dc)
  • Thêm AbstractSandboxedUiAdapter và AbstractSession. (I3617a)

Lỗi đã biết

  • Khi trình cung cấp giao diện người dùng nằm trong cùng một quy trình với ứng dụng khách, SessionObserver.onUiContainerChanged sẽ không được gửi khi vùng chứa cuộn.

Phiên bản 1.0.0-alpha08

Ngày 14 tháng 5 năm 2024

Phát hành androidx.privacysandbox.ui:ui-client:1.0.0-alpha08, androidx.privacysandbox.ui:ui-core:1.0.0-alpha08 và androidx.privacysandbox.ui:ui-provider:1.0.0-alpha08. Phiên bản 1.0.0-alpha08 bao gồm các thay đổi sau.

Tính năng mới

  • Thêm tính năng hỗ trợ để sử dụng SandboxedSdkView bên trong PoolingContainer, chẳng hạn như RecyclerView. Khi SandboxedSdkView có thành phần mẹ là PoolingContainer, vòng đời của các phiên giao diện người dùng sẽ được điều chỉnh cho phù hợp với vòng đời của PoolingContainer để đảm bảo rằng phiên có thể tiếp tục thông qua việc tách cửa sổ.

Thay đổi về API

  • Ngừng sử dụng API Hoạt động trong Hộp cát về quyền riêng tư. Giờ đây, bạn có thể tìm thấy các API này trong thư viện Hoạt động chuyên dụng androidx.privacysandbox.activity. (I68beb)

Sửa lỗi

  • Khắc phục lỗi kết xuất khi hiển thị nội dung từ xa bên trong vùng chứa gộp. (I804df)
  • Khắc phục lỗi gây ra vấn đề kết xuất cho ViewGroups ở chế độ tương thích ngược. (I8de92)
  • Khi một trong các thành phần mẹ của SandboxedSdkView là PoolingContainer, hãy đóng Phiên giao diện người dùng khi PoolingContainer cho biết có thể giải phóng tài nguyên, thay vì khi tách cửa sổ. (I2046b)

Đóng góp bên ngoài

  • GestureDetectorCompat hiện không dùng nữa vì GestureDetector có sẵn trong minSdk. (Icc4cd)

Phiên bản 1.0.0-alpha07

Ngày 18 tháng 10 năm 2023

Phát hành androidx.privacysandbox.ui:ui-client:1.0.0-alpha07, androidx.privacysandbox.ui:ui-core:1.0.0-alpha07 và androidx.privacysandbox.ui:ui-provider:1.0.0-alpha07. Phiên bản 1.0.0-alpha07 bao gồm các thay đổi sau.

Tính năng mới

  • Thêm tính năng hỗ trợ khả năng tương thích ngược cho thư viện. Trên API 33 trở xuống, chế độ xem của nhà cung cấp sẽ được hiển thị bên trong quy trình ứng dụng, trong một trình tải lớp khác. (If0b7a)
  • Thêm logic cho phép thay đổi kích thước vùng chứa máy chủ lưu trữ và nhà cung cấp trong cùng một khung để tránh hiện tượng giật giao diện người dùng. (Ic2cd9)

Thay đổi về API

  • MinSdk cho thư viện được nâng lên API 21. (I474b8)

Phiên bản 1.0.0-alpha06

Ngày 20 tháng 9 năm 2023

Phát hành androidx.privacysandbox.ui:ui-client:1.0.0-alpha06, androidx.privacysandbox.ui:ui-core:1.0.0-alpha06 và androidx.privacysandbox.ui:ui-provider:1.0.0-alpha06. Phiên bản 1.0.0-alpha06 bao gồm các thay đổi sau.

Tính năng mới

  • Thêm logic để cắt SandboxedSdkView vào Khung hiển thị "giới hạn mẹ" mà nó có thể cuộn trong đó. Điều này đảm bảo rằng nội dung của SandboxedSdkView không che khuất các thành phần hiển thị khác hoặc bất kỳ thành phần giao diện người dùng nào bên ngoài thành phần hiển thị nội dung gốc. (I9ea94)

Thay đổi về API

  • Đổi tên SandboxedSdkView.setZOrderOnTopAndEnableUserInteraction thành orderProviderUiAboveClientUi (Iecb7e)

Sửa lỗi

  • Gửi giá trị thứ tự Z chính xác đến máy chủ lưu trữ. (Ib0ddf)
  • Chỉ chuyển tiêu điểm chạm cho thao tác cuộn/hất theo chiều dọc. (I0528c)

Phiên bản 1.0.0-alpha05

Ngày 9 tháng 8 năm 2023

Phát hành androidx.privacysandbox.ui:ui-client:1.0.0-alpha05, androidx.privacysandbox.ui:ui-core:1.0.0-alpha05 và androidx.privacysandbox.ui:ui-provider:1.0.0-alpha05. Phiên bản 1.0.0-alpha05 bao gồm các thay đổi sau.

Tính năng mới

  • Thêm logic để chuyển tiêu điểm chạm sang máy chủ lưu trữ trên thao tác cuộn và hất bắt nguồn từ SandboxedSdkView. Điều này cho phép giao diện người dùng của nhà cung cấp lưu trữ vùng chứa có thể cuộn của ứng dụng phản hồi chính xác các thao tác cuộn và hất.

Thay đổi về API

  • Thêm tham số windowInputToken vào SandboxedUiAdapter (Ief578)

Sửa lỗi

  • Đặt trạng thái phiên thành Đang hoạt động sau lần vẽ đầu tiên (I36f3f)
  • Khắc phục vấn đề về bố cục với SandboxedSdkView. (I09cb8)
  • Thêm logic để chuyển tiêu điểm chạm sang máy chủ lưu trữ. (I33b54)
  • Thêm tham số windowInputToken vào SandboxedUiAdapter. Điều này là cần thiết để đảm bảo mã thông báo của SurfaceControlViewHost được liên kết chính xác với máy chủ lưu trữ của hệ phân cấp được nhúng. (Ief578)
  • Chạy notifyResized bên trong luồng chính. (I62440)
  • Khắc phục sự cố trong luồng Session.close(). (I5392e)

Phiên bản 1.0.0-alpha04

Ngày 21 tháng 6 năm 2023

Phát hành androidx.privacysandbox.ui:ui-client:1.0.0-alpha04, androidx.privacysandbox.ui:ui-core:1.0.0-alpha04 và androidx.privacysandbox.ui:ui-provider:1.0.0-alpha04. Phiên bản 1.0.0-alpha04 bao gồm những thay đổi sau.

Tính năng mới

  • Giới thiệu SdkActivityLauncher. Giao diện cho phép các SDK hỗ trợ thời gian chạy khởi chạy hoạt động. (I5b3dc)

Sửa lỗi

  • Khắc phục điều kiện tương tranh notifyZOrderChanged. Đảm bảo rằng trình cung cấp giao diện người dùng được thông báo về tất cả các thay đổi về thứ tự Z. Nhà cung cấp giao diện người dùng sẽ không được thông báo rõ ràng nếu thứ tự Z của SandboxedSdkView thay đổi trước khi openSession được gọi.

Phiên bản 1.0.0-alpha03

Ngày 24 tháng 5 năm 2023

Phát hành androidx.privacysandbox.ui:ui-client:1.0.0-alpha03, androidx.privacysandbox.ui:ui-core:1.0.0-alpha03 và androidx.privacysandbox.ui:ui-provider:1.0.0-alpha03. Phiên bản 1.0.0-alpha03 bao gồm các thay đổi sau.

Tính năng mới

  • StateChangedListener thông báo cho ứng dụng về các thay đổi trong phiên giao diện người dùng

Thay đổi về API

  • Thêm StateChangedListener để thay thế ErrorConsumer (Icd5d3)

Sửa lỗi

  • Khắc phục tình trạng tương tranh notifyZOrderChanged để nhà cung cấp giao diện người dùng được thông báo về mọi thay đổi về thứ tự Z

Phiên bản 1.0.0-alpha02

Ngày 19 tháng 4 năm 2023

Phát hành androidx.privacysandbox.ui:ui-client:1.0.0-alpha02, androidx.privacysandbox.ui:ui-core:1.0.0-alpha02 và androidx.privacysandbox.ui:ui-provider:1.0.0-alpha02. Phiên bản 1.0.0-alpha02 bao gồm các thay đổi sau.

Sửa lỗi

  • Tắt kiểm thử không ổn địnhChangingSandboxedSdkViewLayoutChangesChildLayout

Phiên bản 1.0.0-alpha01

Ngày 8 tháng 3 năm 2023

Phát hành androidx.privacysandbox.ui:ui-client:1.0.0-alpha01, androidx.privacysandbox.ui:ui-core:1.0.0-alpha01 và androidx.privacysandbox.ui:ui-provider:1.0.0-alpha01. Phiên bản 1.0.0-alpha01 bao gồm các thay đổi sau.

Tính năng mới

  • Đây là các thư viện Jetpack mới mà ứng dụng và SDK hỗ trợ Thời gian chạy (Hộp cát về quyền riêng tư) có thể sử dụng để cho phép ứng dụng (ứng dụng khách) lưu trữ bất kỳ giao diện người dùng nào do SDK (nhà cung cấp) cung cấp.