Giao diện người dùng Compose

Hướng dẫn sử dụng Mã mẫu

Tài liệu tham khảo API
androidx.Comose.ui
androidx.Comose.ui.geometry
androidx.Comose.ui.graphics
androidx.Comose.ui.platform
androidx.Comose.ui.test
(Xem tài liệu tham khảo về API cho tất cả các gói compose)

Các thành phần cơ bản của giao diện người dùng Compose cần thiết để tương tác với thiết bị, bao gồm cả bố cục, bản vẽ và phương thức nhập.

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 8 tháng 2 năm 2023	1.3.3	-	1.4.0-beta01	-

Cấu trúc

Compose là sự kết hợp của 7 mã nhận dạng Nhóm Maven (Maven Group Id) trong androidx. Mỗi Nhóm chứa một tập con chức năng mục tiêu và mỗi tập con có một tập hợp ghi chú phát hành riêng.

Bảng này giải thích các nhóm và đưa ra đường liên kết đến từng tập hợp ghi chú phát hành.

Nhóm	Mô tả
compose.animation	Tạo hiệu ứng chuyển động trong các ứng dụng Jetpack Compose để làm phong phú trải nghiệm người dùng.
compose.compiler	Biến đổi các hàm @Composable và hỗ trợ hoạt động tối ưu hoá bằng trình biên dịch bổ trợ Kotlin.
compose.foundation	Viết ứng dụng Jetpack Compose bằng các khối dựng có sẵn, cũng như mở rộng nền tảng để xây dựng các thành phần của hệ thống thiết kế của riêng bạn.
compose.material	Xây dựng các giao diện người dùng Compose Jetpack bằng các thành phần Material Design có sẵn. Đây là điểm truy cập cấp cao hơn của Compose, được thiết kế nhằm cung cấp các thành phần theo như mô tả trên trang web www.material.io.
compose.material3	Xây dựng giao diện người dùng Jetpack Compose bằng các thành phần Material Design 3, phiên bản cải tiến tiếp theo của Material Design. Material 3 có giao diện cập nhật, cũng như các thành phần và tính năng cá nhân hoá Material You, chẳng hạn như màu động. Công cụ này được thiết kế để phù hợp với phong cách đồ hoạ và giao diện người dùng hệ thống mới trên Android 12.
compose.runtime	Các khối dựng cơ bản cho mô hình lập trình và tính năng quản lý trạng thái của Compose, đồng thời là thời gian chạy cốt lõi để trình biên dịch bổ trợ Compose nhắm đến.
compose.ui	Các thành phần cơ bản của giao diện người dùng Compose cần thiết để tương tác với thiết bị, bao gồm cả bố cục, bản vẽ và phương thức nhập.

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

Để thêm một phần phụ thuộc trên Compose, 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 {
    implementation "androidx.compose.ui:ui:1.3.3"
}

