Jetpack Compose Glimmer

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

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

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

dependencies {
    implementation "androidx.xr.glimmer:glimmer:1.0.0-alpha15"
}

dependencies {
    implementation("androidx.xr.glimmer:glimmer:1.0.0-alpha15")
}

Để 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ề Trình theo dõi sự cố để biết thêm thông tin.

Phiên bản 1.0

Phiên bản 1.0.0-alpha19

Ngày 9 tháng 9 năm 2026

Phát hành androidx.xr.glimmer:glimmer:1.0.0-alpha19 và androidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha19. Phiên bản 1.0.0-alpha19 bao gồm các thay đổi sau.

Thay đổi về API

• Thay đổi tên tham số của color thành baseColor cho cả SurfaceDefaults.color và SurfaceDefaults.focusedColor (Id1a08)
• Thêm tham số pageOffsetFraction vào các hàm animateScrollToPage và scrollToPage trong GlimmerPagerState. (I5ed0d)

Sửa lỗi

• compileSdk cho các thư viện Compose được cập nhật lên phiên bản 37.1. Việc này sẽ yêu cầu bạn cập nhật compileSdk một cách gián tiếp cho tất cả các ứng dụng và thư viện sử dụng Compose. (I05b0f)

Phiên bản 1.0.0-alpha18

Ngày 26 tháng 8 năm 2026

Phát hành androidx.xr.glimmer:glimmer:1.0.0-alpha18 và androidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha18. Phiên bản 1.0.0-alpha18 bao gồm các thay đổi sau.

Thay đổi về API

• Thay đổi loại được chuyển đổi tuần tự ButtonGroupState.Saver từ Int thành *. (I78af5)
• Tạo hàm SurfaceDefaults.color và SurfaceDefaults.focusedColor, cũng như hàm checkedBackgroundColor trong hàm IconToggleButton và ToggleButton, @Composable. (I52eb5, b/481943080)
• Thêm các tham số focusedColor và focusedContentColor vào hàm Modifier.surface() để tuỳ chỉnh màu của bề mặt được lấy tiêu điểm. (Ied24a)
• Xoá chế độ tuỳ chỉnh đường viền khỏi tất cả các thành phần và màu đường viền khỏi GlimmerTheme.colors. (I0d814)

Phiên bản 1.0.0-alpha17

Ngày 12 tháng 8 năm 2026

Phát hành androidx.xr.glimmer:glimmer:1.0.0-alpha17 và androidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha17. Phiên bản 1.0.0-alpha17 bao gồm các thay đổi sau.

Phiên bản 1.0.0-alpha16

Ngày 29 tháng 7 năm 2026

Phát hành androidx.xr.glimmer:glimmer:1.0.0-alpha16 và androidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha16. Phiên bản 1.0.0-alpha16 bao gồm các thay đổi sau.

Thay đổi về API

• Thêm API chỉ báo trang để dùng với GlimmerHorizontalPager. Theo mặc định, thành phần này được đi kèm khi sử dụng Pager, nhưng cũng có thể được dùng riêng miễn là được cung cấp một GlimmerPagerState (I54990, b/481669397)
• Thêm thành phần ButtonGroup (I26324, b/481662773)

Phiên bản 1.0.0-alpha15

Ngày 1 tháng 7 năm 2026

Phát hành androidx.xr.glimmer:glimmer:1.0.0-alpha15 và androidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha15. Phiên bản 1.0.0-alpha15 bao gồm các thay đổi sau.

Phiên bản 1.0.0-alpha14

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

Phát hành androidx.xr.glimmer:glimmer:1.0.0-alpha14 và androidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha14. Phiên bản 1.0.0-alpha14 bao gồm các thay đổi sau.

glimmer và glimmer-google-fonts phiên bản 1.0

Phiên bản 1.0.0-alpha13

Ngày 19 tháng 5 năm 2026

