webgpu

Declarar dependências

Para adicionar uma dependência a Webgpu, adicione o repositório Maven do Google ao seu projeto. Leia Repositório Maven do Google para ver mais informações.

Adicione as dependências dos artefatos necessários ao arquivo build.gradle do seu app ou módulo:

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

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

Para mais informações sobre dependências, consulte Adicionar dependências de build.

Feedback

Seu feedback ajuda a melhorar o Jetpack. Avise se você descobrir novos problemas ou tiver ideias para melhorar esta biblioteca. Consulte os problemas conhecidos nesta biblioteca antes de criar um novo. Adicione seu voto a um problema clicando no botão de estrela.

Criar novo problema

Consulte a documentação do Issue Tracker para saber mais.

Não há notas de versão para este artefato.

Webgpu versão 1.0

Versão 1.0.0-alpha05

22 de abril de 2026

Lançamento de androidx.webgpu:webgpu:1.0.0-alpha05. A versão 1.0.0-alpha05 inclui estes commits.

Novos recursos e constantes

• Limites do modo de compatibilidade

  • Adição de GPUCompatibilityModeLimits (e o Builder correspondente) para definir limites especificamente para o modo de compatibilidade.
  • Inclui limites específicos, como maxStorageBuffersInVertexStage e maxStorageTexturesInFragmentStage.
  • Esse objeto foi integrado como uma propriedade opcional em GPULimits.

• Dimensões da visualização de vinculação de textura

  • Adição de GPUTextureBindingViewDimension para oferecer um controle mais granular sobre as vinculações de visualização de textura.
  • Agora, elas podem ser especificadas em GPUTextureDescriptor.

• Novas constantes e recursos compatíveis

  • TextureUsage:adição de TransientAttachment.
  • WGSLLanguageFeatureName:
    • Adição de SubgroupUniformity.
    • Adição de TextureFormatsTier1.
  • SType:adição do seguinte:
    • ExternalTextureBindingLayout
    • ExternalTextureBindingEntry
    • CompatibilityModeLimits
    • TextureBindingViewDimension

Mudanças na API

• Refatoração da anotação IntDef:a definição estrutural de todos os tipos enumerados (como AdapterType, TextureFormat, BufferUsage, LoadOp etc.) foi refatorada. Eles passaram de classes de anotação pública para classes de construtor particular que contêm uma classe de anotação .Type aninhada. Consequentemente, as anotações de parâmetro em toda a biblioteca foram atualizadas de @FormatName para @FormatName.Type (por exemplo, alterando @TextureFormat para @TextureFormat.Type).
• Atualizações do descritor de visualização de textura:GPUTextureViewDescriptor agora aceita um parâmetro usage (@TextureUsage.Type), permitindo que usos específicos sejam definidos diretamente na visualização de textura.

Observação importante:a documentação fornecida nesta versão da biblioteca foi gerada usando o Google Gemini e pode conter erros.

Versão 1.0.0-alpha04

11 de fevereiro de 2026

Lançamento de androidx.webgpu:webgpu:1.0.0-alpha04. A versão 1.0.0-alpha04 inclui estes commits.

Novos recursos

• Padrão do builder: introduzimos classes de builder estáticas para todos os objetos de descritor e estado (por exemplo, GPUDeviceDescriptor.Builder, GPURenderPipelineDescriptor.Builder) para simplificar a construção de objetos e melhorar a interoperabilidade do Java.
• Pacote de testes expandido: adicionamos mais testes, incluindo as novas extensões de conversão de cores, para melhorar a estabilidade da biblioteca.
• Documentação: melhoramos substancialmente o KDoc e o Javadoc em toda a biblioteca, fornecendo definições mais claras para tipos e flags de API.

Mudanças na API

• Atualizações do construtor: os construtores públicos para classes de descritor foram atualizados para oferecer suporte ao padrão do builder. Muitos construtores sobrecarregados foram removidos para simplificar a API.

• Atualização do Dawn: atualizamos o commit de origem do Dawn interno para dc741dd para manter a sincronização com a implementação do WebGPU upstream.

• Observação importante: a documentação fornecida nesta versão da biblioteca foi gerada usando o Google Gemini e pode conter erros.

Correções de bugs

• Correção do valor padrão incorreto para máscara emGPUMultisampleState (I41e86f0b, b/379441904)

Versão 1.0.0-alpha03

14 de janeiro de 2026

Lançamento de androidx.webgpu:webgpu:1.0.0-alpha03. A versão 1.0.0-alpha03 inclui estes commits.

Novos recursos

• Pacote de testes expandido: adicionamos testes mais abrangentes para melhorar a estabilidade da biblioteca.
• Extensão de conversão de cores: adicionamos funções de extensão para converter facilmente valores de cores do Android em GPUColor.
• Interface de callback unificada: uma nova interface GPURequestCallback foi adicionada para processar operações assíncronas de maneira mais consistente em toda a biblioteca.
• Metadados: o AAR da biblioteca agora inclui um arquivo dawn_build_metadata.json nos recursos. Esse arquivo contém o commit SHA-1 específico do Dawn Git usado para o build.

Mudanças na API

• Consolidação de callback: várias interfaces de callback específicas foram removidas em favor da nova GPURequestCallback genérica.

Versão 1.0.0-alpha02

17 de dezembro de 2025

Lançamento de androidx.webgpu:webgpu:1.0.0-alpha02. A versão 1.0.0-alpha02 inclui estes commits.

Novos recursos

• Pacote de testes expandido: adicionamos testes mais abrangentes para melhorar a estabilidade da biblioteca.
• Atualização mínima do SDK: a biblioteca agora é aplicável ao minSdk 24 e versões mais recentes.

Mudanças na API

• Renomeação da estrutura: todas as estruturas agora têm o prefixo "GPU" para consistência com os objetos atuais. Por exemplo, BindGroupDescriptor foi renomeado como GPUBindGroupDescriptor.
• Encapsulamento de método global: as funções globais foram movidas para um objeto de GPU público para melhor clareza e organização na API Kotlin.
• Refatoração do tratamento de exceções: internalizamos a função getException movendo-a para o objeto complementar WebGpuRuntimeException. Isso impede que os desenvolvedores acessem a lógica interna de criação de exceções, mantendo uma superfície de API pública limpa.

Versão 1.0.0-alpha01

3 de dezembro de 2025

Lançamento de androidx.webgpu:webgpu:1.0.0-alpha01. A versão 1.0.0-alpha01 inclui estes commits.

Novos recursos

• Esta é a versão Alfa inicial da biblioteca WebGPU para aplicativos Android. Nesta fase, ela é destinada à prévia para desenvolvedores. A expectativa é que a API seja finalizada nas próximas versões.