이 페이지는 Cloud Translation API를 통해 번역되었습니다.

그래픽

여러 Android 플랫폼 출시에서 그래픽 기능을 활용합니다.

이 표에는 androidx.graphics 그룹의 모든 아티팩트가 나열됩니다.

아티팩트	안정화 버전	출시 후보 버전	베타 버전	알파 버전
graphics-core	1.0.3	-	-	-
graphics-path	1.0.1	-	-	-
graphics-shapes	1.0.1	-	1.1.0-beta01	-

이 라이브러리는 2025년 7월 30일에 최종 업데이트되었습니다.

종속 항목 선언

Graphics의 종속 항목을 추가하려면 프로젝트에 Google Maven 저장소를 추가해야 합니다. 자세한 내용을 알아보려면 Google Maven 저장소를 읽어보세요.

다음과 같이 앱 또는 모듈의 build.gradle 파일에 필요한 아티팩트의 종속 항목을 추가합니다.

Groovy

dependencies {
    implementation "androidx.graphics:graphics-core:1.0.3"
    implementation "androidx.graphics:graphics-path:1.0.1"
    implementation "androidx.graphics:graphics-shapes:1.1.0-beta01"
}

Kotlin

dependencies {
    implementation("androidx.graphics:graphics-core:1.0.3")
    implementation("androidx.graphics:graphics-path:1.0.1")
    implementation("androidx.graphics:graphics-shapes:1.1.0-beta01")
}

종속 항목에 관한 자세한 내용은 빌드 종속 항목 추가를 참고하세요.

의견

제출하신 의견은 Jetpack을 개선하는 데 도움이 됩니다. 새로운 문제를 발견하거나 라이브러리 개선을 위한 아이디어가 있다면 Google에 알려 주세요. 새 문제를 제출하기 전에 이 라이브러리의 기존 문제를 살펴보시기 바랍니다. 별표 버튼을 클릭하여 기존 문제에 투표할 수 있습니다.

새로운 문제 제출하기

자세한 내용은 Issue Tracker 문서를 참고하세요.

이 아티팩트의 출시 노트는 없습니다.

그래픽 버전 1.1

버전 1.1.0-beta01

2025년 7월 30일

androidx.graphics:graphics-*:1.1.0-beta01이 출시되었습니다. 버전 1.1.0-beta01에는 이 커밋이 포함되어 있습니다.

API 변경사항

Kotlin 2.0으로 출시된 프로젝트를 사용하려면 KGP 2.0.0 이상이 필요합니다 (Idb6b5).
mingwX64, js, wasm 컴파일 타겟 추가 (I2c46a)

버전 1.1.0-alpha01

2024년 12월 11일

androidx.graphics:graphics-*:1.1.0-alpha01이 출시되었습니다. 버전 1.1.0-alpha01에는 이 커밋이 포함되어 있습니다.

새로운 기능

기본 데모를 일반적인 모양 편집기로 리워크했습니다. 이를 통해 SVG 경로에서 도형을 가져오고, 자동 프로세스에서 누락된 경우 감지된 기능을 수동으로 수정하고, 프로덕션 코드에서 사용할 수 있는 코드로 결과를 내보낼 수 있습니다. (I1ac13)
모양 윤곽선 진행률의 각도 측정을 곡선 길이 측정으로 대체하여 더 복잡한 모양을 모핑에 사용할 수 있습니다. (I75478) , I390dd
기능 매핑 알고리즘이 개선되어 더 많은 변형이 더 자연스럽게 표시됩니다. (I83287)

API 변경사항

