webgpu

Deklarowanie zależności

Aby dodać zależność od WebGPU, musisz dodać do projektu repozytorium Maven Google. Więcej informacji znajdziesz w artykule Repozytorium Maven Google.

Dodaj zależności dotyczące potrzebnych artefaktów w pliku build.gradle aplikacji lub modułu:

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

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

Więcej informacji o zależnościach znajdziesz w artykule Dodawanie zależności kompilacji.

Opinia

Twoja opinia pomoże nam ulepszyć Jetpacka. Jeśli odkryjesz nowe problemy lub masz pomysły na ulepszenie tej biblioteki, daj nam znać. Zanim utworzysz nowy problem, zapoznaj się z dotychczasowymi problemami w tej bibliotece. Możesz oddać głos na istniejący problem, klikając przycisk gwiazdki.

Tworzenie nowego problemu

Więcej informacji znajdziesz w dokumentacji narzędzia Issue Tracker.

Brak informacji o wersji tego artefaktu.

WebGPU w wersji 1.0

Wersja 1.0.0-alpha05

22 kwietnia 2026 r.

Publikacja androidx.webgpu:webgpu:1.0.0-alpha05 Wersja 1.0.0-alpha05 zawiera te zmiany.

Nowe funkcje i stałe

• Limity trybu zgodności

  • Dodano znak GPUCompatibilityModeLimits (i odpowiadający mu znak Builder), aby zdefiniować limity specjalnie dla trybu zgodności.
  • Obejmuje konkretne limity, takie jak maxStorageBuffersInVertexStage i maxStorageTexturesInFragmentStage.
  • Ten obiekt został zintegrowany jako właściwość opcjonalna w ramach GPULimits.

• Wymiary widoku powiązania tekstury

  • Dodano GPUTextureBindingViewDimension, aby zapewnić bardziej szczegółową kontrolę nad powiązaniami widoku tekstury.
  • Można je teraz określić w ramach GPUTextureDescriptor.

• Nowe stałe i obsługiwane funkcje

  • TextureUsage: dodano TransientAttachment.
  • WGSLLanguageFeatureName:
    • Dodałeś SubgroupUniformity.
    • Dodałeś TextureFormatsTier1.
  • SType: dodano te elementy:
    • ExternalTextureBindingLayout
    • ExternalTextureBindingEntry
    • CompatibilityModeLimits
    • TextureBindingViewDimension

Zmiany w interfejsie API

• Zmiana struktury adnotacji IntDef: zmieniliśmy strukturę definicji wszystkich wyliczeń (np. AdapterType, TextureFormat, BufferUsage, LoadOp itp.). Zostały one przekształcone z publicznych klas adnotacji w prywatne klasy konstruktorów zawierające zagnieżdżoną klasę adnotacji .Type. W związku z tym adnotacje parametrów w całej bibliotece zostały zaktualizowane z @FormatName na @FormatName.Type (np. zmiana @TextureFormat na @TextureFormat.Type).
• Aktualizacje deskryptora widoku tekstury: GPUTextureViewDescriptor akceptuje teraz parametr usage (@TextureUsage.Type), co umożliwia definiowanie konkretnych zastosowań bezpośrednio w widoku tekstury.

Ważna uwaga: dokumentacja udostępniona w tej wersji biblioteki została wygenerowana przy użyciu Google Gemini i może zawierać błędy.

Wersja 1.0.0-alpha04

11 lutego 2026 r.

Publikacja androidx.webgpu:webgpu:1.0.0-alpha04 Wersja 1.0.0-alpha04 zawiera te zmiany.

Nowe funkcje

• Wzorzec konstruktora: wprowadzono statyczne klasy konstruktora dla wszystkich obiektów deskryptora i stanu (np. GPUDeviceDescriptor.Builder, GPURenderPipelineDescriptor.Builder), aby uprościć tworzenie obiektów i poprawić interoperacyjność z językiem Java.
• Rozszerzony pakiet testowy: dodaliśmy więcej testów, w tym testy nowych rozszerzeń do konwersji kolorów, aby zwiększyć stabilność biblioteki.
• Dokumentacja: znacznie ulepszona dokumentacja KDoc i Javadoc w całej bibliotece, zawierająca jaśniejsze definicje typów i flag interfejsu API.

