webgpu

  
适用于 Kotlin 的现代 GPU 图形和计算 API。
最近更新时间 稳定版 候选版 Beta 版 Alpha 版
2026 年 4 月 22 日 - - - 1.0.0-alpha05

声明依赖项

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

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

Groovy

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

Kotlin

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

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

反馈

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

创建新问题

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

此工件没有版本说明。

Webgpu 版本 1.0

版本 1.0.0-alpha05

2026 年 4 月 22 日

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

新功能和常量

  • 兼容模式限制

    • 添加了 GPUCompatibilityModeLimits（及其对应的 Builder），以专门为兼容模式定义限制。
    • 包括 maxStorageBuffersInVertexStage 和 maxStorageTexturesInFragmentStage 等特定限制。
    • 此对象已作为可选属性集成到 GPULimits 中。

  • 纹理绑定视图维度

    • 添加了 GPUTextureBindingViewDimension，以便更精细地控制纹理视图绑定。
    • 现在可以在 GPUTextureDescriptor 中指定这些内容。

  • 新常量和支持的功能

    • TextureUsage： 添加了 TransientAttachment。
    • WGSLLanguageFeatureName：
      • 添加了 SubgroupUniformity。
      • 添加了 TextureFormatsTier1。
    • SType： 添加了以下内容：
      • ExternalTextureBindingLayout
      • ExternalTextureBindingEntry
      • CompatibilityModeLimits
      • TextureBindingViewDimension

API 更改

  • IntDef 注解重构： 重构了所有枚举（例如 AdapterType、TextureFormat、BufferUsage、LoadOp 等）的结构定义。它们已从公共注解类转换为包含嵌套的 .Type 注解类的私有构造函数类。因此，库中的参数注解已从 @FormatName 更新为 @FormatName.Type（例如，将 @TextureFormat 更改为 @TextureFormat.Type）。
  • 纹理视图描述符更新： GPUTextureViewDescriptor 现在接受 usage 参数 (@TextureUsage.Type)，允许直接在纹理视图上定义特定用法。

重要提示： 此库版本中提供的文档是使用 Google Gemini 生成的，可能包含错误。

版本 1.0.0-alpha04

2026 年 2 月 11 日

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

新功能

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

API 更改

  • 构造函数更新：描述符类的公共构造函数已更新为支持 Builder 模式；移除了许多重载的构造函数，以简化 API。

  • Dawn 更新：将内部 Dawn 源代码提交更新为 dc741dd，以与上游 WebGPU 实现保持同步。

  • 重要提示：此库版本中提供的文档是使用 Google Gemini 生成的，可能包含错误。

bug 修复

版本 1.0.0-alpha03

2026 年 1 月 14 日

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

新功能

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

API 更改

  • 回调整合：移除了几个特定的回调接口，转而使用新的通用 GPURequestCallback。

版本 1.0.0-alpha02

2025 年 12 月 17 日

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

新功能

  • 扩展的测试套件：添加了更全面的测试，以提高库的稳定性。
  • 最低 SDK 更新：该库现在适用于 minSdk 24 及更高版本。

API 更改

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

版本 1.0.0-alpha01

2025 年 12 月 3 日

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

新功能

  • 这是 WebGPU for Android 应用库的初始 Alpha 版。在此阶段，它旨在用于开发者预览。预计 API 将在接下来的几个版本中最终确定。