SVG 경로 가져오기 및 기능 직렬화기 추가 일반적인 흐름은 다음과 같습니다.
- 새 SvgPathParser.parseFeatures()를 사용하여 SVG 경로 (SVG의 path 요소에 있는 d 속성의 값)를 List<Feature>로 변환합니다.
- 그런 다음 FeatureSerializer.serialize()를 사용하여 문자열로 직렬화할 수 있습니다.
- 결과 문자열은 프로덕션 코드에서 사용할 수 있으며 FeatureSerializer.parse()로 가져옵니다.
- 1단계와 2단계는 한 번만 실행하며 새 앱으로 실행할 수 있습니다. 프로덕션 코드는 3단계만 실행하면 됩니다. (I9bd00, b/371196190), (Ic3842), (If68ed), (I10251)
다각형 기능 및 기능 유형을 노출합니다. 이제 List<Features>를 사용하는 기본 생성자로 더 일반적인 RoundedPolygons를 만들 수 있습니다. 기능은 주로 3차 베지어 곡선 목록이지만, 변신 알고리즘이 시작 모양과 끝 모양을 일치시킬 수 있도록 태그가 지정됩니다 (볼록한 모서리는 볼록한 모서리에 매핑되고 오목한 모서리는 오목한 모서리에 매핑됨). (I61e76), (I1fc5c)
watchosDeviceArm64 KMP 타겟 및 타겟 kotlin 1.9 지원을 추가합니다. (Icf15d, b/364652024)

버그 수정

마지막 기능이 비어 있는 경우의 특이 사례가 수정되었습니다. (I390dd)
RoundedPolygon 생성의 안정성 향상 (Ib862c, b/360888486)
RoundedPolygon 초기화의 버그 수정 (I83ddb)
다각형의 중심을 추정하는 알고리즘의 오류를 수정합니다. (Ida147)

그래픽 도형 버전 1.0

버전 1.0.1

2024년 9월 4일

androidx.graphics:graphics-shapes:1.0.1, androidx.graphics:graphics-shapes-android:1.0.1 및 androidx.graphics:graphics-shapes-desktop:1.0.1이 출시되었습니다. 버전 1.0.1에는 이 커밋이 포함되어 있습니다.

버전 1.0.0

2024년 8월 21일

androidx.graphics:graphics-shapes:1.0.0, androidx.graphics:graphics-shapes-android:1.0.0 및 androidx.graphics:graphics-shapes-desktop:1.0.0이 출시되었습니다. 버전 1.0.0에는 이 커밋이 포함되어 있습니다.

버전 1.0.0-rc01

2024년 7월 24일

androidx.graphics:graphics-shapes:1.0.0-rc01, androidx.graphics:graphics-shapes-android:1.0.0-rc01 및 androidx.graphics:graphics-shapes-desktop:1.0.0-rc01이 출시되었습니다. 버전 1.0.0-rc01에는 이 커밋이 포함되어 있습니다.

버전 1.0.0-beta01

2024년 5월 1일

androidx.graphics:graphics-shapes:1.0.0-beta01, androidx.graphics:graphics-shapes-android:1.0.0-beta01 및 androidx.graphics:graphics-shapes-desktop:1.0.0-beta01이 출시되었습니다. 버전 1.0.0-beta01에는 이 커밋이 포함되어 있습니다.

API 변경사항

도형이 다른 지점에서 시작하도록 미리 회전할 수 있습니다. 이 변경사항을 통해 pillStar 도형이 둘레의 기본이 아닌 지점에서 곡선을 시작할 수 있습니다. 이는 도형의 윤곽선에서 특정 위치부터 그리기를 시작하여 도형의 경로 획을 애니메이션으로 만들 때 유용합니다. (Ifbb4d, b/324303807)
RoundedPolygon의 동일한 함수와 병렬인 calculateBounds() 함수를 Morph에 추가했습니다. (I8a3b6, b/325463575)

버전 1.0.0-alpha05

2024년 2월 7일

androidx.graphics:graphics-shapes:1.0.0-alpha05, androidx.graphics:graphics-shapes-android:1.0.0-alpha05 및 androidx.graphics:graphics-shapes-desktop:1.0.0-alpha05이 출시되었습니다. 버전 1.0.0-alpha05에 포함된 커밋을 확인하세요.

새로운 기능

