webgpu

  
適用於 Kotlin 的現代 GPU API，可用於圖像和運算。
最近更新時間 穩定版 候選版 Beta 版 Alpha 版
2026 年 4 月 22 日 - - - 1.0.0-alpha05

宣告依附元件

如要為 Webgpu 新增依附元件，必須將 Google Maven 存放區新增至專案。詳情請參閱 Google 的 Maven 存放區。

在應用程式或模組的 build.gradle 檔案中，新增所需構件的依附元件：

Groovy

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

Kotlin

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

如要進一步瞭解依附元件，請參閱「新增建構依附元件」一文。

意見回饋

您的意見可協助我們改善 Jetpack。如果您發現新問題，或是有改進這個程式庫的建議，請告訴我們。回報新問題前，請先查看這個程式庫的現有問題。只要按一下星號按鈕，即可投票給現有的問題。

建立新問題

詳情請參閱 Issue Tracker 文件。

這個構件沒有任何版本資訊。

Webgpu 1.0 版

1.0.0-alpha05 版本

2026 年 4 月 22 日

發布 androidx.webgpu:webgpu:1.0.0-alpha05。1.0.0-alpha05 版包含這些修訂項目。

新功能和常數

  • 相容模式限制

    • 新增 GPUCompatibilityModeLimits (和對應的 Builder)，專門定義相容性模式的限制。
    • 包括 maxStorageBuffersInVertexStage 和 maxStorageTexturesInFragmentStage 等特定限制。
    • 這個物件已整合為 GPULimits 中的選用屬性。

  • 紋理繫結檢視區塊維度

    • 新增 GPUTextureBindingViewDimension，可更精細地控管紋理檢視區塊繫結。
    • 現在可以在 GPUTextureDescriptor 中指定這些項目。

  • 新常數和支援的功能

    • TextureUsage：新增 TransientAttachment。
    • WGSLLanguageFeatureName：
      • 新增了 SubgroupUniformity。
      • 新增了 TextureFormatsTier1。
    • SType：新增下列項目：
      • ExternalTextureBindingLayout
      • ExternalTextureBindingEntry
      • CompatibilityModeLimits
      • TextureBindingViewDimension

API 變更

  • IntDef 註解重構：所有列舉 (例如 AdapterType、TextureFormat、BufferUsage、LoadOp 等) 的結構定義都會重構。這些類別已從公開註解類別轉換為私有建構函式類別，其中包含巢狀 .Type 註解類別。因此，程式庫中的參數註解已從 @FormatName 更新為 @FormatName.Type (例如將 @TextureFormat 變更為 @TextureFormat.Type)。
  • 紋理檢視區塊描述元更新： GPUTextureViewDescriptor 現在接受 usage 參數 (@TextureUsage.Type)，可直接在紋理檢視區塊上定義特定用途。

重要注意事項：本程式庫版本提供的文件是使用 Google Gemini 生成，可能含有錯誤。

1.0.0-alpha04 版本

2026 年 2 月 11 日

發布 androidx.webgpu:webgpu:1.0.0-alpha04。1.0.0-alpha04 版包含這些修訂項目。

新功能

  • 建構工具模式：為所有描述元和狀態物件 (例如 GPUDeviceDescriptor.Builder、GPURenderPipelineDescriptor.Builder) 導入靜態建構工具類別，簡化物件建構作業並提升 Java 互通性。
  • 擴充測試套件：新增更多測試，包括新的顏色轉換擴充功能，以提升程式庫穩定性。
  • 說明文件：大幅改善整個程式庫的 KDoc 和 Javadoc，提供更清楚的 API 類型和旗標定義。

API 變更

  • 建構函式更新：描述元類別的公開建構函式已更新，可支援建構工具模式；為簡化 API，許多多載建構函式已移除。

  • Dawn 更新：內部 Dawn 來源提交內容已更新為 dc741dd，與上游 WebGPU 實作項目保持同步。

  • 重要注意事項：本程式庫版本提供的文件是使用 Google Gemini 生成，可能含有錯誤。

修正錯誤

1.0.0-alpha03 版本

2026 年 1 月 14 日

發布 androidx.webgpu:webgpu:1.0.0-alpha03。1.0.0-alpha03 版包含這些修訂項目。

新功能

  • 擴充測試套件：新增更全面的測試，提升程式庫穩定性。
  • 顏色轉換擴充功能：新增擴充功能函式，可輕鬆將 Android 顏色值轉換為 GPUColor。
  • 統一回呼介面：新增了 GPURequestCallback 介面，可在整個程式庫中更一致地處理非同步作業。
  • 中繼資料：程式庫 AAR 現在的資產中包含 dawn_build_metadata.json 檔案。這個檔案包含用於建構的特定 Dawn Git SHA-1 修訂版本。

API 變更

  • 回呼整合：我們已移除多個特定回呼介面，並改用新的泛型 GPURequestCallback。

1.0.0-alpha02 版

2025 年 12 月 17 日

發布 androidx.webgpu:webgpu:1.0.0-alpha02。1.0.0-alpha02 版包含這些修訂項目。

新功能

  • 擴大測試套件：新增更全面的測試，提升程式庫穩定性。
  • 最低 SDK 版本更新：程式庫現在適用於 minSdk 24 以上版本。

API 變更

  • 結構體重新命名：所有結構體現在都會加上「GPU」前置字元，與現有物件保持一致。舉例來說，BindGroupDescriptor 已重新命名為 GPUBindGroupDescriptor。
  • 全域方法包裝：全域函式已移至公開 GPU 物件，方便在 Kotlin API 中清楚瞭解及整理。
  • 例外狀況處理重構：將 getException 函式移至 WebGpuRuntimeException 伴隨物件，使其內部化。這樣一來，開發人員就無法存取內部例外狀況建立邏輯，同時維持乾淨的公用 API 介面。

1.0.0-alpha01 版

2025 年 12 月 3 日

發布 androidx.webgpu:webgpu:1.0.0-alpha01。1.0.0-alpha01 版包含這些修訂項目。

新功能

  • 這是 Android 應用程式專用 WebGPU 程式庫的初始 Alpha 版。目前僅適用於開發人員預覽版。我們預計在接下來的幾個版本中完成 API。