webgpu

Cómo declarar dependencias

Para agregar una dependencia en WebGPU, debes agregar el repositorio de Maven de Google a tu proyecto. Consulta el repositorio de Maven de Google para obtener más información.

Agrega las dependencias de los artefactos que necesites en el archivo build.gradle de tu app o módulo:

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

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

Para obtener más información sobre las dependencias, consulta Cómo agregar dependencias de compilación.

Comentarios

Tus comentarios ayudan a mejorar Jetpack. Avísanos si descubres nuevos errores o tienes ideas para mejorar esta biblioteca. Consulta los errores existentes de esta biblioteca antes de crear uno nuevo. Puedes agregar tu voto a un error existente haciendo clic en el botón de la estrella.

Crear un error nuevo

Consulta la documentación sobre la Herramienta de seguimiento de errores para obtener más información.

No hay notas de la versión para este artefacto.

WebGPU versión 1.0

Versión 1.0.0-alpha05

22 de abril de 2026

Lanzamiento de androidx.webgpu:webgpu:1.0.0-alpha05. La versión 1.0.0-alpha05 contiene estas confirmaciones.

Nuevas funciones y constantes

• Límites del modo de compatibilidad

  • Se agregó GPUCompatibilityModeLimits (y su Builder correspondiente) para definir límites específicamente para el modo de compatibilidad.
  • Incluye límites específicos, como maxStorageBuffersInVertexStage y maxStorageTexturesInFragmentStage.
  • Este objeto se integró como una propiedad opcional dentro de GPULimits.

• Dimensiones de la vista de vinculación de texturas

  • Se agregó GPUTextureBindingViewDimension para proporcionar un control más detallado sobre las vinculaciones de la vista de texturas.
  • Ahora se pueden especificar dentro de GPUTextureDescriptor.

• Nuevas constantes y funciones admitidas

  • TextureUsage: Se agregó TransientAttachment.
  • WGSLLanguageFeatureName:
    • Se agregó SubgroupUniformity.
    • Se agregó TextureFormatsTier1.
  • SType: Se agregó lo siguiente:
    • ExternalTextureBindingLayout
    • ExternalTextureBindingEntry
    • CompatibilityModeLimits
    • TextureBindingViewDimension

Cambios en la API

• Refactorización de la anotación IntDef: Se refactorizó la definición estructural de todas las enumeraciones (como AdapterType, TextureFormat, BufferUsage, LoadOp, etc.). Pasaron de clases de anotación públicas a clases de constructor privadas que contienen una clase de anotación .Type anidada. En consecuencia, las anotaciones de parámetros en toda la biblioteca se actualizaron de @FormatName a @FormatName.Type (p.ej., cambiar @TextureFormat a @TextureFormat.Type).
• Actualizaciones del descriptor de la vista de texturas: GPUTextureViewDescriptor ahora acepta un parámetro usage (@TextureUsage.Type), lo que permite definir usos específicos directamente en la vista de texturas.

Nota importante: La documentación que se proporciona en esta versión de la biblioteca se generó con Google Gemini y puede contener errores.

Versión 1.0.0-alpha04

11 de febrero de 2026

Lanzamiento de androidx.webgpu:webgpu:1.0.0-alpha04. La versión 1.0.0-alpha04 contiene estas confirmaciones.

Nuevas funciones

• Patrón de compilador: Se introdujeron clases de compilador estáticas para todos los objetos de descriptor y de estado (p.ej., GPUDeviceDescriptor.Builder, GPURenderPipelineDescriptor.Builder) para simplificar la construcción de objetos y mejorar la interoperabilidad de Java.
• Paquete de pruebas expandido: Se agregaron más pruebas, incluidas las nuevas extensiones de conversión de color, para mejorar la estabilidad de la biblioteca.
• Documentación: Se mejoraron significativamente KDoc y Javadoc en toda la biblioteca, lo que proporciona definiciones más claras para los tipos y las marcas de la API.

Cambios en la API

• Actualizaciones del constructor: Se actualizaron los constructores públicos para las clases de descriptor para admitir el patrón de compilador; se quitaron muchos constructores sobrecargados para optimizar la API.

• Actualización de Dawn: Se actualizó la confirmación de la fuente interna de Dawn a dc741dd para mantener la sincronización con la implementación de WebGPU upstream.

• Nota importante: La documentación que se proporciona en esta versión de la biblioteca se generó con Google Gemini y puede contener errores.

Correcciones de errores

• Se corrigió el valor predeterminado incorrecto para la máscara enGPUMultisampleState (I41e86f0b, b/379441904).

Versión 1.0.0-alpha03

14 de enero de 2026

Lanzamiento de androidx.webgpu:webgpu:1.0.0-alpha03. La versión 1.0.0-alpha03 contiene estas confirmaciones.

Nuevas funciones

• Paquete de pruebas expandido: Se agregaron pruebas más completas para mejorar la estabilidad de la biblioteca.
• Extensión de conversión de color: Se agregaron funciones de extensión para convertir fácilmente los valores de color de Android en GPUColor.
• Interfaz de devolución de llamada unificada: Se agregó una nueva interfaz GPURequestCallback para controlar las operaciones asíncronas de manera más coherente en toda la biblioteca.
• Metadatos: El AAR de la biblioteca ahora incluye un archivo dawn_build_metadata.json en sus recursos. Este archivo contiene la confirmación SHA-1 de Git de Dawn específica que se usó para la compilación.

Cambios en la API

• Consolidación de devolución de llamada: Se quitaron varias interfaces de devolución de llamada específicas en favor de la nueva GPURequestCallback genérica.

Versión 1.0.0-alpha02

17 de diciembre de 2025

Lanzamiento de androidx.webgpu:webgpu:1.0.0-alpha02. La versión 1.0.0-alpha02 contiene estas confirmaciones.

Nuevas funciones

• Paquete de pruebas expandido: Se agregaron pruebas más completas para mejorar la estabilidad de la biblioteca.
• Actualización del SDK mínimo: La biblioteca ahora es aplicable para minSdk 24 y versiones posteriores.

Cambios en la API

• Cambio de nombre de la estructura: Todas las estructuras ahora tienen el prefijo "GPU" para mantener la coherencia con los objetos existentes. Por ejemplo, se cambió el nombre de BindGroupDescriptor a GPUBindGroupDescriptor.
• Ajuste del método global: Las funciones globales se movieron a un objeto de GPU público para mejorar la claridad y la organización dentro de la API de Kotlin.
• Refactorización del control de excepciones: Se internalizó la función getException moviéndola al objeto complementario WebGpuRuntimeException. Esto evita que los desarrolladores accedan a la lógica interna de creación de excepciones y, al mismo tiempo, mantiene una superficie de API pública limpia.

Versión 1.0.0-alpha01

3 de diciembre de 2025

Lanzamiento de androidx.webgpu:webgpu:1.0.0-alpha01. La versión 1.0.0-alpha01 contiene estas confirmaciones.

Nuevas funciones

• Esta es la versión alfa inicial de la biblioteca de WebGPU para aplicaciones para Android. En esta etapa, está destinada a la versión preliminar para desarrolladores. Se espera que la API se finalice en las próximas versiones.