webgpu

  
A modern GPU API for graphics and compute from Kotlin.
Latest Update Stable Release Release Candidate Beta Release Alpha Release
October 07, 2026 - - - 1.0.0-alpha06

Declaring dependencies

To add a dependency on Webgpu, you must add the Google Maven repository to your project. Read Google's Maven repository for more information.

Add the dependencies for the artifacts you need in the build.gradle file for your app or module:

Groovy

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

Kotlin

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

For more information about dependencies, see Add build dependencies.

Feedback

Your feedback helps make Jetpack better. Let us know if you discover new issues or have ideas for improving this library. Please take a look at the existing issues in this library before you create a new one. You can add your vote to an existing issue by clicking the star button.

Create a new issue

See the Issue Tracker documentation for more information.

There are no release notes for this artifact.

Webgpu Version 1.0

Version 1.0.0-alpha06

October 07, 2026

androidx.webgpu:webgpu:1.0.0-alpha06 is released. Version 1.0.0-alpha06 contains these commits.

New Features

  • Hardware Buffer Integration: Added GPUAndroidHardwareBufferUtil to zero-copy import HardwareBuffer memory into Dawn. Includes createTexture() for RGB buffers and createExternalTexture() for multi-planar YCbCr buffers (requires SharedTextureMemoryAHardwareBuffer and YCbCrVulkanSamplers features).
  • Fence Synchronization: Added GPUSyncFence as an AutoCloseable wrapper around a ParcelFileDescriptor holding a kernel sync file. Added await(timeoutMillis) which blocks natively until fence signals. Added fromSyncFence which adopts descriptors out of a platform android.hardware.SyncFence on API 33+. Added Extensions.toSyncFence to convert back to a platform SyncFence.
  • Dawn Toggles Descriptor: Added GPUDawnTogglesDescriptor and its corresponding Builder to pass Dawn implementation toggles as enabledToggles and disabledToggles string arrays. Toggles can be scoped to instances, adapter selections, or single devices because this object integrates as an optional dawnTogglesDescriptor property within GPUInstanceDescriptor, GPURequestAdapterOptions, and GPUDeviceDescriptor.
  • Color Space and HDR Support: Added GPUColorSpaceDawn and its corresponding Builder to specify color space parameters including primaries, transfer characteristics, matrix, full or narrow range, and HDR reference white luminance. Added supporting color space constants like ColorSpacePrimariesDawn, ColorSpaceTransferDawn, ColorSpaceYCbCrMatrixDawn, and ColorSpaceYCbCrRangeDawn.

API Changes

  • Minimum SDK Update: Minimum supported SDK for androidx.webgpu has been increased from API 24 to API 26.
  • Builder Pattern Migration: Descriptors and configuration structures across libraries now provide a dedicated nested Builder class. Java callers must use new builders because @JvmOverloads annotations have been removed from Kotlin constructors to improve Java interoperability. Affected structures include GPUBufferDescriptor, GPUTextureBindingLayout, GPUPipelineLayoutDescriptor, GPUComputePipelineDescriptor, GPUVertexState, and GPUSurfaceDescriptor.
  • Thread Safety Enforcement: Updated WebGpu helper classes for strict single-threaded execution. Added adapter, dispatcher, and isClosed properties, alongside execute() and processEventsLoop() suspend functions. createWebGpu() now accepts a custom CoroutineDispatcher.
  • Experimental API Annotation: Introduced @ExperimentalWebGpuApi to mark incubating and Dawn specific experimental APIs across libraries. This includes GPUSyncFence, GPUDawnTogglesDescriptor, GPUExternalTextureDescriptor, and GPUHardwareBufferWrapper.
  • Hardware Buffer Extras: Added GPUHardwareBufferWrapper as a common base for hardware buffer imports. Added GPUExternalTextureDescriptor and its corresponding Builder, GPUExtent2D, and GPUOrigin2D so crop rects, color spaces, and rotation can fold into sampling operations.
  • Color Conversion Extension: Removed the @RequiresApi(26) restriction on Extensions.toGPUColor(long) as it is now redundant with the library's overall minimum SDK bump to API 26.
  • Immediate Executions: Added setImmediates method to GPUComputePassEncoder, GPURenderBundleEncoder, and GPURenderPassEncoder.
  • Device Methods: Added createErrorExternalTexture and createExternalTexture methods to GPUDevice.
  • Texture Methods: Added destroy method to GPUExternalTexture.
  • New Constants and Supported Features:
    • VertexFormat: Added Snorm10_10_10_2.
    • SType: Added DawnTogglesDescriptor.
    • WGSLLanguageFeatureName: Added BufferView, FragmentDepth, ImmediateAddressSpace, LinearIndexing, and SwizzleAssignment.
    • FeatureName: Added SubgroupSizeControl.
    • Added experimental features like OpaqueYCbCrAndroidForExternalTexture, SharedFenceSyncFD, SharedTextureMemoryAHardwareBuffer, and YCbCrVulkanSamplers.
    • PredefinedColorSpace: Added DisplayP3Linear, Rec2020Linear, and SRGBLinear.
    • ExternalTextureRotation: Added Rotate0Degrees, Rotate90Degrees, Rotate180Degrees, and Rotate270Degrees.

