wear protolayout

  
Thư viện này cho phép xác định một tập hợp các bố cục của giao diện người dùng và các biểu thức không phải giao diện người dùng được kết xuất/đánh giá trên các nền tảng từ xa.
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 7 tháng 5 năm 2025 1.2.1 - 1.3.0-beta02 -

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

Để thêm một phần phụ thuộc trên wear-protolayout, bạn phải thêm kho lưu trữ Maven của Google vào dự án. Hãy đọ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 support for Wear ProtoLayout Expressions
    implementation "androidx.wear.protolayout:protolayout-expression:1.2.1"

    // Use to implement support for Wear ProtoLayout
    implementation "androidx.wear.protolayout:protolayout:1.2.1"

    // Use to utilize components and layouts with Material design in your ProtoLayout
    implementation "androidx.wear.protolayout:protolayout-material:1.2.1"
}

Kotlin

dependencies {
    // Use to implement support for Wear ProtoLayout Expressions
    implementation("androidx.wear.protolayout:protolayout-expression:1.2.1")

    // Use to implement support for Wear ProtoLayout
    implementation("androidx.wear.protolayout:protolayout:1.2.1")

    // Use to utilize components and layouts with Material design in your ProtoLayout
    implementation("androidx.wear.protolayout:protolayout-material:1.2.1")
}

Để 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

Hãy 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.3

Phiên bản 1.3.0-beta02

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

Phát hành androidx.wear.protolayout:protolayout-*:1.3.0-beta02. Phiên bản 1.3.0-beta02 bao gồm các thay đổi sau.

Sửa lỗi

  • Chúng tôi đã cải tiến đáng kể các giá trị thiết kế Kiểu chữ được áp dụng trên API 36 trở lên. Lý do là từ API 36, tất cả Thẻ thông tin sẽ có phông chữ hệ thống, vì vậy, thay đổi này sẽ mang lại tính nhất quán cao hơn cho băng chuyền Thẻ thông tin. (If316f)
  • Trình tạo Text,Spacer, ArcLine và DashedArcLine sẽ không gửi nếu bạn không đặt layoutConstraints cho các giá trị động. Xin lưu ý rằng các trình kết xuất cũ vẫn yêu cầu bạn phải đặt layoutConstraints và sẽ bỏ qua mọi giá trị động không được đặt. (Ic52e8)
  • Thêm đối tượng sửa đổi ngữ nghĩa tiêu đề để cho biết một phần tử bố cục đang hướng đến một phần nội dung cho mục đích hỗ trợ tiếp cận và đánh dấu văn bản trong khung tiêu đề của primaryLayout là tiêu đề hỗ trợ tiếp cận theo mặc định. (Iae1fb)
  • Hoàn thiện trải nghiệm người dùng cuối cùng của primaryLayout, trong đó khoảng trống giữa khe tiêu đề và khe chính giảm xuống còn 4 dp thay vì 6 dp trên màn hình nhỏ hơn. (I0e056)
  • Áp dụng nội dung mô tả mặc định cho textEdgeButton. (Ifaf8b)
  • Cập nhật nhỏ cho khoảng đệm bên trong avatarButton. (I0910b)

Phiên bản 1.3.0-beta01

Ngày 9 tháng 4 năm 2025

Phát hành androidx.wear.protolayout:protolayout-*:1.3.0-beta01. Phiên bản 1.3.0-beta01 bao gồm các thay đổi sau.

Tính năng mới

Bản phát hành 1.3.0-beta01 của Wear ProtoLayout cho biết bản phát hành này của thư viện đã hoàn thiện về tính năng và API đã bị khoá (ngoại trừ những phần được đánh dấu là thử nghiệm). Wear ProtoLayout 1.3 bao gồm các chức năng và API mới sau:

  • Thiết kế Material 3 được áp dụng cho đồng hồ, với các thành phần và bố cục được tối ưu hoá cho màn hình tròn và điều chỉnh theo tỷ lệ phù hợp từ kích thước màn hình nhỏ đến lớn
    • Thư viện này bao gồm thư viện protolayout-material3 chỉ dành cho Kotlin với nhiều API giống Compose hơn cho các thành phần và tính năng sau:
    • Giao diện màu động từ hệ thống và mặt đồng hồ với giao diện Material3 mới nhất cho màu sắc, hình dạng và kiểu chữ
    • MaterialScope để xử lý tất cả các giá trị mặc định có định kiến và dễ tuỳ chỉnh hơn
    • iconEdgeButton, textEdgeButton
    • iconButton, textButton, button, imageButton, avatarButton, compactButton
    • titleCard, appCard, graphicDataCard, iconDataCard, textDataCard
    • circularProgressIndicator, segmentedCircularProgressIndicator
    • primaryLayout, buttonGroup
    • Tất cả thành phần đều hoạt động trên mọi cấp độ SDK và phiên bản Trình kết xuất ProtoLayout, cung cấp các phương án dự phòng hợp lý nếu có
  • Các API tương tự như Compose, thân thiện hơn với Kotlin cho các phần tử ProtoLayout cơ sở
    • LayoutModifier có khả năng thêm hầu hết các đối tượng sửa đổi dưới dạng hàm theo chuỗi (padding, contentDescription (bao gồm cả clearSemantics), background, clip, opacity, v.v.), có thể chuyển đổi thành đối tượng Modifiers hiện có
    • LayoutColors và LayoutString dưới dạng các loại có hỗ trợ dễ dàng hơn để sử dụng các trường và quy tắc ràng buộc động
    • text và fontStyle
    • hỗ trợ bản đồ tốt hơn cho StateBuilder, bao gồm cả DynamicDataMap và các phương thức nhà máy như intAppDataKey để tạo đối tượng AppDataKey dễ dàng hơn
  • Ảnh động Lottie hỗ trợ bao gồm cả tuỳ chọn đặt các trình kích hoạt khác nhau về thời điểm bắt đầu ảnh động, chẳng hạn như khi bố cục được tải hoặc khi bố cục hiển thị
    • Cải thiện khả năng hỗ trợ hiệu ứng chuyển màu:
    • API chuyển màu tuyến tính là một phần của Brush có thể được dùng trong đối tượng sửa đổi Background cho các phần tử như Box, Spacer, v.v. …
    • Cho phép các giá trị màu động trong ColorStop dùng cho kiểu chuyển màu tuyến tính và quét
    • Hiện tại, hiệu ứng chuyển màu quét trong các đối tượng vòng cung hỗ trợ màu động và góc bắt đầu và kết thúc
  • Liên kết dữ liệu nền tảng trong protolayout-expression để nhận thông tin bất cứ khi nào chế độ hiển thị của bố cục thay đổi, chẳng hạn như có thể dùng để ẩn một số phần nhất định của bố cục trong khi thẻ thông tin đang được vuốt đến
  • Thư viện kiểm thử – protolayout-testing – đã được thêm vào để hỗ trợ phạm vi kiểm thử đơn vị dễ dàng hơn cho mọi phần tử ProtoLayout
  • Phần tử mới DashedArcLine với bộ tính năng cải tiến để dòng có thể có dấu gạch ngang, trái ngược với ArcLine hiện có
  • Hỗ trợ ArcSpacer để đặt chiều dài theo phương diện DP thay vì độ
  • Thêm trục FontSetting hình tròn áp dụng cho một số phông chữ

Phiên bản 1.3.0-alpha10

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

Phát hành androidx.wear.protolayout:protolayout-*:1.3.0-alpha10. Phiên bản 1.3.0-alpha10 bao gồm các thay đổi sau.

Tính năng mới

  • Thêm trình trợ giúp cho Bút vẽ trong công cụ sửa đổi nền kotlin. (I995de)
  • Trường Android Context bắt buộc đã được công khai trong MaterialScope để cho phép sử dụng dễ dàng hơn trong các hàm của nhà phát triển đang tạo thành phần cho thẻ thông tin Material3. (I7df73)

Thay đổi về API

  • Đổi tên api platformVisibilityStatus thành PlatformEventSources.isLayoutVisible và thêm một API thử nghiệm mới PlatformEventSources.isLayoutUpdatePending. (Ie1e04)