이제 라이브러리에서 이러한 둥근 모양/별 모양을 쉽게 만들 수 있는 새로운 pill() 및 pillStar() 함수를 제공합니다. 모양에 필요한 정확한 경계를 계산하는 새로운 API도 있습니다. 이전 경계는 기본 베지어 곡선 앵커와 제어점을 기반으로 한 추정치일 뿐이었습니다. 또한 컨테이너 내에서 회전하는 경우 컨테이너의 크기를 결정하는 데 도움이 될 수 있는 최대 가능한 경계도 있습니다. (I71827)

API 변경사항

이제 정확한 경계와 최대 경계를 가져오는 옵션이 더 많아졌습니다. (I6d49f, b/317286450)

버그 수정

이러한 도형을 획이 있는 경로로 그릴 때 0 길이 곡선과 관련된 하위 수준 렌더링 문제로 인해 가끔 렌더링 아티팩트가 있었습니다. 이 버그는 도형에 필요하지 않은 길이가 0인 곡선을 모두 제거하여 수정되었습니다. 따라서 도형에서 생성된 경로의 오버헤드도 절약됩니다.

버전 1.0.0-alpha04

2023년 12월 13일

androidx.graphics:graphics-shapes:1.0.0-alpha04, androidx.graphics:graphics-shapes-android:1.0.0-alpha04 및 androidx.graphics:graphics-shapes-desktop:1.0.0-alpha04이 출시되었습니다. 버전 1.0.0-alpha04에 포함된 커밋을 확인하세요.

새로운 기능

이 출시에는 여러 API 변경사항과 버그 수정이 포함되어 있습니다.
API 변경사항의 대부분은 Shapes 라이브러리를 KMP 친화적으로 만듭니다. 이렇게 하면 Android에 구속되지 않는 Compose 코드와 같은 Android가 아닌 코드에서 더 쉽게 호출할 수 있습니다. 예를 들어 이전 PointF, Matrix, Path 유형과 같은 Android 유형이 API에 없습니다.
성능상의 이유로, 특히 객체 할당 (및 수집)을 최소화하기 위해 API와 구현에도 몇 가지 변경사항이 적용되었습니다. 예를 들어 PointF에서 별도의 Float 매개변수로 이동하면 이러한 꼭짓점을 보유하기 위해 임시 PointF 구조를 많이 할당하지 않아도 됩니다.

API 변경사항

Morph.asMutableCubics를 MutableCubics을 반복하는 함수로 대체했습니다. PointTransformer 함수형 인터페이스가 변경되어 이제 Point의 x 및 y 좌표를 가져와 변환된 x 및 y 좌표로 구성된 TransformedResult를 반환합니다(I6719e).
공개 Cubic 생성자가 삭제되고 팩토리 함수가 되었습니다. (I409ce)
Android 전용 변환 및 그리기 API 추가 (I079f6, b/292289543)
Android 종속 항목 제거 (Iadc1c, b/292289543)
이제 앵커 및 제어 속성 이름이 더 합리적입니다 (If13bd, b/294562941).
PointF 매개변수가 Float 쌍으로 변경됨 (Id4705, b/276466399, b/290254314)
이제 progress가 Morph 그리기 명령어에 직접 전달됩니다 (Icdca2).

버그 수정

큰 도형을 만들 때 발생하는 버그가 수정되었습니다. (I4fd66, b/313497325)

버전 1.0.0-alpha03

2023년 6월 7일

androidx.graphics:graphics-shapes:1.0.0-alpha03이 출시되었습니다. 버전 1.0.0-alpha03에 포함된 커밋을 확인하세요.

API 변경사항

새로운 RoundedPolygon.rectangle() 함수 추가 (I78e7e, b/280322189)
이제 Star 및 Circle 함수는 대문자가 아닌 RoundedPolygon의 동반 객체를 통해 호출됩니다.예를 들면 다음과 같습니다. RoundedPolygon.star(...)(I14735)

버그 수정

스무딩 버그 수정 (Ibf894)
시작 도형과 종료 도형이 동일할 때 발생하는 버그를 수정했습니다. 잘라낼 수 있는 측면의 사용 가능한 공간을 더 잘 분배합니다. 먼저 라운딩에 사용 가능한 공간을 사용한 다음 공간이 남으면 스무딩에 사용합니다. (Ibd320, b/277936300)