Phát hành androidx.xr.glimmer:glimmer:1.0.0-alpha13 và androidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha13. Phiên bản 1.0.0-alpha13 bao gồm các thay đổi sau.

Thay đổi về API

• Thêm một tham số enabled không bắt buộc vào Modifier.surface. Tham số này sẽ áp dụng một lớp phủ trực quan khi bề mặt bị vô hiệu hoá. (I8b781)
• Giới thiệu reverseLayout trong GlimmerPagerLayoutInfo (I73818, b/481669559)
• Đổi tên animateShape thành animatedShape trong ToggleButtonDefaults và IconToggleButtonDefaults (I15f00)
• Đổi tên các thành phần liên quan đến List để sử dụng tiền tố GlimmerLazyList. (If0737, b/425919254, b/483126735)
• Triển khai ban đầu chỉ báo bằng giọng nói cho Glimmer (I446c7, b/481998624)
• Xoá các phương thức nạp chồng có thể lấy tiêu điểm và có thể nhấp cho đối tượng sửa đổi "surface". Giờ đây, đây là một đối tượng sửa đổi duy nhất chỉ chịu trách nhiệm về hiệu ứng hình ảnh. Thêm "focusable" (có thể lấy tiêu điểm)/"clickable" (có thể nhấp)/các đối tượng sửa đổi khác theo cách thủ công để tạo các thành phần có thể tương tác – hãy xem các mẫu để biết thêm thông tin. (I12dbe)

Phiên bản 1.0.0-alpha12

Ngày 6 tháng 5 năm 2026

Phát hành androidx.xr.glimmer:glimmer:1.0.0-alpha12 và androidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha12. Phiên bản 1.0.0-alpha12 bao gồm các thay đổi sau.

Thay đổi về API

• Giới thiệu API Glimmer Pager (I2d830, b/481670271)
• Thêm các API ToggleButton và IconToggleButton (I2656b, Ib1667, b/481299196, b/481663547)

Phiên bản 1.0.0-alpha11

Ngày 22 tháng 4 năm 2026

Phát hành androidx.xr.glimmer:glimmer:1.0.0-alpha11 và androidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha11. Phiên bản 1.0.0-alpha11 bao gồm các thay đổi sau.

Thay đổi về API

• glimmer-google-fonts được phát hành – hãy thêm phần phụ thuộc này và dùng createGoogleSansFlexTypography để tạo một thực thể Typography bằng cấu hình Google Sans Flex được đề xuất. Bạn có thể cung cấp thực thể Typography này như bình thường thông qua GlimmerTheme. (Iec9e4, b/458447191)

Phiên bản 1.0.0-alpha10

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

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

Thay đổi về API

• Thêm API IconButton. (I0f3dd, b/481298420)
• Tổng quát hoá loại trình lưu StackState thành Saver<StackState, *>. (Ic164f, b/491893461)

Sửa lỗi

• Cập nhật Compose compileSdk lên API 37. Điều này có nghĩa là bạn phải dùng AGP phiên bản tối thiểu là 9.2.0 khi sử dụng Compose. (Id45cd, b/413674743)

Phiên bản 1.0.0-alpha09

Ngày 25 tháng 3 năm 2026

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

Thay đổi về API

• Điều chỉnh các giá trị mặc định cho giá trị chính, giá trị dương, giá trị âm và giá trị bề mặt. Đã thêm một trục màu mới có tên là "background". (I6bb6c, b/481671956)
• Đã thêm một hệ thống con ComponentSpacingValues trong GlimmerTheme cung cấp các giá trị để sử dụng trên các thành phần cho khoảng đệm và các phần tử khoảng cách khác. Các hằng số khoảng cách và khoảng đệm PascalCase hiện có trong các đối tượng Mặc định của thành phần (ví dụ: ContentPadding, ItemSpacing) đã được đổi tên thành camelCase và chuyển đổi thành các thuộc tính Composable. (I96e30, b/491166461)
• Di chuyển onClick đến vị trí cuối cùng trong danh sách tham số để dùng làm lambda ở cuối. Không sử dụng IndirectPointerEvent(s) nếu không có lambda nào có thể áp dụng (I9343e, b/486965466)
• Đổi tên Độ sâu và các thực thể có liên quan thành DepthEffect. Các thuộc tính lớp của DepthEffect được công khai. (Ie26d2, b/485632564)