Sửa lỗi

  • Giờ đây, lề cho primaryLayout được làm tròn lên đúng cách, điều này có thể ảnh hưởng đến một số bố cục, giảm tối đa 2 dp không gian cho khe chính. (I8f5d3)
  • Giải thích rõ hơn về giao diện màu động mặc định trong các thành phần Material3 ProtoLayout. (Iff5f3)
  • Theo mặc định, kiểu chữ Typography.NUMERAL_* không còn là kiểu chữ dạng bảng/kiểu chữ một khoảng cách nữa. Nếu văn bản đang tạo ảnh động, bạn nên thêm chế độ cài đặt FontSetting.tabularNum() vào văn bản đó. Trong tất cả các trường hợp khác, bạn không cần sử dụng tùy chọn phông chữ một kiểu chữ này và sẽ có nhiều ký tự hơn khi không sử dụng tùy chọn này. (Id3cd9)
  • Giải thích rõ hơn về giao diện màu động mặc định trong các thành phần Material3 ProtoLayout. (I9d831)

Phiên bản 1.3.0-alpha09

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

Phát hành androidx.wear.protolayout:protolayout-*:1.3.0-alpha09. Phiên bản 1.3.0-alpha09 bao gồm các thay đổi sau.

Tính năng mới

  • Thêm đối tượng sửa đổi thử nghiệm cho enterTransition và exitTransition (I4a4d6)
  • Chúng tôi đã thêm tính năng liên kết nền tảng bổ sung để nhận trạng thái hiển thị của bố cục đầy đủ, bất cứ khi nào bố cục đó thay đổi. (I250c3)
  • Cho phép chèn trạng thái ứng dụng kiểm thử và dữ liệu nền tảng vào LayoutElementAssertionsProvider để đánh giá các giá trị động. (Ib5fcb)
  • Thêm bộ lọc góc vào thư viện kiểm thử protolayout (Ie2361)
  • ButtonColors, CardColors và ProgressIndicatorColors hiện hỗ trợ phương thức sao chép, với tuỳ chọn ghi đè một số tham số. (Ie2054)

Thay đổi về API

  • Thêm tính năng hỗ trợ liên kết dữ liệu động vào thư viện kiểm thử (Ib98de)
  • Khắc phục imageButton khi sử dụng với hàm backgroundImage bằng cách xoá lớp phủ. Ngoài ra, cho phép hàm backgroundImage chỉ định giá trị rỗng cho màu lớp phủ, nghĩa là lớp phủ sẽ không được áp dụng. (Ibec3c)

Sửa lỗi

  • Thay đổi phương thức hasValueOfType mặc định để gửi UnsupportedOperationException thay vì IllegalArgumentException. (Ia36c3)
  • Các giá trị mã thông báo màu mặc định được cập nhật để phản ánh thông số kỹ thuật mới nhất. (I75d44)
  • Khắc phục vấn đề răng cưa xuất hiện trên các đường vòng cung trong trình kết xuất thẻ thông tin AndroidX. (I88190)

Phiên bản 1.3.0-alpha08

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

Phát hành androidx.wear.protolayout:protolayout-*:1.3.0-alpha08. Phiên bản 1.3.0-alpha08 bao gồm các thay đổi sau.

Tính năng mới

  • Thêm tham số danh sách FontSetting cho văn bản Material3. (Ic102d)
  • Thêm lớp DynamicDataMap mà StateBuilder hiện hỗ trợ để có API Kotlin an toàn hơn cho các trạng thái ứng dụng (I012ba)
  • Thêm các phương thức nhà máy như intAppDataKey để tạo đối tượng AppDataKey dễ dàng hơn (Icea2a)
  • DynamicDataValue hiện có phương thức hasValueOfType(Class<?>) ngoài các phương thức hasInt/hasColor/.... (I4f7a6)
  • Chúng tôi đã thêm errorDim vào Material3 ProtoLayout ColorScheme, cho các lỗi có mức độ ưu tiên cao hoặc các hành động khẩn cấp như cảnh báo an toàn. (Ia17bb)
  • Chúng tôi đã thêm một biện pháp bảo vệ để tránh sự cố khi truy cập vào chế độ cài đặt giảm chuyển động toàn cục. Chế độ này được kích hoạt trên một số nền tảng không cung cấp chế độ cài đặt đó. (I01e2c)

Thay đổi về API

  • addKeyToValueMapping được đổi tên thành addToStateMap và các phương thức DynamicDataMap.put bị xoá vì không cần thiết. (Ibe9dd)
  • Kiểu chữ Material3 hiện hỗ trợ trục biến tròn cho các phông chữ hệ thống hỗ trợ trục này. ProtoLayout FontSetting hỗ trợ trục độ tròn cho các phông chữ hỗ trợ trục này. (I33eb5)
  • Đổi tên multilineAlignment thành căn chỉnh trong phương thức văn bản Material3. (I2b66b)
  • Cập nhật chỉ báo tiến trình dạng tròn thành loại Hộp, đồng thời chỉ định mainContent trong constructGraphic thành loại Hộp (I5a3dc)
  • Hỗ trợ tốt hơn cho việc sử dụng chỉ báo tiến trình hình tròn trong biểu đồ (I039db)

Sửa lỗi

  • Cho phép giá trị động trong ColorStop và cũng cho các góc bắt đầu/kết thúc trong SweepGradient. (I0146d)
  • Các bản sửa lỗi cho Tài liệu. (I4a63a)
  • Cập nhật các thành phần Material 3 (graphicCard và avatarButton) để cung cấp phương án dự phòng khi không hỗ trợ phương diện mở rộng weight (ví dụ: dưới API 33). Cập nhật thành phần văn bản để dự phòng TEXT_OVERFLOW_ELLIPSIZE_END khi trình kết xuất không hỗ trợ TEXT_OVERFLOW_ELLIPSIZE. (I19e2c)
  • Cập nhật tài liệu cho PrimaryLayoutMargins. (Ibaf7b)

Phiên bản 1.3.0-alpha07

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

Phát hành androidx.wear.protolayout:protolayout-*:1.3.0-alpha07. Phiên bản 1.3.0-alpha07 bao gồm các thay đổi sau.

Tính năng mới

  • Thêm tuỳ chọn API để đặt các trình kích hoạt khác nhau cho ảnh động Lottie. Ngoài ra, thêm API cho các trình kích hoạt được kích hoạt khi bố cục hiển thị (I8272d)
  • Thêm đối tượng sửa đổi border, visibility và opacity. (I6d3dd)
  • Thêm nút hình đại diện vào thành phần ProtoLayout Material3. (Idb5ae)
  • Chúng tôi hiện cho phép tuỳ chỉnh lề (bên và trong một số trường hợp là dưới cùng) trong Material3 primaryLayout. (Ib22f6)
  • Thêm biến thể phân đoạn của chỉ báo tiến trình hình tròn. (I6a648)
  • Thêm thành phần nút thu gọn vào ProtoLayout Material3. (Ia3c5c)
  • Thêm thành phần nút hình viên nang và nút hình ảnh vào ProtoLayout Material3. (Ifb88a)

Thay đổi về API

  • LayoutModfier.foldIn hiện được gọi là foldRight để phản ánh rõ hơn hành vi dự kiến của nó (Idf242)
  • Trình kích hoạt VisibleOnce hiện đang thử nghiệm. (Ib2d26)
  • Xoá withOpacity khỏi API công khai vì có một thư viện đồ hoạ thay thế. (I030c2)
  • Đổi tên các phương thức cấp cao nhất trong LayoutString.kt và LayoutColor.kt để có tên thân thiện với Java. (I7aff0)
  • Xoá các kiểu chữ không phải ProtoLayout trong Material3. (Idd9ae)
  • Thêm hậu tố Color vào các trường trong lớp *Colors trong Material3. (I2d114)

Sửa lỗi

  • Thêm phương thức triển khai dự phòng EdgeButton cho trình kết xuất cũ không hỗ trợ các góc không đối xứng. (I63364)
  • Thêm phương thức triển khai dự phòng của chỉ báo tiến trình hình tròn bằng trình kết xuất cũ. (I0f134)

Phiên bản 1.3.0-alpha06

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

Phát hành androidx.wear.protolayout:protolayout-*:1.3.0-alpha06. Phiên bản 1.3.0-alpha06 bao gồm các thay đổi sau.