버전 1.0.0-alpha02

2023년 4월 19일

androidx.graphics:graphics-shapes:1.0.0-alpha02이 출시되었습니다. 버전 1.0.0-alpha02에 포함된 커밋을 확인하세요.

API 변경사항

Polygon 슈퍼클래스가 서브클래스인 RoundedPolygon와 병합되었습니다. 이제 모든 다각형은 [선택적으로] 둥근 다각형입니다.
Star 함수 (이전과 같이 여전히 RoundedPolygon 반환)는 이제 이전의 innerRadiusRatio 매개변수 대신 innerRadius 값을 사용합니다. 이는 기존 반경 매개변수와 동일한 단위이므로 더 간단하고 일관성 있게 사용할 수 있습니다. 또한 내부 및 외부 반지름에 동일한 숫자가 적용됨을 명확히 하기 위해 numOuterVertices 매개변수의 이름이 numVerticesPerRadius로 변경되었습니다.
이전에는 CornerRounding.radius이 다각형의 크기에 상대적인 것으로 문서화되었지만, 상대 값이 아닌 절대 값입니다. 문서가 업데이트되었으며 최대값 1.0으로 제한하는 주석이 수정되었습니다.

버전 1.0.0-alpha01

2023년 4월 5일

그래픽-모양은 둥근 다각형 모양을 쉽게 만들고 렌더링할 수 있을 뿐만 아니라 다양한 모양 간의 간단하고 자동화된 모핑 (애니메이션)을 지원하는 새로운 라이브러리입니다.

androidx.graphics:graphics-shapes:1.0.0-alpha01이 출시되었습니다. 이 버전은 내부 브랜치에서 출시되었습니다.

새로운 기능

Polygon API를 사용하여 원하는 꼭짓점 개수로 일반 다각형과 별 다각형을 만듭니다.
선택사항인 CornerRounding 매개변수를 사용하여 모서리의 반올림 반경과 평활화 매개변수를 지정하면 모서리가 둥근 다각형 모양이 됩니다.
새 Morph(Polygon, Polygon) API를 사용하여 시작 모양과 종료 모양 사이를 애니메이션으로 전환하기 위해 진행률을 0에서 1로 설정할 수 있는 '모핑' 모양을 자동으로 계산합니다. 시간이 지남에 따라 진행률을 애니메이션으로 표시하고 모든 프레임에 결과를 그려 이러한 새로운 둥근 모양 사이의 부드러운 애니메이션을 만듭니다.

그래픽 경로 버전 1.0

버전 1.0.1

2024년 5월 1일

androidx.graphics:graphics-path:1.0.1이 출시되었습니다. 버전 1.0.1에는 이 커밋이 포함되어 있습니다.

버그 수정

컴파일러 플래그가 개선되었습니다.

버전 1.0.0

2024년 3월 6일

androidx.graphics:graphics-path:1.0.0이 출시되었습니다.

버전 1.0.0-rc01

2024년 2월 21일

androidx.graphics:graphics-path:1.0.0-rc01이 출시되었습니다. 버전 1.0.0-rc01에 포함된 커밋을 확인하세요.

버그 수정

API 34 미만에서 PathIterator 성능 개선 (Id4629)

버전 1.0.0-beta02

2024년 1월 10일

이번 출시의 변경사항은 모두 네이티브 코드에서 이루어진 가정으로 인해 필요 이상으로 커진 라이브러리의 크기를 줄이는 데 중점을 두었습니다.

androidx.graphics:graphics-path:1.0.0-beta02이 출시되었습니다. 버전 1.0.0-beta02에 포함된 커밋을 확인하세요.

버그 수정

libandroidx.graphics.path.so의 크기를 96% 줄였습니다. (I71397)
libandroidx.graphics.path.so의 크기를 5% 줄여 줘. (I2da7c)
androidx.graphics:graphics-path의 네이티브 구성요소를 43% 축소했습니다. (I8e40d)