android {
    buildFeatures {
        compose true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.4.2"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

Kotlin

dependencies {
    implementation("androidx.compose.ui:ui:1.3.3")
}

android {
    buildFeatures {
        compose = true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.4.2"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

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

Phiên bản 1.4.0-beta01

Ngày 8 tháng 2 năm 2023

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

Các thay đổi về API

Đổi tên PinnableContainer.PinnedHandle.unpin() thành release() (I4667a)
Thêm waitUntilNodeCount, waitUntilAtLeastOneExists, waitUntilExactlyOneExists và waitUntilDoesNotExist làm API thử nghiệm cho ComposeTestRule, mở rộng API waitUntil để chấp nhận mọi trình so khớp và số lượng nút bất kỳ. Hãy xem ComposeTestRule để biết thêm thông tin. (Ifa1b9, b/226934294)
Đổi tên Font.MaximumAsyncTimeout thành Font.MaximumAsyncTimeoutMillis. (I07af5)
Xoá GoogleFont.Provider.AllFontsListUri và liên kết đến mã này trong ktdoc. (I16f29)

Sửa lỗi

Bổ sung tài liệu cho AndroidFont.fontVariationSettings (I7d9e2)

Phiên bản 1.4.0-alpha05

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

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

Thay đổi về API

Ra mắt các phương thức nạp chồng thử nghiệm mới cho hàm runComposeUiTest và các hàm create*ComposeRule chấp nhận tham số CoroutineContext. Ngữ cảnh này sẽ được dùng cho thành phần kiểm thử cũng như mọi lệnh gọi LaunchedEffect và rememberCoroutineScope() trong thành phần đó. (I10614, b/265177763)
Thêm một API mới để theo dõi tốc độ theo 1 phương diện (If5a82)
FocusRequester nay được đánh dấu là @Stable. (I580ee)
Xoá chú thích thử nghiệm khỏi hàm khởi tạo DialogProperties nhận tham số usePlatformDefaultWidth. (Ic4048)
Thêm hàm vào vị trí cần tính toán và tiếp tuyến với một khoảng cách nhất định đối với một đường thẳng – với PathMeasure.getPosition() và PathMeasure.getTangent() (I3b47c)
Xoá phương thức setter công khai vô tình xuất hiện trên PlatformParagraphStyle. (I07f47)
Kiểu/tính chất rỗng khác dành cho các hàm cùng dòng/bị ẩn vì ngừng sử dụng (I24f91)
Thêm AnnotatedString.hasStringAnnotations để truy vấn các chú thích có cơ cấu phân bổ 0 (zero-allocations). (I94dfe, b/246960758)
Thêm phương thức nạp chồng mới cho hàm TextMeasurer.measure (hàm này nhận String dưới dạng văn bản). (I47b2d, b/242705342)
Các API LineBreak và Hyphens trong TextStyle dần trở nên ổn định. (Ic1e1d)

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

Các phương thức notifyFocusedRect trong TextInputSession và TextInputService đã được dùng trở lại. (I23a04, b/262648050)

Phiên bản 1.4.0-alpha04

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

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

Tính năng mới

Thêm một API PinnableContainer mới cho phép ghim các mục trong danh sách lazy để chúng không bị loại bỏ khi cuộn ra ngoài ranh giới. Ví dụ: Modifier.focusable() dùng cơ chế này để ghim mục hiện được đặt làm tiêu điểm. (Ib8881, b/259274257, b/195049010)
Hệ thống tiêu điểm được viết lại bằng API Modifier.Node thử nghiệm mới. (I7f4d7, b/247708726, b/255352203, b/253043481, b/247716483, b/254529934, b/251840112, b/251859987, b/257141589)
Thêm thuộc tính ngữ nghĩa IsContainer trên Nền tảng. Thuộc tính này sẽ được dùng cho một thay đổi trong tương lai để xác định thứ tự truyền tải dựa trên ý nghĩa ngữ nghĩa của các phần tử, chẳng hạn như nền tảng. (I63379)
Thêm vai trò hỗ trợ tiếp cận mới DropdownList. Bạn có thể dùng tính năng này để tái tạo hành vi của TalkBack's khi đặt tiêu điểm vào android.widget.Spinner. (I177e5, b/236159001)
Bạn hiện có thể dùng PlatformTextStyle(emojiSupportMatch) để tắt quy trình xử lý hỗ trợ biểu tượng cảm xúc (không bắt buộc) cho một Đoạn. (Ia7100, b/139326806)
Giờ đây, các hoạt động kiểm thử giao diện người dùng trong Android Compose sẽ chạy lệnh chuyển bố cục cho từng khung khi thực thi các khung để chuyển sang trạng thái rảnh (ví dụ: qua waitForIdle). Điều này có thể ảnh hưởng đến các hoạt động kiểm thử xác nhận trên từng khung ảnh động bố cục riêng lẻ. (I8ea08, b/222093277)
Thêm TextMotion thử nghiệm vào TextStyle để xác định Văn bản là Static(default) hay Ảnh động. Dùng TextMotion.Animated nếu Văn bản sẽ được điều chỉnh tỷ lệ, chuyển đổi hoặc xoay thông qua chuyển động. (I24dd7)

Thay đổi về API

Thay thế đối số maxSize: IntSize trong drawText bằng size: Size để cùng dòng với các hàm DrawScope khác. Theo mặc định, size được đặt thành Size.Unspecified và điều này sẽ không thay đổi hành vi mặc định trước đó. (Icd27d)
Xoá hàm khởi tạo phông chữ thử nghiệm không dùng nữa. (I8a724, b/261435386)
Lớp dữ liệu công cụ giao diện người dùng Group hiện có trường isInline. Trường này cho biết liệu nhóm có phải là dành cho lệnh gọi đến một hàm có khả năng kết hợp cùng dòng hay không. Nếu isInline là true thì lệnh gọi sẽ đến một hàm có khả năng kết hợp cùng dòng. Tuy nhiên, giá trị này có thể là false đối với các lệnh gọi đến hàm có khả năng kết hợp cùng dòng từ các mô-đun được biên dịch bằng phiên bản trình bổ trợ trình biên dịch Compose không tạo thông tin hàm cùng dòng. (Idb846)
Đưa một số API thử nghiệm trước đây vào phiên bản chính thức
Rotary Scroll Event API hiện đã ổn định (I42ad3, b/261561229)
FontVariation API hiện đã ổn định (I8779f, b/241016309)
Tất cả các hàm khởi tạo Font() hiện là API ổn định (I5948b, b/261435386)
DeviceFontFamilyName hiện đã ổn định (I8b640, b/261435386)
Hàm khởi tạo AndroidFont có variationSettings hiện là một API ổn định và có thể dùng để tạo các loại mới của bộ mô tả phông chữ. (I5adcc, b/261565807)
createFontFamilyResolver API hiện đã ổn định. Bạn có thể dùng API này để phát hiện các ngoại lệ chưa được phát hiện trong quá trình tải phông chữ không đồng bộ. (Ibb481, b/261435386)
Font.loadingStrategy API hiện đã ổn định. (I5937c, b/261435386)
GoogleFont API hiện đã ổn định. (Ic90b0, b/261435386)
TextUnit(float, TextUnitType) hiện là API ổn định. (I90c84, b/261561612)
pluralStringResource hiện là API ổn định. (I09849, b/261439703)

Phiên bản 1.4.0-alpha03

Ngày 7 tháng 12 năm 2022

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

Thay đổi về API

Xoá ExperimentalComposeUiApi khỏi PointerIcon (I23af8)
Ra mắt Thao tác hỗ trợ tiếp cận trên trang: PageUp, PageDown, PageLeft, PageRight. Lưu ý rằng những thao tác này chỉ có trong API 29. (Ida4ab)
Cập nhật khung hiển thị tham số rememberNestedScrollConnection từ khung hiển thị gốc thành khung hiển thị máy chủ. (Ia5200)
Thêm Modifier API (API Đối tượng sửa đổi) để truy vấn thông tin cuộn của đối tượng cấp trên. (I2ba9d, b/203141462)
Dùng trong Clickable để trì hoãn đúng cách thao tác tương tác nhấn, khi các cử chỉ có thể trở thành sự kiện cuộn.
Sửa lỗi khiến Clickables không trì hoãn đúng cách các hiệu ứng gợn sóng khi được dùng bên trong một Scrollable ViewGroup.
Cập nhật các Ngăn và Trang tính để trì hoãn đúng cách thao tác nhấn trong trường hợp các cử chỉ có thể trở thành sự kiện cuộn.
Đổi tên CompositingStrategy.Always thành Offscreen để cho biết graphicsLayer sẽ luôn được kết xuất vào vùng đệm trung gian (I47dc1)
Hiện đã ổn định phương thức nạp chồng bố cục có nhiều vị trí nội dung (I10566, b/248294649)
Thêm các API thử nghiệm mới PerfettoTrace.record {} và PerfettoTraceRule để ghi lại dấu vết Perfetto (còn gọi là Dấu vết hệ thống) như một phần của hoạt động kiểm thử, để kiểm tra hành vi và hiệu suất kiểm thử. (I3ba16)
Ở những hoạt động kiểm thử giao diện người dùng sử dụng quy tắc Compose, các thành phần tiếp tục (continuation) trong quá trình gọi lại withFrameNanos sẽ không được gửi đi cho đến khi mọi lệnh gọi lại khung đã chạy xong. Điều này phù hợp với hành vi của Compose khi chạy bình thường. Tuy nhiên, bài kiểm thử dựa trên hành vi cũ có thể không thành công. Điều này chỉ ảnh hưởng đến mã gọi trực tiếp withFrameNanos hoặc withFrameMillis và có logic bên ngoài lệnh gọi lại được truyền đến các hàm mà có thể cần được di chuyển bên trong lệnh gọi lại. Hãy xem các thay đổi về hoạt động kiểm thử ảnh động trong CL này để biết ví dụ.
Thêm tham số onPerformTraversals: (Long) -> Unit (không bắt buộc) vào hàm khởi tạo TestMonotonicFrameClock và hàm nhà máy để chạy mã sau lệnh gọi lại withFrameNanos nhưng trước khi tiếp tục coroutine của phương thức gọi. (Idb413, b/254115946, b/222093277, b/255802670)
Thêm EmojiCompat vào Compose (Ibf6f9, b/139326806)
Thêm tham số hình nền mới vào @Preview để hỗ trợ màu động (I9f512)

Sửa lỗi

Hệ thống hiện sẽ gửi thông báo áp dụng ảnh chụp nhanh sau khi Recomposer hoàn tất việc áp dụng các thay đổi. (Iad6c0, b/222093277)
Ra mắt các thay đổi trong captureToImage để cho phép chụp ảnh màn hình nhiều cửa sổ. Điều này rất hữu ích cho các hoạt động kiểm thử ảnh chụp màn hình sử dụng Cửa sổ bật lên của Compose. (I169c5)

Thông tin cập nhật về phần phụ thuộc

Giờ đây, giao diện người dùng Compose và Compose Material phụ thuộc vào Lifecycle 2.5.1. (I05ab0, b/258038814)

Phiên bản 1.4.0-alpha02

Ngày 9 tháng 11 năm 2022

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

Thay đổi về API

Cập nhật GraphicsLayerScope để hiển thị kích thước hiện tại của graphicsLayer. Điều này rất hữu ích cho việc tính toán các phép biến đổi graphicsLayer dưới dạng một hàm của kích thước Thành phần kết hợp (Composable). (If8c43,b/181387080)
Ra mắt CompositingStrategy nhằm xác định thời điểm tận dụng lớp kết hợp ngoài màn hình để hiển thị nội dung graphicsLayer. Tự động duy trì hành vi mặc định sẽ tận dụng nội bộ một lớp nếu áp dụng phiên bản alpha hoặc RenderEffect/Overscroll. Luôn cung cấp vùng đệm ngoài màn hình mà ở đó, thay vì tận dụng vùng đệm ngoài màn hình, ModulateAlpha sẽ điều chỉnh từng hướng dẫn vẽ đã ghi trong graphicsLayer. Việc dùng ModulateAlpha sẽ vẫn tận dụng vùng đệm ngoài màn hình để sử dụng RenderEffect/Overscroll (I25e82, b/256382834)
Thêm invalidateSubtree() vào Modifier.Node để cho phép vô hiệu hoá toàn bộ hệ phân cấp cho bố cục và bản vẽ. (I4bd90)
Chuyển rememberNestedScrollInteropConnection lên bản ổn định. Giới thiệu khả năng truyền khung hiển thị gốc tới rememberNestedScrollInteropConnection. Điều này có thể giúp khung hiển thị tuỳ chỉnh phản ứng tốt hơn với các giới hạn cuộn, đặc biệt là trong các khung hiển thị không chuẩn (ví dụ: ModalBottomSheetDialog). (I9e107)
Thêm giao diện ObserverNode có thể dùng trong các lượt triển khai Modifier.Node cần được thông báo khi giá trị mà chúng đọc trước đó đã thay đổi (I5728b, b/247716483)
Thêm một hàm khởi tạo mới vào Paint chấp nhận android.graphics.Paint gốc. Đồng thời thêm hàm mở rộng toComposePaint() chuyển đổi một đối tượng Paint (Vẽ) gốc hiện có thành Compose Paint. (Ica91b)
Thêm FontFamily.Resolver.resolveAsTypeface mới để dùng trên Android. (I8950b)
Thêm ToolingState để giúp công cụ thay đổi trạng thái nội bộ của Thành phần kết hợp (Ie6614)
Tái cấu trúc công cụ để hỗ trợ tốt hơn cho ảnh động mới được thêm vào (I8677b)
Thêm tham số minLines vào Text (Văn bản) Material cũng như Material3, TextField và OutlinedTextField giúp đặt chiều cao tối thiểu của thành phần theo số lượng dòng (I4af1d)

Phiên bản 1.4.0-alpha01

Ngày 24 tháng 10 năm 2022

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

Thay đổi về API

Thêm một phương thức mới là awaitEachGesture() cho trình phát hiện cử chỉ. Phương thức này hoạt động tương tự như forEachGesture(), nhưng các vòng lặp trên cử chỉ hoạt động hoàn toàn trong AwaitPointerEventScope, do đó, các sự kiện không bị mất giữa các vòng lặp.
Ngừng sử dụng forEachGesture() và thay bằng awaitEachGesture() vì phương thức này khiến sự kiện bị mất giữa các cử chỉ. (Iffc3f, b/251260206)
Ngừng sử dụng tính năng tái chế các đối tượng hỗ trợ tiếp cận trong androidx. Chúng tôi nhận thấy các thay đổi về hiệu suất là không đáng kể, ngay cả trong các phiên bản cũ nhất được hỗ trợ. (I0a961)
Thêm DrawStyle ở dạng thuộc tính Thử nghiệm vào TextStyle và SpanStyle để hỗ trợ vẽ văn bản có đường viền. (If24b8, b/155421273)
AnnotatedString.Builder hiện triển khai kotlin.text.Appendable. (I1a061, b/231030444)
AnnotatedString.Builder hiện có phương thức append(AnnotatedString, start: Int, end: Int) để nối một chuỗi con của AnnotatedString và các kiểu giao nhau.
Thêm tham số DrawStyle vào các hàm vẽ Paragraph và MultiParagraph để hỗ trợ vẽ văn bản có đường viền. (Ic8102, b/155421273)

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

Cảm ơn vighnesh vì đã thêm Thiết bị TV vào Bản xem trước (Ie15cd)

Phiên bản 1.3

Phiên bản 1.3.3

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

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

Sửa lỗi

Khắc phục sự cố thỉnh thoảng xảy ra trên Android 9 khi Hoạt động đang lưu trạng thái của Khung hiển thị Compose. (I0b755, b/260322832)

Phiên bản 1.3.2

Ngày 7 tháng 12 năm 2022

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

Sửa lỗi

Cập nhật để sử dụng Profobuf 3.21.8 tránh cảnh báo bảo mật trong protobuf-javalite:3.19.4 (CVE-2022-3171) (b/255545055)

Phiên bản 1.3.1

Ngày 9 tháng 11 năm 2022

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

Phiên bản 1.3.0

Ngày 24 tháng 10 năm 2022

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

Những thay đổi quan trọng kể từ phiên bản 1.2.0

Bộ API thử nghiệm mới LookaheadLayout (hỗ trợ các hành vi ảnh động mà trước đây không làm được)
Bộ API thử nghiệm mới Modifier.Node (phương án thay thế có hiệu suất cao hơn cho Modifier.composed)
Cải thiện khả năng hỗ trợ phần lồng ghép cửa sổ.
Hỗ trợ tiêu điểm cho các phím D-Pad và bàn phím phần cứng trong LazyLists.
Giảm độ nâng tối đa được hỗ trợ trong hộp thoại và cửa sổ bật lên xuống còn 8 dp (sự thay đổi có thể gây lỗi về hành vi đối với một số hệ thống thiết kế tuỳ chỉnh – lý do trong phần ghi chú phát hành của phiên bản beta01)
Có nhiều điểm cải tiến nhỏ, không gây lỗi API
Sửa nhiều lỗi và cải tiến hiệu suất

Phiên bản 1.3.0-rc01

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

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

Thay đổi về API

Thêm các Dấu gạch nối API thử nghiệm mới để hỗ trợ tính năng tự động gạch nối trong Văn bản (Iaa869)

Sửa lỗi

Theo mặc định, phông chữ DeviceFontFamilyName sẽ không định cấu hình các chế độ cài đặt biến thể wght và ital mà sẽ sử dụng chế độ cài đặt nền tảng cho Typeface được tải. (Ia7a6d, b/246989332)
Sửa lỗi rò rỉ bộ nhớ LazyColumn – onModifierLocalsUpdated không được gọi với giá trị mặc định khi các đối tượng sửa đổi được sử dụng lại (b/230168389)

Phiên bản 1.3.0-beta03

Ngày 21 tháng 9 năm 2022

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

Thay đổi về API

Thêm tuỳ chọn để tuỳ chỉnh dấu ngắt dòng trong Văn bản. (I86907)
Thay đối số size:IntSize bằng constraints: Constraints trong phương thức TextMeasurer.measure để hỗ trợ các điều kiện bắt buộc tối thiểu về chiều rộng. (I37530, b/242707525)

Sửa lỗi

API BackHandler của AndroidX Activity hiện hoạt động trong một thành phần kết hợp Dialog. (I35342)

Phiên bản 1.3.0-beta02

Ngày 7 tháng 9 năm 2022

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

Thay đổi về API

Thêm phương thức nạp chồng thử nghiệm cho Bố cục để chấp nhận danh sách bao gồm nhiều lambda nội dung có khả năng kết hợp, từ đó đưa các số liệu đo lường có nguy cơ vào các lambda nội dung khác nhau theo nhiều cách (Ic1b4e)

Các thay đổi đối với API thử nghiệm liên quan đến Tiêu điểm:

Ngừng sử dụng FocusDirection.In và FocusDirection.Out, đồng thời thay thế bằng FocusDirection.Enter và FocusDirection.Exit. (Ia4262, b/183746982)
Bổ sung 2 thuộc tính tiêu điểm mới là enter (vào) và exit (thoát) để chỉ định hành vi tuỳ chỉnh cho FocusManager.moveFocus(Enter) và FocusManager.moveFocus(Exit). (I5f3f9, b/183746982)
Giờ đây, bạn có thể dùng FocusRequester.Cancel để huỷ một thao tác di chuyển tiêu điểm. Bạn có thể dùng FocusRequester.Cancel trong bất kỳ thuộc tính tiêu điểm nào sau đây: up, down, left, right, next, previous, start, end, enter và exit (lên, xuống, sang trái, sang phải, đi tiếp, quay lại, bắt đầu, kết thúc, vào và thoát). (Ib300f)

Phiên bản 1.3.0-beta01

Ngày 24 tháng 8 năm 2022

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

Tái cấu trúc Modifier.Node

Phần lớn lớp xử lý các thực thể Modifier/Modifier.Element và điều phối hành vi của những thực thể này trên LayoutNodes sẽ được tái cấu trúc. Hiện tại, cách tái cấu trúc như trên không ảnh hưởng đến API công khai của bất kỳ công cụ sửa đổi nào trong Compose, đồng thời có thể được xem là thay đổi chỉ triển khai. Mặc dù vậy, đây là một thay đổi quan trọng vì nhiều lý do. (Ie4313)

Tóm tắt nội dung thay đổi

Các API Modifier.Node thử nghiệm đã thêm sẽ cung cấp tính năng trừu tượng hỗ trợ duy trì trạng thái trên một thực thể được giữ lại với vòng đời của nút bố cục, cũng như được phân bổ theo từng nút bố cục và mỗi lần sử dụng Modifier.Element tương ứng tạo ra nút đó.

Nói chung, tính năng trừu tượng này cung cấp một cơ chế thay thế để tạo ra các đối tượng sửa đổi trạng thái mà không cần dựa vào cơ chế của API Modifier.composed.

Rủi ro

Thay đổi này hoàn toàn tương thích nhị phân với bản phát hành trước, đồng thời hướng đến tương thích ngược về mặt hành vi ghi nhận được cả trên thực tế và lý thuyết. Tuy nhiên, có vài hệ thống phụ của Compose mà cách tái cấu trúc này chưa tác động đến. Ngoài ra, có thể hành vi đã thay đổi theo những cách chưa trải qua quy trình kiểm thử của chúng tôi, cũng như chưa được tìm thấy và khắc phục.

Vui lòng thận trọng khi nâng cấp lên bản phát hành này. Nếu bạn gặp vấn đề với thao tác này, vui lòng cho chúng tôi biết.

API thử nghiệm

Chúng tôi đã thêm nhiều API thử nghiệm và tất cả đều liên quan đến khái niệm mới về "Modifier.Node". Modifier.Node được tạo từ

fun modifierElementOf(…): Modifier
abstract class ModifierNodeElement
abstract class Modifier.Node
abstract class DelegatingNode
interface LayoutModifierNode
interface DrawModifierNode
interface SemanticsNode
interface PointerInputNode
interface ModifierLocalNode
interface ParentDataModifierNode
interface LayoutAwareModifierNode
interface GlobalPositionAwareModifierNode
interface IntermediateLayoutModifierNode

Sự thay đổi có thể gây lỗi về hành vi

Độ nâng tối đa được hỗ trợ cho hộp thoại và cửa sổ bật lên đã giảm xuống còn 8 dp.

Độ cao tối đa được hỗ trợ cho hộp thoại và cửa sổ bật lên trong Compose đã giảm từ 30 dp xuống còn 8 dp. Sự thay đổi này ảnh hưởng đến cả hộp thoại và cửa sổ bật lên tuỳ chỉnh trên giao diện người dùng cũng như Material. Sự thay đổi này được thực hiện để giảm thiểu lỗi hỗ trợ tiếp cận trên các phiên bản Android thấp hơn S, cũng như để đảm bảo rằng các dịch vụ hỗ trợ tiếp cận trong những cửa sổ đó có thể tương tác với nội dung bên trong hộp thoại hoặc cửa sổ bật lên.

Bạn sẽ chỉ chịu ảnh hưởng của sự thay đổi này nếu đang tạo hộp thoại hoặc cửa sổ bật lên tuỳ chỉnh với độ nâng được đặt ở mức lớn hơn 8 dp. Hãy cân nhắc giảm độ cao của hộp thoại hoặc cửa sổ bật lên. Nếu bạn cần chọn không sử dụng hành vi mới này, thì hãy cân nhắc tạo hộp thoại hoặc cửa sổ bật lên của riêng bạn với độ cao mong muốn. Bạn không nên làm vậy vì khả năng hỗ trợ tiếp cận có thể bị ảnh hưởng tiêu cực. Nhà phát triển cần đảm bảo rằng các dịch vụ hỗ trợ tiếp cận có thể tương tác và đọc được phần dưới cùng của hộp thoại hoặc cửa sổ bật lên.

Thay đổi về API

Khắc phục sự cố painterResource không cập nhật các thay đổi về cấu hình (I58e73, b/228862715)
rememberTextMeasurer không còn nhận các thông số FontFamily.Resolver, Density hoặc LayoutDirection. Vui lòng dùng hàm khởi tạo TextMeasurer để cung cấp giá trị tuỳ chỉnh cho những thông số này. (Ia1da3)
Thêm thuộc tính DialogProperties.decorFitsSystemWindows để các Hộp thoại có thể hỗ trợ WindowInsets. (I57742, b/229378542)
Di chuyển các hàm khởi tạo phông chữ về tệp Kotlin ban đầu để giữ lại khả năng tương thích nhị phân. Không thay đổi so với bản phát hành ổn định gần đây nhất. (Ieb2f3)
Xoá toán tử không cần thiết khỏi nhiều định nghĩa tương đương nhau – thao tác này không gây ảnh hưởng gì. (I6c309)
FontVariation.Setting là một giao diện kín, hỗ trợ các API kẹp trong tương lai. (I11021, b/143703328)
Thêm CompositionGroup.findParameters vào SlotTree.kt. Việc này giúp các công cụ truy xuất thông số cho CompositionGroup mà không cần phải phân tích cú pháp toàn bộ bảng vị trí. (I124fe)

Phiên bản 1.3.0-alpha03

Ngày 10 tháng 8 năm 2022

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

Thay đổi về API

LayoutCoordinates.findRootCoordinates() hiện đã được công khai (I7fa37, b/204723384)
Thêm API thử nghiệm để nhận LayoutCoordinates trong PlacementScope. Điều này cho phép các nhà phát triển biết vị trí hiện tại của bố cục để đặt vị trí con so với vị trí của bố cục. (I5482b, b/238632578)
Thêm LayoutCoordinates.transformFrom để chuyển đổi Ma trận từ LayoutCoordinates sang LayoutCoordinates khác. (Ic5ab1, b/238632578)
Ngừng sử dụng SemanticsModifier.id và thay vào đó, chuyển mã ngữ nghĩa sang LayoutInfo.semanticsId. (Iac808, b/203559524)
Phông chữ trong tài nguyên hiện hỗ trợ thiết lập chế độ cài đặt biến thể phông chữ (API cấp 26 trở lên). (I900dd, b/143703328)
Hỗ trợ phông chữ có thể thay đổi trong DeviceFontFamilyNameFont (Ic1279, b/143703328)
Hàm khởi tạo phông chữ hiện chấp nhận danh sách FontVariation.Setting để định cấu hình các phông chữ thay đổi trên thiết bị chạy Android O trở lên. (I11a9d, b/143703328)
Thêm API FontVariation để xác định và sử dụng phông chữ biến đổi. (I3c40c, b/143703328)
Hàm khởi tạo LineHeightStyle.Alignment hiện đang ở chế độ công khai (thử nghiệm) (I4bbbe, b/235876330)
Paragraph (Đoạn) hiện là expect|actual (mong đợi|thực tế) và được xác định cho Android và Máy tính. (Id387e, b/239962983)
Đoạn Giao diện hiện là một Đoạn giao diện kín. Không có trường hợp sử dụng nào để chia nhỏ paragraph (đoạn). Bạn nên liên hệ nếu sự thay đổi này ảnh hưởng đến bạn. (If5247, b/239962983)
Xoá chú giải thử nghiệm khỏi PlatformTextStyle và LineHeightStyle. (I64bef)
Ngừng sử dụng TextInputService.show|hideSoftwareKeyboard. Vui lòng sử dụng SoftwareKeyboardController thay thế trong mã ứng dụng và TextInputSession trong mã quản lý IME. (I14e4c, b/183448615)
Thêm API mới cho loại ảnh động hiện có (I26179)

Sửa lỗi

Thêm @RequiresPermission vào các API yêu cầu cấp quyền POST_NOTIFICATIONS trên SDK 33 trở lên. (Ie542e, b/238790278)

Phiên bản 1.3.0-alpha02

Ngày 27 tháng 7 năm 2022

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

Thay đổi về API

Thêm một thuộc tính PointerInputChange#pressure mới để truy xuất dữ liệu về áp lực. (I45a5e, b/205164819)
Thêm rememberTextMeasurer để dễ dàng tạo và ghi nhớ các thực thể TextMeasurer trong cấu trúc. (I8d66e)
Rect, RoundRect và MutableRect hiện hỗ trợ cú pháp in của Kotlin để gọi hàm contains. (Ie42b0, b/238642990)
Xoá các hàm không cần thiết khỏi KeyInjectionScope, vì chúng có thể dễ dàng triển khai bằng các phần đơn giản hơn của API. Các hàm đã xoá bao gồm pressKeys, keysDown và keysUp. (I81d77)
Tên hằng số và tham số được tái cấu trúc trong KeyInjectionScope để bao gồm hậu tố "Millis", trong đó đơn vị của hằng số và tham số kể trên là mili giây. (Iabef5)
Thêm phương thức toStringForLog() vào EditCommand để giúp khắc phục sự cố chỉnh sửa văn bản. (I53354, b/228862731)
Thêm hàm mở rộng drawText trên DrawScope để cung cấp cách vẽ văn bản nhiều kiểu trên các thành phần kết hợp và đối tượng sửa đổi hoạt động trên DrawScope như Canvas và drawBehind. (I16a62, b/190787898)
Ra mắt một API thử nghiệm mới có tên là TextMeasurer, cho phép tính toán bố cục văn bản tuỳ ý để tạo kết quả giống hệt với BasicText, không phụ thuộc vào thời gian chạy trong Compose. (I17101)
Thêm mapTree vào SlotTree.kt. Điều này cho phép các công cụ kiểm tra SlotTree mà không cần tạo bản sao trong bộ nhớ trước tiên như asTree. Đối với Layout Inspector (Trình kiểm tra bố cục), tính năng này giúp cải thiện hiệu suất của một factor 10. (I5e113)
Thay đổi tính năng Xem trước trong Compose để được lưu trữ trong các tệp đầu ra nhị phân, để cho phép nhà phát triển viết và sử dụng lại chú giải MultiPreview trong các thư viện. (I85699, b/233511976)

Sửa lỗi

Khi thêm sự kiện InputEventChange vào Velocity Tracker, chúng tôi sẽ xem xét delta thay vì vị trí, điều này sẽ đảm bảo tốc độ được tính toán chính xác cho tất cả các trường hợp ngay cả khi phần tử đích di chuyển (Icea9d, b/216582726, b/223440806, b/227709803)
Khắc phục NPE do AnnotatedString.toUpperCase gây ra khi có chú thích. (I0aca2, b/210899140)

Phiên bản 1.3.0-alpha01

Ngày 29 tháng 6 năm 2022

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

Các thay đổi về API

LookaheadLayout mới hỗ trợ lượt truyền có tính toán trước rồi mới đưa ra bố cục/phép đo lường thực tế. Điều này cho phép tính toán trước bố cục khi bố cục thay đổi, trong khi cho phép dùng bố cục/phép đo lường sau khi tính toán để dùng kích thước/vị trí đã tính toán trước để tạo kích thước và vị trí hướng tới mục tiêu. SubcomposeLayouts hiện chưa được hỗ trợ nhưng sẽ có trong bản phát hành sắp tới. (I477f5)
Thêm tham số alpha (không bắt buộc) vào phiên bản Brush (Bút vẽ) của TextStyle và SpanStyle để sửa đổi độ mờ của toàn bộ Text. (Ic2fac, b/234117635)
Giới thiệu loại chú thích UrlAnnotation và các phương thức liên kết để hỗ trợ việc liên kết TalkBack trong AnnotatedString. (I1c754, b/231495122)
Di chuyển chức năng tiện ích sang thời gian chạy (I4f729)

Sửa lỗi

TextLayoutResult.getLineForOffset không gửi. (Idc5d6, b/235876324)

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

Thêm API WindowInfo.keyboardModifiers mới để quan sát trạng thái của API này trong các hàm có khả năng kết hợp hoặc thông qua snapshotFlow (Icdb8a)

Phiên bản 1.2

Phiên bản 1.2.1

Ngày 10 tháng 8 năm 2022

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

Sửa lỗi

Khắc phục lỗi nullpointer trong công cụ kiểm tra (b/237987764)
Khắc phục trường hợp ngoại lệ truyền lớp trong quá trình ghi nhớ trong công cụ kiểm tra (b/235526153)

Phiên bản 1.2.0

Ngày 27 tháng 7 năm 2022

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

Những cải tiến trong việc truyền tải có tâm điểm:
- Giờ đây, thao tác cuộn tập trung vào danh sách Lazy sẽ hoạt động bằng cách sử dụng API cốt lõi BeyondBoundsLayout mới
- API tuỳ chỉnh hành vi mới trong FocusOrder và FocusProperties
- Cải thiện hành vi bằng bàn phím thực hoặc điều khiển từ xa của TV
API mới cho:
- Lồng ghép cửa sổ
- Các dữ liệu gốc cho ảnh động bố cục dựa trên cử chỉ, vô hạn và có bố cục
- Các chức năng của GraphicsLayer, bao gồm RenderEffect
Sửa nhiều lỗi và cải thiện hiệu suất

Phiên bản 1.2.0-rc03

Ngày 29 tháng 6 năm 2022

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

Không có thay đổi nào kể từ phiên bản 1.2.0-rc02.

Phiên bản 1.2.0-rc02

Ngày 22 tháng 6 năm 2022

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

Phiên bản 1.2.0-rc01

Ngày 15 tháng 6 năm 2022

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

Các thay đổi về API

Các giao diện trong thư viện Compose hiện được xây dựng bằng phương thức giao diện mặc định jdk8 (I5bcf1)
Đã thêm các hàm bậc cao hơn vào KeyInjectionScope để chèn các phím nhấn trong khi các phím khác được giữ hoặc bật. Các hàm này bao gồm withKeysDown, withKeysToggled, v.v. Ngoài ra, bạn cũng có thể thêm các thuộc tính khác để kiểm tra xem một phím meta cụ thể có hoạt động hay không, chẳng hạn như isCtrlDown để kiểm tra xem một trong hai phím điều khiển có được nhấn hay không. Hãy tham khảo KeyInjectionScope để xem tài liệu về từng hàm. (I9f6cd, b/229831515)
Ra mắt OverscrollEffect thử nghiệm để cho phép các hiệu ứng cuộn quá mức tuỳ chỉnh cùng với các phương thức nạp chồng Modifier.scrollable chấp nhận hiệu ứng này.
Chuyển LocalOverScrollConfiguration thử nghiệm từ foundation.gesture sang gói nền tảng và đổi tên thành LocalOverscrollConfiguration (If19fb, b/204650733)
Đổi tên runComposeUiTestWithoutActivity {} thành runEmptyComposeUiTest {} để căn chỉnh với createEmptyComposeRule() (I6fed7)

Phiên bản 1.2.0-beta03

Ngày 2 tháng 6 năm 2022

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

Thay đổi về API

Thêm pressKeyTimes cũng như isCapsLockOn và thuộc tính khác vào KeyInjectionScope. Ngoài ra, API này hiện hỗ trợ các mẫu chèn kết hợp chuột và bàn phím, chẳng hạn như nhấp vào nút chuột khi giữ một phím meta. (I4c8da, b/229831515)
Đã thêm tuỳ chọn hỗ trợ thử nghiệm để chèn các sự kiện chính. Dùng performKeyInput để gửi các sự kiện quan trọng hoặc gửi các sự kiện đó thông qua thuộc tính key của MultiModalInjectionScope trong cử chỉ nhập nhiều phương thức với performMultiModalInput. Hãy xem KeyInjectionScope để biết tài liệu về API sẵn có (Ic5000, b/229831515)
Thêm GoogleFont.Provider.AllFontsListUri mới để truy xuất nguồn Internet chính tắc của Google Fonts do Android hỗ trợ.
Cải thiện thông báo lỗi báo cáo khi GoogleFonts không tải được khi soạn thư. (I0416c)

Sửa lỗi

Khi thêm sự kiện InputEventChange vào Velocity Tracker, chúng tôi sẽ xem xét delta thay vì vị trí, điều này sẽ đảm bảo tốc độ được tính toán chính xác cho tất cả các trường hợp ngay cả khi phần tử đích di chuyển (I51ec3, b/216582726, b/223440806, b/227709803)
Chế độ cài đặt Show Layout Bounds hiện sẽ được áp dụng cho các thành phần kết hợp ngay sau khi bật/tắt chế độ này trong ô của trình đơn Cài đặt nhanh mà không cần phải rời khỏi và nhập lại hoạt động này. (I843d5, b/225937688)
Hoạt động tra cứu chuỗi hỗ trợ tiếp cận không kích hoạt tính năng tải phông chữ. Trước đây, trình duyệt này sẽ cố gắng tải phông chữ cho StyleSpans, việc này dẫn đến sự cố nếu FontFamily.Resolver đã bị ghi đè. (I4609d)
Thao tác nhấn phím xoá phía trước khi con trỏ ở cuối trường văn bản sẽ không gặp sự cố nữa.
DeleteSurroundingTextCommand và DeleteSurroundingTextInCodePointsCommand hiện yêu cầu các đối số hàm dựng không được âm. (Ica8e6, b/199919707)

Phiên bản 1.2.0-beta02

Ngày 18 tháng 5 năm 2022

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

Thay đổi về API

Sử dụng lại chức năng trong các loại bản xem trước khác (I19f39)

Sửa lỗi

ViewCompositionStrategy.DisposeOnDetachedFromWindowIfNotInPoolingContainer đã được đổi tên thành DisposeOnDetachedFromWindowOrReleasedFromPool để phản ánh rõ hơn thời điểm xảy ra việc loại bỏ, thay vì chỉ đơn giản là khi chúng không xảy ra. (If15ca)

Phiên bản 1.2.0-beta01

Ngày 11 tháng 5 năm 2022

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

Đây là bản phát hành beta 1.2 đầu tiên!

Thay đổi về API

Thêm BeyondBoundsInterval thử nghiệm có thể sử dụng được bằng cách triển khai tuỳ chỉnh của LazyList khi bố cục các mục nằm ngoài giới hạn hiển thị (Ifabfb, b/184670295)
Các phiên bản chính của Modifier.composed hiện có API ổn định (Ie65e4, b/229988420)
Đơn giản hoá API rememberNestedScrollConnection để sử dụng cấu trúc cục bộ nhằm thu nạp thông tin khung hiển thị hiện tại (I67ca7)
Bạn hiện có thể dùng chú giải @ComposableTarget và chú giải được đánh dấu bằng @ComposableTargetMarker trong phạm vi tệp bằng cách sử dụng tiền tố @file. Việc sử dụng chú giải mục tiêu ở phạm vi tệp sẽ khiến trình biên dịch giả định tất cả các hàm có khả năng kết hợp trong tệp đều hướng mục tiêu đến trình áp dụng liên kết. Ví dụ: việc sử dụng @file:UiComposable sẽ khai báo rằng tất cả các hàm @Composable đều nhắm mục tiêu đến ứng dụng Giao diện người dùng trong Compose. Một hàm khi nhắm mục tiêu đến ứng dụng khác phải cung cấp rõ ràng chú thích điểm đánh dấu mục tiêu mà ứng dụng mong muốn. (I40804)
Ra mắt API thử nghiệm mới, độc lập về nền tảng: interface ComposeUiTest và fun runComposeUiTest(block: ComposeUiTest.() -> Unit). Bạn có thể sử dụng API này để chạy chương trình kiểm thử giao diện người dùng trong Compose mà không cần TestRule. Để chạy chương trình kiểm thử mà không cần ComposeTestRule, hãy truyền chương trình kiểm thử dưới dạng hàm lambda cho runComposeUiTest, đồng thời sử dụng các phương thức và thành phần trong phạm vi trình thu nhận ComposeUiTest, giống như trong ComposeContentTestRule.

Thêm interface AndroidComposeUiTest và fun runAndroidComposeUiTest(block: AndroidComposeUiTest.() -> Unit) dành riêng cho Android để cung cấp quyền truy cập vào Hoạt động cơ bản, tương tự như AndroidComposeTestRule. Để tăng cường quyền kiểm soát, bạn có thể tự tạo thực thể cho class AndroidComposeUiTestEnvironment.

Cách triển khai cho máy tính là class DesktopComposeUiTest, nhưng hiện tại không có chức năng nào chạy riêng cho máy tính được cung cấp.

Bạn có thể di chuyển chương trình kiểm thử từ ComposeTestRule sang ComposeUiTest như thế này (ví dụ trong Android). Từ:
```
@RunWith(AndroidJUnit4::class)
class MyTest {
    @get:Rule val rule = createComposeRule()
    @Test
    fun test() {
        rule.setContent {
            Text("Hello Compose!")
        }
        rule.onNodeWithText("Hello Compose!").assertExists()
    }
}
```
Đến:
```
@RunWith(AndroidJUnit4::class)
class MyTest {
    @Test
    @OptIn(ExperimentalTestApi::class)
    fun test() = runComposeUiTest {
        setContent {
            Text("Hello Compose!")
        }
        onNodeWithText("Hello Compose!").assertExists()
    }
}
```
Hiện tại, ComposeContentTestRule và ComposeTestRule không mở rộng từ ComposeUiTest, nghĩa là chưa thể gọi các hàm mở rộng trên ComposeUiTest trong giao diện TestRule. Khi ComposeUiTest chuyển sang API ổn định, ComposeContentTestRule và ComposeTestRule sẽ được thay đổi để mở rộng từ ComposeUiTest. (Ib4e90)
LineHeightBehavior được đổi tên thành LineHeightStyle
LineVerticalAlignment được đổi tên thành LineHeightStyle.Alignment
Đổi tên LineHeightTrim thành LineHeightStyle.Trim
Xoá các giá trị hàm khởi tạo mặc định từ LineHeightStyle (I582bf, b/181155707)
Thêm Brush vào TextStyle và SpanStyle để cung cấp cách vẽ văn bản chuyển màu. (I53869, b/187839528)
Các thuộc tính trimFirstLineTop, trimLastLineBottom của LineHeightBehavior đã chuyển thành một giá trị enum duy nhất: LineHeightTrim. LineHeightTrim có các giá trị của 4 trạng thái được xác định bằng 2 giá trị boolean: FirstLineTop, LastLineBottom, Both (Cả hai) và None (Không có) (Ifc6a5, b/181155707 )
Thêm LineHeightBehavior vào TextStyle và ParagraphStyle. LineHeightBehavior kiểm soát việc áp dụng chiều cao dòng cho đầu dòng đầu tiên và cuối dòng cuối cùng. Phần này cũng xác định sự căn chỉnh của dòng trong không gian do TextStyle(lineHeight) cung cấp.

Ví dụ: có thể lấy hành vi tương tự như CSS đã xác định thông qua LineHeightBehavior(alignment = LineVerticalAlignment.Center, trimFirstLineTop=false, trimLastLineBottom = false).
Các cấu hình trimFirstLineTop, trimLastLineBottom chỉ hoạt động chính xác khi includeFontPadding sai. (I97332, b/181155707)
Hàm PlatformParagraphStyle.lerp và PlatformSpanStyle.lerp được thay đổi thành hàm cấp cao nhất (I9a268)

Sửa lỗi

Tài liệu PointerInputChange::copy hiện có thể nói một cách chính xác rằng đó là một bản sao shallow. (I182f5)
Hỗ trợ dấu ba chấm khi chiều cao bị giới hạn và không vừa với tất cả các dòng văn bản (Ie528c, b/168720622)
Bật includeFontPadding mặc định. Bạn có thể tắt includeFontPadding bằng thuộc tính TextStyle.platformTextStyle. Trong tương lai gần, chúng tôi sẽ thay đổi hành vi mặc định, tuy nhiên hiện tại, điều này cho phép chúng tôi tích hợp tốt hơn các cải tiến về chiều cao dòng (aosp/2058653) và giải quyết các sự cố về cắt TextField. (I01423, b/171394808)

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

MouseInjectionScope.scroll(delta = someDelta) hiện sẽ đảo ngược trên Android nếu chúng ta cuộn theo chiều dọc (nếu someDelta dương thì nó sẽ di chuyển xuống dưới) (Ifb697, b/224992993)

Phiên bản 1.2.0-alpha08

Ngày 20 tháng 4 năm 2022

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

Thay đổi về API

Các hàm pluralStringResource được đánh dấu là thử nghiệm để cho phép cải tiến nhằm hỗ trợ quá trình quốc tế hoá tốt hơn trong tương lai. (If24e4)
Đoạn và Nhiều đoạn hiện chấp nhận thông số Constraints. Hiện tại, việc truyền Constraints.maxHeight không hoạt động nhưng sẽ cho phép thực hiện một số tính toán trong tương lai, chẳng hạn như tạo dấu ba chấm dựa trên chiều cao. (I6afee, b/168720622)
SubcomposeSlotReusePolicy.getSlotsToRetain() hiện chấp nhận một lớp tuỳ chỉnh giống MutableSet, lớp này không cho phép thêm các mục mới vào lớp đó. (Icd314)
PointerIcon hiện là giao diện @Stable (I9dafe)
Mức sử dụng một phần (giảm/không có vị trí) trong PointerInputChange sẽ không được dùng nữa. Bạn có thể dùng consume() để thay đổi hoàn toàn. Bạn có thể sử dụng isConsumed để xác định xem ai đó đã từng thực hiện thay đổi trước đây hay chưa.
Giờ đây, PointerInputChange::copy() luôn tạo một bản sao nông. Điều này có nghĩa là các bản sao của PointerInputChange sẽ được sử dụng sau khi một trong các bản sao được sử dụng. Nếu bạn muốn tạo một PointerInputChange không liên kết, hãy dùng hàm khởi tạo. (Ie6be4, b/225669674)
Bật tính năng tương tác Cuộn giữa lồng giữa và Chế độ xem theo hướng Compose > Chế độ xem. Điều này có nghĩa là thành phần chính trong Compose có thể nhận các delta cuộn lồng từ khung hiển thị cuộn lồng. (If7949, b/174348612)
SemanticsProperty testTagsAsResourceId mới, có thể được dùng để tạo nên tính năng Soạn thư phù hợp với các thử nghiệm UIAutomator được thiết kế cho hệ thống Chế độ xem. (I39c20)
Hiển thị mọi trọng số hiện có cho phông chữ hệ thống trên Android khi sử dụng FontFamily.SansSerif. Tính năng này sẽ sử dụng các tên phông chữ dự phòng như alt-serif-medium trong API 21-28. Đây là thay đổi về hành vi vì trước đây chỉ có trọng số 400 và 700 được hỗ trợ trên API 21-28. (I380fe, b/156048036, b/226441992)
Người hướng dẫn Đoạn và Nhiều đoạn cần sắp xếp lại các đối số vị trí trước đối số không bắt buộc. (Idafaa)
AndroidFont hiện lấy typefaceLoader làm thông số hàm dựng. (I2c971)

Phiên bản 1.2.0-alpha07

Ngày 6 tháng 4 năm 2022

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

Thay đổi về API

Thêm hàm mới Snapshot.withoutReadObservation { ... }. Tính năng này cho phép người dùng chạy hàm lambda đã truyền mà không cần phải đăng ký các thay đổi về giá trị trạng thái đã đọc trong khối này. Điều này hữu ích trong các trường hợp sử dụng khi bạn muốn hưởng lợi từ việc đọc/ghi an toàn theo chuỗi ảnh chụp nhanh, nhưng cũng muốn đọc được giá trị này mà không cần quá trình tái cấu trúc hoặc đo lường lại không cần thiết. (I9f365, b/214054486)
Thuộc tính của tiện ích consumeWindowInsets của ComposeView cho phép nhà phát triển tắt tuỳ chọn sử dụng Android WindowInsets. Việc này cho phép sử dụng ComposeViews riêng biệt trong hệ phân cấp, áp dụng cho WindowInsets mà không gây cản trở cho nhau. (I0ef08, b/220943142)
Thêm KeyboardType.Decimal làm giải pháp thay thế cho Keyboard.Number để thêm riêng dấu phân tách số thập phân trong IME. (Iec4c8, b/209835363)
PointerEventType.Scroll và PointerEvent.scrollDelta hiện là các API ổn định (I574c5, b/225669674)
Bật khả năng tương tác Cuộn lồng giữa Khung hiển thị và Compose cho các lớp Khung hiển thị cộng tác. Tức là giờ đây, Compose có thể điều phối các delta cuộn đến thành phần mẹ trong Khung hiển thị (đang cộng tác). (I5d1ac, b/174348612)
Cập nhật FontFamily.Resolver để tích hợp chế độ cài đặt hỗ trợ tiếp cận văn bản in đậm trên toàn hệ thống (I6c1e7)
Ngừng sử dụng Font(AssetManager, String, ...) và thay thế bằng Font(String, AssetManager, ...). Đây là một API thử nghiệm. (I1c7a4)
Thêm bộ mô tả phông chữ mới Font(DeviceFontFamilyName) để tuỳ ý tra cứu phông chữ do hệ thống cài đặt trong chuỗi dự phòng phông chữ. (I30468, b/219754572)
Thêm cấu hình tương thích tạm thời cho includeFontPadding trong TextStyle/ParagraphStyle. Bạn có thể thay đổi includeFontPadding qua TextStyle(platformStyle = PlatformTextStyle(includeFontPadding = true/false)). Đây là tuỳ chọn cấu hình tạm thời để bật tính năng di chuyển và sẽ bị xoá. (If47be, b/171394808)
Thêm phần mở rộng GoogleFont.Provider.isAvailableOnDevice để trợ giúp gỡ lỗi. (I64e31)
Thêm hàm khởi tạo GoogleFont.Provider để sử dụng với @ArrayRes (Ic5ee1, b/225984280)
Compose GoogleFont hiện được gọi là Font(GoogleFont), nếu không thì API sẽ ổn định. (I125f2)

Sửa lỗi

Thêm tính năng kiểm tra tìm lỗi mã nguồn vào material/Scaffold để đảm bảo rằng khoảng đệm bên trong đang được sử dụng (Ifb111)

Phiên bản 1.2.0-alpha06

Ngày 23 tháng 3 năm 2022

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

Thay đổi về API

Đã thêm hành động ngữ nghĩa RequestFocus để yêu cầu tập trung vào mục tiêu có thể đặt tiêu điểm. (I17b71)
Cập nhật số liệu phân tích cú pháp các vectơ vẽ được để hỗ trợ tính năng tự động phản chiếu nhằm lật nội dung của VectorPainter nếu hướng bố cục hiện tại là RTL. (I79cd9, b/185760237)
Cập nhật màu shadow/ambient (bóng/môi trường xung quanh) thành các tham số cuối của Modifier.graphicsLayer cho khả năng tương thích API (I3f864, b/160665122)
Thêm các phương pháp triển khai mặc định vào màu shadow/ambient (bóng/môi trường xung quanh) trên GraphicsLayerScope để đảm bảo các thay đổi về API không gây lỗi
Thêm thời gian diễn ra sự kiện cho sự kiện RSB (Ief8ae)
FocusOrder hiện đã được hợp nhất vào FocusProperties và focusProperties() hiện có tất cả các tính năng của focusOrder(). Ngừng sử dụng FocusOrder và focusOrder(). focusOrder() chấp nhận một focusRequester sẽ được thay thế bằng đối tượng sửa đổi focusRequester() kết hợp với focusProperties(). Điều này cho phép đối tượng sửa đổi phân tách các mối quan ngại mạnh mẽ hơn. (I601b7)
Giờ đây, việc nâng cấp cả RecyclerView và Compose sẽ mang lại hiệu suất cuộn tốt hơn nhiều cho RecyclerView với chế độ xem Compose là con.
Thêm ViewCompositionStrategy.Default làm phương tiện truy xuất chiến lược mặc định được tích hợp sẵn
Thêm ViewCompositionStrategy.DisposeOnDetachedFromWindowIfNotInPoolingContainer, đây là chiến lược mặc định mới và xử lý đúng cách các vùng chứa gộp chung như RecyclerView. (If7282)
Thêm tuỳ chọn hỗ trợ để chú thích cho lớp chú giải với @Preview làm bước đầu tiên nhằm bổ sung tính năng Multipreview. Các chú giải như vậy có thể được dùng để chú thích các phương thức Thành phần kết hợp hoặc các lớp chú giải khác, sau đó có thể được coi là được chú thích gián tiếp bằng @Preview đã cho. (I12eff)
Những thiết bị tham chiếu được thêm vào danh sách Thiết bị cho @Preview (I071c9)

Sửa lỗi

Cập nhật các API đồ hoạ vectơ để sử dụng chú giải thành phần kết hợp thích hợp @VectorComposable thay vì @UiComposable (I942bc)
Xoá chéo dòng khỏi AnnotatedString.Builder.withStyle (If84d5)

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

compose-ui: Thêm thuộc tính ambientShadowColor và spotShadowColor vào GraphicsLayerScope (I1ba1a, b/160665122)
Tài nguyên cố định hiện được hỗ trợ thông qua hàm pluralStringResource. (Ib2f23, b/191375123)

Phiên bản 1.2.0-alpha05

Ngày 9 tháng 3 năm 2022

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

Thay đổi về API

TextToolbar hiện áp dụng các đối số lambda thay vì ActionCallback. (Ib2eb9, b/197950089)
Cập nhật tính chất rỗng trong lõi và appcompat để phù hợp với Tiramisu DP2 (I0cbb7)
Giao diện được đo lường giờ biểu thị thuộc tính parentData (I3313f)
Modifier.onPlaced và giao diện OnPlacedModifier hiện đã ổn định. (Ib5482)
Thật tuyệt! Hiệu ứng chuyển động trong Compose hiện đã hỗ trợ chế độ cài đặt "Tỷ lệ thời lượng của trình tạo hiệu ứng chuyển động" trong Tuỳ chọn cho nhà phát triển. (I5a4fc, b/161675988)
Thêm giá trị đối tượng sửa đổi cục bộ BeyondBoundsLayout (If8b51, b/184670295)
Văn bản: includeFontPadding hiện bị tắt theo mặc định. Chúng tôi đã xử lý các sự cố cắt từ do includeFontPadding=false và hiện tượng cắt từ sẽ không nảy sinh trong các tập lệnh có phông chữ cao. (I31c84, b/171394808)

Sửa lỗi

ComposeContentTestRule.setContent hiện sẽ gửi IllegalStateException nếu bạn cố cài đặt nội dung khi đã có nội dung. (I888a5, b/199631334)
Khắc phục sự cố do nội dung trong bảng nhớ tạm gây ra khi đọc từ bảng nhớ tạm trên Android. (I06020, b/197769306)
Cải thiện các mẫu cuộn RSB. (I6a596)

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

Cập nhật để sử dụng các coroutine Kotlinx 1.6.0 (I3366d)

Phiên bản 1.2.0-alpha04

Ngày 23 tháng 2 năm 2022

Phát hành androidx.compose.ui:ui-*: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 ComposableTarget, ComposableTargetMarker và ComposableOpenTarget cho phép báo cáo thời gian biên dịch khi gọi một hàm có khả năng kết hợp nhắm đến một trình áp dụng mà nó không được thiết kế để sử dụng.

Trong hầu hết các trường hợp, trình bổ trợ trình biên dịch Compose có thể suy ra các chú giải. Do đó, các chú giải này hiếm khi được sử dụng trực tiếp. Có những trường hợp không thể dự đoán được như việc tạo và sử dụng các hàm trừu tượng có khả năng kết hợp, trình áp dụng tuỳ chỉnh (chẳng hạn như phương thức giao diện), các trường hoặc biến toàn cục là các biểu thức lambda có khả năng kết hợp (biến và tham số cục bộ được suy đoán), hoặc khi sử dụng ComposeNode hoặc hàm có khả năng kết hợp liên quan.

Đối với các trình áp dụng tuỳ chỉnh, những hàm có khả năng kết hợp gọi ComposeNode hoặc ReusableComposeNode cần thêm chú giải ComposableTarget cho hàm đó và mọi loại tham số lambda có khả năng kết hợp. Tuy nhiên, bạn nên tạo chú giải được chú thích bằng ComposableTargetMarker, sau đó trực tiếp sử dụng chú giải được đánh dấu thay cho ComposableTarget. Một chú giải của thành phần kết hợp được đánh dấu bằng ComposableTargetMarker sẽ tương đương với ComposbleTarget có tên đủ điều kiện của lớp thuộc tính dưới dạng tham số của trình áp dụng. Để biết ví dụ về cách sử dụng ComposableTargetMarker, vui lòng xem anroidx.compose.ui.UiComposable. (I38f11)
Font(resId, ...) hiện đã sử dụng adStrategy trên API ổn định. (Ief3d2)
FontLoadingStrategy hiện là API ổn định. (I1ee35, b/174162090)
Hỗ trợ tải phông chữ không đồng bộ trong Văn bản (I77057, b/214587005)
Thêm API cầu nối để chuyển đổi Font.ResourceLoader tuỳ chỉnh thành FontFamily.Resolver. (Ia0060)

Sửa lỗi

Truyền FontFamily.Resolver được cung cấp đến các thành phần phụ như Cửa sổ bật lên.
Truyền Font.ResourceLoader được cung cấp đến các thành phần phụ như Cửa sổ bật lên. (I48fa5)

Phiên bản 1.2.0-alpha03

Ngày 9 tháng 2 năm 2022

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

Thay đổi về API

Hiện ngừng sử dụng và sẽ không gọi các phương thức notifyFocusedRect trong TextInputSession và TextInputService nữa. Thay thế bằng BringIntoViewRequester. (Ia4302, b/192043120, b/216842427, b/178211874)
Ra mắt phương thức destroyDisplayListData trên lớp mã giả lập RenderNode (I1e659, b/216660268)
Thêm API mới cho phép đo lường trước phần tử con của SubcomposeLayout do bạn kết hợp trước. (I857ea)
Đã thêm movableContentOf chuyển đổi Lambda có thể kết hợp thành một Lambda di chuyển trạng thái và các nút tương ứng, sang bất kỳ vị trí mới nào mà nó được gọi. Khi lệnh gọi trước rời khỏi cấu trúc, trạng thái sẽ được lưu giữ tạm thời và nếu một lệnh gọi mới đến lambda nhập vào cấu trúc, thì trạng thái và các nút liên quan sẽ được chuyển đến vị trí của lệnh gọi mới. Nếu không có lệnh gọi mới nào được thêm, trạng thái sẽ bị xoá vĩnh viễn và nhớ là các trình quan sát được thông báo.

Nếu hệ thống gọi lambda movableContentOf nhiều lần trong cùng một cấu trúc, thì trạng thái mới và các nút sẽ được tạo cho mỗi lệnh gọi. Khi các lệnh gọi rời khỏi cấu trúc và các lệnh gọi mới nhập vào, trạng thái đó sẽ được chuyển từ lệnh gọi rời đi đầu tiên đến lệnh gọi nhập vào theo thứ tự chúng được gọi. Tất cả trạng thái không được xác nhận quyền sở hữu bởi các cuộc gọi mới sẽ bị xoá vĩnh viễn. (Ib4850)
FontFamilyResolver hiện được cung cấp qua LocalFontFamilyResolver.current
Thêm createFontFamilyResolver(context) và createFontFamilyResolver(context, coroutineScope) để tạo các trình phân giải FontFamily mới cho việc sử dụng bên ngoài Compose.
Đoạn và nhiều Đoạn hiện sử dụng mã FontFamily.Resolver
TextLayoutResult.layoutInput.fontFamilyResolver hiện chứa trình phân giải dùng cho bố cục này, đã ngừng sử dụng TextLayoutResult.layoutInput.resourceLoader vì mã này không còn được dùng nữa. (Id5a45, b/174162090)
Hỗ trợ tải phông chữ không đồng bộ và tuỳ chọn với hành vi dự phòng. Đường dẫn này được Text (Văn bản) và TextField (Trường văn bản) sử dụng và được hiển thị thông qua FontFamilyResolver
Hỗ trợ tải trước phông chữ qua FontFamilyResolver.preload
FontFamilyResolver.setAsyncLoadContext cho phép cài đặt ngữ cảnh coroutine chung cần thiết để tải phông chữ không đồng bộ. (I87fe8, b/174162090)
Thêm AndroidFont, một API cấp độ thấp mới để cung cấp các loại trình mô tả tài nguyên phông chữ mới trên Android. Ví dụ: tải phông chữ từ một lệnh phụ trợ cụ thể cho ứng dụng, tuỳ chọn định vị phông chữ cài đặt sẵn trên thiết bị hoặc tải phông chữ từ một tài nguyên không do nhà máy Font (Phông chữ) hiện tại cung cấp.
Mở rộng API Font.ResourceLoaded để hỗ trợ việc tải phông chữ không bắt buộc và không đồng bộ. Các nhà phát triển ứng dụng không nên trực tiếp sử dụng API này. Để thêm các loại phông chữ mới, hãy xem AndroidFont.
Hàm mở rộng Font.AndroidResourceLoader cho phép tạo một Font.ResourceLoader khi ở bên ngoài cấu trúc.
Thêm tham số loadingStrategy vào các phông chữ dựa trên tài nguyên để cho phép tải không đồng bộ khi phông chữ tài nguyên tham chiếu đến XML của phông chữ có thể tải xuống. (Ie5aea, b/174162090)
Ngừng sử dụng hàm khởi tạo Typeface(FontFamily). Trước đây, hàm này dùng để tải trước phông chữ và có thể mất đến 10 giây để tải xuống các phông chữ. Với phông chữ có thể tải xuống, thao tác gọi lệnh này có thể chặn trong 10 giây. Thay vào đó, hãy sử dụng FontFamilyResolver.preload.
Ngừng sử dụng fontResource(FontFamily): Typeface. Trước đây, hàm này dùng để tải trước phông chữ và có thể mất đến 10 giây để tải xuống các phông chữ. Thay vào đó, hãy sử dụng FontFamilyResolver.preload (If8e7c, b/174162090)
Ngừng sử dụng hàm khởi tạo SubcomposeLayoutState chấp nhận maxSlotsToRetainForReuse. Thay vào đó, có một hàm khởi tạo mới chấp nhận SubcomposeSlotReusePolicy – một giao diện mới cho phép bạn kiểm soát chi tiết hơn về việc cần giữ lại những khe nào để tái sử dụng trong tương lai. (I52c4d)
Hiển thị hàm HSV và HSL trong Color dưới dạng API không thử nghiệm. Hệ màu Oklab hiện là API công khai. (I08fb6, b/180731008)
Ngừng sử dụng AndroidComposeTestRule.AndroidComposeStatement, vốn không nằm trong API công khai và không thực hiện thao tác nào cho bạn. (Ibc46b)
Đổi tên lớp kt được tạo nội bộ (Ia0b9e, b/174162090)
Xoá FontLoadingStrategy.values (I42a9d, b/174162090)
Trình tải phông chữ chung hiện được gọi là FontFamilyResolver. (I4f773, b/174162090)
Sử dụng hệ thống tải phông chữ mới cho máy tính. (I9ce5c, b/174162090)
FontFamily.Resolver.resolve trả về State<Any> (I4406c, b/174162090)

Sửa lỗi

Giờ đây, các trường văn bản TextField sẽ được giữ ở phía trên bàn phím khi các trường này được lấy làm tâm điểm và bàn phím hiển thị khi chế độ nhập mềm là ADJUST_PAN. (I8eaeb, b/190539358, b/192043120)
Máy tính sử dụng cấu trúc cục bộ cho FontFamily.Resolver
Ngừng sử dụng FontLoader dành cho máy tính
Lập trình hướng đối tượng mã createFontFamilyResolver mới trên Máy tính (I6bbbb, b/174162090)
Kiểu nhập bằng bàn phím mềm không còn nhấp nháy khi thay đổi tâm điểm giữa các trường văn bản. (I1bf50, b/187746439)

Phiên bản 1.2.0-alpha02

Ngày 26 tháng 1 năm 2022

androidx.compose.ui:ui-*:1.2.0-alpha02 đã được phát hành. Phiên bản 1.2.0-alpha02 bao gồm các thay đổi sau.

Thay đổi về API

Thêm Modifier.onRotaryScrollEvent() và Modifier.onPreRotaryScrollEvent() cho các thiết bị Wear có nút bên xoay (I18bf5, b/210748686)
Thêm phần mở rộng View.createLifecycleAwareRecomposer thử nghiệm (I0cde6)

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

PointerEvent.scrollDelta.y hiện đang được đảo ngược trên Android (hiện giờ giá trị này trả về 1 thay vì -1 nếu chúng ta nghiêng con lăn chuột sang phải) (Ia9811)

Phiên bản 1.2.0-alpha01

Ngày 12 tháng 1 năm 2022

androidx.compose.ui:ui-*:1.2.0-alpha01 đã được phát hành. Phiên bản 1.2.0-alpha01 bao gồm các thay đổi sau.

Thay đổi về API

Ngừng sử dụng FontFamily.canLoadSynchronously. Thuộc tính này không có ý nghĩa ngữ nghĩa. (Ica5ef)
Thêm trường nhận dạng vào CompositionData để tạo mã nhận dạng bất biến (invariant id) trong Layout Inspector. (Ic116e)
Thêm mã thiết bị Wear OS vào danh sách Thiết bị xem trước (I93232)

Thông tin cập nhật về phần phụ thuộc

Hiện phụ thuộc vào Kotlin 1.6.10.

Phiên bản 1.1

Phiên bản 1.1.1

Ngày 23 tháng 2 năm 2022

androidx.compose.ui:ui-*:1.1.1 đã được phát hành. Phiên bản 1.1.1 bao gồm các thay đổi sau.

Sửa lỗi

Sửa NullPointerException tại androidx.compose.ui.platform.RenderNodeLayer.updateDisplayList (aosp/1947059, b/206677462)
Khắc phục sự cố do nội dung trong bảng nhớ tạm gây ra khi đọc từ bảng nhớ tạm trên Android. (I06020, b/197769306)
Sửa RTL ở LazyVerticalGrid (aosp/1931080, b/207510535)

Phiên bản 1.1.0

Ngày 9 tháng 2 năm 2022

Phát hành androidx.compose.ui:ui-*: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ợ ổn định cho Hiệu ứng cuộn quá mức (Overscroll effect) của Android 12
Những cải tiến đối với kích thước đích nhấn
- Lưu ý rằng đối với phiên bản Compose 1.0, các thành phần Material sẽ mở rộng không gian bố cục để đáp ứng các nguyên tắc hỗ trợ tiếp cận của Material cho kích thước đích chạm. Ví dụ: đích chạm Button (Nút) sẽ mở rộng tới kích thước tối thiểu 48 x 48 dp, ngay cả khi bạn đặt kích thước nhỏ hơn cho Nút. Nhờ vậy, Compose Material được điều chỉnh phù hợp với hành vi tương ứng của các Thành phần Material Design, tạo ra hành vi nhất quán khi kết hợp Khung hiển thị và Compose. Sự thay đổi này cũng đảm bảo rằng khi bạn tạo giao diện người dùng bằng các thành phần Compose Material, các yêu cầu tối thiểu về hỗ trợ tiếp cận đích chạm sẽ được đáp ứng.
Hỗ trợ ổn định cho Dải điều hướng
Đưa một số API thử nghiệm trước đây vào phiên bản chính thức
Hỗ trợ các phiên bản Kotlin mới hơn

Phiên bản 1.1.0-rc03

Ngày 26 tháng 1 năm 2022

androidx.compose.ui:ui-*:1.1.0-rc03 đã được phát hành. Phiên bản 1.1.0-rc03 bao gồm các thay đổi sau.

Sửa lỗi

Cập nhật để hỗ trợ Compose Material 1.1.0-rc03

Phiên bản 1.1.0-rc01

Ngày 15 tháng 12 năm 2021

androidx.compose.ui:ui-*:1.1.0-rc01 đã được phát hành. Phiên bản 1.1.0-rc01 bao gồm các thay đổi sau.

Sửa lỗi

Sửa lỗi gây ra sự cố thiếu thao tác cuộn hỗ trợ tiếp cận (I7cbfb)
SemanticsNodeInteraction.captureToImage() hiện cũng sẽ hoạt động nếu HardwareRenderer.isDrawingEnabled() là false, bằng cách bật giá trị này trong suốt thời gian diễn ra lệnh gọi (Idf3d0 )

Phiên bản 1.1.0-beta04

Ngày 1 tháng 12 năm 2021

androidx.compose.ui:ui-*:1.1.0-beta04 đã được phát hành. Phiên bản 1.1.0-beta04 bao gồm các thay đổi sau.

Tính năng mới

Cập nhật để tương thích với Kotlin 1.6.0

Thay đổi về API

Đã xoá sạch giá trị rỗng trong androidx.core.view (I7078a, b/204917439)
Thêm API thử nghiệm cho phép người dùng sử dụng toàn bộ PointerInputchange hoặc kiểm tra xem nó có được sử dụng hay không. (I2e59d)
Thêm hỗ trợ cho các sự kiện con lăn chuột trong lớp giao diện người dùng. (Ia14eb, b/198214718)
Thêm phương thức nạp chồng Modifier.composed thử nghiệm chấp nhận các khoá để so sánh tính cân bằng và đủ điều kiện để bỏ qua quá trình tối ưu hoá. (Ice799, b/205851704)
ComposeNotIdleException hiện mở rộng từ Exception thay vì trực tiếp từ Throwable. Lưu ý rằng điều này có nghĩa là các mệnh đề phát hiện đang phát hiện Exception hiện có thể phát hiện được ComposeNotIdleException. Đây là điều mà trước đây chúng không làm được. (I9c217)

Sửa lỗi

Khắc phục lỗi ô điều khiển văn bản không di chuyển khi chế độ hiển thị IME thay đổi. (I25f2e)

Phiên bản 1.1.0-beta03

Ngày 17 tháng 11 năm 2021

androidx.compose.ui:ui-*:1.1.0-beta03 đã được phát hành. Phiên bản 1.1.0-beta03 bao gồm các thay đổi sau.

Thay đổi về API

Thêm đối tượng sửa đổi mới Modifier.onPlaced cho phép theo dõi việc thay đổi vị trí. Do đó, có thể sửa đổi thêm mức chênh lệch của đối tượng sửa đổi con dựa trên sự thay đổi về vị trí có thể quan sát được. (I558fd)
Đã xoá InjectionScope.flush() và InjectionScope.dispose(). Mọi sự kiện và phạm vi đang bị xoá và loại bỏ ở cuối phương thức có tên là perform*Input() như trước đây. (I2bed8)
Đã xoá MultiModalInjectionScope.Touch và MultiModalInjectionScope.Mouse. Để chèn sự kiện chạm và sự kiện chuột cho các cử chỉ đa phương thức, bạn hiện có thể sử dụng MultiModalInjectionScope.touch() và MultiModalInjectionScope.mouse(), cả hai đều chấp nhận lambda có phạm vi trình thu nhận của phương thức đó. (Idde18)

Sửa lỗi

Giá trị mặc định cho durationMillis trong TouchInjectionScope.swipeWithVelocity hiện được tính toán để cho phép vuốt. (I19deb)

Phiên bản 1.1.0-beta02

Ngày 3 tháng 11 năm 2021

androidx.compose.ui:ui-*:1.1.0-beta02 đã được phát hành. Phiên bản 1.1.0-beta02 bao gồm các thay đổi sau.

Thay đổi về API

Thêm API BringIntoView thử nghiệm cho phép bạn gửi yêu cầu đến thành phần mẹ để các thành phần này cuộn cho một mục xuất hiện trong khung hiển thị (Ib918d, b/195353459)
Các API ảnh động mới để hỗ trợ công cụ. Cụ thể, các API này cho phép công cụ kiểm tra hiệu ứng chuyển động và cấu hình của chúng trong một Transitions. (I4116e)

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

Thêm Modifier.pointerHoverIcon (I95f01)

Phiên bản 1.1.0-beta01

Ngày 27 tháng 10 năm 2021

androidx.compose.ui:ui-*:1.1.0-beta01 đã được phát hành. Phiên bản 1.1.0-beta01 bao gồm các thay đổi sau.

Thay đổi về API

Thêm API BringIntoView thử nghiệm cho phép bạn gửi yêu cầu đến thành phần mẹ để chúng cuộn đưa một mục vào khung hiển thị (Ib918d, b/195353459)
Các API ảnh động mới để hỗ trợ công cụ. Cụ thể, các API này cho phép công cụ kiểm tra hiệu ứng chuyển động và cấu hình của chúng trong một Transitions. (I4116e)

Phiên bản 1.1.0-alpha06

Ngày 13 tháng 10 năm 2021

androidx.compose.ui:ui-*:1.1.0-alpha06 đã được phát hành. Phiên bản 1.1.0-alpha06 bao gồm các thay đổi sau.

Thay đổi về API

Xoá ExperimentalComposeUiApi khỏi ViewRootForInspector và LayoutInfo.ownerViewId (I5c2e3)
Thêm phương thức nạp chồng không có thành phần con cho Layout (Bố cục) với hiệu quả được cải thiện (Ib0d9a)
Xoá InternalCompilerApi khỏi các phương thức Compose bắt buộc phải được gọi mô-đun chéo (I1aa0b)
SemanticsNodeInteraction.performSemanticsAction hiện trả về SemanticsNodeInteraction mà hàm được gọi. (I9e5db)
Thêm LocalInputModeManager CompositionLocal để phát hiện TouchMode/NonTouchMode. (I6a83c, b/175899786)
Thêm viewConfiguration: ViewConfiguration vào LayoutInfo để người dùng có thể nhận được giá trị chính xác cho những thông tin như thời gian chờ nhấn và giữ. (I76ca6)
- Thêm viewConfiguration: ViewConfiguration vào InjectionScope để cho phép hoạt động kiểm thử nhằm điều chỉnh nội dung chèn đầu vào theo thời gian chờ nhấn và giữ hoặc giới hạn khoảng cách cảm ứng.
- Thay đổi thời lượng mặc định của thao tác nhấn và giữ cũng như nhấn đúp cho cả phương thức nhập bằng cảm ứng và bằng chuột theo các giá trị trong InjectionScope.viewConfiguration.
Việc triển khai ExposedDropdownMenu dựa trên ExposedDropdownMenuBox với TextField và DropdownMenu bên trong (If60b2)
Thêm dismissOnOutsideClick vào PopupProperties, thay thế dismissOnClickOutside không được dùng nữa. Thuộc tính mới nhận được vị trí nhấp chuột và giới hạn liên kết, cho phép bạn kiểm soát tốt hơn việc có nên gọi onDismissRequest hay không. Ví dụ: thuộc tính này có thể hữu ích trong việc tránh loại bỏ thẻ ký tự liên kết (anchor) mỗi khi chạm vào thẻ.
- Thêm updateAndroidWindowManagerFlags vào PopupProperties, cung cấp khả năng kiểm soát ở mức thấp đối với các cờ do cửa sổ bật lên chuyển đến trình Android WindowManager. Tham số của biểu thức lambda sẽ là những cờ được tính toán từ giá trị PopupProperties dẫn đến cờ WindowManager: ví dụ như có thể làm tâm điểm (focusable). Kết quả của biểu thức lambda sẽ là những lá cờ cuối cùng được chuyển đến trình Android WindowManager. Theo mặc định, updateAndroidWindowManagerFlags sẽ không thay đổi những lá cờ đã được tính toán từ các thông số. Bạn nên sử dụng API này thận trọng, chỉ trong trường hợp cửa sổ bật lên có các yêu cầu về hành vi rất cụ thể. (I6e9f9)
Ngừng sử dụng Recomposer.state và thay bằng Recomposer.currentState để đổi loại mã thành StateFlow (Ic2ab3, b/197773820)
Thêm flush() và dispose() vào InjectionScope. Hãy sử dụng các thứ nguyên đó khi bạn muốn xoá mọi sự kiện trong danh sách chờ ngay lập tức và khi muốn loại bỏ phạm vi. (Ifb73a)
Thêm performScrollToNode(matcher: SemanticsMatcher) có thể cuộn một vùng chứa cuộn được vào nội dung phù hợp với trình so khớp nhất định. (Ic1cb8)
InjectionScope hiện triển khai Density, cho phép bạn dễ dàng chuyển đổi giữa px và dp trong performTouchInput và bạn bè. (I8fe1f)

Sửa lỗi

AndroidView hiện đã phát hành chế độ xem LocalLifecycleOwner và LocalSavedStateRegistryOwner qua ViewTreeLifecycleOwner và ViewTreeSavedStateRegistryOwner. (I38f96, b/179708470)
Sửa lỗi WearOS SwipeToDismissBox đôi khi không xử lý các thao tác vuốt. (I9387e)
Thời gian mặc định giữa các sự kiện đầu vào được chèn đã thay đổi từ 10 mili giây thành 16 mili giây. Việc này có thể làm thay đổi kết quả kiểm thử thực hiện các thao tác nhập, chẳng hạn như một thao tác vuốt cụ thể. (I829fd)

Phiên bản 1.1.0-alpha05

Ngày 29 tháng 9 năm 2021

androidx.compose.ui:ui-*:1.1.0-alpha05 đã được phát hành. Phiên bản 1.1.0-alpha05 bao gồm các thay đổi sau.

Thay đổi về API

Thêm tuỳ chọn hỗ trợ cho hình thức giao tiếp liên đối tượng sửa đổi (inter-modifier) (Id5467, b/198826874)
Thêm con trỏ nhật ký thử nghiệm vào PointerEventChange. (Ic1fd8, b/197553056, b/199921305)
Thêm density: Density và layoutDirection: LayoutDirection vào LayoutInfo. Việc này cho phép người dùng ở LayoutInfo diễn giải đúng cách kích thước và vị trí xuất hiện trong LayoutInfo. (I002f1)
Đã thêm tuỳ chọn hỗ trợ thử nghiệm để chèn các sự kiện chuột. Sử dụng performMouseInput để bắt đầu gửi các sự kiện chuột hoặc gửi sự kiện chuột thông qua thuộc tính Mouse của MultiModalInjectionScope trong thao tác nhập nhiều phương thức với performMultiModalInput. Hãy xem MouseInjectionScope để biết tài liệu về API sẵn có (Iaa4a8, b/190493367)

Sửa lỗi

Khắc phục khả năng hỗ trợ tiếp cận cho nội dung cuộn được (cả tải từng phần và tải toàn bộ) với tính năng cuộn (I6cdb0)
Có cải thiện TouchInjectionScope.swipeWithVelocity Cửa sổ này hiện chấp nhận nhiều biến đầu vào và sẽ đề xuất các thay đổi đối với đầu vào nếu không thể tạo lần vuốt (I40fbe, b/182477143)

Phiên bản 1.1.0-alpha04

Ngày 15 tháng 9 năm 2021

androidx.compose.ui:ui-*:1.1.0-alpha04 đã được phát hành. Phiên bản 1.1.0-alpha04 bao gồm các thay đổi sau.

Thay đổi về API

PointerEvent hiện đã có PointerEventType để hỗ trợ các sự kiện di chuột. (I091fa)
Cho phép phần tử con chấp nhận phương thức nhập của con trỏ bên ngoài giới hạn nhập ban đầu. Phần tử mẹ có thể chặn các lệnh gọi đó bằng một thuộc tính PointerInputScope.alwaysInterceptChildEvents (I9eae3, b/192479655)
Ngừng sử dụng performGesture và GestureScope, thay thế bằng performTouchInput và TouchInjectionScope. (Ia5f3f, b/190493367)
Thêm touchBoundsInRoot vào SemanticsNode có kích thước đích chạm tối thiểu để nhà phát triển có thể đảm bảo rằng đích chạm đáp ứng các tiêu chí tối thiểu về khả năng hỗ trợ tiếp cận. (I2e14b, b/197751214)
Làm lại thao tác triển khai có thể kiểm tra (I927bc, b/191017532)
Đã thay đổi tên thông số của thành phần có thể kiểm tra để khớp với thành phần (I3a482, b/191017532)
Ra mắt performTouchInput và TouchInjectionScope làm thuộc tính thay thế cho performTouchInput và TouchInjectionScope, tạo điều kiện bắt đầu các phương thức khác (như chuột).

TouchInjectionScope có các phương thức tương tự như GestureScope, ngoại trừ movePointerTo và movePointerBy (đã được đổi tên thành updatePointerTo và updatePointerBy). Tất cả các phương thức khác đều giống nhau.

Hành vi của TouchInjectionScope giống hệ với GestureScope với hai chi tiết nhỏ:
1. Khi gửi một sự kiện xuống khi con trỏ đã được di chuyển mà không gửi sự kiện di chuyển (nói cách khác là đã sử dụng updatePointerTo() thay vì move() và sau đó down() được gọi), việc triển khai trước sẽ chuyển đổi thời gian diễn ra sự kiện và gửi sự kiện di chuyển trước khi gửi sự kiện xuống. Thao tác triển khai mới vẫn gửi sự kiện di chuyển, nhưng không đẩy thời gian chuyển đổi vào kịch bản cụ thể này.
2. Khi gửi một sự kiện lên trong khi con trỏ đã được di chuyển mà không gửi sự kiện di chuyển (tương tự như trên), việc triển khai trước đó sẽ chuyển tiếp thời gian diễn ra sự kiện và gửi sự kiện di chuyển trước khi gửi sự kiện lên. Cách triển khai mới không thực hiện cả hai: các vị trí mới của các con trỏ sẽ chỉ được phản ánh thông qua sự kiện lên.
Cuối cùng, TouchInjectionScope giới thiệu một currentPosition(pointerId: Int) phương thức mới để lấy vị trí hiện tại của con trỏ đã cho. (If1191, b/190493367)

Sửa lỗi

Cho phép cắt đoạn video nhằm mở rộng giới hạn của đích chạm bên ngoài khu vực của đoạn video để có mục đích chạm tối thiểu. (I43e10, b/171509422)
Hỗ trợ hiệu ứng kéo giãn khi cuộn quá mức trên các thiết bị Android 12. (Iccf3c, b/171682480)

Phiên bản 1.1.0-alpha03

Ngày 1 tháng 9 năm 2021

androidx.compose.ui:ui-*:1.1.0-alpha03 đã được phát hành. Phiên bản 1.1.0-alpha03 bao gồm các thay đổi sau.

Tính năng mới

Cập nhật 1.1.0-alpha03 của Compose để phụ thuộc vào Kotlin 1.5.30. (I74545)

Thay đổi về API

Thêm Modifier.inspectable để gói các đối tượng sửa đổi khác. (I1909b, b/191017532)
Thêm API BlurredEdgeTreatment nhằm tinh giản các trường hợp sử dụng làm mờ thành các tổ hợp gắn cờ cắt bớt và TileModes thường dùng. Hầu hết các trường hợp sử dụng đều liên quan đến việc cho phép nội dung được làm mờ hiển thị bên ngoài giới hạn nội dung gốc và làm mờ các vùng nằm ngoài giới hạn này bằng màu đen trong suốt hoặc cắt nội dung theo giới hạn nội dung, lấy mẫu cạnh gần nhất để làm mờ hạt nhân vượt quá giới hạn nội dung. (I6b4b7, b/166927547)
Thêm tuỳ chọn hỗ trợ RenderEffect trong ứng dụng Compose dành cho máy tính. Ra mắt OffsetEffect cũng như đối tượng sửa đổi làm mờ như một cách đơn giản để giới thiệu các hiệu ứng làm mờ trực quan cho một phần của hệ phân cấp cấu trúc. (I0f6aa, b/166927547)
Ra mắt API RenderEffect có thể được định cấu hình tuỳ chọn trên Modifier.graphicsLayer để thay đổi nội dung của chính lớp đó. Tính năng này có thể dùng để làm mờ nội dung của thành phần kết hợp và thành phần kết hợp con trong hệ phân cấp cấu trúc. (I47c4d, b/166927547)
AwaitPointerEventScope hiện có với withTimeout() và withTimeoutOrNull() (I507f0, b/179239764, b/182397793)
Thêm kích thước đích chạm tối thiểu vào ViewConfiguration để sử dụng trong ngữ nghĩa và phương thức nhập con trỏ, giúp đảm bảo khả năng hỗ trợ tiếp cận. (Ie861c)
Thêm hỗ trợ TileMode.Decal hữu ích cho việc xác định hành vi của cạnh viền cho hiệu ứng làm mờ dựa trên RenderEffects. (I7e8ed, b/166927547)
performScrollToIndex, performScrollToKey, hasScrollToIndexAction và hasScrollToKeyAction hiện là API ổn định (I142ae, b/178483889)
Thêm phương thức kiểm thử để lấy giới hạn được cắt đoạn. (I6b28e)

Sửa lỗi

Xoá phương thức isBounded khỏi phần BlurredEdgeTreatment theo hướng kiểm tra rõ ràng liệu tham số hình dạng có bị rỗng hay không. (I85d68)

Phiên bản 1.1.0-alpha02

Ngày 18 tháng 8 năm 2021

androidx.compose.ui:ui-*:1.1.0-alpha02 đã được phát hành. Phiên bản 1.1.0-alpha02 bao gồm các thay đổi sau.

Thay đổi về API

PointerEvent hiện có hỗ trợ đọc trạng thái nút chuột và trạng thái công cụ sửa đổi bàn phím. (I6310c, b/180075467)
Các cử chỉ được chèn hiện sử dụng thời gian của MainTestClock làm nguồn thông tin đáng tin cậy cho thời gian. Thời gian hiện tại cho các sự kiện được chèn trong performGesture sẽ được khởi chạy tới thời điểm hiện tại của MainTestClock. (Ifb364, b/192064452)
Thêm hàm khởi tạo DpRect(DpOffset, DpSize) (I2cf16, b/194219828)
Thêm lớp DpSize (I7abb1, b/194219828)

Sửa lỗi

Đã cập nhật trình phân tích cú pháp xml của đồ hoạ vectơ nhằm hỗ trợ ColorStateLists dưới dạng các thuộc tính sắc thái màu gốc trên VectorDrawables. (I86915, b/195668138)

Phiên bản 1.1.0-alpha01

Ngày 4 tháng 8 năm 2021

androidx.compose.ui:ui-*:1.1.0-alpha01 đã được phát hành. Phiên bản 1.1.0-alpha01 bao gồm các thay đổi sau.

Thay đổi về API

RelocationRequester.bringIntoView hiện chấp nhận hình chữ nhật dưới dạng tham số, điều này cho phép chúng ta đưa một phần của thành phần kết hợp sang khung hiển thị (Ice2c5, b/194330245)
AnimatedImageVector và các API liên quan hiện nằm trong mô-đun androidx.compose.animation:animation-graphics mới. (I60873)
Thêm đối tượng sửa đổi thử nghiệm để xử lý yêu cầu chuyển vị trí. (I65a97, b/178211874)
Đã giới thiệu API BrushPainter để hỗ trợ tính năng vẽ của một Bút vẽ tuỳ ý trong Painter, tương tự như ColorPainter

Đã cập nhật API Bút vẽ để có thông số kích thước nội tại được truy vấn trong BrushPainter (Ia2752, b/189466433)
Đã cập nhật phương thức DrawScope#drawImage để sử dụng các nguồn và nguồn đích đến để sử dụng thông số FilterQuality không bắt buộc. Cách này hữu ích cho các hình ảnh pixel dùng để tạo pixel khi phóng to cho các hình ảnh dựa trên pixel. Cập nhật thành phần kết hợp BitmapPainter + Hình ảnh để sử dụng tham số FilterQuality tuỳ chọn (Ie4fb0, b/180311607)
Thêm phương thức GestureScope.advanceEventTime để có thêm quyền kiểm soát thời gian của các sự kiện trong một cử chỉ (Ibf3e2)

Sửa lỗi

Để hỗ trợ tốt hơn cho việc sắp xếp chuỗi các công cụ sửa đổi bản vẽ, hãy đảm bảo rằng phương thức triển khai Modifier.paint gọi drawsContent. Trước đó, Modifier.paint đã được dự kiến sử dụng cho một nút lá trong chuỗi của Đối tượng sửa đổi. Tuy nhiên, nếu làm như vậy, nút này sẽ không được định cấu hình trên một vùng chứa có thể kết hợp (ví dụ: hộp) hoặc thêm các yếu tố trang trí bổ sung ở trên cùng chẳng hạn như Modifier.paint().border(). Bằng cách yêu cầu Modifier.paint gọi drawContent sau khi vẽ nội dung của trình vẽ được cung cấp, chúng ta có tính nhất quán cao hơn về hành vi trong hành vi với mẫu của đối tượng sửa đổi. (Ibb2a7, b/178201337, b/186213275)
Các hộp thoại hiện tuân theo hành vi định kích thước nền tảng. Đặt usePlatformDefaultWidth thành false để ghi đè hành vi này. (Iffaed, b/192682388)
Di chuyển InfiniteAnimationPolicy sang :compose:ui (I5eb09, b/160602714)
Việc cuộn qua các thao tác ngữ nghĩa cho danh sách lazy và các thành phần cuộn thông thường hiện là ảnh động (Id9066, b/190742024)

Phiên bản 1.0

Phiên bản 1.0.5

Ngày 3 tháng 11 năm 2021

androidx.compose.ui:ui-*:1.0.5 đã được phát hành. Phiên bản 1.0.5 bao gồm các thay đổi sau.

Sửa lỗi

Khắc phục sự cố theo dõi các thực thể derivedStateOf. (aosp/1792247)

Phiên bản 1.0.4

Ngày 13 tháng 10 năm 2021

androidx.compose.ui:ui-*:1.0.4 đã được phát hành. Phiên bản 1.0.4 bao gồm các thay đổi sau.

Thông tin cập nhật về phần phụ thuộc

Cập nhật để phụ thuộc vào Kotlin 1.5.31

Phiên bản 1.0.3

Ngày 29 tháng 9 năm 2021

androidx.compose.ui:ui-*:1.0.3 đã được phát hành. Phiên bản 1.0.3 bao gồm các thay đổi sau.

Thông tin cập nhật về phần phụ thuộc

Cập nhật để phụ thuộc vào Kotlin 1.5.30

Phiên bản 1.0.2

Ngày 1 tháng 9 năm 2021

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

Cập nhật để hỗ trợ bản phát hành Compose 1.0.2. Compose 1.0.2 vẫn tương thích với Kotlin 1.5.21.

Phiên bản 1.0.1

Ngày 4 tháng 8 năm 2021

androidx.compose.ui:ui-*:1.0.1 đã được phát hành. Phiên bản 1.0.1 bao gồm các thay đổi sau.

Thông tin cập nhật về phần phụ thuộc

Cập nhật để phụ thuộc vào Kotlin 1.5.21.

Phiên bản 1.0.0

Ngày 28 tháng 7 năm 2021

androidx.compose.ui:ui-*:1.0.0 đã được phát hành. 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

Đây là bản phát hành chính thức đầu tiên của ứng dụng Compose. Vui lòng xem blog về Bản phát hành Compose chính thức để biết thêm thông tin chi tiết!

Lỗi đã biết

Nếu đang sử dụng Android Studio Bumblebee Canary 4 hoặc AGP 7.1.0-alpha04/7.1.0-alpha05, bạn có thể gặp sự cố sau đây:
```
  java.lang.AbstractMethodError: abstract method "void androidx.lifecycle.DefaultLifecycleObserver.onCreate(androidx.lifecycle.LifecycleOwner)"
```
Để khắc phục, hãy tạm thời tăng giá trị minSdkVersion lên 24 trở lên trong tệp build.gradle. Sự cố này sẽ được khắc phục trong phiên bản tiếp theo của Android Studio Bumblebee và AGP 7.1. (b/194289155)

Phiên bản 1.0.0-rc02

Ngày 14 tháng 7 năm 2021

androidx.compose.ui:ui-*:1.0.0-rc02 đã được phát hành. Phiên bản 1.0.0-rc02 bao gồm các thay đổi sau.

Sửa lỗi

Các hộp thoại hiện tuân theo hành vi định kích thước nền tảng. Đặt usePlatformDefaultWidth thành false để ghi đè hành vi này. (Iffaed, b/192682388)

Phiên bản 1.0.0-rc01

Ngày 1 tháng 7 năm 2021

androidx.compose.ui:ui-*:1.0.0-rc01 đã được phát hành. Phiên bản 1.0.0-rc01 bao gồm các thay đổi sau.

Tính năng mới

Tách mô-đun công cụ giao diện người dùng thành ui-tooling và ui-tooling-preview (Iefa28, b/190649014)

Thay đổi về API

Xoá FocusManager#moveFocusIn và FocusManager#moveFocusOut thử nghiệm không dùng nữa (I227d7, b/170154986, b/186567354, b/168510304)
Canvas hiện hỗ trợ tham số contentDescription dành cho tính năng hỗ trợ tiếp cận. (Ib547c)
Đổi tên useDefaultMaxWidth trong PopupProperties thành usePlatformDefaultWidth. (I05710)
Hộp thoại hiện có thể áp dụng với toàn bộ chiều rộng của màn hình. (I83929, b/190810877)
Thêm tuỳ chọn hỗ trợ thử nghiệm cho nội dung trình bày màu HSV và HSL. (Id7cf8, b/180731008)

Thay đổi về hành vi

Compose @Preview hiện cung cấp LocalActivityResultRegistryOwner cho phép bạn xem trước các Thành phần kết hợp sử dụng API như rememberLauncherForActivityResult() phụ thuộc vào chủ sở hữu hiện tại đó. (Ib13d1, b/185693006)
Compose @Preview hiện cung cấp LocalOnBackPressedDispatcherOwner cho phép bạn xem trước các Thành phần kết hợp sử dụng API như BackHandler phụ thuộc vào chủ sở hữu hiện tại đó. (Ia1c05, b/185693006)

Sửa lỗi

Di chuyển InfiniteAnimationPolicy sang androidx.compose.ui:ui (I5eb09, b/160602714)
AnimatedImageVector đã bị xoá tạm thời để thay đổi cấu trúc mô-đun. (I41906, b/160602714)

Phiên bản 1.0.0-beta09

Ngày 16 tháng 6 năm 2021

androidx.compose.ui:ui-*:1.0.0-beta09 đã được phát hành. Phiên bản 1.0.0-beta09 bao gồm các thay đổi sau.

Thay đổi về API

Thay đổi enum Role và LiveRegionMode thành các lớp cùng dòng bằng hàm khởi tạo riêng tư (Id1890)
KeyboardCapitalization được chuyển đổi thành lớp cùng dòng. (Id5a1c)
Thay đổi HapticFeedbackType thành lớp cùng tuyến. (I255ec)
Modifier.pointerInteropFilter là @ExperimentalComposeUiApi. (Iede6c)
TextAlign, FontSynthesis và TextDirection hiện là các lớp cùng dòng. (I212fe)
TextOverflow được thay đổi thành lớp cùng dòng. (I433af)
FontStyle hiện là lớp cùng dòng. (I9e48b)

Sửa lỗi

Các hằng số chính hiện tại là @ExperimentalComposeUiApi. Việc sử dụng mã có thể khai báo các hằng số riêng trước khi ổn định. (Ia5d48)
Bạn hiện có thể chạy các chương trình kiểm thử Compose trên Robolectric. Cho đến nay, đã xác định được các giới hạn sau:
- Không có bitmap gốc, vì vậy ImageBitmap() dẫn đến một NullPointerException.
- Không có bản vẽ nào, vì vậy captureToImage() sẽ đợi vô thời hạn lần truyền bản vẽ tiếp theo (chẳng hạn như bản vẽ bị tắc nghẽn).
- Không có phông chữ nào được tải, vì vậy mọi văn bản sẽ được đo lường không chính xác. Tất cả các ký tự đều có chiều cao cố định khoảng 20px và chiều rộng là 1px.
- ComposeTestRule.waitUntil {} không chạy luồng chính trong khi chờ, khiến mã này có hiệu quả giống với ComposeTestRule.mainClock.advanceTimeUntil {}. Có thêm một số giới hạn sẽ được xác định trong tương lai. (I284fa)

Bổ sung quy tắc hồ sơ

Bản phát hành này bổ sung các quy tắc hồ sơ cho những mô-đun Compose sau (I14ed6):

androidx.compose.animation
androidx.compose.animation-core
androidx.compose.foundation
androidx.compose.foundation-layout
androidx.compose.material
androidx.compose.material-ripple
androidx.compose.runtime
androidx.compose.ui
androidx.compose.ui.geometry
androidx.compose.ui.graphics
androidx.compose.ui.text
androidx.compose.ui.text
androidx.compose.ui.unit
androidx.compose.ui.util

Quy tắc hồ sơ là gì?

Quy tắc hồ sơ cho thư viện được chỉ định trong tệp văn bản baseline-prof.txt nằm trong src/main hoặc thư mục tương đương. Tệp này chỉ định quy tắc trên mỗi dòng, trong đó quy tắc trong trường hợp này là mẫu để khớp với phương thức hoặc lớp trong thư viện. Cú pháp cho các quy tắc này là tập mẹ của định dạng hồ sơ ART mà con người có thể đọc được, được dùng khi sử dụng adb shell profman --dump-classes-and-methods .... Các quy tắc này dùng một trong hai biểu mẫu để nhắm mục tiêu vào phương thức hoặc lớp.

Quy tắc phương thức sẽ có mẫu sau:

<FLAGS><CLASS_DESCRIPTOR>-><METHOD_SIGNATURE>

Và quy tắc lớp sẽ có mẫu sau:
```
<CLASS_DESCRIPTOR>
```
Ở đây, <FLAGS> là một hoặc nhiều ký tự trong số các ký tự H, S và P để cho biết có cần gắn cờ "Hot", "Startup" hoặc "Post Startup" cho phương thức này hay không.
<CLASS_DESCRIPTOR> là phần mô tả cho lớp chứa phương thức được nhắm mục tiêu. Ví dụ: lớp androidx.compose.runtime.SlotTable sẽ có phần mô tả là Landroidx/compose/runtime/SlotTable;.
<METHOD_SIGNATURE> là chữ ký của phương thức và bao gồm tên, loại thông số và loại dữ liệu trả về của phương thức. Ví dụ: phương thức fun isPlaced(): Boolean trên LayoutNode có chữ ký isPlaced()Z.
Những mẫu này có thể có ký tự đại diện (**, * và ?) để có một quy tắc duy nhất bao gồm nhiều lớp hoặc phương thức.

Những quy tắc này có chức năng gì?

Phương thức có cờ H cho biết rằng phương thức này là một phương thức "khởi động nóng" và phải được biên dịch trước.
Phương thức có cờ S cho biết đây là phương thức được gọi khi khởi động và phải được biên dịch trước khi thực thi để tránh chi phí biên dịch và diễn giải phương thức này tại thời điểm khởi động.
Phương thức có cờ P cho biết đây là phương thức được gọi sau khi khởi động.
Một lớp có trong tệp này cho biết rằng lớp này được dùng trong khi khởi động và cần được phân bổ trước trong vùng nhớ khối xếp để tránh chi phí tải lớp.

Cơ chế này hoạt động như thế nào?

Thư viện có thể xác định những quy tắc sẽ được đóng gói trong cấu phần phần mềm AAR. Khi một ứng dụng được tạo bao gồm các cấu phần phần mềm này, các quy tắc này được hợp nhất với nhau và các quy tắc hợp nhất được dùng để tạo ra một hồ sơ ART nhị phân nhỏ gọn dành riêng cho ứng dụng. Sau đó, ART có thể tận dụng hồ sơ này khi ứng dụng được cài đặt trên thiết bị để biên dịch trước một tập hợp con cụ thể của ứng dụng nhằm cải thiện hiệu suất của ứng dụng, đặc biệt là lần chạy đầu tiên. Lưu ý rằng việc này sẽ không ảnh hưởng đến các ứng dụng có thể gỡ lỗi.

Phiên bản 1.0.0-beta08

Ngày 2 tháng 6 năm 2021

androidx.compose.ui:ui-*:1.0.0-beta08 đã được phát hành. Phiên bản 1.0.0-beta08 bao gồm các thay đổi sau.

Thay đổi về API

Thay thế enum NestedScrollSource bằng một lớp cùng dòng. (Ie321b, b/187055290)
FocusManager.clearFocus(forcedClear = true) đã được đổi tên thành FocusManager.clearFocus(force = true) (Ia0c41)
Cách sử dụng enum tái cấu trúc cho lớp cùng dòng để tránh gặp vấn đề với những câu lệnh when đầy đủ khi các giá trị enum mới được thêm. (I2b5eb)
Xoá @ExperimentalComposeUiApi khỏi PopupProperties. (I01fa6)
Đã thay đổi PointerType từ một enum thành một lớp cùng dòng (If5058)
Thuộc tính ngữ nghĩa của ContentDescription và Text (Văn bản) không còn là giá trị đơn lẻ nữa mà là danh sách. Điều này cho phép hợp nhất chúng nguyên vẹn thay vì thực hiện phép nối. Đồng thời cung cấp các API kiểm thử tốt hơn để tận dụng những thay đổi này (Ica6bf, b/184825850)
Ngừng sử dụng Modifier.focusModifier() và thay thế bằng Modifier.focusTarget() (I6c860)
Modifier.onSizeChanged() và Modifier.onGloballyPositioned() không còn là các hàm cùng dòng nữa (I727f6, b/186109675)
Thay thế enum KeyboardType bằng một lớp cùng dòng. (I73045, b/187055290)
Thay thế enum FocusState bằng giao diện FocusState (Iccc1a, b/187055290)
Enum ImeActionđược thay thế bằng một lớp cùng dòng. (I18be5, b/187055290)
PlaceholderVerticalAlign được chuyển đổi thành một lớp cùng dòng. (If6290)
TextUnitType hiện là một lớp cùng dòng. (I4cba9)
Các hàm AnnotatedString.withAnnotation hiện là ExperimentalTextApi thay vì ExperimentalComposeApi. (I0cd0a)
- Hàm khởi tạo TextUnit với TextUnitType hiện là ExperimentalTextApi thay vì ExperimentalComposeApi.

Sửa lỗi

Sửa lỗi xuất hiện trong phiên bản beta07 khiến các mục LazyColumn/Row hiển thị một phần sau khi cuộn (I8c9ac, b/188566058)
Hiện tại, detectDragGesures, detectVerticalGestures và detectHorizontalGestures sẽ tự động thay đổi vị trí, không cần gọi change.consumePositionChange trong lệnh gọi lại onDrag (I42fc4, b/185096350, b/187320697)
Đã sửa LayoutModifiers, công cụ cung cấp các dòng căn chỉnh. Sửa lỗi khiến thành phần mẹ không thể đo lường lại khi các dòng căn chỉnh của thành phần con thay đổi. (I4401f, b/174315652)
Thay đổi Modifier.onGloballyPositioned() để báo cáo các toạ độ của đối tượng sửa đổi này trong chuỗi đối tượng sửa đổi, chứ không phải là toạ độ bố cục sau khi áp dụng tất cả các đối tượng sửa đổi. Tức là thứ tự của các công cụ sửa đổi hiện đang ảnh hưởng đến những toạ độ sẽ được báo cáo. (Ieb67d, b/177926591)

Phiên bản 1.0.0-beta07

Ngày 18 tháng 5 năm 2021

androidx.compose.ui:ui-*:1.0.0-beta07 đã được phát hành. Phiên bản 1.0.0-beta07 bao gồm các thay đổi sau.

Thay đổi về API

Đã thêm giao diện ViewRootForInspector để sử dụng trong công cụ kiểm tra (Ib70df)
SubcomposeLayoutState hiện hỗ trợ đếm tập hợp các vị trí có thể sử dụng lại. Bố cục này sẽ duy trì hoạt động của các vị trí đếm này thay vì loại bỏ các vị trí đó để sử dụng lại vị trí trong lần tiếp theo, khi cần một vị trí mới (Ieb981)
Thay thế enum KeyEventType bằng một lớp cùng dòng. (Id670a, b/187055290)
Thay thế enum FocusDirection bằng một lớp cùng dòng. (Ib6d03, b/187055290, b/184086802)
Ra mắt khả năng chuyển trạng thái SubcomposeLayout lên trên cho phép bạn kết hợp trước nội dung vào một slotId bắt buộc, điều này sẽ khiến phép đo tiếp theo truyền nhanh hơn vì khi chúng ta cố kết hợp phụ với slotId đã cho vào lần tiếp theo thì sẽ không cần cấu trúc nữa. (I42580, b/184940225)
Thêm tính năng cắt ô điều khiển lựa chọn (Iff80d, b/183408447)
Xoá API không sử dụng liên quan đến hỗ trợ LayoutInspector. (I2ac78)

Sửa lỗi

Giờ đây, LazyColumn/Row sẽ giữ trạng thái đang hoạt động (chưa bị loại bỏ) cho tối đa 2 mục hiển thị trước đó, ngay cả khi các mục đã bị cuộn ra ngoài. Điều này cho phép thành phần đó sử dụng lại các cấu trúc phụ đang hoạt động khi chúng ta cần kết hợp một mục mới để cải thiện hiệu suất của tính năng cuộn. (Ie5555)
TextGeomerticTransform và TextDecoration tại AnnotatedString sẽ được áp dụng như đã nêu. (I61900, b/184760917)

Phiên bản 1.0.0-beta06

Ngày 5 tháng 5 năm 2021

androidx.compose.ui:ui-*:1.0.0-beta06 đã được phát hành. Phiên bản 1.0.0-beta06 bao gồm các thay đổi sau.

Thay đổi về API

Giải quyết xung đột bằng Cử chỉ điều hướng (I1145e)
@ComposeCompilerApi không còn @RequiresOptIn (Iab690)
Thêm các API hỗ trợ tiếp cận CollectionInfo và CollectionItemInfo cho phép đánh dấu bộ sưu tập và các mục của bộ sưu tập đó cho các dịch vụ hỗ trợ tiếp cận (Id54ef, b/180479017)
Đã thêm SemanticsActions.ScrollToIndex để cuộn danh sách các mục đã lập chỉ mục cho mục có một chỉ mục nhất định và SemanticsProperties.IndexForKey để lấy chỉ mục của một mục trong danh sách có các mục được khoá. Cả hai hành động đều được lệnh LazyList triển khai.
- Thêm SemanticsNodeInteraction.performScrollToIndex cuộn danh sách vào chỉ mục đã cho và SemanticsNodeInteraction.performScrollToKey cuộn danh sách đến mục có khoá đã cho. (I4fe63, b/178483889, b/161584524)
Thêm ownerViewId vào GraphicLayerInfo (I19f62)
Thêm phương thức nạp chồng Font() để tải phông chữ từ các thành phần, File (Tệp) và FileDescriptor (I5d382)
Thêm error API hỗ trợ tiếp cận cho phép đánh dấu một nút chứa dữ liệu đầu vào không hợp lệ (I12997, b/180584804, b/182142737)
Thêm phương thức nạp chồng Font() để tải phông chữ từ các thành phần, File (Tệp) và FileDescriptor (I43007)
AnnotatedString lưu hỗ trợ vào TextFieldValue.Saver. Thêm addTtsAnnotation và các hàm số hiệu dụng withAnnotation vào AnnotatedString.Builder (I8cbdc, b/178446304)
Thêm hàm khởi tạo TextUnit TextUnit(value: Float, type: TextUnitType) (I7ecce, b/178446304)

Phiên bản 1.0.0-beta05

Ngày 21 tháng 4 năm 2021

androidx.compose.ui:ui-*:1.0.0-beta05 đã được phát hành. Phiên bản 1.0.0-beta05 bao gồm các thay đổi sau.

Thay đổi về API

Thêm FocusManager.moveFocus(In) và FocusManager.moveFocus(Out) thử nghiệm (Ic5534, b/183746743)
Thêm API performTextInputSelection thử nghiệm (I2dcbb, b/178510628)
Ngừng sử dụng giao diện InputEventCallback. Không thể sử dụng giao diện trong bất kỳ API công khai nào; và không sử dụng giao diện này trong mã này. (I34a02, b/184003208)
Ngừng sử dụng hàm TextLayoutResult/createTextLayoutResult. Đây là một hàm công khai không được sử dụng mà đã được thêm vào để thử nghiệm. Hàm không thực hiện bất cứ tính năng nào hữu ích đối với API văn bản của Compose. Ngừng sử dụng và sẽ xoá hàm này sau. (I80413)

Sửa lỗi

Khắc phục các thao tác cuộn hỗ trợ tiếp cận ACTION_SCROLL_FORWARD, ACTION_SCROLL_BACKWARD, accessibilityActionScrollLeft, accessibilityActionScrollUp, accessibilityActionScrollRight và accessibilityActionScrollDown. Thay vì cuộn xuống cuối của thanh cuộn, giờ đây, trang này sẽ hiển thị theo một màn hình ở hướng nhất định. (Ieccb0)
Các tệp AndroidManifest của ui-test-manifest và ui-tooling-data hiện tương thích với Android 12 (I6f9de, b/184718994)

Phiên bản 1.0.0-beta04

Ngày 7 tháng 4 năm 2021

androidx.compose.ui:ui-*:1.0.0-beta04 đã được phát hành. Phiên bản 1.0.0-beta04 bao gồm các thay đổi sau.

Thay đổi về API

Lần lượt đổi tên hideSoftwareKeyboard và showSoftwareKeyboard tại SoftwareKeyboardController thành hide() và show().
- Cung cấp giao diện CompositionLocal đầy đủ cho LocalSoftwareKeyboardController, cho phép cài đặt giao diện (đặc biệt hữu ích trong các hoạt động kiểm thử) (I579a6)
Đã thêm API hỗ trợ tiếp cận LiveRegion. Nếu nút được đánh dấu là khu vực đang hoạt động, các dịch vụ hỗ trợ tiếp cận sẽ tự động thông báo cho người dùng về các thay đổi của nút (Idcf6f, b/172590946)
Giới thiệu TextOverflow.Visible. (Ic8f89)

Sửa lỗi

Khắc phục vấn đề khi các mục của LazyColumn/LazyRow nằm ở các cạnh được đặt không chính xác sau khi hất nhanh (Ie4d13, b/183877420)
AndroidViewBinding hiện đã gỡ bỏ đúng cách các mảnh được tăng cường qua FragmentContainerView khi AndroidViewBinding bị gỡ bỏ khỏi hệ phân cấp trong Compose. (Ib0248, b/179915946)
AndroidViewBinding hiện lồng ghép chính xác các mảnh được tăng cường qua FragmentContainerView khi ComposeView nằm trong Fragment, khắc phục các vấn đề khi lưu và khôi phục trạng thái của các mảnh đó. (I70eb0, b/179915946)
ViewBinding của Compose hiện phụ thuộc vào Fragment 1.3.2 và hiển thị một cách nhất quán các mảnh được tăng cường thông qua FragmentContainerView sau các thay đổi về cấu hình. (I0743d, b/179915946)

Phiên bản 1.0.0-beta03

Ngày 24 tháng 3 năm 2021

androidx.compose.ui:ui-*:1.0.0-beta03 đã được phát hành. Phiên bản 1.0.0-beta03 bao gồm các thay đổi sau.

Thay đổi về API

Đã tạm hoãn kiểm tra các phần phụ thuộc ViewTree của ComposeView (I8dbbf, b/182466548)
Đã thêm thông số startX/endX và startY/endY tuỳ chọn vào các hàm swipeUp/swipeDown/swipeLeft/swipeRight tại GestureScope. (I49e2d, b/182063305)

Phiên bản 1.0.0-beta02

Ngày 10 tháng 3 năm 2021

androidx.compose.ui:ui-*:1.0.0-beta02 đã được phát hành. Phiên bản 1.0.0-beta02 bao gồm các thay đổi sau.

Thay đổi về API

Thêm API CompositionLocal LocalSoftwareKeyboardController mới để thay thế giao diện SoftwareKeyboardController trước đó trên TextField. (I5951e, b/168778053)
Thêm API CompositionLocal LocalSoftwareKeyboardController mới để thay thế giao diện SoftwareKeyboardController trước đó trên TextField. (I84472, b/168778053)
Đã gỡ bỏ SemanticsMatcher sau:
- hasWidth(width, tolerance)
- hasHeight(height, tolerance)
- hasLeftPosition(left, tolerance)
- hasTopPosition(top, tolerance)
- hasRightPosition(right, tolerance)
- hasBottomPosition(bottom, tolerance) (If16bd)
Đã đánh dấu SemanticsMatchers sau là @ExperimentalTestApi:
- hasWidth(width, tolerance)
- hasHeight(height, tolerance)
- hasLeftPosition(left, tolerance)
- hasTopPosition(top, tolerance)
- hasRightPosition(right, tolerance)
- hasBottomPosition(bottom, tolerance) (Ia600c)
Đã thêm SemanticsMatcher sau:
- hasWidth(width, tolerance)
- hasHeight(height, tolerance)
- hasLeftPosition(left, tolerance)
- hasTopPosition(top, tolerance)
- hasRightPosition(right, tolerance)
- hasBottomPosition(bottom, tolerance) (I2f502)

Sửa lỗi

Thực thi các hạn chế về việc sử dụng công khai API thử nghiệm (I6aa29, b/174531520)
androidx.compose.ui:ui không còn phụ thuộc vào AppCompat hay Fragment. Nếu bạn đang sử dụng ComposeView trong ứng dụng và sử dụng Fragment và/hoặc AppCompat, hãy đảm bảo rằng bạn đang sử dụng AppCompat 1.3+ / Fragment 1.3+ – những phiên bản này cần thiết để thiết lập chính xác vòng đời và chủ thể trạng thái đã lưu cần thiết cho ComposeView. (I1d6fa, b/161814404)
Sửa lỗi rememberSaveable { mutableStateOf(0) } bị hỏng khi được sử dụng bên trong một đích đến của navigation-compose. (I1312b, b/180042685, b/180701630)
Thêm API CompositionLocal LocalSoftwareKeyboardController mới để thay thế giao diện SoftwareKeyboardController trước đó trên TextField. (I658b6, b/168778053)
Khắc phục tình trạng hiếm gặp NoSuchElementException tại tearDownRegistry() của ComposeRootRegistry (Iddce1)

Phiên bản 1.0.0-beta01

Ngày 24 tháng 2 năm 2021

androidx.compose.ui:ui-*:1.0.0-beta01 đã được phát hành. Phiên bản 1.0.0-beta01 bao gồm các thay đổi sau.

Đây là bản phát hành đầu tiên của Compose 1.0.0 Beta.

Thay đổi về API

Thêm lệnh gọi lại onStart vào detectDragGestures (I67269, b/179995594)
Các đối tượng sửa đổi kích thước cho hàm nội tại không còn là thử nghiệm. (I15744)
MeasureBlocks đã được đổi tên thành MeasurePolicy, qua đó trở thành một giao diện thú vị. Cập nhật/đơn giản hoá API bố cục để sử dụng MeasurePolicy. (Icab48, b/167662468, b/156751158)
Thay thế InteractionState bằng [Mutable]InteractionSource
- Giao diện chịu trách nhiệm phát / thu thập các sự kiện tương tác.
- Thay vì truyền interactionState = remember { InteractionState() } vào các thành phần như Button và Modifier.clickable(), hãy sử dụng interactionSource = remember { MutableInteractionSource() }.
- Thay vì Interaction.Pressed in interactionState, bạn nên dùng các hàm mở rộng trên InteractionSource, chẳng hạn như InteractionSource.collectIsPressedAsState().
- Đối với các trường hợp sử dụng phức tạp, bạn có thể sử dụng InteractionSource.interactions để quan sát luồng tương tác. Hãy xem tài liệu và ví dụ về InteractionSource để biết thêm thông tin.
- (I85965, b/152525426, b/171913923, b/171710801, b/174852378)
Thêm giao diện AccessibilityMananger và LocalAccessibilityMananger trong CompositionLocals (I53520)
Gỡ bỏ các phương thức LayoutCoordinates không dùng nữa, hãy sử dụng hàm thay vì thuộc tính cho positionInParent và boundsInParent (I580ed, b/169874631, b/175142755)
Typealiases được thay thế bằng các loại cơ bản:
- ColorStop hiện là Pair<Float, Color>
- SpanStyleRange hiện là `AnnotatedString.Range
- ParagraphStyleRange hiện là AnnotatedString.Range<ParagraphStyle>
- StringAnnotation hiện là AnnotatedString.Range<String>
- (I8dd1a)
Tạo TextInputSession mới cho các phiên nhập từ các thành phần văn bản cấp thấp, chẳng hạn như CoreTextField. (I8817f, b/177662148)
Giờ đây, Placeable hiển thị measuredSize, đại diện cho kích thước mà bố cục con thực sự đo lường. Kích thước này có thể không tuân theo giới hạn đo lường. (Ib2729, b/172560206, b/172338608)
Thêm đối tượng sửa đổi selectionGroup cho phép đánh dấu bộ sưu tập Tab hoặc RadioButtons cho các mục đích hỗ trợ tiếp cận (Ie5c29)
Giờ đây, bạn bắt buộc phải sử dụng defaultFactory cho compositionLocalOf và staticCompositionLocalOf thay vì không bắt buộc.

Sự thay đổi này sẽ loại bỏ lỗi tiềm ẩn về loại đối với các loại không thể có giá trị rỗng nếu bạn chưa cung cấp nhà máy mặc định ban đầu. Trước đây điều này sẽ cung cấp một tham chiếu rỗng cho loại không thể rỗng.

Đối với các loại giá trị rỗng, bạn nên cung cấp { null } làm nhà máy (factory) mặc định.

Bạn không nên sử dụng các thành phần cục bộ có loại không thể rỗng, trừ phi có thể cung cấp giá trị mặc định hợp lý. Nếu không có giá trị mặc định hợp lý, hàm lambda defaultFactory sẽ tạo ngoại lệ. Tuy nhiên việc loại bỏ một trường hợp ngoại lệ có nghĩa là người dùng thành phần cục bộ sẽ có phần phụ thuộc ngầm định được cung cấp mà không được hệ thống loại này thực thi. (Ifbd2a)
Đã xoá các phương thức không còn hoạt động khỏi mô-đun giao diện người dùng (I646f6)
Đã đổi tên công cụ sửa đổi kích thước. Modifier.width/height/size được đổi tên thành requiredWidth/requiredHeight/requiredSize Modifier.preferredWidth/preferredHeight/preferredSize được đổi tên thành width/height/size. (I5b414)
Xoá Modifier.tapGestureFilter. Thay vào đó, hãy sử dụng Modifier.pointerInput { detectTapGestures(...) }. (I266ed, b/175294473)
mức tiêu thụ một phần đã bị xoá khỏi hệ thống nhập con trỏ. Đề xuất cách kết hợp mức tiêu thụ một phần là Modifier.nestedScroll. (Ie9c9b)
Orientation (Hướng) đã được chuyển đến gói nền tảng. Chuyển VelocirtTracker từ ui.gesture sang ui.input.pointer. (Iff4a8, b/175294473)
imageResource và vectơResource hiện là các hàm mở rộng lần lượt trên cùng ImageBitmap và ImageVector. Các hàm load{Image,Vector,Font}Resource đã bị xoá. (I89130)
AnimationClockObservable và lớp con đã bị xoá. Xoá AnimatedFloat. (Icde52, b/177457083)
Nhà cung cấp đã được đổi tên thành CompositionLocalProvider
- Hàm khởi tạo Composition (Cấu trúc) không còn chấp nhận một tham số chính và không được dùng nữa.
- Chuyển currentCompositeKeyHash thuộc tính cấp cao nhất của thành phần kết hợp thay vì hàm cấp cao nhất của thành phần kết hợp.
- CompositionData và CompositionGroup được chuyển sang không gian tên androidx.compose.runtime.tooling
- ComposableLambda đã được đặt thành một giao diện thay vì loại cụ thể, và không còn có các thông số loại nữa.
- Đặt ComposableLambdaN thành giao diện thay vì loại cụ thể và không còn có tham số loại.
- Di chuyển hàm snapshotFlow sang không gian tên androidx.compose.runtime
- Phương thức hợp nhất của SnapshotMutationPolicy không còn ở giai đoạn thử nghiệm
- Xoá hàm @TestOnly clearRoots cấp cao nhất. Dữ liệu này không còn cần thiết nữa.
- Xoá hàm keySourceInfoOf và resetSourceInfo. Các dữ liệu này không còn cần thiết nữa.
- Xoá Composer.collectKeySourceInformation. Dữ liệu này không còn cần thiết nữa.
- Xoá phương thức isJoinedKey, joinedKeyLeft và joinedKeyRight. Các dữ liệu này không còn cần thiết nữa.
- Di chuyển nhiều API cấp cao nhất và sắp xếp lại thành các tệp khác nhau. Do ngữ nghĩa lớp tệp của Kotlin, khả năng tương thích nhị phân sẽ bị phá vỡ chứ không phải khả năng tương thích nguồn. Do đó, đây không phải là vấn đề đối với hầu hết người dùng.
- (I99b7d, b/177245490)
Đã xoá ComponentActivity.setContent() khỏi Compose:ui. Thay vào đó hãy sử dụng từ androidx.activity:activity-compose:1.3.0-alpha01. Đã xoá viewModel() và LocalViewModelStoreOwner khỏi Compose:ui. Hãy sử dụng trình duyệt có trong androidx.lifecycle:lifecycle-viewmodel-compose:1.0.0-alpha01 (I6f36b)
Sửa đổi Modifier.scrollable. Bây giờ, tính năng sẽ sử dụng giao diện Scrollable thay vì lớp ScrollableController (I4f5a5, b/174485541, b/175294473)
Đã xoá tuỳ chọn hỗ trợ Customevens của PointerInputModifier (I02707, b/175294473)
SnapshotStateObserver không còn ở giai đoạn Thử nghiệm nữa (Id2e6a)
Xoá một số API không dùng nữa (Ice5da, b/178633932)
Xoá longPressGestureFilter và doubleClickGestureFilter. Hãy sử dụng Modifier.pointerInput với các chức năng trợ giúp, như detectTapGestures (I2fedf, b/175294473)
Xoá việc sử dụng API String.format được tái cấu trúc trong nhiều phương thức toString để tránh tận dụng String.format nội bộ. (Id1290)
Xoá câu nhận định dp (I798d2)
Đã xoá androidx.Comose.runtime:runtime-dispatch (I55feb)
Bây giờ, thao tác văn bản sẽ tự động kiểm tra tiêu điểm (I13777, b/179648629)
Xoá runBlockingWithManualClock (I15cdc, b/179664814)
Vị trí cuộn trong Modifier.verticalScroll()/horizontalScroll() hiện tại được biểu thị bằng Ints (I81298)
Hiện tại, FlingConfig đã được đổi tên thành FlingBehavior, cho phép bạn tuỳ chỉnh các ảnh động tạm ngưng thay vì các Giá trị giảm dần được xác định trước. (I02b86, b/175294473)
Thêm chức năng trợ giúp hữu ích để đặt cùng một thao tác cho tất cả các lệnh gọi lại ImeAction (I63447, b/179226323)
Xoá lệnh gọi lại SoftwareKeyboardController khỏi tất cả các trường văn bản để sớm thay thế bằng một API mới. (Iae869, b/168778053)
Fontspan và FontWeigthStyleSpan không còn được sử dụng và đã bị xoá. (Ie5b56, b/177423444)
Thực hiện các thay đổi sau với API Material:
- Thêm tham số contentPadding vào Top/BottomAppBar để cho phép tuỳ chỉnh khoảng đệm mặc định.
- Sắp xếp lại tham số trong BackdropScaffold để tuân thủ các nguyên tắc về API đối với tham số bắt buộc đứng trước tham số không bắt buộc.
- Di chuyển tham số icon trong BottomNavigationItem ra phía sau selected và onClick.
- Đã đổi tên thông số alwaysShowLabels trong NavigationNavigationItem thành alwaysShowLabel.
- Đã đổi tên thông số bodyContent trong một vài thành phần thành chỉ content.
- Sắp xếp lại các thông số trong ButtonDefaults.buttonColors(). Vui lòng lưu ý rằng vì kiểu tham số này không thay đổi, mã của bạn sẽ không gặp lỗi. Hãy đảm bảo bạn đang sử dụng các tham số có tên hoặc cập nhật thứ tự theo cách thủ công, nếu không thì mã của bạn sẽ không hoạt động được như trước.
- Thêm tham số secondaryVariant vào darkColors(). Thường thì màu này giống với màu secondary trong giao diện tối, nhưng thêm màu này để tăng cường tính nhất quán và khả năng tuỳ chỉnh.
- Xoá ElevationDefaults và animateElevation() trên giao diện API công khai vì chúng không được sử dụng phổ biến/hữu ích.
- Đổi tên onValueChangeEnd trong Slider thành onValueChangeFinished và đặt là có giá trị rỗng.
- Đã đổi tên thông số text trong Snackbar thành content để đảm bảo tính nhất quán.
- Thêm tham số contentPadding vào DropdownMenuItem để cho phép tuỳ chỉnh khoảng đệm mặc định và đặt content làm phần mở rộng trên RowScope.
- Đổi tên ModalDrawerLayout thành ModalDrawer.
- Đổi tên BottomDrawerLayout thành BottomDrawer.
- (I1cc66)

Sửa lỗi

Thêm API để sử dụng các tài nguyên AnimatedVectorDrawable trong Compose. Sử dụng animatedVectorResource để tải một <animated-vector> XML dưới dạng AnimatedImageVector và hoạt ảnh với painterFor (I8ea91)
Thêm API CompositionLocal LocalSoftwareKeyboardController để thay thế giao diện SoftwareKeyboardController trong TextField. (I658b6, b/168778053)

Phiên bản 1.0.0-alpha12

Ngày 10 tháng 2 năm 2021

androidx.compose.ui:ui-*:1.0.0-alpha12 đã phát hành. Phiên bản 1.0.0-alpha12 bao gồm các thay đổi sau.

Thay đổi về API

Xoá tính năng hỗ trợ ViewGroups khỏi UiApplier. Xoá các thành phần kết hợp emitView không được dùng nữa. (Ifb214)
Hiện tại, Modifier.pointerInput yêu cầu các phím nhớ để cho biết thời điểm phát hiện coroutine đầu vào con trỏ cho các phần phụ thuộc mới. (I849cd)
CompositionReference được đổi tên thành CompositionContext (I53fcb)
Đổi tên Bounds thành DpRect (I4b32a)
Kiểm tra bản cập nhật: hasText() sẽ kiểm tra cả văn bản nhập và nhãn/nội dung gợi ý/phần giữ chỗ trong trường văn bản (Iab803)
viewModel() tổng hợp và LocalViewModelStoreChủ đã được chuyển sang androidx.lifecycle.viewmodel.camose. Bây giờ, bạn cần thêm một phần phụ thuộc riêng biệt androidx.lifecycle:lifecycle-viewmodel-compose:1.0.0-alpha01 để sử dụng phần phụ thuộc này. (I7a374)
Cho phép hành động có thể rỗng trong AccessibilityAction, thay đổi nhãn hành động trong AccessibilityAction và CustomAccessibilityAction từ CharSequence thành String (I0dc82)
Để các quy ước đặt tên khớp hơn với ImageBitmap và ImageVector, ImagePainter được đổi tên thành BitmapPainter cho phù hợp với VectorPainter. (Iba381, b/174565889)
Chuỗi kiểm tra chuỗi con có chuỗi con bây giờ là một đối số (Icbe78)
Thêm một Modifier.focusOrder() chấp nhận FocusRequester mà không cần chỉ định thứ tự tiêu điểm tuỳ chỉnh lambda. Điều này hữu ích khi chúng tôi chỉ cần chỉ định tệp đối chiếu mà không cần phải là thứ tự tiêu điểm tuỳ chỉnh cho thành phần kết hợp (I4f52a, b/179180978)
Chuyển ComponentActivity.setContent sang androidx.activity.compose.setContent trong mô-đun androidx.activity:activity-compose. (Icf416)
Xoá phương thức giải cấu trúc và copy() khỏi một số lớp mà chúng ít khi được sử dụng. (I26702, b/178659281)
Chuyển Cửa sổ bật lên sang chế độ dành riêng cho một nền tảng. AndroidPopupProperties đã được đổi tên thành PopupProperties, và isFocusable đã được chuyển sang thông số focusable trong PopupProperties (Ieeea5)
Đã chuyển hộp thoại sang chế độ dành riêng cho nền tảng. Đã đổi tên AndroidDialogProperty thành DialogProperty. (I4ef69, b/179138130)
Đặt LayoutNode thành lớp nội bộ (I8a7b1, b/175103944)
Thay thế Constraints.enforce bằng Constraints.constrain. (I8b8ea)
Ngừng sử dụng loadFontResource. Thay vào đó, hãy sử dụng fontResource. Ngừng sử dụng imageResource, loadImageResource, vectorResource và loadVectorResource. Thay vào đó hãy sử dụng painterResource. (I6b809)
Vì lý do hiệu suất, giờ đây, ngữ nghĩa ScrollAxisRange lấy các hàm lambda trả về Độ chính xác đơn thay vì các giá trị Độ chính xác đơn trực tiếp. (If4a35, b/178657186)
Thêm ngữ nghĩa EditableText để đánh dấu văn bản nhập vào có thể chỉnh sửa của trường văn bản, hỗ trợ cho khả năng tiếp cận và các phương pháp kiểm thử tương ứng để kiểm tra ngữ nghĩa (I8e07a)
Làm OwnerLayer/OwnerScope/OwnerSnapshotObserver nội bộ (I4ffaf, b/175103944)
toIntPx() đã đổi tên thành roundToPx(). (I9b7e4, b/173502290)
IntBounds đổi tên thành IntRect và API đã được cải thiện. (I1f6ff)
Cập nhật Snapshot API (API Ảnh chụp nhanh) để phù hợp hơn với nguyên tắc API cũng như ẩn các lớp triển khai nội bộ từ API công khai. (Id9e32)
Đã bổ sung các hành động về ngữ nghĩa mở rộng và thu gọn. Đã bổ sung expand và halfExpand trong ModalDownSheetState (Ib5064)
Ngừng sử dụng Modifier.dragGestureFilter. Thay vào đó, hãy sử dụng Modifier.pointerInput { detectDragGestures (...)}. Ngoài ra, hãy sử dụng Modifier.draggable cho các thao tác kéo một trục (I0ba93, b/175294473)
Đổi tên Ambients để khớp với Ambient -> Đổi tên CompositionLocal. Ambients trước đây có tên là AmbientFoo, CompositionLocals hiện có tên là LocalFoo. (I2d55d)
BaseTextField không còn được dùng nữa hiện đã bị xoá. Sử dụng BasicTextField thay thế. (I71368)
Lựa chọn đã được di chuyển sang nền tảng. (I7892b)
Tương tự như cách trước đây chúng tôi đã xoá thành phần kết hợp state { 0 } và hiện khuyến khích sử dụng remember { mutableStateOf(0) }, chúng tôi sẽ xoá thành phần kết hợp savedInstanceState { 0 }. Thay vào đó, bạn nên sử dụng rememberSaveable { mutableStateOf(0) }. Thao tác này sẽ tự động lưu và khôi phục nếu bạn có thể lưu trữ loại được dùng trong MutableState trong Gói. Nếu trước đó bạn đã truyền đi một đối tượng trình lưu tuỳ chỉnh, thì bây giờ bạn cần sử dụng một nạp chồng mới của rememberSaveable có tham số stateSaver. Cách sử dụng sẽ có dạng như sau: val holder = rememberSaveable(stateSaver = HolderSaver) { mutableStateOf(Holder(0)) } (Ib4c26, b/177338004)
Thêm ngữ nghĩa của mật khẩu cho tính năng hỗ trợ tiếp cận (I231ce)
Thêm ProgressBarRangeInfo.Indeterminate để đánh dấu các thanh tiến trình không xác định cho tính năng hỗ trợ tiếp cận (I6fe05)
Ngừng sử dụng các phần mềm tiện ích emptyContent() và (@Composable () -> Unit).orEmpty() do không còn có bất kỳ giá trị hoặc tác động tích cực nào về hiệu suất (I0484d)
snapshotFlow và withMutableSnapshot không còn ở trạng thái thử nghiệm (I6a45f)
Bạn hiện có thể đóng các bộ cấu phần lại. Trình kết hợp lại đã đóng sẽ tiếp tục tái cấu trúc cho đến khi hoàn tất quá trình tái cấu trúc coroutine con. Recomposer.shutDown được đổi tên để huỷ chế độ tương phản với chế độ đóng. (Ib6d76)
Đổi tên UiSavedStateRegistry thành SaveableStateRegistry, đổi tên AmbientUiSavedStateRegistry thành AmbientSaveableStateRegistry và cả hai đều chuyển sang gói androidx.comose.runtime.saveable. (I30224)
Đổi tên Cấu phần phần mềm androidx:Comose:runtime:runtime-saved-instance-state thành androidx:compose:runtime:runtime-saveable (I6dcac)
Xoá nhiều API không còn dùng từ lâu trong gói giao diện người dùng. (I2f2dc)
Hiện ngừng sử dụng cấu phần phần mềm compose:runtime-dispatch. Giờ đây, bạn có thể tìm thấy compose:runtime và AndroidUiDispatcher trong compose:ui. (Ib5c36)
Các loại Outline.* không còn là lớp dữ liệu nữa (I4879e, b/178001427)
Đã xoá view.captureToImage() mà không thay thế. (I7fcd2)
Ra mắt ColorMatrix API dùng để sửa đổi các giá trị rgb của nguồn nội dung API ColorFilter đã tái cấu trúc làm một giao diện và khớp với cách triển khai PathEffect. (Ica1e8)
Thêm tham số layoutDirection vào createOutline của Hình dạng. Hành vi này cho phép tạo các hình dạng nhận biết hướng bố cục. (I57c20, b/152756983)
Ngừng sử dụng onImeActionPerformed. Thay vào đó, hãy sử dụng KeyboardActions (If0bbd, b/179071523)
Ra mắt thành phần ngữ cảnh coroutine InfiniteAnimationPolicy sẽ được áp dụng trong ảnh động vô hạn. Theo mặc định, không có chính sách nào được cài đặt, trừ phi chạy thử nghiệm với ComposeTestRule. (I50ec4, b/151940543)
Xoá canDrag khỏi Modifier.scrollable. (Id66e7, b/175294473)
Đã đổi tên LayoutCoordinates.parentCoordinates thành LayoutCoordinates.parentLayoutCoordinate để cho phép cho một thuộc tính parentCoordinates mới. Thuộc tính parentCoordinates hiện cung cấp đối tượng sửa đổi mẹ của LayoutCoordintes. Điều này sẽ tạo ra các trường hợp sử dụng hoàn chỉnh hơn cho onSizeChanged() và onGloballyPositioned() (Idfbfd, b/177926591)
Ngừng sử dụng tapGestureFilter, doubleTapGestureFilter, longPressGestureFilter và pressIndicaitonGestureFilter. Thay vào đó, hãy sử dụng Modifier.clickable hoặc Modifier.pointerInput với hàm detectTapGestures. (I6baf9, b/175294473)
Đã xoá unregisterProvider của SaveableStateRegistry. Thay vào đó, registerProvider() hiện trả về đối tượng SaveableStateRegistry.Entry mà bạn có thể sử dụng để huỷ đăng ký (Ic4274, b/178583739)
rememberSavedInstanceState() đổi tên thành rememberSaveable() và chuyển sang gói androidx.compose.runtime.saveable. (I1366e, b/177338004)
Đã xoá CoreText và CoreTextField khỏi API công khai
- Xoá phương thức nạp chồng SelectionContainer không dùng nữa
- (I99c19)
Các thử nghiệm mà ứng dụng Compose dùng để sử dụng trong các hệ phân cấp được thêm/xoá trực tiếp vào nhóm WindowManager hiện đã ổn định hơn. (Ie81ed, b/175765614)
Xoá Recomposer.current(). [Abstract]ComposeView hiện được đặt mặc định là các Trình kết hợp lại tạo từng phần ở phạm vi cửa sổ do ViewTreeLifecycleOwner cho cửa sổ tạo ra. Tạm dùng quy trình kết hợp lại và kim đánh dấu nhịp độ khung hình ảnh động dựa trên withFrameNanos trong khi Vòng đời máy chủ ngừng hoạt động. (I38e11)
Recomposer.runningRecomposers hiện cung cấp StateFlow toàn cục của RecomposerInfo chỉ đọc để quan sát trạng thái cấu trúc đang diễn ra trong quá trình này. Ưu tiên API này hơn Recomposer.current() hiện không dùng nữa. (If8ebe)
Saver, listSaver(), mapSaver(), autoSaver đã được chuyển từ androidx.compose.runtime.savedinstancestate thành androidx.compose.runtime.saveable (I77fe6)
EditCommands chấp nhận AnnotatedString. Tuy nhiên, đây là API chỉ thay đổi và tính năng chỉnh sửa văn bản nhiều kiểu chưa được triển khai. (I4c3ea)
Đã xoá Thời gian hoạt động và Thời lượng. (Ib9bf4, b/177420019)
CompositionData.asTree() và các API liên quan đã chuyển sang mô-đun dữ liệu ui-tooling-data riêng biệt và được đánh dấu là thử nghiệm (Ic95b8)
Đổi tên các tham số trên RounderCornerShape, CutCornerShape và CornerBasedShape từ trái/phải thành bắt đầu/kết thúc để hỗ trợ tính năng tự động phản chiếu hình dạng theo hướng rtl. AbsoluteRounderCornerShape và AbsoluteRounderCornerShape được giới thiệu cho các trường hợp không mong muốn tạo phản chiếu. (I61040, b/152756983)
API mà trình biên dịch Compose nhắm mục tiêu đã được tái cấu trúc để sử dụng một giao diện thay vì một loại cụ thể. Giao diện này cũng không còn sử dụng tham số loại.

Đây là một thay đổi nội bộ sẽ không ảnh hưởng đến khả năng tương thích cho mã nguồn mà là một thay đổi có thể gây lỗi nhị phân. (I3b922, b/169406779)
Xoá hàm StringBuilder.deleteAt không công khai (Id6ed9)

Sửa lỗi

ComposeViews được đặt trong hệ phân cấp khung hiển thị là con của một cấu trúc khác hiện lưu trữ các cấu trúc con của đối tượng cấp trên (I92883)
Cập nhật API imageFromResource của Compose để sử dụng lại bộ nhớ đệm có thể kéo tài nguyên khi tải các đối tượng ImageBitmap. (If3627, b/178751994)

Phiên bản 1.0.0-alpha11

Ngày 28 tháng 1 năm 2021

androidx.compose.ui:ui-*:1.0.0-alpha11 đã phát hành. Phiên bản 1.0.0-alpha11 bao gồm các thay đổi sau.

Thay đổi về API

WithConstraints đã được thiết kế lại dưới dạng BoxWithConstraints và được chuyển sang foundation.layout. (I9420b, b/173387208)
Ngừng sử dụng Key.DPadUp. Hãy sử dụng Key.DirectionUp thay thế. (Iab335, b/177954892)
Giao diện chủ sở hữu hiện sẽ hiển thị trong nội bộ. (If8e35)
Thêm API FocusManager.moveFocus() để di chuyển tâm điểm theo phương thức lập trình. (I045cb, b/177681839)
Thay đổi PopupPositionProvider để sử dụng các toạ độ tương đối với cửa sổ, chứ không phải các toạ độ chung. Đổi tên gparentGlobalBounds thành anchorBounds và thay đổi windowGlobalBounds thành windowSize: IntSize (I2994a)
Thời lượng và Thời gian hoạt động sẽ được thay thế bằng thời gian dài mili giây và bước này sẽ xoá phần phụ thuộc của phương thức nhập con trỏ vào các loại đó. (Ia33b2, b/175142755, b/177420019)
Thêm AmbientSavedStateRegistryOwner, tương tự như AmbientLifecycleOwner và AmbientViewModelStoreOwner hiện có (I9a3e8, b/176756365)
Cập nhật API đồ hoạ vectơ để hỗ trợ phân tích cú pháp việc phủ màu được áp dụng cho thư mục gốc của đồ hoạ vectơ. (Id9d53, b/177210509)
Thêm toolType vào PointerInputChange để phân biệt các thiết bị (Iac787, b/175142755)
AmbientwindowManager được đổi tên thành AmbientWindowInfo (I2686a, b/177084714, b/177084983)
Ngừng sử dụng phương thức toạ độ chung và tạo phương thức toạ độ dựa trên cửa sổ mới. (Iee284)
Bổ sung Modifier.toolingGraphicsLayer để thêm đối tượng sửa đổi lớp đồ hoạ khi bật chế độ kiểm tra. (I315df)
FocusRequester.createRefs hiện được đánh dấu là thử nghiệm vì có thể thay đổi. (I2d898, b/177000821)
SemanticsPropertyReceiver.hidden được đổi tên thành invisibleToUser và được đánh dấu là @ExperimentalComposeUiApi. Đổi tên AccessibilityRangeInfo thành ProgressBarRangeInfo. Đổi tên stateDescriptionRange thành progressBarRangeInfo. Đổi tên AccessibilityScrollState thành ScrollAxisRange. Đổi tên horizontalAccessibilityScrollState thành horizontalScrollAxisRange. Đổi tên verticalAccessibilityScrollState thành verticalScrollAxisRange. (Id3148)
Xoá PointerInputData và sửa đổi PointerInputChange để cung cấp cho tất cả các trường của PointerInputData. Nội bộ hoá PointerInputEvent và PointerInputEventData vì chúng không được sử dụng trong bất kỳ API công khai nào. (Ifff97, b/175142755)
GraphicsLayerScope cập nhật triển khai mật độ để hỗ trợ các lượt chuyển đổi dp thành pixel thô. (Ied528, b/176819695)
Cập nhật API ma trận để tuân theo thứ tự hàng chính và cung cấp các hằng số chỉ mục để hỗ trợ chuyển đổi giữa các lần biểu diễn ma trận khác nhau cho phù hợp với logic chuyển đổi khung giữa SkMatrix và Matrix4 trong nội bộ. (I432e6)
Xoá các phương thức monotonicFrameAnimationClockOf thử nghiệm (Ib753f, b/170708374)
Di chuyển String.fintPrecedingBreak và String.fingFollowBreak tới InternalTextApi. (I657c4)
androidx.comose.ui.util.isSurrogatePair đã được xoá khỏi API công khai. (Ia9494)
Đã đổi tên TransformedText.transformedText thành TransformedText.text
- TransformedText không còn là lớp dữ liệu (Ie672a)
Đã xoá data class khỏi các loại sau:
- InlineTextContent
- LocaleList (I605c7)
Các loại sau đây không còn là loại dữ liệu:
- AnnotatedString
- ParagraphStyle
- SpanStyle
- TextStyle
- FontWeight
- TextDecoration
- TextGeometricTransform
- TextIndex
- TextLayoutResult
- TextLayoutInput (Iaff99)
Đã thay đổi VisualTransformation thành giao diện chức năng (I3bba4)
Đã thêm loại tham số tham chiếu hàm (I5e1bd)
Thêm các giới hạn đã chuyển đổi vào InspectorNode (Ice42f)

Sửa lỗi

Ngừng sử dụng onCommit, onDispose và onActive, thay vào đó là các API SideEffect và DisposableEffect (If760e)
Thay đổi đối với các hàm trả về một đối tượng cho Font/FontFamily/Typeface
- Thêm các hàm trạng thái ban đầu bắt đầu bằng chữ cái viết hoa
- Ngừng sử dụng các hàm nhà máy có chữ cái đầu tiên viết thường
- Các hàm nhà máy mới sẽ trả về FontFamily thay vì các lớp con
- Ẩn các hàm khởi tạo của lớp con để những lớp này chỉ có thể được tạo dựng qua các hàm nhà máy.
- Đã đổi tên Font.asFontFamily thành Font.toFontFamily (I42aa7)
Ra mắt ComposeContentTestRule, phần mở rộng ComposeTestRule và định nghĩa setContent, đã bị xoá khỏi ComposeTestRule. Thêm phương thức nhà máy createEmptyComposeRule(). Phương thức này trả về ComposeTestRule và không chạy Hoạt động (Activity) cho bạn. Sử dụng tuỳ chọn này khi bạn muốn chạy Hoạt động (Activity) trong quá trình kiểm thử, ví dụ: sử dụng ActivityScenario.launch (I9d782, b/174472899)
animateAsState giờ là animateFooAsState, nơi mà Foo trở thành loại biến được tạo hiệu ứng động, ví dụ như Float, Dp, Offset, v.v. (Ie7e25)
Thêm tham số mô tả nội dung vào Hình ảnh và Biểu tượng. Tham số này được dùng để cung cấp thông tin mô tả cho các dịch vụ hỗ trợ tiếp cận (I2ac4c)
Xoá displaySize vì cần phải tránh dùng tính năng này. Thông thường, bạn nên sử dụng kích thước onRoot() hoặc ít nhất là kích thước cửa sổ. (I62db4)
OnSizeChanged đã báo cáo kích thước nội dung của bố cục. Giờ báo cáo sẽ hiển thị kích thước ở vị trí tương ứng trong chuỗi đối tượng sửa đổi. (I36b78, b/177562900)
API emit() và tất cả các phương thức nạp chồng đều đã ngừng hoạt động và được đổi tên thành ComposeNode. Các API giống hệt nhau, chỉ khác một tên để tuân theo quy ước đặt tên của Compose (I4137b)
TextFieldValue chấp nhận AnnotatedString. Tuy nhiên, đây chỉ là thay đổi đối với API và tính năng chỉnh sửa văn bản nhiều kiểu chưa được triển khai.
- Xoá initial khỏi tham số hàm khởi tạo EditingBuffer. (I326d5)
Ngừng sử dụng invalidate và compositionReference(), thay vào đó lần lượt là currentRecomposeScope và rememberCompositionReference. (I583a8)
AnnotatedString được thay đổi để mở rộng từ kotlin.CharSequence. Do đó, length (độ dài) và subSequence giờ là các hàm thực thể và các hàm mở rộng bị xoá. (Iaf429)
Ngừng sử dụng CompositionLifecycleObserver và thay thế bằng RememberObserver.

RememberObserver thay thế cho CompositionLifecycleObserver với ngữ nghĩa được sửa đổi và phương thức được đổi tên. Việc thay đổi sang API mới có thể được thực hiện bằng máy móc đối với các đối tượng chỉ được nhớ một lần và tiếp tục là phương pháp được đề xuất. Tuy nhiên, nếu một tệp đối chiếu được nhớ nhiều lần trong một cấu trúc, thì onRemembered sẽ được gọi cho mỗi tệp đối chiếu mà onEnter chỉ được gọi một lần. onEnter được gọi nhiều lần nếu đối tượng được sử dụng trong các cấu trúc phụ, chẳng hạn như WithConstraints và Scaffold, giúp đảm bảo rằng một lệnh gọi onEnter không đáng tin cậy và đã bị xoá cho RememberObserver.

RememberObserver thêm onAbandoned được gọi nếu thực thể RememberObserver được trả về từ lệnh gọi lại truyền đến remember nhưng không được nhớ ở trạng thái cấu trúc và do đó, sẽ không bao giờ onRemembered được gọi. Điều này có thể xảy ra nếu một trường hợp ngoại lệ chấm dứt quá trình cấu trúc trước khi hoàn tất hoặc cấu trúc bị huỷ vì trạng thái đang tạo quá trình cấu trúc không còn hiệu lực hoặc không còn cần thiết nữa. Nếu thực thể của RememberObserver (tuân theo một mục đề xuất tham chiếu ở trên) đang theo dõi một tài nguyên bên ngoài (cả onForgotten và onAbandoned), thì mỗi loại sẽ cho thấy tài nguyên không còn cần thiết nữa. Nếu đối tượng đang theo dõi công việc đã bắt đầu hoặc tài nguyên được phân bổ trong onRemembered, onAbandoned có thể bị bỏ qua vì đối tượng này sẽ không được gọi nếu onRemembered được gọi. (I02c36)
Không dùng các phép tính số học từ 2 TextUnits trở lên. TextUnit.Sp và TextUnit.Em không dùng nữa, có chức năng ưu tiên cho các chức năng của tiện ích như Int.sp và Int.em. (I48369)
Theo mặc định, các tài nguyên trong thư viện chưa được khai báo rõ ràng (ví dụ: qua public.xml) sẽ ở chế độ riêng tư. (Ia1dcc, b/170882230)
Ngừng sử dụng ScrollableColumn/Row. Việc sử dụng ScrollableColumn ít hiệu quả hơn so với LazyColumn khi bạn có nội dung cuộn lớn vì với LazyColumn, chúng ta chỉ có thể soạn/đo lường/vẽ các phần tử hiển thị. Để tránh việc người dùng sử dụng không hiệu quả, chúng tôi quyết định sẽ ngừng sử dụng ScrollableColumn và ScrollableRow, đồng thời khuyến khích sử dụng LazyColumn và LazyRow thay thế. Người dùng vẫn có thể quyết định rằng họ không cần hoạt động tải rảnh tay và sử dụng các đối tượng sửa đổi trực tiếp như sau: Column(Modifier.verticalScroll(rememberScrollState())) (Ib976b, b/170468083)
Phương thức khôi phục mặc định mới của items(count: Int) cho phạm vi của LazyColumn/LazyRow/LazyVerticalGrid. items(items: List) và itemsIndexed(items: List) hiện là các hàm mở rộng nên bạn phải nhập thủ công các hàm đó khi sử dụng. Các nội dung nạp chồng phần mở rộng mới cho Mảng: items(items: Array) và itemsIndexed(Array) (I803fc, b/175562574)
Vui lòng sử dụng ImeAction.None thay vì ImeAction.NoAction
- Vui lòng sử dụng ImeAction.Default thay vì ImeAction.Unspecified (Ie1bcc)
Tận dụng TestCoroutineDispatcher trong quá trình kiểm thử (I532b6)
Đổi tên TextInputService.onStateUpdated thành updateState (Id4853)
Ngừng sử dụng tính năng chuyển đổi dựa trên TransitionDefinition (I0ac57)
TextUnitType.Inherit đã bị xoá. Thay vào đó, hãy sử dụng TextUnitType.Unspecified. (I9ff64)

Phiên bản 1.0.0-alpha10

Ngày 13 tháng 1 năm 2021

androidx.compose.ui:ui-*:1.0.0-alpha10 đã phát hành. Phiên bản 1.0.0-alpha10 bao gồm các thay đổi sau.

Thay đổi có thể gây lỗi

Việc sắp xếp lại cấu trúc của API trình biên dịch nội bộ cho phép thay đổi hàng loạt các nút được tạo do kết quả của cấu trúc vào giai đoạn "áp dụng các thay đổi" của cấu trúc, sau khi tất cả các hàm @Composable đã hoàn tất.

Đây là thay đổi có thể gây lỗi hành vi có khả năng ảnh hưởng đến mã ứng dụng vì các nút không còn hoạt động qua API nội bộ và thử nghiệm cho đến khi thay đổi được áp dụng. Bạn thường có thể xử lý vấn đề này bằng cách đặt mã xung quanh các phần phụ thuộc như vậy trong một thành phần kết hợp SideEffect để trì hoãn việc thực thi mã cho đến khi các nút đã được tạo và khởi chạy. (I018da)

Thay đổi về API

Thêm Modifier.focusOrder() có thể dùng để chỉ định thứ tự truyền tải tiêu điểm tuỳ chỉnh (I90cf5, b/175899543, b/170155556, b/170155429)
Xoá focusObserver không còn được dùng nữa và thay thế bằng onFocusChanged hoặc onFocusEvent. (I3ecb9, b/175156387)
Các thay đổi về API EditOperations
- Đổi tên EditOperation là EditCommand
- Thêm hậu tố Command cho các hoạt động triển khai chi tiết EditOperation
- EditCommand không còn là lớp dữ liệu
- Đổi tên hàm EditOperation.process thành applyTo
- Đổi tên InputEventListener thành InputEventCallback
- (I0a366)
Đã xoá PxSquared, PxCubed, PxInverse không sử dụng. Thay đổi Size.center() thành thuộc tính. (I973f7)
Giờ đây, mô-đun ui-test có thể định cấu hình việc tạo Trình kết hợp lại cho Giao diện người dùng đang trong quá trình kiểm thử (Ibebd8)
Tốc độ đã sửa đổi để có các phần và thành phần toán học. (Ib0447)
Đổi tên @ExperimentalTesting thành @ExperimentalTestApi để phù hợp với các chú giải API thử nghiệm tương tự (Ia4502, b/171464963)
Đã đổi tên Color.useOrElse() thành Color.takeOrElse() (Ifdcf5)
Đã xoá các loại DpInverse, DpSquared và DpCubed không dùng đến. (I4d62b)
Constraints#satisfiedBy đã được đổi tên thành isSatisfiedBy. (I9cf5c)
Thêm lệnh gọi lại để thông báo cho Chủ sở hữu khi giới hạn layoutnode thay đổi. (I72fd1)
Thêm isSpecified, isUnspecified và useOrElse cho các lớp cùng dòng có một hằng số Không xác định. (I93f7b, b/174310811)
Mở rộng [Abstract]ComposeView API để cho phép tái chế khung hiển thị dựa trên Compose, loại bỏ cấu trúc để tạo lại sau. Thêm API để cài đặt và khám phá Trình kết hợp lại trong phạm vi cửa sổ và CompositionReferences để tạo cấu trúc con.

Thêm ViewCompositionStrategy để định cấu hình chiến lược loại bỏ cấu trúc của [Abstract]ComposeViews; hành vi mặc định được loại bỏ trên cửa sổ có thể tách biệt. (I860ab)
Xoá api công khai Any.identityHashCode() (I025d7)
Xoá API toStringAsFixed và sử dụng String.format thay thế trực tiếp. (Iaba6b)
Thêm nút Bật/tắt đối với nền tảng Strings.kt (I4a5b7, b/172366489)
Chuyển nativeClass thành mô-đun giao diện và nội bộ hoá nội dung đó. Thay vào đó, cập nhật việc sử dụng nativeClass trong các nội dung triển khai ngang bằng để sử dụng 'is MyClass'. (I4f734)
Ngừng sử dụng Modifier.focus() và Modifier.focusRequester(). Thay vào đó là Modifier.focusModifier() và Modifier.focusReference(). (I75a48, b/175160751, b/175160532, b/175077829)
Giới thiệu SelectionRegistrar.notifySelectableChange để thông báo các bản cập nhật Có thể chọn (Selectable) cho SelectionManager. (I6ff30, b/173215242)
Ra mắt thuộc tính Outline.bounds để lấy phần giới hạn cho các cách triển khai đường viền khác nhau. (I16e74, b/175093504)
Ngừng sử dụng TestUiDispatcher. Sử dụng Dispatchers.Main thay thế (Ic171f, b/175385255)
ImeOptions và KeyboardOptions không còn là loại dữ liệu (I3c898, b/168684531)
Các thay đổi về API ImageTransformation
- Đổi tên OffsetMap thành OffsetMapping
- Đổi tên OffsetMapping.identityOffsetMap thành OffsetMapping.Identity
- ChangeTransformation không còn là loại dữ liệu nữa
- Di chuyển OffsetMapping đến tệp riêng của lệnh
- (I0bdf3)
Đổi tên Position thành DpOffset và xoá getDistance() (Ib2dfd)
Đã thay đổi fun Dp.isFinite() thành val Dp.isFinite (I50e00)

Sửa lỗi

Trình kết hợp lại sẽ cho thấy Flow (Luồng) của trạng thái hiện tại, cho phép theo dõi hoạt động và hoạt động của Flow và của các hiệu ứng liên quan. (Ifb2b9)
Giờ đây, bạn có thể truy cập vào keyEvent gốc thông qua keyEvent.nativeKeyEvent (I87c57, b/173086397)
animate() hiện được thay thế bằng animateAsState() trả về State<T> thay vì T. Việc này tạo ra hiệu suất cao hơn do phạm vi vô hiệu hoá có thể được thu hẹp đến vị trí mà giá trị Trạng thái được đọc. (Ib179e)
Thêm API có vai trò Ngữ nghĩa và thêm Vai trò dưới dạng tham số cho SemanticsModifier có thể nhấp, chọn và bật/tắt. Thay đổi Modifier.progressSemantics sao cho Thanh trượt cũng có thể sử dụng được. (I216cd)
Animatable API dựa trên coroutine mới đảm bảo tính loại trừ lẫn nhau giữa các ảnh động.
- Decay AnimationSpec mới để hỗ trợ ảnh động giảm nhiều chiều
- (I820f2, b/168014930)

Phiên bản 1.0.0-alpha09

Ngày 16 tháng 12 năm 2020

androidx.compose.ui:ui-*:1.0.0-alpha09 đã phát hành. Phiên bản 1.0.0-alpha09 bao gồm các thay đổi sau.

Thay đổi về API

KeyEvent.Alt không còn được dùng nữa hiện đã bị xoá. Sử dụng KeyEvent.isAlt Pressed thay thế. (Idd695)
Ngừng sử dụng Modifier.keyInputFilter và Modifier.previewKeyInputFilter. Thay vào đó là Modifier.onKeyEvent và Modifier.onPreviewKeyEvent (Idbf1b, b/175156384)
Ngừng sử dụng Modifier.focusObserver. Chuyển sang sử dụng Modifier.onFocusChanged hoặc Modifier.onFocusEvent (I30f17, b/168511863, b/168511484)
Để tạm ngưng các API nhập con trỏ, đổi tên HandlePointerInputScope thành AwaitPointerEventScope và handlePointerInput() thành awaitPointerEventScope(). (Idf0a1, b/175142755)
API tự động điền hiện là API thử nghiệm và yêu cầu chọn tham gia (I0a1ec)
Thêm các bản khai báo về việc giải mã để tạo thực thể FocuSRequester (I35d84, b/174817008)
accessibilityLabel đã đổi tên thành contentDescription. accessibilityValue đã đổi tên thành stateDescription. (I250f2)
Đã xoá các sự kiện tuỳ chỉnh khỏi việc tạm ngưng API nhập con trỏ (Ia54d5, b/175142755)
Ra mắt một số hàm mới trong SelectionRegistrar và cũng đổi tên onPositionChange thành notifyPositionChange. (Ifbaf7)
Nhiều thành viên khác của LayoutsNode mà chúng tôi đã đánh dấu là nội bộ (I443c6)
Bố cục thông tin được giới thiệu để sử dụng trong công cụ và thử nghiệm (I9b190)
Đặt AndroidOwner thành nội bộ (Ibcad0, b/170296980)
Xoá chú thích ExperimentalPointerInput (Ia7a24)
Đã thêm hệ thống cuộn lồng. Tham khảo Modifier.nestedScroll để biết thêm chi tiết (I36e15, b/162408885)
Đặt subcomposeInto(LayoutNode) thành nội bộ (Id724a)
Thay đổi giao diện Applier để đơn giản hoá quy trình xây dựng cây từ dưới lên thay vì từ trên xuống.

Phương thức insert() được đổi tên thành insertTopDown().

Thêm phương thức mới: insertBottomUp().

Một trình áp dụng sẽ chèn các nút vào cây mà trình áp dụng này đang chỉnh sửa bằng cách sử dụng insertTopDown() hoặc insertBottomUp(), tuỳ thuộc vào việc chế độ nào hoạt động hiệu quả hơn.

Một số cây, chẳng hạn như LayoutNode và View, có hiệu quả hơn khi tạo từ dưới lên so với từ trên xuống. Trước đó, hệ thống phải có một tập hợp các nút chèn để triển khai từ dưới lên nên cần sao chép sang tất cả các trình áp dụng cần xây dựng từ dưới lên để đạt được hiệu suất. Với thay đổi này, Applier ghi đè insertBottomUp() để tạo cây từ dưới lên và insertTopDown() để tạo cây từ trên xuống. (Icbdc2)
Thêm các thuộc tính dismissOnBackPress và dismissOnClickOutside vào AndroidDialogProperties. Các tuỳ chọn này cho phép định cấu hình khi lambda onDismissRequest của hộp thoại sẽ được gọi. (If5e17)
Thêm API painterResource để xử lý các đối tượng Painter (Trình vẽ) được tải mờ ảo từ các định dạng thành phần tạo từ đường quét (như PNG) hoặc VectorDrawables. Người dùng không còn phải xác định trước loại thành phần và có thể gọi phương thức này để nhận đối tượng Painter (Trình vẽ) để sử dụng trong các thành phần kết hợp Image (Hình ảnh) hoặc đối tượng sửa đổi trình vẽ. (I2c703, b/173818471)
Thêm Modifier.clearAndSetSemantics để xoá ngữ nghĩa của các thành phần con và đặt các ngữ nghĩa mới. (I277ca)
Di chuyển ContentDrawScope sang mô-đun ui-graphics để kết hợp với DrawScope. (Iee043, b/173832789)
Giới thiệu API đồ hoạ PathEffect để cung cấp các mẫu khác nhau cho hình dạng vừa vẽ. Ngừng sử dụng NativePathEffect và thay bằng việc hỗ trợ quá trình triển khai dự kiến/thực tế của PathEffect. (I5e976, b/171072166)
Thêm giao diện IdlingResource vào Compose, dưới dạng một biến thể hỗ trợ Compose của tài nguyên đang hoạt động của Espresso. Bạn có thể đăng ký và huỷ đăng ký thông qua ComposeTestRule (I433f3)
Xoá gói (huỷ) đăng ký chung của ComposeIdlingResource và (huỷ) đăng ký đồng hồ vào ComposeIdlingResource (I32660)

Sửa lỗi

Biểu thức lambda trong công cụ sửa đổi độ chênh lệch hiện trả về kết quả IntOffset thay vì Float. (Ic9ee5, b/174137212, b/174146755)
Xoá SlotTable, SlotReader và SlotWriter khỏi API công khai. Trước đây, các hàm này được đánh dấu là InternalComposeAPI. Giờ đây, chúng thuộc nội bộ của mô-đun Compose.

CompositionData và CompositionGroup được thêm vào để thay thế cho API ui-tooling dùng để trích xuất thông tin về cấu trúc. Các hàm này là công khai nhưng không nhằm sử dụng bên ngoài API công cụ giao diện người dùng vì chúng cung cấp thông tin chưa xử lý mà API công cụ giao diện người dùng diễn giải (I31a9c)
Tái cấu trúc ShaderBrush để tạo một thực thể chương trình đổ bóng theo yêu cầu khi có sẵn thông tin về kích thước môi trường vẽ. Thao tác này rất hữu ích để xác định các hàm gradient (chuyển màu) chiếm toàn bộ giới hạn vẽ của một thành phần kết hợp tại thời điểm kết hợp mà không cần thực hiện các tuỳ chọn triển khai DrawModifier tuỳ chỉnh.

Ngừng sử dụng các API hàm khởi tạo hàm gradient (chuyển màu) thay cho phương thức nhà máy trên đối tượng Gradient. (I511fc, b/173066799)
Không dùng LazyColumnFor, LazyRowFor, LazyColumnForIndexed và LazyRowForIndexed nữa. Thay vào đó, sử dụng LazyColumn và LazyRow (I5b48c)
Ngừng sử dụng BuildCompat.isAtLeastR (Idb37e)
Thêm hàm nhà máy buildAnnotatedString để tạo một AnnotatedString. Ngừng sử dụng hàm trình tạo annotatedString. (Idfe0b)
Đã xoá các phương thức mở rộng trên Float và Double để chuyển đổi giá trị sang radian. Di chuyển sang một hàm riêng trong quá trình triển khai PathParser là nơi duy nhất mà tệp được sử dụng (I25f52)

Phiên bản 1.0.0-alpha08

Ngày 2 tháng 12 năm 2020

androidx.compose.ui:ui-*:1.0.0-alpha08 đã phát hành. Phiên bản 1.0.0-alpha08 bao gồm các thay đổi sau.

Thay đổi về API

Thêm thao tác ngữ nghĩa Loại bỏ (Dismiss) (I2b706)
Di chuyển các API DrawModifier từ gói androidx.compose.ui sang gói androidx.compose.ui.draw. Tạo tệp DrawModifierDeprecated.kt để đưa các phương thức typealiases/helper vào nhằm hỗ trợ quá trình di chuyển từ các API không dùng nữa sang các API hiện tại. (Id6044, b/173834241)
Đổi tên Modifier.drawLayer thành Modifier.graphicsLayer Đồng thời cập nhật các lớp liên quan lên GraphicsLayer theo phản hồi của API. (I0bd29, b/173834241)
Thêm các phương thức placeable.placeWithLayer() và placeable.placeRelativeWithLayer() mới, cho phép bố cục tuỳ chỉnh và đối tượng sửa đổi bố cục đặt thành phần con để giới thiệu một lớp đồ hoạ cho bản vẽ. Nhờ đó mà chúng ta có thể tối ưu hoá bản vẽ lại đầu tiên. Vì vậy, khi cần di chuyển một thành phần con, chúng ta không phải vẽ lại nội dung của nó, thứ hai, chúng ta có thể áp dụng các phép biến đổi bản vẽ cho một thành phần con (Ibd8f6 ,b/170296989 ,b/171493718 ,b/173030831)
Xoá <T> khỏi nội dung khai báo SubcomposeLayout. Bạn có thể sử dụng thuộc tính này mà không cần chỉ định loại ngay. (Ib60c8)
Thêm API Modifier.scale/rotate để thuận tiện hơn cho drawLayer.
- Đổi tên Modifier.drawOpacity thành Modifier.alpha.
- Đã đổi tên Modifier.drawShadow thành Modifier.shadow (I264ca, b/173208140)
Điều chỉnh để thời gian hoạt động của PointerInputData và các trường vị trí không nhận giá trị rỗng. (Id468a)
MaterialTheme hiện đặt màu chính xác cho các ô điều khiển lựa chọn và nền lựa chọn. Các ứng dụng không dùng Material có thể sử dụng AmbientTextSelectionColors theo cách thủ công để tuỳ chỉnh màu sắc dùng để lựa chọn. (I1e6f4, b/139320372, b/139320907)
Thêm WindowManager.isWindowFocused để kiểm tra xem cửa sổ máy chủ có phải là tiêu điểm hay không và WindowFocusObserver cung cấp một lệnh gọi lại onWindowFocusChanged. (I53b2a, b/170932874)
Cập nhật API TransformOrigin để có cú pháp giải cấu trúc trả về pivotFractionX và pivotFractionY dưới dạng component1 và component2 (If43c4, b/173586560)
Thêm mục kiểm tra tìm lỗi mã nguồn (lint) cho việc đặt tên và vị trí tham số lambda có khả năng kết hợp, để kiểm tra tính nhất quán với nguyên tắc Compose. Ngoài ra, chúng tôi cũng đã di chuyển một số API sử dụng children dưới dạng tên cho lambda theo sau sang content, theo hướng dẫn và mục kiểm tra tìm lỗi mã nguồn. (Iec48e)
Đã thêm API để kiểm tra xem phím Alt, Ctrl, Meta hay phím bổ trợ Shift đã được nhấn khi một sự kiện chính được gửi đi. (I50ed9)
Thêm phương thức nạp chồng Modifier.drawLayer() mới. Phương thức này sẽ chặn một khối lambda trên một GraphicsLayerScope mới mà bạn sẽ xác định các thông số lớp theo cách cho phép bỏ qua việc sắp xếp lại và bố cục lại khi trạng thái thay đổi. DrawLayerModifier đang là nội bộ để chuẩn bị di chuyển logic của nó sang phương thức placeable.placeWithLayer() của LayoutModifier (I15e9f, b/173030831)
Ngừng sử dụng các Ambient được đặt tên với hậu tố là Ambient và thay thế chúng bằng các thuộc tính mới có tiền tố là Ambient, tuân theo các nguyên tắc khác về API Compose và Ambient. (I33440)
Di chuyển androidx.compose.ui.text.Typeface sang androidx.compose.ui.text.font.Typeface (Ic2b81)
Đổi tên đối số ngữ nghĩa mergeAllDescendants thành mergeDescendants. (Ib6250)
Trình phát hiện thao tác kéo mới tạm ngưng API nhập con trỏ, bao gồm cả việc khoá hướng. (Icef25)
Đã đổi tên VectorAsset thành ImageVector Đã chuyển và đổi tên VectorAsset thành Builder để trở thành một lớp nội tại của ImageVector theo mỗi hướng dẫn của hội đồng API. Thêm tên thay thế mới của VectorAssetBuilder để liên kết với ImageVector.Builder nhằm tăng khả năng tương thích. (Icfdc8)
Đổi tên ImageAsset và các phương thức liên quan thành ImageBitmap. (Ia2d99)
Thêm thông số zIndex cho place() của PlacementScope để Modifier.zIndex() hiện hoạt động như một LayoutsModifier và mọi bố cục tuỳ chỉnh có thể đặt zIndex cho con ngay trong khối vị trí (I711f7, b/171493718)
Di chuyển các thuộc tính ngữ nghĩa nền tảng sang giao diện người dùng (I6f05c)
Ngừng sử dụng place(Offset) và placeRelative(Offset). Thay vào đó, sử dụng các giá trị nạp chồng với độ dời số nguyên (I4c5e7)
Xoá các API trước đây đã ngừng hoạt động: Xoá Modifier.onPositioned, sử dụng Modifier.onGloballyPositioned. Xoá, Modifier.onDraw, sử dụng Modifier.onDrawBehind. Modifier.plus đã bị xoá, hãy sử dụng Modifier.then. Color.Unset đã bị xoá, hãy sử dụng Color.Unspecified. Đã xoá loại PxBounds, hãy dùng Rect thay thế. (Ie9d02, b/172562222)
Giao diện Căn chỉnh đã được cập nhật và hoạt động bình thường. (I46a07, b/172311734)
Trình phát hiện cử chỉ cho thao tác nhấn, nhấn đúp, nhấn và giữ và chỉ báo nhấn được thêm bằng cách dùng nội dung nhập con trỏ tạm ngưng mới. Chúng tôi cũng bổ sung một số tiện ích giúp nhà phát triển dễ viết trình phát hiện cử chỉ của riêng họ hơn. (I00807)
Đổi tên id thành layoutId cho LayoutIdParentData. Measurable.id được đổi tên thành Measurable.layoutId. (Iadbcb, b/172449643)
Trình phát hiện cử chỉ chạm đa điểm mới, bao gồm các trình trợ giúp phát hiện thao tác xoay, thu phóng và kéo. (Ic459d)
Ra mắt các API SweepGradientShader và SweepGradientBrush. (Ia22c1)
Tính năng kiểm soát thời gian trong chương trình kiểm thử (TestAnimationClock và cách sử dụng) đang được thử nghiệm (I6ef86, b/171378521)
Thêm các API cuộn dựa trên coroutine:

Thêm LazyListState.snapToItem và LazyListState.smoothScrollBy, cũng như các API cấp thấp hơn để kiểm soát thao tác cuộn. Các API này cung cấp giao diện tạm ngưng để kiểm soát tính năng cuộn. Tính năng này sẽ đợi cho đến khi hoàn thiện thanh cuộn trước khi trả về. (Ie5642)
Modifier.focusable cần có nền bổ trợ. Hãy dùng Modifier.focusable để thêm nội dung có thể đặt tiêu điểm vào một thành phần, kèm theo khả năng hỗ trợ tiếp cận và ngữ nghĩa chính xác. (I41eb9, b/152525426, b/162865824)
Cung cấp các phương thức triển khai mặc định của các phương thức và thuộc tính trong AnimationWatchTestRules có thể được uỷ quyền cho clock (I7ea3d, b/173399709) của phương thức đó
AndroidComposeTestRule hiện có thể chấp nhận trình chạy hoạt động tuỳ chỉnh (Ib8288, b/153623653, b/154135019)
Ngừng sử dụng TextLayoutResult.getLineVisibleEnd. Thay thế TextLayoutResult.getLineEnd hiện đã có một thông số mới visibleEnd. (I73282)
Đã cập nhật API TextFieldValue
- đặt TextFieldValue.composition ở chế độ chỉ đọc
- Xoá ngoại lệ được gửi do phạm vi lựa chọn không hợp lệ (I4a675, b/172239032)
Hỗ trợ TtsAnnotation cho công cụ chuyển văn bản sang lời nói. (I54cc6)
Các API mới để chạy ảnh động trong coroutine (Ied662)

Sửa lỗi

Đổi tên tham số căn chỉnh của Hộp thành contentAlignment. (I2c957)
Các công cụ sửa đổi offsetPx đã được đổi tên thành offset. Công cụ này hiện đang sử dụng các thông số lambda thay vì Trạng thái. (Ic3021, b/173594846)
Thêm tham số resetInput vào TextInputService#onStateUpdated (I3e8f5, b/172239032, b/171860947)
Thêm tuỳ chọn kiểm tra lỗi mã nguồn cho các tham số của Đối tượng sửa đổi trong các Hàm có khả năng kết hợp. Bước kiểm tra mã nguồn này kiểm tra tên, loại dữ liệu trả về, giá trị mặc định và thứ tự của tham số để đảm bảo tính nhất quán với các nguyên tắc của Compose. (If493b)
Tạm thời thêm tuỳ chọn cho phép điều khiển TestAnimationClock bằng MonotonicFrameClock (I1403b, b/173402197)
Thêm trình bao bọc Bộ phông chữ (Typeface) của Android. Bạn có thể tải Bộ phông chữ Android thông qua hàm typeface, ví dụ typeface(Typeface.DEFAULT). Cũng đã đổi tên typefaceFromFontFamily() thành typeface() (I52ab7)
Thêm mục kiểm tra tìm lỗi mã nguồn để đảm bảo rằng các hàm nhà máy của Đối tượng sửa đổi được xác định là phần mở rộng của Đối tượng sửa đổi, nhờ vậy, các hàm này có thể liên kết trơn tru với nhau. (I07981)
Xoá mô-đun cũ, giao diện người dùng kiểm tra giao diện người dùng và các nội dung mô-đun (I3a7cb)
Trình kết hợp lại không còn chấp nhận EmbeddingContext; các phần phụ thuộc lên lịch bắt buộc được lấy từ effectCoroutineContext. Ngừng sử dụng FrameManager; việc tích hợp nền tảng sẽ bắt đầu quá trình xử lý ảnh chụp nhanh toàn cục của riêng chúng. (I02369)
Chuyển thông tin kiểu đến nút hỗ trợ tiếp cận. (If5e8d)
TextUnit.Inherit được đổi tên thành TextUnit.Unspecified nhất quán với các đơn vị khác. (Ifce19)