webgpu

API 参考文档
androidx.webgpu

一个用于从 Kotlin 进行图形和计算的现代 GPU API。

最近更新时间	稳定版	候选版	Beta 版	Alpha 版
2026 年 2 月 11 日	-	-	-	1.0.0-alpha04

声明依赖项

如需添加 Webgpu 的依赖项，您必须将 Google Maven 制品库添加到项目中。如需了解详情，请参阅 Google 的 Maven 代码库。

在应用或模块的 build.gradle 文件中添加所需工件的依赖项：

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

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

如需详细了解依赖项，请参阅添加 build 依赖项。

您的反馈将帮助我们改进 Jetpack。如果您发现了新问题，或对此库有任何改进建议，请告诉我们。创建新问题前，请先查看此库中的现有问题。您可以点击星标按钮，为现有问题投票。

如需了解详情，请参阅问题跟踪器文档。

此工件没有版本说明。

2026 年 2 月 11 日

发布了 androidx.webgpu:webgpu:1.0.0-alpha04。版本 1.0.0-alpha04 中包含这些提交内容。

新功能

构建器模式：为所有描述符和状态对象（例如，GPUDeviceDescriptor.Builder、GPURenderPipelineDescriptor.Builder），以简化对象构建并提高 Java 互操作性。
扩展了测试套件：添加了更多测试，包括针对新的颜色转换扩展的测试，以提高库的稳定性。
文档：大幅改进了整个库中的 KDoc 和 Javadoc，为 API 类型和标志提供了更清晰的定义。

** API 变更 **

bug 修复

2026 年 1 月 14 日

发布了 androidx.webgpu:webgpu:1.0.0-alpha03。版本 1.0.0-alpha03 中包含这些提交内容。

新功能

扩展了测试套件：添加了更全面的测试，以提高库的稳定性。
颜色转换扩展程序：添加了扩展函数，可轻松将 Android 颜色值转换为 GPUColor。
统一的回调接口：新增了 GPURequestCallback 接口，以便在整个库中更一致地处理异步操作。
元数据：库 AAR 现在在其资源中包含一个 dawn_build_metadata.json 文件。此文件包含用于 build 的特定 Dawn Git SHA-1 提交。

API 变更

2025 年 12 月 17 日

发布了 androidx.webgpu:webgpu:1.0.0-alpha02。版本 1.0.0-alpha02 中包含这些提交内容。

新功能

API 变更

结构重命名：所有结构现在都以“GPU”为前缀，以便与现有对象保持一致。例如，BindGroupDescriptor 已重命名为 GPUBindGroupDescriptor。
全局方法封装：全局函数已移至公共 GPU 对象中，以便在 Kotlin API 中实现更好的清晰度和组织性。
异常处理重构：通过将 getException 函数移至 WebGpuRuntimeException 伴生对象中，实现了该函数的内部化。这样可防止开发者访问内部异常创建逻辑，同时保持干净的公共 API 表面。

2025 年 12 月 3 日

发布了 androidx.webgpu:webgpu:1.0.0-alpha01。版本 1.0.0-alpha01 中包含这些提交内容。

新功能