webgpu

Kotlin에서 그래픽과 컴퓨팅을 위한 최신 GPU API입니다.

최근 업데이트	안정화 버전	출시 후보 버전	베타 버전	알파 버전
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을 개선하는 데 도움이 됩니다. 새로운 문제를 발견하거나 라이브러리 개선을 위한 아이디어가 있다면 Google에 알려 주세요. 새 문제를 제출하기 전에 이 라이브러리의 기존 문제를 살펴보시기 바랍니다. 별표 버튼을 클릭하여 기존 문제에 투표할 수 있습니다.

새로운 문제 제출하기

자세한 내용은 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에는 이러한 커밋이 포함되어 있습니다.

새로운 기능

빌더 패턴: 객체 구성을 간소화하고 Java 상호 운용성을 개선하기 위해 모든 설명자 및 상태 객체 (예: GPUDeviceDescriptor.Builder, GPURenderPipelineDescriptor.Builder)에 정적 빌더 클래스가 도입되었습니다.
테스트 모음 확장: 라이브러리 안정성을 개선하기 위해 새로운 색상 변환 확장 프로그램을 포함한 테스트를 추가했습니다.
문서: 라이브러리 전반에서 KDoc 및 Javadoc이 크게 개선되어 API 유형과 플래그에 대한 정의가 더 명확해졌습니다.

API 변경사항

생성자 업데이트: 설명자 클래스의 공개 생성자가 빌더 패턴을 지원하도록 업데이트되었습니다. API를 간소화하기 위해 오버로드된 생성자가 많이 삭제되었습니다.
Dawn 업데이트: 업스트림 WebGPU 구현과 동기화되도록 내부 Dawn 소스 커밋을 dc741dd로 업데이트했습니다.
중요: 이 라이브러리 출시에서 제공되는 문서는 Google Gemini를 사용하여 생성되었으며 오류가 포함될 수 있습니다.

버그 수정

GPUMultisampleState의 마스크 기본값이 잘못된 문제 수정 (I41e86f0b, b/379441904)

버전 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로 바뀌었습니다.
전역 메서드 래핑: Kotlin API 내에서 명확성과 조직을 개선하기 위해 전역 함수가 공개 GPU 객체로 이동되었습니다.
예외 처리 리팩터링: getException 함수를 WebGpuRuntimeException 컴패니언 객체로 이동하여 내부화했습니다. 이렇게 하면 개발자가 내부 예외 생성 로직에 액세스하지 못하도록 하면서 깔끔한 공개 API 노출 영역을 유지할 수 있습니다.

버전 1.0.0-alpha01

2025년 12월 3일

androidx.webgpu:webgpu:1.0.0-alpha01이 출시되었습니다. 버전 1.0.0-alpha01에는 이러한 커밋이 포함되어 있습니다.

새로운 기능

Android 애플리케이션용 WebGPU 라이브러리의 초기 알파 버전입니다. 이 단계에서는 개발자 프리뷰를 대상으로 합니다. 이 API는 향후 몇 번의 출시를 통해 최종 확정될 예정입니다.