버전 1.0.0-beta01

2023년 11월 29일

androidx.graphics:graphics-path:1.0.0-beta01이 출시되었습니다. 버전 1.0.0-beta01에 포함된 커밋을 확인하세요.

API 변경사항

실험용 isAtLeastU() API 사용을 삭제했습니다. (Ie9117, b/289269026)

버그 수정

라이브러리에서 원뿔을 처리하는 방식을 비롯한 다양한 수정사항과 성능 개선사항

버전 1.0.0-alpha02

2023년 6월 7일

androidx.graphics:graphics-path:1.0.0-alpha02이 출시되었습니다. 이 버전은 내부 브랜치에서 개발되었습니다.

새로운 기능

Android 14 미리보기에서 실행할 때 문제를 일으키는 내부 플랫폼 버전 확인 문제가 수정되었습니다 (버전 확인이 실패하지만 이전 출시에서 작업을 실행하는 메커니즘이 특히 Android 14에서는 제대로 작동하지 않음).

버전 1.0.0-alpha01

2023년 3월 22일

androidx.graphics:graphics-path:1.0.0-alpha01이 출시되었습니다. 버전 1.0.0-alpha01에 포함된 커밋을 확인하세요.

새로운 기능

이 새로운 라이브러리를 사용하면 새로운 PathIterator API를 통해 경로 데이터를 쿼리할 수 있습니다. 호출자는 이 API를 사용하여 Path 객체의 모든 세그먼트를 반복하여 해당 세그먼트의 작업과 데이터를 확인할 수 있습니다.
이 라이브러리는 Android 14 미리보기에서 도입된 유사한 API를 사용하지만 이 AndroidX 버전의 API는 API 21까지의 버전에서도 작동합니다.

그래픽 코어 버전 1.0

버전 1.0.3

2025년 3월 26일

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

버그 수정

API<33인 특정 기기에서 그리는 동안 전체 화면이 깜박이는 문제 수정

버전 1.0.2

2024년 10월 16일

androidx.graphics:graphics-core:1.0.2이 출시되었습니다. 버전 1.0.2에는 이 커밋이 포함되어 있습니다.

버그 수정

SurfaceControl 인스턴스가 출시된 후에도 시스템 컴포지터에서 계속 관리하는 문제가 수정되었습니다.
지연 시간 감소 종속 항목이 삭제된 후 현재 표시된 HardwareBuffer 인스턴스가 해제되지 않는 문제 수정
전면 버퍼 사용 플래그를 지원하지 않는 특정 Android 14 이상 기기에서 깜박임 문제가 수정되었습니다.

버전 1.0.1

2024년 9월 4일

androidx.graphics:graphics-core:1.0.1이 출시되었습니다. 버전 1.0.1에는 이 커밋이 포함되어 있습니다.

버그 수정

메모리 리소스가 가끔 해제되지 않는 문제가 수정되었습니다.

버전 1.0.0

2024년 5월 29일

androidx.graphics:graphics-core:1.0.0이 출시되었습니다. 버전 1.0.0에는 이 커밋이 포함되어 있습니다.

1.0.0의 주요 기능

graphics-core 라이브러리의 공식 안정화 버전입니다. 1.0.0-rc01의 사소한 버그 수정 및 성능 개선사항이 포함됨

버전 1.0.0-rc01

2024년 4월 17일

androidx.graphics:graphics-core:1.0.0-rc01이 출시되었습니다. 이 버전은 내부 브랜치에서 개발되었습니다.

버그 수정

Android 14를 실행하는 특정 Android 기기에서 CanvasBufferedRendererAPI을 사용하여 파일 설명자가 잠재적으로 이중으로 닫히는 문제를 수정했습니다.
FrameBuffer가 프레임 버퍼 인스턴스를 제대로 삭제하지 않는 문제가 수정되었습니다.

버전 1.0.0-beta01

2023년 12월 13일