Tính năng mới

  • LayoutColor để hỗ trợ cả loại màu tĩnh và động (I4c89b)
  • Thêm thành phần textButton ProtoLayout Material3. (Id680d)
  • Thêm thành phần Material3 ProtoLayout iconButton. (Ica3f0)
  • Thêm thành phần vùng chứa nút ProtoLayout Material3. (I17a38)
  • Thêm tính năng hỗ trợ đối tượng sửa đổi ngữ nghĩa có thể tạo chuỗi vào protolayout-material3 (I4af62)
  • Thêm CircularProgressIndicator phân đoạn đơn ProtoLayout Material3 (I2c8a2)
  • Thêm đối tượng sửa đổi padding,metadata (I8720a)
  • Thêm đối tượng sửa đổi background,clip và clickable (I35478)
  • Thêm LinearGradient vào Bút vẽ và cho phép sử dụng trong Đối tượng sửa đổi nền. (Ic4dea)
  • Thêm kích thước nhỏ cho appCard và titleCard. (I91f98)
  • Thêm thành phần graphicDataCard ProtoLayout Material3. (I92be7)
  • Thêm thành phần ProtoLayout Material3 iconDataCard và textDataCard. (I4e1e4)
  • Thêm thành phần appCard ProtoLayout Material3. (Id4c57)
  • Trừu tượng EdgeButtonColors thành ButtonColors. (I83624)
  • Thêm thành phần titleCard ProtoLayout Material3. (I2dc72)

Thay đổi về API

  • API ProtoLayout Material3 hiện chấp nhận LayoutString để hỗ trợ cả văn bản tĩnh và động. (I9c24a)

Sửa lỗi

  • Thêm hoạt động triển khai trình kết xuất để tăng cường DashedArcLine (I0c700)
  • Thay đổi trình kết xuất để cho phép ArcSpacer lấy chiều dài dp. (I1437b)

Phiên bản 1.3.0-alpha05

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

Phát hành androidx.wear.protolayout:protolayout-*:1.3.0-alpha05. Phiên bản 1.3.0-alpha05 bao gồm các thay đổi sau.

Tính năng mới

  • Thêm LayoutString để hỗ trợ các trường chuỗi bố cục có thể liên kết. (Ida650)
  • Thêm thành phần vùng chứa thẻ ProtoLayout Material3. (Ic985a)

Sửa lỗi

  • Thư viện này hiện sử dụng chú giải về tính chất rỗng của JSpecify, là loại sử dụng. Nhà phát triển Kotlin nên sử dụng đối số trình biên dịch sau để thực thi cách sử dụng chính xác: -Xjspecify-annotations=strict (đây là giá trị mặc định bắt đầu từ phiên bản 2.1.0 của trình biên dịch Kotlin). (Id1f9b, b/326456246)

Phiên bản 1.3.0-alpha04

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

Phát hành androidx.wear.protolayout:protolayout-*:1.3.0-alpha04. Phiên bản 1.3.0-alpha04 bao gồm các thay đổi sau.

Tính năng mới

  • Cập nhật hình dạng Material3 thành một lớp có các trường chứa giá trị thực tế của Góc, giống như trong Wear Compose. (Ied8cd)
  • Cập nhật màu Material3 để thêm khái niệm ColorScheme, giống như trong Wear Compose. (If645e)
  • Thêm nhiều trình so khớp thường dùng vào thư viện kiểm thử. (Ie5cec)

Phiên bản 1.3.0-alpha03

Ngày 30 tháng 10 năm 2024

Phát hành androidx.wear.protolayout:protolayout-*:1.3.0-alpha03. Phiên bản 1.3.0-alpha03 bao gồm các thay đổi sau.

Tính năng mới

  • Thêm LayoutElementAssertionsProvider, LayoutElementAssertion và LayoutElementMatcher vào thư viện kiểm thử (Id1110)

Phiên bản 1.3.0-alpha02

Ngày 16 tháng 10 năm 2024

Phát hành androidx.wear.protolayout:protolayout-*:1.3.0-alpha02. Phiên bản 1.3.0-alpha02 bao gồm các thay đổi sau.

Tính năng mới

  • Phiên bản đầu tiên của thư viện Material 3. Bao gồm các thành phần text, edgeButton, buttonGroup và primaryLayout.

Bản sửa lỗi bảo mật

  • Kể từ thay đổi này, androidx sẽ biên dịch dựa trên protobuf 4.28.2 để giải quyết CVE-2024-7254. Nâng cấp phần phụ thuộc trên phiên bản 1.3.0-alpha01 của androidx.wear.protolayout:protolayout-proto và androidx.wear.protolayout:protolayout-external-protobuf lên 1.3.0-alpha02 để giải quyết rủi ro về lỗ hổng.

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

Phiên bản 1.3.0-alpha01

Ngày 2 tháng 10 năm 2024

Phát hành androidx.wear.protolayout:protolayout-*:1.3.0-alpha01. Phiên bản 1.3.0-alpha01 bao gồm các thay đổi sau.

Sửa lỗi

  • Làm rõ rằng việc có tên bộ phông chữ Roboto và Roboto Flex hay không còn tuỳ thuộc vào thiết bị. (I193be)
  • Bật bộ phông chữ Roboto Flex trong trình kết xuất Thẻ thông tin AndroidX. (I08e94)

Phiên bản 1.2

Phiên bản 1.2.1

Ngày 16 tháng 10 năm 2024

Phát hành androidx.wear.protolayout:protolayout-*:1.2.1. Phiên bản 1.2.1 bao gồm các thay đổi sau.

Bản sửa lỗi bảo mật

  • Kể từ thay đổi này, androidx sẽ biên dịch dựa trên protobuf 4.28.2 để giải quyết CVE-2024-7254. Nâng cấp phần phụ thuộc trên phiên bản 1.2.0 của androidx.wear.protolayout:protolayout-proto và androidx.wear.protolayout:protolayout-external-protobuf lên 1.2.1 để giải quyết rủi ro về lỗ hổng.

Phiên bản 1.2.0

Ngày 7 tháng 8 năm 2024

Phát hành androidx.wear.protolayout:protolayout-*:1.2.0. Phiên bản 1.2.0 bao gồm các thay đổi sau.

Thay đổi quan trọng kể từ phiên bản 1.1.0

  • FontStyle đã được cập nhật để hỗ trợ thêm phông chữ cho các trục biến và API lựa chọn phông chữ tốt hơn để hỗ trợ các phông chữ Flex sắp ra mắt.
  • Các đối tượng sửa đổi bổ sung được hỗ trợ:
    • Công cụ sửa đổi phép biến đổi cung cấp tính năng dịch, xoay và điều chỉnh theo tỷ lệ có hoặc không có ảnh động.
    • Chỉ định các giá trị khác nhau (ngang và dọc) cho mỗi bán kính góc.
  • Cải thiện khả năng hỗ trợ tiếp cận của tất cả các mục tiêu chạm bằng cách mở rộng khu vực có thể nhấn của bất kỳ phần tử nào sử dụng đối tượng sửa đổi Có thể nhấp thành ít nhất là 48dp x 48dp.
  • Cải thiện PrimaryLayout và EdgeContentLayout bằng cách thêm setResponsiveContentInsetEnabled để hỗ trợ tốt hơn hành vi thích ứng của các bố cục này trên nhiều kích thước màn hình và cải thiện tính nhất quán của Thẻ thông tin.
  • Cải thiện khả năng điều chỉnh tỷ lệ/không điều chỉnh tỷ lệ của Văn bản Material cho tỷ lệ phông chữ phi tuyến tính của Android 14.
  • Cải thiện khả năng hỗ trợ hướng bố cục RTL trên tất cả các phần tử vòng cung.

Các thay đổi khác

  • Để biết đầy đủ hơn về các thay đổi được giới thiệu trong phiên bản 1.1.0, hãy xem ghi chú phát hành beta01.

Phiên bản 1.2.0-rc01

Ngày 24 tháng 7 năm 2024

Phát hành androidx.wear.protolayout:protolayout-*:1.2.0-rc01. Phiên bản 1.2.0-rc01 bao gồm các thay đổi sau.

Sửa lỗi

  • Chúng tôi đã sửa Khối Material chuẩn để chỉ có thể sử dụng làm biểu tượng nếu không có nhãn chính hoặc phụ nào được truyền vào. (Iceef9)
  • Tài liệu về bố cục Material đã được cập nhật để bao gồm hình ảnh từ trang có liên quan để dễ hiểu hơn về bố cục. (I0256a)

Phiên bản 1.2.0-beta01

Ngày 10 tháng 7 năm 2024

Phát hành androidx.wear.protolayout:protolayout-*:1.2.0-beta01. Phiên bản 1.2.0-beta01 bao gồm các thay đổi sau.

Tính năng mới

