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 11 tháng 12 năm 2024 - - - 1.0.0-alpha12

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

    
}

Để 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-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 đã đó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 bị đ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ủ. (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.