webgpu

  
Một API GPU hiện đại cho đồ hoạ và điện toán từ Kotlin.
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 22 tháng 4 năm 2026 - - - 1.0.0-alpha05

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:

Groovy

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

Kotlin

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

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

Webgpu phiên bản 1.0

Phiên bản 1.0.0-alpha05

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

Phát hành androidx.webgpu:webgpu:1.0.0-alpha05. Phiên bản 1.0.0-alpha05 chứa các cam kết này.

Tính năng và hằng số mới

  • Giới hạn chế độ tương thích

    • Đã thêm GPUCompatibilityModeLimits (và Builder tương ứng) để xác định các giới hạn dành riêng cho chế độ tương thích.
    • Bao gồm các giới hạn cụ thể như maxStorageBuffersInVertexStage và maxStorageTexturesInFragmentStage.
    • Đối tượng này đã được tích hợp dưới dạng một thuộc tính không bắt buộc trong GPULimits.

  • Kích thước khung hiển thị liên kết kết cấu

    • Đã thêm GPUTextureBindingViewDimension để kiểm soát thật chi tiết hơn các liên kết khung hiển thị hoạ tiết.
    • Giờ đây, bạn có thể chỉ định các liên kết này trong GPUTextureDescriptor.

  • Hằng số và tính năng mới được hỗ trợ

    • TextureUsage: Đã thêm TransientAttachment.
    • WGSLLanguageFeatureName:
      • Đã thêm SubgroupUniformity.
      • Đã thêm TextureFormatsTier1.
    • SType: Đã thêm những nội dung sau:
      • ExternalTextureBindingLayout
      • ExternalTextureBindingEntry
      • CompatibilityModeLimits
      • TextureBindingViewDimension

Thay đổi về API

  • Tái cấu trúc chú thích IntDef: Định nghĩa cấu trúc của tất cả enum (chẳng hạn như AdapterType, TextureFormat, BufferUsage, LoadOp, v.v.) đều được tái cấu trúc. Chúng đã chuyển đổi từ các lớp chú thích công khai sang các lớp hàm khởi tạo riêng tư chứa một lớp chú thích .Type lồng ghép. Do đó, các chú thích tham số trên toàn bộ thư viện đã được cập nhật từ @FormatName thành @FormatName.Type (ví dụ: thay đổi @TextureFormat thành @TextureFormat.Type).
  • Cập nhật mô tả khung hiển thị kết cấu: GPUTextureViewDescriptor hiện chấp nhận tham số usage (@TextureUsage.Type), cho phép xác định các cách sử dụng cụ thể trực tiếp trên khung hiển thị kết cấu.

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.

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 chứa các cam kết này.

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 mô tả và trạng thái (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 với Java.
  • Bộ kiểm thử mở rộng: Thêm nhiều bài kiểm thử hơn, bao gồm cả các bài 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 trên 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ị quá tải đã bị xoá để đơn giản hoá API.

  • Cập nhật Dawn: Đã cập nhật cam kết nguồn Dawn nội bộ thành dc741dd để luôn đồng bộ hoá với quá trình triển khai WebGPU ngược dòng.

  • 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ạ trongGPUMultisampleState (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 chứa các cam kết này.

Tính năng mới

  • Bộ kiểm thử mở rộng: Thêm nhiều bài 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 mở rộng để dễ dàng chuyển đổi các giá trị Màu Android thành GPUColor.
  • Giao diện lệnh gọi lại hợp nhất: Đã thêm một giao diện GPURequestCallback mới để 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 bao gồm một tệp dawn_build_metadata.json trong thành phần của nó. Tệp này chứa cam kết SHA-1 Git Dawn cụ thể đượ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 chứa các cam kết này.

Tính năng mới

  • Bộ kiểm thử mở rộng: Thêm nhiều bài 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: Tất cả cấu trúc hiện đều có tiền tố là "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.
  • Gói phương thức toàn cục: Các hàm toàn cục đã đượ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 API Kotlin.
  • Tái cấu trúc xử lý ngoại lệ: Nội bộ hoá hàm getException bằng cách 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 bề mặt 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 chứa các cam kết này.

Tính năng mới

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