Bản phát hành 1.2.0-beta01 của Wear ProtoLayout cho biết bản phát hành này của thư viện đã hoàn thiện về tính năng và API đã bị khoá (ngoại trừ những phần được đánh dấu là thử nghiệm). Wear ProtoLayout 1.2 bao gồm các chức năng và API mới sau:

  • FontStyle đã được cập nhật để hỗ trợ thêm phông chữ như sau:
    • Đặt các chế độ cài đặt biến thể phông chữ khác nhau, chẳng hạn như FontSetting.weight và FontSetting.width
    • Đặt cùng chiều rộng cho tất cả ký tự số – số dạng bảng (chế độ cài đặt tính năng phông chữ FontSetting.tnum)
    • Cải thiện API lựa chọn phông chữ để hỗ trợ các phông chữ flex sắp ra mắt bằng cách chỉ định tên bộ phông chữ ưu tiên sẽ được sử dụng.
  • Mở rộng đối tượng sửa đổi Corner để hỗ trợ chỉ định từng CornerRadius bằng các giá trị riêng biệt theo chiều ngang và chiều dọc để cho phép tạo các phần tử có góc không đối xứng.
  • Thêm đối tượng sửa đổi Transformation mới cung cấp tính năng dịch, xoay và chia tỷ lệ LayoutElement. Bạn có thể tạo ảnh động cho các phép biến đổi này bằng cách sử dụng các giá trị động.
  • Thêm setArcDirection với các tuỳ chọn Clockwise, CounterClockwise và Normal vào tất cả phần tử vòng cung (Arc, ArcLine và ArcText) để hỗ trợ tốt hơn theo nhiều hướng bố cục (chẳng hạn như LTR và RTL).
  • Cải thiện khả năng hỗ trợ tiếp cận của tất cả các mục tiêu chạm bằng cách mở rộng khu vực có thể nhấn của bất kỳ phần tử nào sử dụng đối tượng sửa đổi Clickable thành ít nhất là 48dp x 48dp.
  • Cải thiện PrimaryLayout và EdgeContentLayout bằng cách thêm setResponsiveContentInsetEnabled để hỗ trợ tốt hơn hành vi thích ứng của các bố cục này trên nhiều kích thước màn hình và cải thiện tính nhất quán của Thẻ thông tin. Thêm cảnh báo trình tìm lỗi mã nguồn để đề xuất sử dụng các API này bằng một bản sửa lỗi nhanh.
  • Cải thiện khả năng điều chỉnh tỷ lệ/không điều chỉnh tỷ lệ của Material Text cho tỷ lệ phông chữ phi tuyến tính của Android 14.

Thay đổi về API

  • Tên bộ phông chữ mặc định (DEFAULT_SYSTEM_FONT) bị xoá vì tên này được ngụ ý khi không sử dụng API preferredFontFamilies. (I39dab)
  • Tham số được truyền vào FontSetting.width phải là số dương. (I1266f)

Phiên bản 1.2.0-alpha05

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

Phát hành androidx.wear.protolayout:protolayout-*:1.2.0-alpha05. Phiên bản 1.2.0-alpha05 bao gồm các thay đổi sau.

Tính năng mới

  • Thêm phương thức hasText vào Material.CompactChip để kiểm tra xem nội dung văn bản đã được đặt hay chưa. (I6e8fc)

Thay đổi về API

  • FontFamily const được chuyển sang FontStyle thay vì lớp Builder. (I06ced)
  • Cập nhật API FontSetting.weight và FontSetting.width để đưa vào các chú thích Phạm vi và thay đổi tham số của trọng số thành int. (Ia726c)

Sửa lỗi

  • Văn bản không thể mở rộng trong thư viện Material hiện hoạt động chính xác với tỷ lệ phông chữ phi tuyến tính của Android 14. (I6601e)

Phiên bản 1.2.0-alpha04

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

Phát hành androidx.wear.protolayout:protolayout-*:1.2.0-alpha04. Phiên bản 1.2.0-alpha04 bao gồm các thay đổi sau.

Thay đổi về API

  • Thêm API góc không đối xứng để có thể chỉ định riêng bán kính của mỗi góc bằng 2 giá trị. (Icbd69)
  • Mở rộng API FontSetting để bao gồm:
    • chế độ cài đặt tính năng phông chữ, chẳng hạn như đặt phông chữ thành dạng bảng. (If12b7)
    • chế độ cài đặt biến thể phông chữ, chẳng hạn như cài đặt chiều rộng tuỳ chỉnh cho phông chữ biến thể. (I2b36d)
  • Thêm API bộ phông chữ vào FontStyle để cho phép chỉ định danh sách thứ tự về bộ phông chữ cần sử dụng. (Iba9f5)
  • Đã đổi tên các hằng số cho chiều cao không gian giữa nội dung và nhãn phụ trong LayoutDefaults của Material. Ban đầu, các hằng số này có tiền tố là "Nội dung cạnh" để chung chung hơn vì có thể áp dụng cho cả PrimaryLayout và EdgeContentLayout. (I4dc32)

Sửa lỗi

  • Đổi tên cho trục phông chữ biến từ axisName thành axisTag. (I02ba3)

Phiên bản 1.2.0-alpha03

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

Phát hành androidx.wear.protolayout:protolayout-*:1.2.0-alpha03. Phiên bản 1.2.0-alpha03 bao gồm các thay đổi sau.

Tính năng mới

  • Thêm API để đặt giá trị trọng số tuỳ chỉnh cho FontStyle. (I7390a)

Sửa lỗi

  • Khắc phục lỗi trong getTouchDelegateInfo do bản đồ mục tiêu trống. (I2accf)

Phiên bản 1.2.0-alpha02

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

Phát hành androidx.wear.protolayout:protolayout-*:1.2.0-alpha02. Phiên bản 1.2.0-alpha02 bao gồm các thay đổi sau.

Thay đổi về API

  • Chúng tôi đã thêm tính năng hỗ trợ để tắt phản hồi gợn sóng trên từng phần tử có thể nhấp. (If1ede)
  • API cho phép biến đổi đã bị xoá khỏi ArcModifiers vì các API này không hỗ trợ tính năng đó (Ic0827)
  • Trình tạo ArcDirectionProp hiện chờ đợi một giá trị trong hàm khởi tạo. (I76ada)
  • Phương thức PlatformDataValues.Builder.putAll sẽ cho phép hợp nhất một PlatformDataValue vào một PlatformDataValue khác. (I50ba3)
  • Text#setIsScalable đổi tên thành Text#setScalable. (If920e)
  • Material Text có thể đặt xem có sử dụng kích thước có thể mở rộng (tăng khi người dùng thay đổi kích thước phông chữ) hay không. (Ibc849)
  • Chúng tôi thêm tuỳ chọn đặt nội dung mô tả thành TitleChip. (I5d21f)
  • Sửa CompactChip để chỉ hoạt động chính xác với biểu tượng và cập nhật API để cho phép tuỳ chọn này. (I6589e)

Sửa lỗi

  • Khắc phục vấn đề có thể xảy ra với dữ liệu nền tảng trùng lặp trong quá trình khởi động. (Iba0fd)
  • Giới thiệu một phương thức getter mới cho DynamicDataNode để truy xuất chi phí nút. Chi phí này được sử dụng khi mua hạn mức nút động. Hiện tại, các Nút có giá trị cố định sẽ có chi phí là 0, tất cả các nút khác sẽ có chi phí là 1. (Ia33e1)
  • Xoá logic đếm khỏi NO_OP_QUOTA_MANAGER. (Ib50b8)
  • Chúng tôi đã thêm một quy tắc tìm lỗi mã nguồn để báo cáo cảnh báo khi PrimaryLayout được sử dụng mà không có setResponsiveContentInsetEnabled và cung cấp bản sửa lỗi nhanh. (I12025)
  • Có giới hạn về số lượng nút biểu thức động. (Iffae8)

Phiên bản 1.2.0-alpha01

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

Phát hành androidx.wear.protolayout:protolayout-*:1.2.0-alpha01. Phiên bản 1.2.0-alpha01 bao gồm các thay đổi sau.