androidx.graphics:graphics-core:1.0.0-beta01이 출시되었습니다. 버전 1.0.0-beta01에 포함된 커밋을 확인하세요.

새로운 기능

뷰 계층 구조 내에서 Android의 2D 그래픽 API (캔버스 + 페인트)를 사용하여 지연 시간이 짧은 렌더링을 지원하는 새로운 LowLatencyCanvasView API가 도입되었습니다.
HardwareBuffer에 대한 하드웨어 가속 캔버스 렌더링을 지원하는 CanvasBufferedRenderer API가 도입되었습니다. 이를 사용하여 Bitmap.wrapHardwareBuffer API를 사용하여 Bitmap으로 변환할 수 있는 버퍼에 사용자 인터페이스의 일부를 그릴 수 있습니다.

API 변경사항

선택적 울타리 매개변수가 있도록 CanvasBufferRenderer#releaseBuffer API를 업데이트했습니다. RenderResult#fence가 반환되는 경우를 설명하도록 문서를 업데이트했습니다. (If1ea7)
코루틴을 활용하여 그리기 요청을 예약할 수 있도록 draw 메서드를 RenderRequest에 추가 실행기를 사용한 이전 그리기 메서드의 이름을 drawAsync로 변경했습니다. isClosed() 메서드를 속성으로 리팩터링했습니다. (I5bff6)
CanvasFrontBufferRenderer에 버퍼 형식 매개변수를 노출하여 CanvasBufferedRenderer.Builder#setBufferFormat에 직접 매핑 (I0f272)
하드웨어 가속 캔버스 렌더링을 HardwareBuffer로 처리하는 CanvasBufferedRenderer API를 생성했습니다. 이를 통해 스왑체인 깊이 HardwareBuffers의 구성과 함께 Android Q에 백포트된 구현이 제공됩니다. ColorSpace 구성은 여전히 Android U 이상으로 제한되지만 호환성 구현은 개발자를 대신하여 no-op 동작을 제공합니다. (I9b1d8)
원활한 전환 또는 기본 전환을 위한 변경 전략과 함께 프레임 속도를 제어하기 위해 setFrameRate/clearFrameRate API를 SurfaceControlCompat.Transaction에 추가 (I6045c)
setDataSpace의 필수 API 수준을 Android T에서 Android Q로 낮췄습니다. (I59c34)
버퍼가 더 이상 표시되지 않을 때 소비자가 상태를 정리할 수 있도록 GLFrameBufferRenderer API에 onBufferReleased 콜백 추가 (I8a4e2)
뷰 계층 구조 렌더링과 동기화되는 지연 시간이 짧은 콘텐츠 렌더링의 간단한 사용 사례를 지원하기 위해 LowLatencyCanvasView 생성 이렇게 하면 동기화되고 지연 시간이 짧은 렌더링을 위해 각각 화면에서 변환되는 SurfaceView 인스턴스를 내부적으로 관리하여 SurfaceView 관리와 관련된 복잡성이 완화됩니다. (I9253b)
CanvasFrontBufferedRenderer API에 색상 공간 구성 지원이 추가되었습니다. 백 버퍼링된 SurfaceControl도 포함하도록 멀티 버퍼링된 콜백 업데이트 (I24bd9)

버전 1.0.0-alpha05

2023년 9월 6일

androidx.graphics:graphics-core:1.0.0-alpha05이 출시되었습니다. 버전 1.0.0-alpha05에 포함된 커밋을 확인하세요.

새로운 기능

GLFrameBufferRenderer API를 도입했습니다. OpenGL 종속 항목, 스왑 체인 구성, 픽셀 형식, SurfaceControl 구성의 조합을 제공합니다. (Ic775b)

API 변경사항

