webgpu

Dichiara le dipendenze

Per aggiungere una dipendenza da Webgpu, devi aggiungere il repository Maven di Google al tuo progetto. Per saperne di più, consulta il repository Maven di Google.

Aggiungi le dipendenze per gli artefatti necessari nel file build.gradle per la tua app o il tuo modulo:

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

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

Per saperne di più sulle dipendenze, consulta Aggiungere dipendenze di build.

Feedback

Il tuo feedback ci aiuta a migliorare Jetpack. Facci sapere se riscontri nuovi problemi o hai idee per migliorare questa raccolta. Prima di segnalare un nuovo problema, dai un'occhiata ai problemi esistenti in questa raccolta. Puoi aggiungere il tuo voto a un problema esistente facendo clic sul pulsante a forma di stella.

Crea un nuovo problema

Per saperne di più, consulta la documentazione di Issue Tracker.

Non sono disponibili note di rilascio per questo artefatto.

Webgpu versione 1.0

Versione 1.0.0-alpha05

22 aprile 2026

androidx.webgpu:webgpu:1.0.0-alpha05 è stato rilasciato. La versione 1.0.0-alpha05 contiene questi commit.

Nuove funzionalità e costanti

• Limiti della modalità di compatibilità

  • È stato aggiunto GPUCompatibilityModeLimits (e il relativo Builder) per definire limiti specifici per la modalità di compatibilità.
  • Include limiti specifici come maxStorageBuffersInVertexStage e maxStorageTexturesInFragmentStage.
  • Questo oggetto è stato integrato come proprietà facoltativa in GPULimits.

• Dimensioni della visualizzazione dell'associazione di texture

  • È stato aggiunto GPUTextureBindingViewDimension per fornire un controllo più granulare sulle associazioni di visualizzazioni di texture.
  • Ora possono essere specificati in GPUTextureDescriptor.

• Nuove costanti e funzionalità supportate

  • TextureUsage: è stato aggiunto TransientAttachment.
  • WGSLLanguageFeatureName:
    • È stato aggiunto SubgroupUniformity.
    • È stato aggiunto TextureFormatsTier1.
  • SType: sono stati aggiunti i seguenti elementi:
    • ExternalTextureBindingLayout
    • ExternalTextureBindingEntry
    • CompatibilityModeLimits
    • TextureBindingViewDimension

Modifiche alle API

• Refactoring dell'annotazione IntDef: la definizione strutturale di tutti gli enum (ad es. AdapterType, TextureFormat, BufferUsage, LoadOp e così via) è stata sottoposta a refactoring. Sono passati dalle classi di annotazione pubbliche alle classi di costruttori privati contenenti una classe di annotazione .Type nidificata. Di conseguenza, le annotazioni dei parametri nella libreria sono state aggiornate da @FormatName a @FormatName.Type (ad es. la modifica di @TextureFormat in @TextureFormat.Type).
• Aggiornamenti del descrittore della visualizzazione di texture: GPUTextureViewDescriptor ora accetta un parametro usage (@TextureUsage.Type), che consente di definire utilizzi specifici direttamente nella visualizzazione di texture.

Nota importante: la documentazione fornita in questa release della libreria è stata generata utilizzando Google Gemini e potrebbe contenere errori.

Versione 1.0.0-alpha04

11 febbraio 2026

androidx.webgpu:webgpu:1.0.0-alpha04 è stato rilasciato. La versione 1.0.0-alpha04 contiene questi commit.

Nuove funzionalità

• Pattern Builder: sono state introdotte classi Builder statiche per tutti gli oggetti descrittori e di stato (ad es. GPUDeviceDescriptor.Builder, GPURenderPipelineDescriptor.Builder) per semplificare la creazione di oggetti e migliorare l'interoperabilità Java.
• Suite di test espansa: sono stati aggiunti altri test, inclusi quelli per le nuove estensioni di conversione del colore, per migliorare la stabilità della libreria.
• Documentazione: KDoc e Javadoc sono stati notevolmente migliorati in tutta la libreria, fornendo definizioni più chiare per i tipi e i flag delle API.

Modifiche alle API

• Aggiornamenti del costruttore: i costruttori pubblici per le classi di descrittori sono stati aggiornati per supportare il pattern Builder; molti costruttori sovraccarichi sono stati rimossi per semplificare l'API.

• Aggiornamento di Dawn: il commit di origine Dawn interno è stato aggiornato a dc741dd per rimanere sincronizzato con l'implementazione WebGPU upstream.

• Nota importante: la documentazione fornita in questa release della libreria è stata generata utilizzando Google Gemini e potrebbe contenere errori.

Correzioni di bug

• È stato corretto il valore predefinito errato per la maschera inGPUMultisampleState (I41e86f0b, b/379441904)

Versione 1.0.0-alpha03

14 gennaio 2026

androidx.webgpu:webgpu:1.0.0-alpha03 è stato rilasciato. La versione 1.0.0-alpha03 contiene questi commit.

Nuove funzionalità

• Suite di test espansa: sono stati aggiunti test più completi per migliorare la stabilità della libreria.
• Estensione di conversione del colore: sono state aggiunte funzioni di estensione per convertire facilmente i valori di colore Android in GPUColor.
• Interfaccia di callback unificata: è stata aggiunta una nuova interfaccia GPURequestCallback per gestire le operazioni asincrone in modo più coerente nella libreria.
• Metadati: l'AAR della libreria ora include un file dawn_build_metadata.json nei suoi asset. Questo file contiene il commit SHA-1 Git Dawn specifico utilizzato per la build.

Modifiche alle API

• Consolidamento delle callback: diverse interfacce di callback specifiche sono state rimosse a favore della nuova GPURequestCallback generica.

Versione 1.0.0-alpha02

17 dicembre 2025

androidx.webgpu:webgpu:1.0.0-alpha02 è stato rilasciato. La versione 1.0.0-alpha02 contiene questi commit.

Nuove funzionalità

• Suite di test espansa: sono stati aggiunti test più completi per migliorare la stabilità della libreria.
• Aggiornamento dell'SDK minimo: la libreria è ora applicabile per minSdk 24 e versioni successive.

Modifiche alle API

• Ridenominazione della struttura: tutte le strutture ora hanno il prefisso "GPU" per coerenza con gli oggetti esistenti. Ad esempio, BindGroupDescriptor è stato rinominato in GPUBindGroupDescriptor.
• Wrapping del metodo globale: le funzioni globali sono state spostate in un oggetto GPU pubblico per una maggiore chiarezza e organizzazione all'interno dell'API Kotlin.
• Refactoring della gestione delle eccezioni: la funzione getException è stata internalizzata spostandola nell'oggetto complementare WebGpuRuntimeException. In questo modo, gli sviluppatori non possono accedere alla logica di creazione delle eccezioni interne, mantenendo al contempo una superficie API pubblica pulita.

Versione 1.0.0-alpha01

3 dicembre 2025

androidx.webgpu:webgpu:1.0.0-alpha01 è stato rilasciato. La versione 1.0.0-alpha01 contiene questi commit.

Nuove funzionalità

• Questa è la versione alpha iniziale della libreria WebGPU per applicazioni Android. In questa fase è destinata all'anteprima per gli sviluppatori. È previsto che l'API venga finalizzata nelle prossime release.