Tính năng mới

  • Giờ đây, các phần tử ProtoLayout Arc có thể thêm ArcDirection (Clockwise, Counterclockwise hoặc Normal) vào phần tử đó. Việc thêm hành vi này vào Arc, ArcLine hoặc ArcText sẽ khắc phục hành vi của các thành phần này trên bố cục RTL. (I90699)
  • EdgeContentLayout đã được cập nhật bằng một phương thức setter setResponsiveContentInsetEnabled mới để phù hợp hơn với các nguyên tắc về trải nghiệm người dùng, tính nhất quán trong Thẻ thông tin bằng cách đặt nhãn chính ở vị trí cố định ở trên cùng và phần lồng ghép thích ứng cho nhãn. (I60175)
  • Chúng tôi đã thêm PrimaryLayout.setResponsiveContentInsetEnabled để thêm phần lồng ghép thích ứng vào nhãn chính, nhãn phụ và khối chip dưới cùng trong bố cục này, để tránh nội dung đó bị lệch khỏi cạnh màn hình. (I0c457)
  • Thêm phương thức để xoá lề ngoài khỏi CircularProgressIndicator để có thể sử dụng làm thành phần nhỏ hơn. (I55c06)

Thay đổi về API

  • Trình kết xuất Thẻ thông tin hiện loại trừ khoảng đệm phông chữ trên tất cả phần tử văn bản theo mặc định, không có tuỳ chọn để đưa khoảng đệm đó vào. (I3e300)

Sửa lỗi

  • Khắc phục vấn đề căn chỉnh Văn bản khi ellipsize, khoảng cách chữ cái và căn giữa đều được sử dụng trên Văn bản. (I716c7)
  • Thêm giải pháp cho vấn đề vẽ vòng cung skia. (I08f09)
  • Sửa hướng vẽ ArcLine cho bố cục RTL. (I6c141)

Phiên bản 1.1

Phiên bản 1.1.0

Ngày 7 tháng 2 năm 2024

Phát hành androidx.wear.protolayout:protolayout-*:1.1.0. Phiên bản 1.1.0 bao gồm các thay đổi sau.

Thay đổi quan trọng kể từ phiên bản 1.0.0

  • Hỗ trợ độ dốc và thể hiện tốt hơn các độ dài lớn hơn 360 độ trong ArcLine.
  • Định dạng ngày giờ hỗ trợ nhiều múi giờ cho các loại dữ liệu động.
  • Các tuỳ chọn tự động định cỡ và cắt bớt văn bản tốt hơn để xử lý văn bản bị cắt bớt.
  • Khoảng đệm hỗ trợ các kích thước mở rộng có trọng số không bắt buộc.
  • Chú thích yêu cầu về phiên bản giản đồ cho tất cả API ProtoLayout.
  • Mở rộng vùng mục tiêu cho bất kỳ phần tử Clickable nào thành 48 dp x 48 dp để đáp ứng các yêu cầu về hỗ trợ tiếp cận.
  • Khoảng đệm phông chữ bị tắt theo mặc định và là hành vi duy nhất trên tất cả các phần tử Văn bản và thành phần Material chứa văn bản.

Các thay đổi khác

  • Để biết đầy đủ hơn về các thay đổi được giới thiệu trong phiên bản 1.1.0, hãy xem ghi chú phát hành beta01.

Phiên bản 1.1.0-rc01

Ngày 24 tháng 1 năm 2024

Phát hành androidx.wear.protolayout:protolayout-*:1.1.0-rc01. Phiên bản 1.1.0-rc01 bao gồm các thay đổi sau.

Sửa lỗi

  • PlatformTimeUpdateNotifierImpl đánh dấu ngay sau khi bật tính năng cập nhật. (I77145)
  • Sửa CircularProgressIndicator cho bố cục RTL. Từ giờ trở đi, nó sẽ chạy theo chiều kim đồng hồ trong mọi trường hợp. (I95ee3)
  • Thêm giải pháp cho vấn đề vẽ vòng cung skia. (I08f09)

Phiên bản 1.1.0-beta01

Ngày 10 tháng 1 năm 2024

Phát hành androidx.wear.protolayout:protolayout-*:1.1.0-beta01. Phiên bản 1.1.0-beta01 bao gồm các thay đổi sau.

Tính năng mới

Bản phát hành 1.1.0-beta01 của Wear ProtoLayout cho biết bản phát hành này của thư viện đã hoàn thiện về tính năng và API đã bị khoá (ngoại trừ những phần được đánh dấu là thử nghiệm). Wear ProtoLayout 1.1 bao gồm các chức năng và API mới sau:

  • ArcLine hiện hỗ trợ hiệu ứng chuyển màu bằng cách thêm Brush với SweepGradient và có bóng trên nắp để thể hiện tốt hơn chiều dài lớn hơn 360 độ bằng cách thêm Shadow vào StrokeCap hiện có.
  • DynamicInstant hỗ trợ định dạng ngày giờ theo múi giờ. Bạn có thể sử dụng DynamicInstant và DynamicDuration làm loại dữ liệu trạng thái hoặc nền tảng.
  • Tính năng tự động định cỡ cho kích thước văn bản cho phép đặt nhiều kích thước thành FontStyle.setSizes, trong đó Kích thước văn bản sẽ tự động điều chỉnh theo tỷ lệ dựa trên không gian có trong thành phần mẹ. Ngoài ra, chúng tôi đã cải thiện các tuỳ chọn dấu ba chấm cho văn bản tràn lề bằng cách thêm TEXT_OVERFLOW_ELLIPSIZE và ngừng sử dụng TEXT_OVERFLOW_ELLIPSIZE_END.
  • Spacer hiện hỗ trợ việc mở rộng kích thước có trọng số không bắt buộc. Để tạo ExpandedDimensionProp, chúng ta đã thêm một phương thức trợ giúp DimensionBuilders.weight.
  • Hỗ trợ ẩn và hiện linh động các phần tử bố cục bằng Modifier.visible. Điều này bao gồm việc có các giá trị động trong BoolProp.
  • Tất cả API ProtoLayout hiện đều có chú thích yêu cầu về phiên bản giản đồ và bạn có thể kiểm tra phiên bản trước khi gọi một API mới hơn.
  • Giờ đây, mọi phần tử có Clickable đều có vùng mục tiêu được mở rộng ít nhất là 48x48 trong trình kết xuất để hỗ trợ tốt hơn các yêu cầu về hỗ trợ tiếp cận.
  • Theo các thành phần Material và sáng kiến Compose khác, chúng tôi hiện đã tắt khoảng đệm phông chữ theo mặc định trên tất cả các phần tử Text. Ngoài ra, AndroidTextStyle và các phương thức setter liên quan đã bị xoá khỏi API công khai. với các bản sửa lỗi sau:
  • Thêm một phương thức setter để định vị nội dung cạnh trong EdgeContentLayout để có thể định vị trước nội dung khác.
  • Liên tục gửi một ngoại lệ khi gặp một giá trị enum không được nhận dạng.
  • Làm mất hiệu lực kết quả của một biểu thức khi biểu thức đó trả về một giá trị số không hợp lệ (NaN hoặc vô hạn) hoặc gửi một ArithmeticException.

Thay đổi về API

  • Cập nhật API SweepGradient để cho phép chấp nhận màu hoặc ColorStops trong hàm khởi tạo. (I6676f)

Sửa lỗi

  • Thêm API bị hạn chế và hỗ trợ trình kết xuất để đặt hướng vẽ các phần tử vòng cung. (Idef5a)
  • RoundMode mặc định là Floor trong FloatToInt32Node khi không được chỉ định. Nút này vẫn sẽ gửi một ngoại lệ nếu RoundMode được cung cấp không được nhận dạng. (I1b2d8)

Phiên bản 1.1.0-alpha04

Ngày 13 tháng 12 năm 2023

Phát hành androidx.wear.protolayout:protolayout-*:1.1.0-alpha04. Phiên bản 1.1.0-alpha04 bao gồm các thay đổi sau.

Tính năng mới

  • Lớp VersionInfo không triển khai giao diện Comparable. (I8d13c)
  • Trình kết xuất hiện hỗ trợ tuỳ chọn TEXT_OVERFLOW_ELLIPSIZE. (I7f085)

Thay đổi về API

  • Tuỳ chọn tràn văn bản TEXT_OVERFLOW_ELLIPSIZE_END hiện không còn được dùng nữa. Vui lòng sử dụng API TEXT_OVERFLOW_ELLIPSIZE mới có hành vi rất giống. (I822d8)
  • Theo các thành phần Material và sáng kiến Compose khác, chúng tôi hiện đã tắt khoảng đệm phông chữ theo mặc định trên tất cả các phần tử Văn bản. Ngoài ra, AndroidTextStyle và các phương thức setter liên quan đã bị xoá khỏi API công khai. (I79094, Ib0b03, I32959, Iaf7d5, Ifa298, I0a4ae, Ida9d3)
  • Modifier.hidden được thay thế bằng Modifier.visible (I56902)
  • FontStyle#setSizes hiện chấp nhận int thay vì đối số SpProp. (I02b37)