SurfaceHolder#Callbacks에서 크기를 파이프하도록 다양한 콜백 API에 너비 및 높이 매개변수 추가 (I7f9fc)
전면 및 멀티 버퍼링 레이어를 모두 지우는 명확한 API를 추가했습니다. (Ic1f95)
GLFrontBufferedRenderer 내에서 사용되는 스왑 체인의 기본 버퍼 유형을 구성하는 지원을 추가했습니다. (I07a13)
최대 버퍼 항목의 GLFrameBufferRenderer, IntRange 주석과 setFormat/setUsage의 HardwareBufferFormart, HardwareBufferUsage 주석에 getter용 Kotlin 속성이 추가되었습니다. (Ief89e)
출시 장벽을 제공하기 위해 SurfaceControl 트랜잭션에서 setBuffer API를 업데이트했습니다. (Ice1bb)
데이터 공간을 구성하고 확장 밝기 범위를 설정하는 SurfaceControlCompat.Transaction API를 추가했습니다. (Ic378d)

버전 1.0.0-alpha04

2023년 6월 7일

androidx.graphics:graphics-core:1.0.0-alpha04이 출시되었습니다. 버전 1.0.0-alpha04에 포함된 커밋을 확인하세요.

새로운 기능

기존 OpenGL 구현과 함께 android.graphics.Canvas API를 활용하는 지연 시간이 짧은 그래픽을 지원하기 위해 CanvasFrontBufferedRenderer 도입

API 변경사항

해당 플랫폼 API를 미러링하도록 null 허용 HardwareBuffer 인스턴스를 허용하도록 SurfaceControlCompat.Transaction#setBuffer API가 업데이트되었습니다 (I173d7).
지원 스왑체인에 2개 이상의 버퍼가 포함될 수 있으므로 이중 버퍼 렌더링을 참조하는 메서드를 다중 버퍼로 이름 변경 (I830d7)
캔버스 API를 사용하여 서드 파티가 프런트 버퍼링 렌더링 시스템을 활용할 수 있도록 CanvasFrontBufferedRenderer API 만들기 (Ibfc29)

버그 수정

상응하는 활동을 재개한 후 GLFrontBufferedRenderer가 콘텐츠를 렌더링하지 않는 문제를 수정했습니다.
버퍼링된 전면 콘텐츠가 조기에 삭제되는 문제를 수정했습니다.
지연 시간이 짧은 그래픽 API가 출시된 후 SurfaceHolder.Callbacks가 삭제되지 않는 문제가 수정되었습니다.

버전 1.0.0-alpha03

2023년 3월 22일

androidx.graphics:graphics-core:1.0.0-alpha03이 출시되었습니다. 버전 1.0.0-alpha03에 포함된 커밋을 확인하세요.

API 변경사항