Important Note: Documentation provided in this library release has been generated utilizing Google Gemini and may contain errors.

Version 1.0.0-alpha05

April 22, 2026

androidx.webgpu:webgpu:1.0.0-alpha05 is released. Version 1.0.0-alpha05 contains these commits.

New Features & Constants

  • Compatibility Mode Limits

    • Added GPUCompatibilityModeLimits (and its corresponding Builder) to define limits specifically for compatibility mode.
    • Includes specific limits such as maxStorageBuffersInVertexStage and maxStorageTexturesInFragmentStage.
    • This object has been integrated as an optional property within GPULimits.

  • Texture Binding View Dimensions

    • Added GPUTextureBindingViewDimension to provide more granular control over texture view bindings.
    • These can now be specified within GPUTextureDescriptor.

  • New Constants and Supported Features

    • TextureUsage: Added TransientAttachment.
    • WGSLLanguageFeatureName:
      • Added SubgroupUniformity.
      • Added TextureFormatsTier1.
    • SType: Added the following:
      • ExternalTextureBindingLayout
      • ExternalTextureBindingEntry
      • CompatibilityModeLimits
      • TextureBindingViewDimension

API Changes

  • IntDef Annotation Refactoring: The structural definition of all enums (such as AdapterType, TextureFormat, BufferUsage, LoadOp, etc.) are refactored. They have transitioned from public annotation classes to private constructor classes containing a nested .Type annotation class. Consequently, parameter annotations across the library have been updated from @FormatName to @FormatName.Type (e.g., changing @TextureFormat to @TextureFormat.Type).
  • Texture View Descriptor Updates: GPUTextureViewDescriptor now accepts a usage parameter (@TextureUsage.Type), allowing specific usages to be defined directly on the texture view.

Important Note: The documentation provided in this library release has been generated utilizing Google Gemini and may contain errors.

Version 1.0.0-alpha04

February 11, 2026

androidx.webgpu:webgpu:1.0.0-alpha04 is released. Version 1.0.0-alpha04 contains these commits.

New Features

  • Builder Pattern: Introduced static Builder classes for all descriptor and state objects (e.g., GPUDeviceDescriptor.Builder, GPURenderPipelineDescriptor.Builder) to simplify object construction and improve Java interoperability.
  • Expanded Test Suite: Added more tests, including for the new color conversion extensions, to improve library stability.
  • Documentation: Substantially improved KDoc and Javadoc throughout the library, providing clearer definitions for API types and flags.

API Changes

  • Constructor Updates: Public constructors for descriptor classes have been updated to support the Builder pattern; many overloaded constructors were removed to streamline the API.

  • Dawn Update: Updated the internal Dawn source commit to dc741dd to stay synchronized with the upstream WebGPU implementation.

  • Important Note: The documentation provided in this library release has been generated utilizing Google Gemini and may contain errors.

Bug Fixes

Version 1.0.0-alpha03

January 14, 2026

androidx.webgpu:webgpu:1.0.0-alpha03 is released. Version 1.0.0-alpha03 contains these commits.

New Features

  • Expanded Test Suite: Added more comprehensive tests to improve library stability.
  • Color Conversion Extension: Added extension functions to easily convert Android Color values into GPUColor.
  • Unified Callback Interface: A new GPURequestCallback interface has been added to handle asynchronous operations more consistently across the library.
  • Metadata: The library AAR now includes a dawn_build_metadata.json file in its assets. This file contains the specific Dawn Git SHA-1 commit used for the build.

API Changes

  • Callback Consolidation: Several specific callback interfaces have been removed in favor of the new generic GPURequestCallback.

Version 1.0.0-alpha02

December 17, 2025

androidx.webgpu:webgpu:1.0.0-alpha02 is released. Version 1.0.0-alpha02 contains these commits.

New Features

  • Expanded Test Suite: Added more comprehensive tests to improve library stability.
  • Minimum SDK Update: The library is now applicable for minSdk 24 and higher.

API Changes

  • Structure Renaming: All structures are now prefixed with "GPU" for consistency with existing objects. For example, BindGroupDescriptor has been renamed to GPUBindGroupDescriptor.
  • Global Method Wrapping: Global functions have been moved into a public GPU object for better clarity and organization within the Kotlin API.
  • Exception Handling Refactor: Internalized the getException function by moving it into the WebGpuRuntimeException companion object. This prevents developers from accessing the internal exception creation logic while maintaining a clean public API surface.

Version 1.0.0-alpha01

December 03, 2025

androidx.webgpu:webgpu:1.0.0-alpha01 is released. Version 1.0.0-alpha01 contains these commits.

New Features

  • This is the initial alpha version of the WebGPU for Android Applications library. It is intended at this stage for developer preview. The API is expected to be finalized over the next few releases.