Sửa lỗi

  • Gửi một ngoại lệ khi gặp giá trị enum Không xác định hoặc Không nhận dạng được. (I9d2cf)
  • Tái cấu trúc DynamicTypeBindingRequest. (I27b57)
  • Làm mất hiệu lực kết quả của một biểu thức khi biểu thức đó trả về một giá trị số không hợp lệ (NaN hoặc vô hạn) hoặc gửi một ArithmeticException. (I681ae)

Phiên bản 1.1.0-alpha03

Ngày 29 tháng 11 năm 2023

Phát hành androidx.wear.protolayout:protolayout-*:1.1.0-alpha03. Phiên bản 1.1.0-alpha03 bao gồm các thay đổi sau.

Tính năng mới

  • Thêm tính năng hỗ trợ thử nghiệm để ẩn/bật động các thành phần bố cục (I64a78)
  • Thêm tính năng hỗ trợ giá trị động vào BoolProp (I2fe96)
  • Thêm chú thích yêu cầu về phiên bản giản đồ vào các API ProtoLayout (I0f03c)
  • Mở rộng API bằng tuỳ chọn mới trong TextOverflow để tạo dấu ba chấm cho Văn bản trong vùng chứa mẹ cố định ngay cả khi chưa đạt đến số dòng tối đa (nhưng không đủ không gian cho Văn bản). (I110a9)
  • Thêm phương thức trợ giúp DimensionBuilders.weight để tạo ExpandedDimensionProp có trọng số. (I4f72b)
  • Bạn có thể sử dụng DynamicInstant và DynamicDuration làm loại dữ liệu trạng thái hoặc nền tảng. (I6819f)

Thay đổi về API

  • Cập nhật API để ẩn DynamicZonedDateTime và chuyển tất cả các thao tác của API đó sang DyanamicInstant (I34b94)
  • Khoảng đệm hiện hỗ trợ phương diện Mở rộng cho chiều rộng/chiều cao. (Ie7c94)
  • Hỗ trợ tiện ích vùng mục tiêu nhấp trong Trình kết xuất (I39c79)

Phiên bản 1.1.0-alpha02

Ngày 15 tháng 11 năm 2023

Phát hành androidx.wear.protolayout:protolayout-*:1.1.0-alpha02. Phiên bản 1.1.0-alpha02 bao gồm các thay đổi sau.

Tính năng mới

  • Thêm trường ArcLine StrokeCap Shadow vào API. (I830ec)
  • Mở rộng API để có thể chỉ định chiều rộng hoặc chiều cao của Spacer để mở rộng. (I757ca)
  • Chúng tôi đã thêm một API thử nghiệm để tự động điều chỉnh kích thước văn bản dựa trên không gian mà văn bản đó có bên trong thành phần mẹ. (Ibbe63)
  • Hỗ trợ kích thước tối thiểu có thể nhấp (I178e3)
  • Thêm tính năng hỗ trợ trình kết xuất cho StrokeCap Shadow. (I48b17)
  • Thêm tính năng hỗ trợ trình kết xuất cho hiệu ứng Chuyển màu quét trong ArcLine. (I4d5bb)

Phiên bản 1.1.0-alpha01

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

Phát hành androidx.wear.protolayout:protolayout-*:1.1.0-alpha01. Phiên bản 1.1.0-alpha01 bao gồm các thay đổi sau.

Tính năng mới

  • Thêm tuỳ chọn bút vẽ vào Arcline, hỗ trợ SweepGradient. (Ie7ce3)
  • Thêm tính năng hỗ trợ định dạng ngày giờ theo múi giờ. (Ibfae0)
  • Thêm các proto và trình bao bọc Java cần thiết để định dạng ngày giờ theo múi giờ. (I97126)
  • Thêm phương thức getter để đọc lại giá trị được lưu trữ trong DynamicDataValue. (Ie6cea)
  • Thêm một phương thức setter để định vị nội dung cạnh trong EdgeContentLayout để có thể định vị trước nội dung khác. (Ie8e8a)

Sửa lỗi

  • Khắc phục vấn đề khi một biểu thức có nhiều lượt đăng ký nguồn dữ liệu thời gian không được cập nhật ngay lập tức. (I8e1a8)
  • Khắc phục lỗi căn giữa phần tử gốc trong quá trình cập nhật sự khác biệt. (Ie48f7)
  • Các giá trị ràng buộc bố cục chưa đặt (hoặc để trống) sẽ không còn bị bỏ qua nữa. (Ibc785)
  • Giảm độ trễ giữa thời điểm một bố cục hiển thị và thời điểm các nút trong quy trình của bố cục đó được khởi chạy. (I38d4e)

Phiên bản 1.0

Phiên bản 1.0.0

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

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

Các tính năng chính của phiên bản 1.0.0

Thư viện ProtoLayout giới thiệu các API để tạo bố cục và biểu thức có thể sử dụng trên nhiều nền tảng Wear OS. Ví dụ: thư viện Thẻ thông tin sử dụng các API này để hỗ trợ liên kết dữ liệu nền tảng (để cập nhật dữ liệu thẻ thông tin nhanh hơn) và ảnh động.

Phiên bản 1.0.0-rc01

Ngày 26 tháng 7 năm 2023

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

  • Để di chuyển từ Thẻ thông tin sang ProtoLayout, vui lòng làm theo hướng dẫn tại đây.

Thay đổi về API

  • Chúng tôi đã xoá các phương thức setLayoutConstraintForDynamicAnchorAngle và getLayoutConstraintForDynamicAnchorAngle khỏi phần tử Arc. Các phương thức này đã được thêm do nhầm lẫn và không ảnh hưởng đến bố cục được cung cấp. (If7d01)
  • Chúng tôi đã giới hạn chiều sâu tối đa mà bố cục của ProtoLayout có thể có là 30 LayoutElements lồng nhau. (I8a74b)

Sửa lỗi

  • Chúng tôi đã thêm một bước kiểm tra để gửi nếu DynamicColor đã được đặt cho SpanText. (I0e5bc)
  • Xác định rõ đơn vị nguồn dữ liệu DAILY_CALORIES là kcal. (Iaa785)

Phiên bản 1.0.0-beta01

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

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

Tính năng mới

  • Cho phép đặt đồng hồ cho các kiểm thử liên kết thời gian. (I05622)

Thay đổi về API

  • PlatformDataReceiver.onData() và StateBuilders.Builder.addKeyToValueMapping hiện chấp nhận ánh xạ an toàn về kiểu của DynamicDataKey đến DynamicDataValue thay vì các loại chung không an toàn. Điều đó có nghĩa là DynamicDataValue hiện được nhập bằng DynamicType. Các hằng số HEART_RATE_ACCURACY_X được chuyển sang thư mục gốc của PlatformHealthSources để khớp với vị trí của các hằng số Android khác. Hằng số int HEART_RATE_ACCURACY_X hiện được sử dụng trực tiếp trong DynamicHeartRateAccuracy.constant() và DynamicHeartRateAccuracy.dynamicDataValueOf() thay vì hằng số giá trị. (I82ff5)
  • Lớp PlatformHealthSources.Constants đã được tạo bản sao do nhầm lẫn. Lỗi này hiện đã được khắc phục. (Icb849)
  • PlatformTimeUpdateNotifier#setReceiver hiện nhận Runnable thay vì hàm Supplier và Executor để thông báo. (I9d938)
  • Chúng tôi đã thay đổi loại tham số trong PlatformTimeUpdateNotifier#setReceiver từ Callable thành Supplier. (I664bf)
  • CompactChip và TitleChip hiện hỗ trợ việc thêm biểu tượng vào. (I5a01e)

Sửa lỗi

  • Cập nhật thông báo Prop bằng các trường động để sử dụng oneof (I81739)
  • Sử dụng lại phương thức triển khai setter cho các phương thức nạp chồng có setter (Ied70c)
  • Ghi lại vân tay đúng cách trong các phương thức setter có phương thức nạp chồng (I86ed2)

Phiên bản 1.0.0-alpha11

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

Phát hành androidx.wear.protolayout:protolayout-*:1.0.0-alpha11. Phiên bản 1.0.0-alpha11 chứa những cam kết này.