중간 스크래치 버퍼에 렌더링한 후 원래 대상으로 다시 타겟팅하는 데 사용할 수 있는 프레임 버퍼 식별자와 함께 버퍼 너비/높이가 포함된 BufferInfo 객체를 제공하도록 GLFrontBufferedRenderer 콜백 구현을 업데이트했습니다. (I7fe20)
SyncFence 생성을 SyncFenceCompat의 정적 팩토리 메서드로 통합했습니다.
SyncFence 생성을 위한 SyncFenceCompat 팩토리 메서드를 위해 eglDupNativeFenceFDANDROID의 공개 호환성 메서드가 삭제되었습니다. 이는 API 수준과 관계없이 모든 API 노출 영역이 올바른 SyncFence 구현을 수신하도록 하기 위한 것입니다. (I849bb)
FrameBufferRenderer 및 SyncStrategy에 관한 문서가 추가되었습니다.
- FrameBufferRenderer, FrameBuffer, FrameBufferPool를 androidx.graphics.opengl 패키지로 이동
- SyncStrategy을 androidx.graphics.opengl 패키지로 이동
- 업데이트된 RenderCallback#onDraw 문서
- API 구현자가 FrameBuffer.close를 호출해야 한다는 RenderCallback#obtainFrameBuffer 문서 업데이트
- 소비자가 표시할 콘텐츠를 디스패치해야 함을 나타내도록 onDrawComplete 업데이트
- 프레임워크를 미러링하기 위해 SyncFence 호환성 인터페이스/클래스를 androidx.hardware 패키지로 이동
- SyncFence API의 이름을 SyncFenceV19로 변경하고 비공개로 설정하여 가능한 경우 프레임워크의 SyncFence API를 활용하는 SyncFenceCompat로 사용을 통합했습니다. (I5149c)
GLFrontBufferedRenderer#cancel 및 GLFrontBufferedRenderer#execute 메서드가 추가되었습니다. 전자는 전면 버퍼로의 렌더링을 취소하고 전면 버퍼를 숨겨야 하는 손바닥 감지 시나리오에서 유용합니다. 후자는 렌더링을 예약하지 않고 GL 스레드에서 객체를 조작하는 시나리오에서 유용합니다. (If0b7f)
이중 버퍼링된 레이어에 직접 렌더링하는 API 추가 이를 통해 재개 후 장면을 다시 렌더링할 수 있으며 소비자가 렌더링할 원하는 장면을 기반으로 전면 버퍼링된 렌더링을 활용할 시기를 선택적으로 결정할 수 있습니다. (Ied56c)
SurfaceView의 기존 메커니즘 외에 다른 SurfaceControl 인스턴스에서 상위 SurfaceControl를 구성할 수 있도록 SurfaceControlCompat.Builder에 새 API가 추가되었습니다. (I1d1b6)
지원 중단된 숨겨진 함수의 반환 유형 null 허용 여부를 더 추가했습니다. (Ibf7b0)
Android 기기에서 HardwareBuffer 인스턴스를 EGLImage 인스턴스로 사용할 수 있는 EGLClientBuffer 객체로 가져오기를 지원하는지 쿼리하는 EGL_ANDROID_get_native_client_buffer 확장 프로그램 상수를 추가했습니다. (Iad767)
@JvmDefaultWithCompatibility 주석을 추가합니다. (I8f206)

버전 1.0.0-alpha02

2022년 11월 9일

androidx.graphics:graphics-core:1.0.0-alpha02가 출시되었습니다. 버전 1.0.0-alpha02에 포함된 커밋을 확인하세요.

API 변경사항

Android S에서 도입되었던 addTransactionCommitListener의 RequiresApi 주석이 누락되는 문제를 수정했습니다. (I0a035)
소비자가 현재 버퍼 너비/높이 외에도 꼭짓점 셰이더에 전달할 수 있는 변환 매트릭스를 제공하도록 onDraw<Front/Double> 버퍼 콜백을 업데이트했습니다. 소비자는 이러한 매개변수를 사용하여 OpenGL 렌더링 코드를 적절하게 사전에 회전해야 합니다. (I82f9e)

버그 수정

SurfaceControl 트랜잭션을 실행하기 전에 버퍼를 사전 회전하여 그래픽 지연 시간을 개선했습니다.
오류 로그에 오류 300d(EGL_BAD_SURFACE)가 표시되는 문제를 수정했습니다.
이전에 사용된 상응하는 활동이 재개된 후 GLFrontBufferedRenderer가 무효화되는 문제를 수정했습니다.
에뮬레이터 및 ChromeOS 기기 지원을 늘렸습니다.
버퍼링된 전면 레이어가 조기에 숨겨질 수 있는 문제를 수정했습니다.

버전 1.0.0-alpha01

2022년 10월 24일

androidx.graphics:graphics-core:1.0.0-alpha01이 출시되었습니다. 버전 1.0.0-alpha01에 포함된 커밋을 확인하세요.

새로운 기능

그래픽 코어 AndroidX 라이브러리의 최초 출시입니다. 여기에는 스타일러스 입력과 같이 지연 시간이 짧은 사용 사례를 지원하는 API가 포함됩니다. OpenGL 사용에 관한 도우미 API도 추가되었습니다.

API 변경사항

짧은 지연 시간과 고품질 렌더링 출력을 모두 달성하도록 전면 및 다중 버퍼 렌더링을 지원하는 GLFrontBufferedRenderer를 도입합니다.
SurfaceView, TextureView 등 다양한 Surface 제공업체를 위한 OpenGL 렌더링을 지원하는 GLRenderer API를 도입합니다.