webgpu

Bağımlılıkları bildirme

Webgpu'ya bağımlılık eklemek için Google Maven deposunu projenize eklemeniz gerekir. Daha fazla bilgi için Google'ın Maven deposunu okuyun.

Uygulamanız veya modülünüz için build.gradle dosyasına ihtiyacınız olan yapılarla ilgili bağımlılıkları ekleyin:

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

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

Bağımlılıklar hakkında daha fazla bilgi için Derleme bağımlılıkları ekleme başlıklı makaleyi inceleyin.

Geri bildirim

Geri bildiriminiz Jetpack'in iyileştirilmesine yardımcı olur. Yeni sorunlar keşfederseniz veya bu kitaplığı iyileştirmeye yönelik fikirleriniz varsa lütfen bize bildirin. Yeni bir sorun oluşturmadan önce lütfen bu kitaplıktaki mevcut sorunlara göz atın. Yıldız düğmesini tıklayarak mevcut bir soruna oyunuzu ekleyebilirsiniz.

Yeni sorun oluşturma

Daha fazla bilgi için Sorun İzleyici belgelerini inceleyin.

Bu yapı için sürüm notu yok.

Webgpu 1.0 sürümü

Sürüm 1.0.0-alpha05

22 Nisan 2026

androidx.webgpu:webgpu:1.0.0-alpha05 iptal edilir. 1.0.0-alpha05 sürümü bu commit'leri içerir.

Yeni Özellikler ve Sabitler

• Uyumluluk Modu Sınırları

  • Uyumluluk modu için özel olarak sınırları tanımlamak üzere GPUCompatibilityModeLimits (ve karşılık gelen Builder) eklendi.
  • maxStorageBuffersInVertexStage ve maxStorageTexturesInFragmentStage gibi belirli sınırlar içerir.
  • Bu nesne, GPULimits içinde isteğe bağlı bir özellik olarak entegre edilmiştir.

• Doku Bağlama Görüntü Boyutları

  • Doku görünümü bağlamaları üzerinde daha ayrıntılı kontrol sağlamak için GPUTextureBindingViewDimension eklendi.
  • Bu değerler artık GPUTextureDescriptor içinde belirtilebilir.

• Yeni Sabitler ve Desteklenen Özellikler

  • TextureUsage: TransientAttachment eklendi.
  • WGSLLanguageFeatureName:
    • SubgroupUniformity eklendi.
    • TextureFormatsTier1 eklendi.
  • SType: Aşağıdakiler eklendi:
    • ExternalTextureBindingLayout
    • ExternalTextureBindingEntry
    • CompatibilityModeLimits
    • TextureBindingViewDimension

API Değişiklikleri

• IntDef Annotation Refactoring: Tüm numaralandırmaların (ör. AdapterType, TextureFormat, BufferUsage, LoadOp vb.) yapısal tanımı yeniden düzenlendi. Herkese açık açıklama sınıflarından, iç içe yerleştirilmiş .Type açıklama sınıfı içeren özel oluşturucu sınıflarına geçiş yaptılar. Bu nedenle, kitaplıktaki parametre açıklamaları @FormatName yerine @FormatName.Type olarak güncellendi (ör. @TextureFormat, @TextureFormat.Type olarak değiştirildi).
• Doku Görünümü Tanımlayıcı Güncellemeleri: GPUTextureViewDescriptor artık usage parametresini (@TextureUsage.Type) kabul ediyor. Bu sayede, belirli kullanımların doğrudan doku görünümünde tanımlanmasına olanak tanınıyor.

Önemli Not: Bu kitaplık sürümünde sağlanan dokümanlar Google Gemini kullanılarak oluşturulmuştur ve hatalar içerebilir.

Sürüm 1.0.0-alpha04

11 Şubat 2026

androidx.webgpu:webgpu:1.0.0-alpha04 iptal edilir. 1.0.0-alpha04 sürümü bu commit'leri içerir.

Yeni Özellikler

