webgpu

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

Để thêm một phần phụ thuộc trên Webgpu, 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:

dependencies {
    implementation "androidx.webgpu:webgpu:1.0.0-alpha04"
}

dependencies {
    implementation("androidx.webgpu:webgpu:1.0.0-alpha04")
}

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

Không có ghi chú phát hành cho cấu phần phần mềm này.

Phiên bản 1.0

Phiên bản 1.0.0-alpha04

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

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

• Mẫu trình tạo: Giới thiệu các lớp Trình tạo tĩnh cho tất cả các đối tượng trạng thái và đối tượng mô tả (ví dụ: GPUDeviceDescriptor.Builder, GPURenderPipelineDescriptor.Builder) để đơn giản hoá việc tạo đối tượng và cải thiện khả năng tương tác của Java.
• Expanded Test Suite (Bộ kiểm thử mở rộng): Thêm nhiều kiểm thử hơn, bao gồm cả các kiểm thử cho tiện ích chuyển đổi màu mới, để cải thiện độ ổn định của thư viện.
• Tài liệu: Cải thiện đáng kể KDoc và Javadoc trong toàn bộ thư viện, cung cấp các định nghĩa rõ ràng hơn cho các loại và cờ API.

** Thay đổi về API **

• Cập nhật hàm khởi tạo: Các hàm khởi tạo công khai cho các lớp mô tả đã được cập nhật để hỗ trợ mẫu Trình tạo; nhiều hàm khởi tạo bị nạp chồng đã bị xoá để đơn giản hoá API.

• Bản cập nhật Dawn: Đã cập nhật cam kết nguồn Dawn nội bộ thành dc741dd để duy trì trạng thái đồng bộ hoá với việc triển khai WebGPU ở nguồn trên.

• Lưu ý quan trọng: Tài liệu được cung cấp trong bản phát hành thư viện này được tạo bằng Google Gemini và có thể chứa lỗi.

Sửa lỗi

• Khắc phục giá trị mặc định không chính xác cho mặt nạ trong GPUMultisampleState (I41e86f0b, b/379441904)

Phiên bản 1.0.0-alpha03

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

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

Tính năng mới

• Mở rộng Bộ kiểm thử: Thêm các kiểm thử toàn diện hơn để cải thiện độ ổn định của thư viện.
• Tiện ích chuyển đổi màu: Đã thêm các hàm tiện ích để dễ dàng chuyển đổi các giá trị Màu trên Android thành GPUColor.
• Giao diện gọi lại hợp nhất: Một giao diện GPURequestCallback mới đã được thêm vào để xử lý các thao tác không đồng bộ một cách nhất quán hơn trên toàn bộ thư viện.
• Siêu dữ liệu: AAR thư viện hiện chứa một tệp dawn_build_metadata.json trong các thành phần của thư viện. Tệp này chứa cam kết SHA-1 cụ thể của Dawn Git được dùng cho bản dựng.

Thay đổi về API

• Hợp nhất lệnh gọi lại: Một số giao diện lệnh gọi lại cụ thể đã bị xoá để chuyển sang GPURequestCallback chung mới.

Phiên bản 1.0.0-alpha02

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

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

Tính năng mới

• Mở rộng bộ kiểm thử: Thêm các kiểm thử toàn diện hơn để cải thiện độ ổn định của thư viện.
• Cập nhật SDK tối thiểu: Thư viện hiện áp dụng cho minSdk 24 trở lên.

Thay đổi về API

• Đổi tên cấu trúc: Giờ đây, tất cả cấu trúc đều có tiền tố "GPU" để nhất quán với các đối tượng hiện có. Ví dụ: BindGroupDescriptor đã được đổi tên thành GPUBindGroupDescriptor.
• Bao bọc phương thức chung: Các hàm chung đã được chuyển vào một đối tượng GPU công khai để rõ ràng và có tổ chức hơn trong Kotlin API.
• Tái cấu trúc việc xử lý ngoại lệ: Nội bộ hoá hàm getException bằng cách di chuyển hàm này vào đối tượng đồng hành WebGpuRuntimeException. Điều này ngăn nhà phát triển truy cập vào logic tạo ngoại lệ nội bộ trong khi vẫn duy trì một khu vực API công khai rõ ràng.

Phiên bản 1.0.0-alpha01

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

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

Tính năng mới

• Đây là phiên bản alpha ban đầu của thư viện WebGPU cho ứng dụng Android. Ở giai đoạn này, tính năng này dành cho bản dùng thử cho nhà phát triển. API này dự kiến sẽ được hoàn thiện trong vài bản phát hành tiếp theo.