Tính năng mới

  • Chúng tôi đã thêm PlatformDataKey để đảm bảo độ chính xác của nhịp tim. (I7f9b8)

Thay đổi về API

  • Đổi tên StateBuilders#getIdToValueMapping thành getKeyToValueMapping và thay đổi loại dữ liệu trả về thành Map<<AppDataKey<?>,DynamicDataValue>. (Iaa7ae)
  • Đặt StateStore làm lớp cuối cùng (I408ca)
  • Giao diện TimeGateway đã được thay thế bằng PlatformTimeUpdateNotifier trong thư viện protolayout-expression-pipeline, cung cấp tần suất mong muốn để cập nhật dữ liệu thời gian. (I60869)
  • Đổi tên register/unregisterForData trong PlatformDataProvider thành set/clearReceiver (I14b02)
  • Trong Material Text, getExcludeFontPadding đã được đổi tên thành hasExcludeFontPadding. (Iea01d)
  • Thêm phương thức setter để căn chỉnh nhãn một cách hoàn hảo vào tất cả các thành phần khối. Tất cả khối hiện đã áp dụng mục tiêu nhấn tối thiểu. (I8ae92)
  • LayoutDefaults#BUTTON_MAX_NUMBER đổi tên thành MAX_BUTTONS (I84788)
  • DAILY_DISTANCE đổi tên thành DAILY_DISTANCE_M. (I4f758)

Sửa lỗi

  • Cập nhật tài liệu về loại thuộc tính để làm rõ lý do áp dụng giá trị tĩnh. Chỉ định giá trị mặc định được sử dụng nếu bạn không cung cấp giá trị tĩnh. (I155aa)
  • Không gian tên PlatformDataKey phải tuân theo quy tắc đặt tên kiểu Java. (I47bda)

Phiên bản 1.0.0-alpha10

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

Phát hành androidx.wear.protolayout:protolayout-*: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

  • Thêm AppDataKey để truy cập trạng thái đẩy ứng dụng; Thêm PlatformDataKey để truy cập dữ liệu nền tảng; Thêm tính năng hỗ trợ không gian tên trong StateStore. (I7985e)
  • Hỗ trợ các toán tử Equal và NotEqual cho DynamicBool. (I6a0c1)

Thay đổi về API

  • Lớp FontStyles hiện đã hoàn chỉnh (Iaa2ea)
  • Ngừng sử dụng LayoutElementBuilders#FontStyles. Vui lòng sử dụng androidx.wear.protolayout.Typography hoặc tạo FontStyle của riêng bạn. (Ic929b)
  • Ẩn giao diện lồng nhau Action#Builder khỏi giao diện Action. Các lớp LoadAction và LaunchAction đã cung cấp các phương thức triển khai của Builder. (I1d70c)
  • Cho phép sử dụng DynamicFloat với FloatProp. Xin lưu ý rằng FloatProp không yêu cầu các quy tắc ràng buộc bố cục vì không được dùng làm thuộc tính thay đổi bố cục. (I286ac)
  • Các thao tác LoalAction và SetStateAction bị xoá vì chưa được hỗ trợ thực sự. (I5d6a6)
  • Thêm tính năng hỗ trợ định dạng ARGB_8888 cho tài nguyên hình ảnh nội tuyến. (I8a07c)
  • Đổi tên StateEntryValue thành DynamicDataValue và cập nhật API trạng thái để sử dụng DynamicDataKey (If1c01)
  • Chúng tôi đang giới hạn số lượng mục nhập được phép trong StateStore để đảm bảo rằng mức sử dụng bộ nhớ và thời gian cập nhật trạng thái được kiểm soát và kiểm soát chặt chẽ cho mỗi thực thể của StateStore. Do đó, nhà phát triển cần đảm bảo rằng họ không có nhiều hơn MAX_STATE_ENTRY_COUNT mục nhập trong bản đồ, nếu không họ sẽ nhận được IllegalStateException khi tạo hoặc cập nhật StateStore. (Ibadb3)
  • Ẩn các lớp OnLoadTrigger và OnConditionMetTrigger, đồng thời đổi tên setTrigger thành setCondition cho OnConditionMetTrigger. (Ibf629)
  • Vì lý do về hiệu suất và khả năng tương thích, trình kết xuất ProtoLayout sẽ không hỗ trợ đầy đủ các tính năng trong tài nguyên AnimatedVectorDrawable. Chúng tôi sẽ đánh dấu các API đó là thử nghiệm cho đến khi có thể xác định nhóm được hỗ trợ. (Ic6daf)
  • Thêm các loại động cho quãng đường hằng ngày, lượng calo hằng ngày và số tầng hằng ngày. Các khoá cho nguồn trạng thái của nền tảng hiện nằm trong PlatformHealthSources.Keys (Ib7637)
  • Phương thức Easing.cubicBezier thay thế CubicBezierEasing.Builder. Do đó, lớp EasingFunction sẽ bị xoá và các hằng số làm dịu từ lớp đó hiện có thể truy cập trực tiếp từ giao diện Easing. Ngoài ra, setInfiniteRepeatable được thay thế bằng INFINITE_REPEATABLE_WITH_RESTART và INFINITE_REPEATABLE_WITH_REVERSE (Ib41e7)
  • Triển khai PlatformDataProvider để cung cấp nhịp tim và số bước hằng ngày. Xoá giao diện SensorGateway khỏi API công khai. (I55b84)
  • Thêm PlatformDataProvider và cập nhật StateStore để đăng ký với PlatformDataProvider khi nút yêu cầu khoá được hỗ trợ của nhà cung cấp từ quy trình biểu thức. (Ib616a)
  • SensorGateway không còn là Closeable vì không còn duy trì trạng thái nào. (I6b4f7)
  • Cho phép sử dụng FloatProp với DynamicFloat cho tiến trình trong CircularProgressIndicator. Tính năng này được hỗ trợ cho các trình kết xuất hỗ trợ phiên bản 1.2. Trình kết xuất cũ sẽ dự phòng thành staticValue nếu được cung cấp, nếu không thì sẽ thành 0 (I0d91b)
  • Các hằng số MultiButtonLayout đã được tái cấu trúc thành lớp LayoutDefaults.MultiButtonLayoutDefaults. Lớp này hiện chứa các hằng số cho kích thước nút tuỳ thuộc vào số lượng nút trong bố cục. (I13973)
  • Hỗ trợ sử dụng StringProp với DynamicString trong Material Text. Tính năng này được hỗ trợ cho các trình kết xuất hỗ trợ phiên bản 1.2. Các trình kết xuất cũ sẽ quay lại giá trị tĩnh đã cung cấp. Cập nhật loại dữ liệu trả về Text#getText từ String thành StringProp. (I7275b)

Phiên bản 1.0.0-alpha09

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

Phát hành androidx.wear.protolayout:protolayout-*: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

  • Chúng tôi đã thêm một phần tử bố cục tiện ích thử nghiệm. Xin lưu ý rằng bạn không thể sử dụng tính năng này theo mặc định và cần có một tiện ích trình kết xuất có thể hiểu được phần tử bố cục. (I6581d)
  • Thêm tính năng hỗ trợ StrokeCap cho ArcLine. (I94951)
  • Thêm tính năng hỗ trợ cho toán tử Tức thì có điều kiện. (I489a7)
  • Thêm tính năng hỗ trợ cho toán tử Thời lượng có điều kiện. (Iab469)
  • Thêm tính năng hỗ trợ tạo thời lượng từ giây. (Ib5fa1)

Thay đổi về API

  • Các phương thức enable/disablePlatformSource đã bị xoá khỏi DynamicTypeEvaluator. Phương thức gọi phải chịu trách nhiệm về nội dung cập nhật. (I78c6d)
  • Cho phép giới hạn kích thước của các loại dữ liệu liên kết. (Ie2966)
  • Thêm tính năng hỗ trợ cho nội dung mô tả động trong protolayout-material. (I62c8e)
  • Sử dụng long và @IntRange cho thời lượng và độ trễ trong AnimationParameters. (I388b6)

Phiên bản 1.0.0-alpha08

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

Phát hành androidx.wear.protolayout:protolayout-*: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

  • AndroidTextStyle đã được thêm vào LayoutElementBuilders. (I8d967)
  • Chúng tôi đã hỗ trợ thêm tính năng thiết lập để loại trừ khoảng đệm phông chữ trong Văn bản Material ProtoLayout. (I17f5d)
  • ARGB_8888 hiện được hỗ trợ cho hình ảnh nội tuyến. (I18c1e)
  • DynamicColor hiện hỗ trợ thao tác onCondition. (I10927)