• Builder Pattern: Nesne oluşturmayı basitleştirmek ve Java birlikte çalışabilirliğini iyileştirmek için tüm tanımlayıcı ve durum nesneleri (ör. GPUDeviceDescriptor.Builder, GPURenderPipelineDescriptor.Builder) için statik Builder sınıfları kullanıma sunuldu.
• Genişletilmiş Test Paketi: Kitaplık kararlılığını artırmak için yeni renk dönüştürme uzantıları da dahil olmak üzere daha fazla test eklendi.
• Dokümanlar: Kitaplık genelinde KDoc ve Javadoc önemli ölçüde iyileştirilerek API türleri ve işaretleri için daha net tanımlar sağlandı.

API Değişiklikleri

• Oluşturucu Güncellemeleri: Tanımlayıcı sınıfları için herkese açık oluşturucular, Oluşturucu kalıbını destekleyecek şekilde güncellendi. API'yi kolaylaştırmak için aşırı yüklenmiş birçok oluşturucu kaldırıldı.

• Dawn güncellemesi: Yukarı akış WebGPU uygulamasıyla senkronize kalmak için dahili Dawn kaynak commit'i dc741dd olarak güncellendi.

• Önemli Not: Bu kitaplık sürümünde sağlanan dokümanlar Google Gemini kullanılarak oluşturulmuştur ve hatalar içerebilir.

Hata Düzeltmeleri

• GPUMultisampleState içindeki maske için yanlış varsayılan değer düzeltildi (I41e86f0b, b/379441904)

Sürüm 1.0.0-alpha03

14 Ocak 2026

androidx.webgpu:webgpu:1.0.0-alpha03 iptal edilir. 1.0.0-alpha03 sürümü bu commit'leri içerir.

Yeni Özellikler

• Genişletilmiş Test Paketi: Kitaplık kararlılığını artırmak için daha kapsamlı testler eklendi.
• Renk Dönüştürme Uzantısı: Android renk değerlerini kolayca GPUColor biçimine dönüştürmek için uzantı işlevleri eklendi.
• Birleştirilmiş geri çağırma arayüzü: Kitaplıkta eşzamansız işlemlerin daha tutarlı bir şekilde yürütülmesini sağlamak için yeni bir GPURequestCallback arayüzü eklendi.
• Meta veriler: Kitaplık AAR'si artık öğelerinde bir dawn_build_metadata.json dosyası içeriyor. Bu dosya, derleme için kullanılan belirli Dawn Git SHA-1 taahhüdünü içerir.

API Değişiklikleri

• Geri Arama Birleştirme: Yeni genel GPURequestCallback arayüzü lehine birkaç belirli geri arama arayüzü kaldırıldı.

Sürüm 1.0.0-alpha02

17 Aralık 2025

androidx.webgpu:webgpu:1.0.0-alpha02 iptal edilir. 1.0.0-alpha02 sürümü bu commit'leri içerir.

Yeni Özellikler

• Genişletilmiş Test Paketi: Kitaplık kararlılığını artırmak için daha kapsamlı testler eklendi.
• Minimum SDK Güncellemesi: Kitaplık artık minSdk 24 ve sonraki sürümlerde kullanılabilir.

API Değişiklikleri

• Yapı Yeniden Adlandırma: Tüm yapılar, mevcut nesnelerle tutarlılık sağlamak için artık "GPU" ile başlıyor. Örneğin, BindGroupDescriptor, GPUBindGroupDescriptor olarak yeniden adlandırıldı.
• Global Yöntem Sarmalama: Kotlin API'sinde daha iyi netlik ve düzen sağlamak için global işlevler herkese açık bir GPU nesnesine taşındı.
• İstisna İşleme Yeniden Düzenleme: getException işlevini WebGpuRuntimeException yardımcı nesnesine taşıyarak dahili hale getirdik. Bu sayede, geliştiricilerin dahili istisna oluşturma mantığına erişmesi engellenirken temiz bir genel API yüzeyi korunur.

Sürüm 1.0.0-alpha01

3 Aralık 2025

androidx.webgpu:webgpu:1.0.0-alpha01 iptal edilir. 1.0.0-alpha01 sürümü bu commit'leri içerir.

Yeni Özellikler

• Bu, Android Uygulamaları için WebGPU kitaplığının ilk alfa sürümüdür. Bu aşamada geliştirici önizlemesi için tasarlanmıştır. API'nin önümüzdeki birkaç sürümde tamamlanması bekleniyor.