Phiên bản 1.0.0-alpha08

Ngày 11 tháng 3 năm 2026

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

Thay đổi về API

• Thay thế TitleChipDefaults.contentPadding bằng hằng số ContentPadding. (If992f, b/489451530)
• Glimmer ListState hiện cung cấp ScrollIndicatorState (I0a2f8, b/481662773)
• Đã thêm một TextStyle mới có tên là caption. Đối với TextStyles hiện có, fontWeight, fontSize và lineHeight đã được cập nhật. (I2319f, b/473560419)

Phiên bản 1.0.0-alpha07

Ngày 25 tháng 2 năm 2026

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

Phiên bản 1.0.0-alpha06

Ngày 11 tháng 2 năm 2026

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

Thay đổi về API

• Thêm một phiên bản nạp chồng của API VerticalList có vùng cho tiêu đề. (Ic3d44)
• Cập nhật thứ tự tham số Glimmer Text autoSize để đảm bảo tính nhất quán với material3. (Ic24bd, b/477669012)

Phiên bản 1.0.0-alpha05

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

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

Phiên bản 1.0.0-alpha04

Ngày 14 tháng 1 năm 2026

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

Tính năng mới

• Thêm tính năng hỗ trợ nhiều thành phần trang trí cho mỗi mục trong VerticalStack (22daab3) và hỗ trợ các hình dạng trang trí chung (033e015).

Thay đổi về API

• Đã thêm VerticalListDefaults để cung cấp các giá trị được đề xuất cho thành phần kết hợp VerticalList. (I07b1a, b/448364605)

Sửa lỗi

• Thêm tính năng xử lý tiêu điểm ban đầu vào VerticalStack để đảm bảo mục trên cùng nhận được tiêu điểm khi tiêu điểm đi vào ngăn xếp. Điều này khắc phục vấn đề tiêu điểm ban đầu được chỉ định cho mục tiếp theo, dẫn đến việc cuộn ngay đến mục đó. (bd69841)
• Đã khắc phục một lỗi trong ItemDecorationNode của VerticalStack, trong đó các thành phần trang trí không được cập nhật trong phạm vi mục khi nút sửa đổi được dùng lại. (7ec2c94)

Phiên bản 1.0.0-alpha03

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

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

Sửa lỗi

• Cập nhật hành vi và sửa lỗi cho Nhóm ứng dụng

Phiên bản 1.0.0-alpha02

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

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

Thay đổi về API

• Các phương thức mở rộng items(items: List<T>) và itemsIndexed(items: List<T>) mới trên ListScope. (Ic2afe)
• Cung cấp API FlingBehavior cho VerticaList. (I16de7)
• Cung cấp một phương thức ban đầu cho hành vi chụp nhanh nhận biết tiêu điểm VerticalList. (I4a528)

Phiên bản 1.0.0-alpha01

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

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

Tính năng mới

• Bản phát hành ban đầu cho nhà phát triển của Jetpack Compose Glimmer, ngôn ngữ thiết kế và các thành phần giao diện người dùng để xây dựng trải nghiệm Android XR tăng cường. Được thiết kế để đảm bảo độ rõ ràng, dễ đọc và ít gây xao nhãng với kiểu dáng đơn giản, tiêu điểm khác biệt và độ nâng được tối ưu hoá.
• Bắt đầu với bộ thành phần Glimmer ban đầu của Jetpack Compose:
  • Văn bản
  • Biểu tượng
  • Khối tiêu đề
  • Thẻ
  • Danh sách
  • Nút
  • Nhóm video (Đang phát triển)