Zmiany w interfejsie API

• Aktualizacje konstruktorów: publiczne konstruktory klas deskryptorów zostały zaktualizowane, aby obsługiwać wzorzec Builder. Wiele przeciążonych konstruktorów zostało usuniętych w celu usprawnienia interfejsu API.

• Aktualizacja Dawn: zaktualizowaliśmy wewnętrzny commit źródłowy Dawn do dc741dd, aby zachować synchronizację z implementacją WebGPU upstream.

• Ważna uwaga: dokumentacja udostępniona w tej wersji biblioteki została wygenerowana przy użyciu Google Gemini i może zawierać błędy.

Poprawki błędów

• Poprawiono nieprawidłową wartość domyślną maski wGPUMultisampleState (I41e86f0b, b/379441904)

Wersja 1.0.0-alpha03

14 stycznia 2026 r.

Publikacja androidx.webgpu:webgpu:1.0.0-alpha03 Wersja 1.0.0-alpha03 zawiera te zmiany.

Nowe funkcje

• Rozszerzony zestaw testów: dodaliśmy bardziej kompleksowe testy, aby zwiększyć stabilność biblioteki.
• Rozszerzenie Color Conversion: dodano funkcje rozszerzenia, które ułatwiają konwertowanie wartości kolorów Androida na GPUColor.
• Ujednolicony interfejs wywołania zwrotnego: dodaliśmy nowy interfejs GPURequestCallback, który umożliwia bardziej spójną obsługę operacji asynchronicznych w całej bibliotece.
• Metadane: biblioteka AAR zawiera teraz w swoich zasobach plik dawn_build_metadata.json. Ten plik zawiera konkretny commit SHA-1 Git Dawn użyty do kompilacji.

Zmiany w interfejsie API

• Konsolidacja wywołań zwrotnych: usunęliśmy kilka konkretnych interfejsów wywołań zwrotnych na rzecz nowego ogólnego interfejsu GPURequestCallback.

Wersja 1.0.0-alpha02

17 grudnia 2025 r.

Publikacja androidx.webgpu:webgpu:1.0.0-alpha02 Wersja 1.0.0-alpha02 zawiera te zmiany.

Nowe funkcje

• Rozszerzony zestaw testów: dodaliśmy bardziej kompleksowe testy, aby zwiększyć stabilność biblioteki.
• Aktualizacja minimalnej wersji pakietu SDK: biblioteka jest teraz dostępna w przypadku minSdk w wersji 24 i nowszych.

Zmiany w interfejsie API

• Zmiana nazwy struktury: wszystkie struktury mają teraz prefiks „GPU”, aby zachować spójność z istniejącymi obiektami. Na przykład BindGroupDescriptor zmienił nazwę na GPUBindGroupDescriptor.
• Globalne opakowywanie metod: globalne funkcje zostały przeniesione do publicznego obiektu GPU, aby zwiększyć przejrzystość i ułatwić organizację w interfejsie Kotlin API.
• Refaktoryzacja obsługi wyjątków: funkcja getException została przeniesiona do obiektu towarzyszącego WebGpuRuntimeException. Zapobiega to uzyskiwaniu przez deweloperów dostępu do wewnętrznej logiki tworzenia wyjątków przy jednoczesnym zachowaniu przejrzystości publicznego interfejsu API.

Wersja 1.0.0-alpha01

3 grudnia 2025 r.

Publikacja androidx.webgpu:webgpu:1.0.0-alpha01 Wersja 1.0.0-alpha01 zawiera te zmiany.

Nowe funkcje

• Jest to początkowa wersja alfa biblioteki WebGPU dla aplikacji na Androida. Na tym etapie jest ona przeznaczona do wersji przedpremierowej dla programistów. Interfejs API powinien zostać ukończony w ciągu kilku najbliższych wersji.