Thay đổi về API

  • Hỗ trợ thời lượng tuỳ chỉnh cho ảnh động đảo ngược (I3251f)
  • Chúng tôi đã thêm đối tượng sửa đổi SemanticDescription. Ngoài ra, ContentDescription không thể liên kết. (I3f1d)
  • Phương thức DynamicBool.isFalse() hiện được thay thế bằng DynamicBool.negate() và DynamicBool.isTrue() bị xoá. Ngoài ra, các giá trị DynamicFloat NaN và việc thu hẹp DynamicInt32 thành DynamicFloat hiện sẽ tạo ra kết quả động không hợp lệ. (I6ac1e)
  • Trình định dạng int và float hiện sử dụng mẫu Builder. (Ieb213)

Sửa lỗi

  • Giá trị tĩnh dự phòng đã bị xoá khỏi các trường có thể tạo ảnh động. (Ifcb01)
  • Xoá DynamicTypeValueReceiver#onPreUpdate. (I2dc35)
  • Giờ đây, độ dài của Chuỗi trong biểu thức động được giới hạn. (I4c93)
  • Các phần phụ thuộc gradle hiện được đặt chính xác thành api thay vì implementation khi cần. (I40503)

Phiên bản 1.0.0-alpha07

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

Phát hành androidx.wear.protolayout:protolayout-*: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ợ giá trị động vào StringProp (I04342)
  • Đánh dấu các phần tử bố cục có thể liên kết (Ia110b)

Thay đổi về API

  • sensorGateway#registerSensorGatewayConsumer lấy loại dữ liệu làm tham số thay vì phương thức trong Consumer. (Icf314)
  • ObservableStateStore đổi tên thành StateStore (Ieb0e2)
  • Thêm DynamicTypeEvaluator.Builder thay vì đối số hàm khởi tạo để cho phép thêm các đối số không bắt buộc, bao gồm cả ObservableStateStore hiện mặc định là một cửa hàng trống. (I6f832)
  • Sắp xếp lại thứ tự các thông số trong DynamicTypeEvaluator. (Ic1ba4)

Sửa lỗi

  • Truyền chính xác tín hiệu từ nguồn cảm biến của nền tảng đến các nút hạ nguồn (I5a922)

Phiên bản 1.0.0-alpha06

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

Phát hành androidx.wear.protolayout:protolayout-*: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

  • Chúng tôi đã thêm một API thử nghiệm để sử dụng nhịp tim và số bước đi hằng ngày trong biểu thức động (Ifd711)
  • Chúng tôi đã thêm tính năng hỗ trợ độ trễ đảo ngược và chuyển tiếp cho ảnh động. (Ic25f7)
  • Chúng tôi đã thêm tính năng hỗ trợ DynamicColor vào Đường viền và Nền
  • Chúng tôi đã thêm tính năng hỗ trợ giá trị động vào các loại trong DimensionBuilder
  • Bố cục và các thành phần từ tiles-material sẽ chuyển sang protolayout-material

Thay đổi về API

  • LoadActionListener đã được thêm vào ProtoLayoutViewInstance. (If7806)

Sửa lỗi

  • Thêm FloatNodesTest (Id7281)
  • Khắc phục sự cố trình kết xuất khi không thể tải bitmap có cấu trúc.

Phiên bản 1.0.0-alpha05

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

Phát hành androidx.wear.protolayout:protolayout-*: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

  • Chúng tôi đã thêm ảnh động "cập nhật nội dung" thử nghiệm vào đối tượng Modifiers. Ảnh động này sẽ kích hoạt bất cứ khi nào phần tử (có đối tượng sửa đổi này) hoặc một trong các phần tử con của phần tử đó thay đổi trong quá trình cập nhật bố cục. (bd03e5d)

Thay đổi về API

  • Chúng tôi đã thêm forwardRepeatDelayMillis và reverseRepeatDelayMillis vào Repeatable. Chúng tôi cũng đã đổi tên delayMillis trong AnimationSpec thành startDelayMillis (Ifb266)
  • Các phương thức DynamicTypeEvaluator.bind hiện chấp nhận Trình thực thi. (I346ab)
  • Chúng tôi đã thêm phương thức startEvaluation vào BoundDynamicType để kích hoạt quá trình đánh giá sau khi liên kết loại động. (I19908)

Sửa lỗi

  • Đối tượng Animator sẽ được sử dụng lại cho các ảnh động tiếp theo của một phần tử. (Ia3be9)

Phiên bản 1.0.0-alpha04

Ngày 22 tháng 2 năm 2023

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

Tính năng mới

  • Giờ đây, ObservableStateStore cũng sẽ thông báo cho trình nghe khi một khoá bị xoá.
  • Chúng tôi đã thêm phiên bản giản đồ kết xuất đồ hoạ và tỷ lệ phông chữ vào DeviceParameters (có thể dùng để tạo bố cục theo điều kiện nhằm phản hồi nhiều phiên bản và chế độ cài đặt phông chữ).
  • Chúng tôi đã thêm tính năng hỗ trợ tạo ảnh động cho các giá trị DynamicInt32 (I05485)
  • Chúng tôi đã thêm điều kiện kích hoạt OnLoad và OnConditionalMet. Bạn có thể dùng chúng để bắt đầu tạo ảnh động hỗ trợ điều kiện kích hoạt.
  • Chúng tôi đã thêm trọng số bố cục cho thứ nguyên mở rộng và kích thước tối thiểu cho thứ nguyên được bao bọc.
  • Chúng tôi đã thêm các loại động thời điểm và khoảng thời gian. Bạn có thể dùng chúng để biểu thị một thời điểm hoặc khoảng thời gian trong một biểu thức động.
  • Chúng tôi đã thêm tính năng hỗ trợ AnimatedVectorDrawable và SeekableAnimatedVectorDrawable dưới dạng tài nguyên bố cục.

Các thay đổi về API

  • Dữ liệu cảm biến yêu cầu API 29 trở lên. (I8099e)
  • Chúng tôi đã thêm 2 phương thức trợ giúp launchAction (để chạy Hoạt động).

Sửa lỗi

  • Đổi tên set/getSpec thành set/getAnimationSpec trong ảnh động Thẻ thông tin (I3d74b)

Phiên bản 1.0.0-alpha03

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

Phát hành androidx.wear.protolayout:protolayout-*: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

  • Chúng tôi thêm toByteArray() và fromByteArray() vào các loại Dynamic trong thư viện protolayout-express.
  • Chúng tôi thêm toString() vào các loại Dynamic trong thư viện protolayout-expression.
  • Chúng tôi thêm tính năng hỗ trợ đánh giá cho các loại Dynamic. Bạn có thể sử dụng lớp DynamicTypeEvaluator từ thư viện protolayout-expression-pipeline để đánh giá (và nhận các giá trị cập nhật) cho một loại Dynamic tạo trước đó (DynamicString, DynamicFloat...)
  • Khi không thể phát ảnh động (do trình đánh giá đã tắt hoặc số ảnh động đang chạy đã đạt đến giới hạn đã đặt), các giá trị tĩnh được đặt trên nút có thể tạo ảnh động sẽ được dùng để thay thế ảnh động.

Phiên bản 1.0.0-alpha02

Ngày 25 tháng 1 năm 2023

Phát hành androidx.wear.protolayout:protolayout:1.0.0-alpha02, androidx.wear.protolayout:protolayout-expression:1.0.0-alpha02 và androidx.wear.protolayout:protolayout-proto:1.0.0-alpha02. Phiên bản 1.0.0-alpha02 bao gồm các thay đổi sau.

Tính năng mới

  • Các trình xây dựng bố cục từ androidx.wear.tiles:tiles sẽ chuyển sang androidx.wear.protolayout:protolayout. Bản phát hành alpha tiếp theo sẽ không còn dùng các phần tử trong androidx.wear.tiles:tiles nữa.

Phiên bản 1.0.0-alpha01

Ngày 11 tháng 1 năm 2023

Phát hành androidx.wear.protolayout:protolayout-expression:1.0.0-alpha01 và androidx.wear.protolayout:protolayout-proto: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

  • Bản phát hành này giới thiệu một thư viện mới có tên "Biểu thức ProtoLayout" để tạo biểu thức từ các biến động.