Android 게임

Android 게임 라이브러리는 바이너리 다운로드로 제공되는 Android 게임 SDK를 미러링합니다. Android 게임 SDK를 수동으로 다운로드하여 빌드에 통합하는 대신 androidx 라이브러리를 사용할 수 있습니다.

Android 게임 SDK에 관한 자세한 내용은 SDK 문서 및 SDK 출시 노트를 참고하세요.

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

아티팩트 안정화 버전 출시 후보 버전 베타 버전 알파 버전
games-activity 4.0.0 - - 4.2.0-alpha01
games-controller 2.0.2 - - 2.2.0-alpha01
games-frame-pacing 2.1.3 - - 2.3.0-alpha01
games-memory-advice 2.0.1 - 2.1.0-beta01 2.2.0-alpha01
games-text-input 4.0.0 - - 4.2.0-alpha01
games-performance-tuner 2.0.0 - - 2.2.0-alpha01
이 라이브러리는 2025년 7월 2일에 최종 업데이트되었습니다.

요구사항

games-memory-advice

MemoryAdvice API를 사용하려면 NDK 버전 r23.* 이상으로 애플리케이션을 빌드해야 합니다.

종속 항목 선언

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

다음과 같이 앱 또는 모듈의 build.gradle 파일에 필요한 아티팩트의 종속 항목을 추가합니다. games-activity 라이브러리는 game-text-input 라이브러리의 동일한 버전을 통합했으므로 GameActivity 앱은 game-text-input 종속 항목을 다시 포함할 수 없습니다.

Groovy

android {
    ...
    // To use the Android Frame Pacing or Android Performance Tuner libraries, enable
    // native dependencies to be imported. Libraries will be made available to your CMake build
    // as packages named "games-frame-pacing" and "games-performance-tuner".
    buildFeatures {
        prefab true
    }
}

dependencies {
    // To use the Android Frame Pacing library
    implementation "androidx.games:games-frame-pacing:2.1.3"

    // To use the Android Performance Tuner
    implementation "androidx.games:games-performance-tuner:2.0.0"

    // To use the Games Activity library
    implementation "androidx.games:games-activity:4.0.0"

    // To use the Games Controller Library
    implementation "androidx.games:games-controller:2.0.2"

    // To use the Games Text Input Library
    // Do not include this if games-activity has been included
    implementation "androidx.games:games-text-input:4.0.0"
}

Kotlin

android {
    ...
    // To use the Android Frame Pacing or Android Performance Tuner libraries, enable
    // native dependencies to be imported. Libraries will be made available to your CMake build
    // as packages named "games-frame-pacing" and "games-performance-tuner".
    buildFeatures {
        prefab = true
    }
}

dependencies {
    // To use the Android Frame Pacing library
    implementation("androidx.games:games-frame-pacing:2.1.3")

    // To use the Android Performance Tuner
    implementation("androidx.games:games-performance-tuner:2.0.0")

    // To use the Games Activity library
    implementation("androidx.games:games-activity:4.0.0")

    // To use the Games Controller Library
    implementation("androidx.games:games-controller:2.0.2")

    // To use the Games Text Input Library
    // Do not include this if games-activity has been included
    implementation("androidx.games:games-text-input:4.0.0")
}
}

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

Gradle 속성 추가

앱(또는 모듈)의 build.gradle 파일과 동일한 디렉터리에 있는 gradle.properties 파일에 속성을 추가해야 할 수 있습니다. gradle.properties 파일이 없으면 만드세요.

Android 스튜디오 4.0을 사용하는 경우 gradle.properties에 다음 줄이 포함되어 있는지 확인합니다.

# Enables experimental Prefab
android.enablePrefab=true
# Tell Android Studio we are using AndroidX
android.useAndroidX=true

Android 스튜디오 4.1 이상을 사용하는 경우 gradle.properties에 다음 줄이 포함되어 있는지 확인합니다.

# Tell Android Studio we are using AndroidX
android.useAndroidX=true

CMake로 패키지 추가

가져온 게임 SDK 패키지를 제공하려면 기본 앱의 CMakeLists.txt 파일에 다음을 추가합니다.

# Add the packages from the Android Game SDK
find_package(games-frame-pacing REQUIRED CONFIG)
find_package(games-performance-tuner REQUIRED CONFIG)

이렇게 하면 Android 게임 SDK의 헤더 파일을 게임 코드에 포함할 수 있습니다.

#include "swappy/swappyGL.h"
#include "tuningfork/tuningfork.h"

기본 앱의 CMakeLists.txt 파일에서 기본 공유 라이브러리의 target_link_libraries를 찾습니다. 다음과 같이 Android 게임 SDK 정적 라이브러리에 대한 참조를 추가하여 공유 라이브러리에 포함합니다.

target_link_libraries(...
  games-frame-pacing::swappy_static
  games-performance-tuner::tuningfork_static
  ...)

의견

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

새로운 문제 제출하기

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

Games-Memory-Advice 버전 2.1

버전 2.1.0-beta01

2023년 11월 29일

androidx.games:games-memory-advice:2.1.0-beta01이 출시되었습니다. 버전 2.1.0-beta01에 포함된 커밋을 확인하세요.

버전 2.1.0-alpha01

2023년 11월 15일

androidx.games:games-memory-advice:2.1.0-alpha01이 출시되었습니다. 버전 2.1.0-alpha01에 포함된 커밋을 확인하세요.

새로운 기능

  • 더 나은 예측을 위해 라이브러리의 메모리 모델을 업데이트했습니다.

API 변경사항

  • 안전하게 할당할 수 있는 메모리 양의 추정치를 바이트 단위로 반환하는 새 API getAvailableMemory()를 추가했습니다.

버전 2.1.0-alpha01

2023년 7월 26일

androidx.games:games-memory-advice:2.1.0-alpha01이 출시되었습니다. 버전 2.1.0-alpha01에 포함된 커밋을 확인하세요.

API 변경사항

  • GetAvailableMemory 함수 추가

버그 수정

  • 메모리 권장 모델 업데이트
  • 공유 memory_advice 빌드 타겟 수정

Games-Memory-Advice 버전 2.0

버전 2.0.1

2023년 9월 20일

androidx.games:games-memory-advice:2.0.1이 출시되었습니다. 버전 2.0.1에 포함된 커밋을 확인하세요.

버그 수정

  • 스레드가 JVM에 연결되지 않아 상태 감시자 스레드에서 발생하는 비정상 종료 수정

버전 2.0.0

2023년 9월 6일

androidx.games:games-memory-advice:2.0.0이 출시되었습니다. 버전 2.0.0에 포함된 커밋을 확인하세요.

2.0.0의 주요 기능

  • 이 버전에서는 새로운 ML 모델이 학습되고 출시되었습니다.
  • 여유 메모리 양을 예측하는 API가 구현됩니다.

버전 2.0.0-rc01

2023년 7월 26일

androidx.games:games-memory-advice:2.0.0-rc01이 출시되었습니다. 버전 2.0.0-rc01에 포함된 커밋을 확인하세요.

새로운 기능

  • 남은 메모리를 더 잘 예측할 수 있는 새로운 모델이 포함되었습니다.

버그 수정

  • 공유 STL에서 메모리 조언이 작동하지 않는 문제 수정

버전 2.0.0-beta04

2023년 5월 24일

androidx.games:games-memory-advice:2.0.0-beta04이 출시되었습니다. 버전 2.0.0-beta04에 포함된 커밋을 확인하세요.

새로운 기능

  • 라이브러리를 지원하는 머신러닝 모델이 업데이트되어 최신 휴대전화의 결과가 개선됩니다.

버전 2.0.0-beta03

2023년 4월 5일

androidx.games:games-memory-advice:2.0.0-beta03이 출시되었습니다. 버전 2.0.0-beta03에 포함된 커밋을 확인하세요.

버그 수정

  • 라이브러리에서 필요한 TensorFlow Lite 애셋을 제대로 로드할 수 없는 버그가 수정되었습니다.

버전 2.0.0-beta02

2023년 3월 22일

androidx.games:games-memory-advice:2.0.0-beta02이 출시되었습니다. 버전 2.0.0-beta02에 포함된 커밋을 확인하세요.

버그 수정

  • 라이브러리의 정적 버전이 올바르게 연결되지 않는 버그가 수정되었습니다.

버전 2.0.0-beta01

2023년 2월 22일

androidx.games:games-memory-advice:2.0.0-beta01이 출시되었습니다. 버전 2.0.0-beta01에 포함된 커밋을 확인하세요.

새로운 기능

  • 새로운 변경사항이 없음

버전 2.0.0-alpha01

2023년 2월 8일

androidx.games:games-memory-advice:2.0.0-alpha01이 출시되었습니다. 버전 2.0.0-alpha01에 포함된 커밋을 확인하세요.

API 변경사항

  • 빌드 파일 리팩터링으로 인해 메이저 버전이 증가했습니다.

버그 수정

  • 이제 라이브러리 애셋 구성이 잘못된 경우 비정상 종료되는 대신 오류가 발생합니다.

Games-Memory-Advice 버전 1.0.0

버전 1.0.0-beta03

2022년 11월 9일

androidx.games:games-memory-advice:1.0.0-beta03이 출시되었습니다. 버전 1.0.0-beta03에 포함된 커밋을 확인하세요.

새로운 기능

  • 새로운 변경사항이 없음

버전 1.0.0-beta01

2022년 3월 9일

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

  • 1.0.0-alpha01 이후 변경사항 없음

버전 1.0.0-alpha01

2022년 2월 23일

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

새로운 기능

  • 이 C 라이브러리는 게임을 실행하는 기기의 메모리 상태 변경사항에 관한 콜백을 쿼리하고 수신하는 기능을 제공합니다.

API 변경사항

  • 이 버전은 메모리 도움말 라이브러리의 최초 출시입니다. 전체 API는 include/memory_advice/memory_advice.h에서 헤더를 참고하세요.

외부 기여

Games-Text-Input 버전 3.0

버전 3.0.4

2024년 8월 7일

androidx.games:games-text-input:3.0.4이 출시되었습니다. 버전 3.0.4에는 이러한 커밋이 포함되어 있습니다.

버그 수정

  • 텍스트 선택 여부에 따른 삭제 기능을 수정했습니다.

Games-Activity 버전 4.0

버전 4.2.0-alpha01

2025년 3월 26일

androidx.games:games-activity:4.2.0-alpha01 및 androidx.games:games-text-input:4.2.0-alpha01이 출시되었습니다. 버전 4.2.0-alpha01에는 이 커밋이 포함되어 있습니다.

새로운 기능

  • Gradle 8.8.1 (1ed0153)로 업그레이드
  • Java 17로 업그레이드 (1ed0153)

버그 수정

  • getLocaleScript, getLocaleCountry, getLocaleVariant가 요청된 값 대신 언어 언어를 보고하는 GameActivity의 버그 수정 (1198bb0)
  • 소프트웨어 키보드 열기-닫기 이벤트를 잘못 보고하는 GameActivity의 버그를 수정했습니다. (a63ecca)
  • 멀티바이트 이모티콘 처리와 관련된 GameTextInput의 버그 수정 (9d54c68)

버전 4.0.0

2025년 2월 12일

androidx.games:games-activity:4.0.0 및 androidx.games:games-text-input:4.0.0이 출시되었습니다. 버전 4.0.0에는 이러한 커밋이 포함되어 있습니다.

4.0.0의 주요 기능

  • 이제 AAR 파일에 사전 빌드된 정적 라이브러리가 포함됩니다. 이제 애플리케이션 코드는 미리 빌드된 라이브러리를 통해 이러한 라이브러리를 사용하고 구현 (예: #include "GameActivity.cpp")을 포함하는 대신 헤더 (예: #include "GameActivity.h")만 포함해야 합니다.
  • 이제 GameActivity를 사용하는 네이티브 코드에서 Android 언어 정보도 사용할 수 있습니다.

버그 수정

  • GameTextInput의 여러 버그가 수정되었습니다. 이제 라이브러리가 더 안정적이며 널리 사용되는 다양한 소프트웨어 및 하드웨어 키보드와 호환됩니다.

버전 4.0.0-rc01

2025년 1월 29일

androidx.games:games-activity:4.0.0-rc01 및 androidx.games:games-text-input:4.0.0-rc01이 출시되었습니다. 버전 4.0.0-rc01에는 이러한 커밋이 포함되어 있습니다.

버전 4.0.0-beta01

2025년 1월 15일

androidx.games:games-activity:4.0.0-beta01 및 androidx.games:games-text-input:4.0.0-beta01이 출시되었습니다. 버전 4.0.0-beta01에는 이 커밋이 포함되어 있습니다.

버그 수정

  • 새로 추가된 언어 관련 기능이 더 잘 문서화되었습니다.
  • 모든 열거형 유형에 지원 유형이 추가되었습니다.

버전 4.0.0-alpha01

2024년 10월 16일

androidx.games:games-activity:4.0.0-alpha01 및 androidx.games:games-text-input:4.0.0-alpha01이 출시되었습니다. 버전 4.0.0-alpha01에는 이 커밋이 포함되어 있습니다.

새로운 기능

  • 이제 GameTextInput에서 왼쪽/오른쪽 키를 지원합니다.

API 변경사항

  • GameTextInput의 오래된 Java 인터페이스가 삭제되었습니다.
  • 이제 GameActivity 및 GameTextInput의 프리팹에 모든 소스 파일이 포함됩니다. #include <GameActivity.cpp>는 더 이상 권장되지 않습니다. 대신 CMake의 game-activity::game-activity_static과 같은 적절한 정적 또는 동적 라이브러리에 연결하세요. 이러한 라이브러리는 AAR 파일로 제공됩니다.

버그 수정

  • GameTextInput에서 여러 가지 수정사항이 적용되었습니다. 입력 및 삭제 기능이 수정되었습니다.
  • 가장 인기 있는 소프트웨어 키보드와의 호환성이 개선되었습니다.
  • 하드웨어 키보드에서 특수문자 처리 문제 수정
  • GameActivity에서 드물게 발생하는 null 포인터 액세스를 수정했습니다.

Games-Activity 버전 3.0

버전 3.0.5

2024년 8월 7일

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

버그 수정

  • GameTextInput 3.0.4 출시와 일치하도록 GameActivity의 새 버전 출시 (입력에서 텍스트 삭제 기능 수정)

버전 3.0.4

2024년 7월 10일

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

버그 수정

  • null 포인터 처리가 수정되었습니다.
  • onConfiguration() 콜백에서 일부 상태의 상태 업데이트가 누락되는 문제를 수정했습니다.

버전 3.0.3

2024년 4월 17일

androidx.games:games-activity:3.0.3 및 androidx.games:games-text-input:3.0.3이 출시되었습니다. 버전 3.0.3에는 이러한 커밋이 포함되어 있습니다.

버그 수정

  • 일부 소프트웨어 키보드와의 호환성 문제가 해결되었습니다.

버전 3.0.2

2024년 4월 3일

androidx.games:games-activity:3.0.2 및 androidx.games:games-text-input:3.0.2이 출시되었습니다. 버전 3.0.2에는 이러한 커밋이 포함되어 있습니다.

버그 수정

  • 소프트웨어 및 하드웨어 키보드 지원을 개선하기 위해 GamesTextInput에 몇 가지 수정사항이 적용되었습니다. 또한 GameActivity 없이 GameTextInput를 사용하지 못하도록 하는 버그가 수정되었습니다.

버전 3.0.1

2024년 3월 20일

androidx.games:games-activity:3.0.1 및 androidx.games:games-text-input:3.0.1이 출시되었습니다. 버전 3.0.1에는 이러한 커밋이 포함되어 있습니다.

버그 수정

  • 특수문자가 입력되고 표시되는 문제가 수정되었습니다.

버전 3.0.0

2024년 3월 6일

androidx.games:games-activity:3.0.0 및 androidx.games:games-text-input:3.0.0이 출시되었습니다. 버전 3.0.0에는 이 커밋이 포함되어 있습니다.

3.0.0의 주요 기능

  • GameTextInput이 게임에서 사용할 수 있도록 리워크되었습니다.
  • 두 라이브러리의 일부 인터페이스가 버전 2.0.0에 따라 변경되었습니다.

버그 수정

  • 이전 NDK와의 호환성 문제 수정
  • Windows 빌드 문제 수정

버전 3.0.0-rc01

2024년 2월 21일

androidx.games:games-activity:3.0.0-rc01 및 androidx.games:games-text-input:3.0.0-rc01이 출시되었습니다. 버전 3.0.0-rc01에 포함된 커밋을 확인하세요.

버그 수정

  • 키보드 이벤트가 루퍼에 의해 제대로 처리되지 않아 발생하는 정지 문제가 수정되었습니다.

버전 3.0.0-beta01

2023년 11월 29일

androidx.games:games-activity:3.0.0-beta01 및 androidx.games:games-text-input:3.0.0-beta01이 출시되었습니다. 버전 3.0.0-beta01에 포함된 커밋을 확인하세요.

버전 3.0.0-alpha01

2023년 11월 15일

androidx.games:games-activity:3.0.0-alpha01 및 androidx.games:games-text-input:3.0.0-alpha01이 출시되었습니다. 버전 3.0.0-alpha01에 포함된 커밋을 확인하세요.

API 변경사항

  • GameActivityMotionEvent 및 GameActivityCallbacks 구조의 크기가 변경되었습니다.
  • onEditorAction의 반환 유형이 불리언에서 void로 변경됩니다.
  • 이제 setImeEditorInfo은(는) 정수가 아닌 enum 매개변수를 예상합니다.
  • GameActivityEvents의 내부 함수가 GameActivityEvents_internal.h로 이동됩니다.
  • GameTextInput의 입력 유형도 정수가 아닌 열거형입니다.

Games-Activity 버전 2.1

버전 2.1.0-alpha02

2023년 9월 6일

androidx.games:games-activity:2.1.0-alpha02 및 androidx.games:games-text-input:2.1.0-alpha02이 출시되었습니다. 버전 2.1.0-alpha02에 포함된 커밋을 확인하세요.

버그 수정

  • 32비트 기기 호환성이 개선되었습니다.

버전 2.1.0-alpha01

2023년 7월 26일

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

새로운 기능

  • SurfaceView 인스턴스 생성을 재정의하는 기능 제공
  • SDK 버전 보고 추가

API 변경사항

  • 32비트 시스템에서 오버런을 방지하기 위해 historicalEventTimes에 long 대신 int64_t 사용
  • GameActivity_restartInput 메서드 추가
  • 소프트웨어 키보드 표시 상태 변경을 처리하는 네이티브 콜백 추가

버그 수정

  • 터치 이벤트 처리 최적화
  • GameActivityMotionEven의 올바른 소멸
  • GameActivityMotionEvent_getHistoricalAxisValue 색인 계산 수정
  • 동작 필터의 비트 마스크 수정

Games-Activity 버전 2.0

버전 2.0.2

2023년 5월 24일

androidx.games:games-activity:2.0.2이 출시되었습니다. 버전 2.0.2에 포함된 커밋을 확인하세요.

버그 수정

버전 2.0.1

2023년 4월 5일

androidx.games:games-activity:2.0.1이 출시되었습니다. 버전 2.0.1에 포함된 커밋을 확인하세요.

버그 수정

  • historicalEventTimes를 사용한 메모리 조기 해제를 수정했습니다.
  • 32비트 시스템에서 historicalEventTimesNanos이 오버플로되는 문제 수정

버전 2.0.0

2023년 3월 8일

androidx.games:games-activity:2.0.0이 출시되었습니다. 버전 2.0.0에 포함된 커밋을 확인하세요.

2.0.0의 주요 기능

  • 32비트 제한을 극복하기 위해 이전 이벤트 시간의 인터페이스가 변경되었습니다.
  • 방향과 같은 구성 변경에 대한 사용자 액세스를 제공했습니다.
  • contentRect 구조에 최신 정보를 제공했습니다.
  • 기본 SurfaceView를 더 쉽게 맞춤설정할 수 있는 방법을 제공했습니다.
  • 시스템 버튼 처리와 같은 터치 이벤트의 기본 OS 처리를 수정했습니다.
  • 터치 이벤트 처리에서 대부분의 JNI 호출이 최적화되었습니다. 이전에는 성능에 영향을 미쳤습니다.

버전 2.0.0-rc01

2023년 2월 22일

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

버전 2.0.0-beta01

2023년 2월 8일

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

버그 수정

  • 시스템 버튼 처리를 수정했습니다. (2a103e)

버전 2.0.0-alpha01

2023년 1월 11일

androidx.games:games-activity:2.0.0-alpha01은 변경사항 없이 출시되었습니다. 버전 2.0.0-alpha01에 포함된 커밋을 확인하세요.

Games-Activity 버전 1.2

버전 1.2.2

2022년 12월 7일

androidx.games:games-activity:1.2.2가 출시되었습니다. 버전 1.2.2에 포함된 커밋을 확인하세요.

버그 수정

  • 이제 런타임 시 최대 모션 이벤트 수를 설정할 수 있습니다.

버전 1.2.2-alpha01

2022년 11월 9일

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

API 변경사항

  • 이제 API에 GAMEACTIVITY_PACKED_VERSION 형식의 버전 정보도 포함됩니다. (I287e6)
  • 콘텐츠를 배치해야 하는 창에서 직사각형이 변경될 때 호출되는 onContentRectChanged 콜백을 추가했습니다. (I81396)

버그 수정

  • 이벤트 버퍼 오버플로를 수정했습니다. 이제 inputBuffer->keyEvents 및 motionEvents가 동적으로 할당된 버퍼입니다. (Ic00f6)
  • 메모리가 부족해도 심각한 오류가 발생하지 않습니다. 버퍼 크기 조절 중 realloc() 오류 처리를 추가했습니다.

버전 1.2.1

2022년 7월 13일

androidx.games:games-activity:1.2.1이 출시되었습니다. 버전 1.2.1에 포함된 커밋을 확인하세요.

버그 수정

  • 이전 버전에서 .aar 파일이 누락되는 문제를 수정했습니다.

버전 1.2.0

2022년 6월 15일

androidx.games:games-activity:1.2.0이 출시되었습니다. 버전 1.2.0에 포함된 커밋을 확인하세요.

1.1.0 이후 중요 변경사항

  • GameActivity의 파생 클래스가 네이티브 라이브러리 로드를 처리하도록 허용합니다.
  • GameActivity.onCreate에서 항상 네이티브 라이브러리를 로드합니다.
  • 다른 라이브러리가 없는 경우 이름이 'main'인 라이브러리를 로드합니다.

Games-Activity 버전 1.1

버전 1.1.0

2022년 2월 23일

androidx.games:games-activity:1.1.0 및 androidx.games:games-controller:1.1.0이 출시되었습니다. 버전 1.1.0에 포함된 커밋을 확인하세요.

1.0.0 이후 중요 변경사항

게임 활동

  • WindowInsets는 노치 및 IME 응답을 수신 대기하고 쿼리합니다.
  • 키 및 모션 이벤트 필터를 추가합니다.
  • 버그 수정
    • NativeActivity와의 호환성을 위해 누락된 메시지를 추가합니다.
    • onNativeWindowResized의 서명을 수정합니다.
    • 입력 이벤트 손실을 수정합니다.

버전 1.1.0-rc01

2022년 2월 9일

androidx.games:games-activity:1.1.0-rc01 및 androidx.games:games-controller:1.1.0-rc01이 출시되었습니다. 버전 1.1.0-rc01에 포함된 커밋을 확인하세요.

버전 1.1.0-beta03

2022년 1월 26일

androidx.games:games-activity:1.1.0-beta03이 출시되었습니다. 버전 1.1.0-beta03에 포함된 커밋을 확인하세요.

버그 수정

  • onNativeWindowResized의 서명을 수정합니다.
  • onSurfaceChanged에서 네이티브 창 핸들을 유지합니다.

버전 1.1.0-beta02

2021년 12월 15일

androidx.games:games-activity:1.1.0-beta02가 출시되었습니다. 버전 1.1.0-beta02에 포함된 커밋을 확인하세요.

버그 수정

  • 이벤트 필터 설정에서 경합 상태를 수정합니다.

버전 1.1.0-beta01

2021년 11월 17일

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

새로운 기능

  • 창 인셋 쿼리 및 인셋 변경사항 수신 대기에 대한 지원을 추가했습니다. 이를 통해 게임이 IME 팝업에 반응하고 워터폴 및 카메라 컷아웃 인셋을 처리할 수 있습니다.

API 변경사항

  • void GameActivity_getWindowInsets(GameActivity* activity, enum GameCommonInsetsType type, GameCommonInsets* insets);

버그 수정

  • 주요 이벤트를 전부 사용해 버리지 마세요. 볼륨, 카메라 등이 이제 시스템으로 그대로 전달됩니다.

버전 1.1.0-alpha01

2021년 9월 29일

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

API 변경사항

  • GameActivityCallbacks에 onContentRectChanged 콜백을 추가했습니다.

버그 수정

  • android_native_app_glue.h에 누락된 다음 메시지를 추가했습니다.
    • APP_CMD_CONTENT_RECT_CHANGED
    • APP_CMD_WINDOW_REDRAW_NEEDED

Games Performance Tuner 2.0

버전 2.0.0

2024년 8월 7일

androidx.games:games-performance-tuner:2.0.0이 출시되었습니다. 버전 2.0.0에는 이러한 커밋이 포함되어 있습니다.

2.0.0의 주요 기능

  • 2.0.0beta01 이후 주요 변경사항은 없으며, 이번 출시를 안정 버전으로 표시합니다.

버전 2.0.0-beta01

2024년 1월 10일

androidx.games:games-performance-tuner:2.0.0-beta01이 마지막 알파 출시 이후 변경사항 없이 출시되었습니다. 버전 2.0.0-beta01에 포함된 커밋을 확인하세요.

버전 2.0.0-alpha07

2023년 11월 29일

androidx.games:games-performance-tuner:2.0.0-alpha07이 출시되었습니다. 버전 2.0.0-alpha07에 포함된 커밋을 확인하세요.

버그 수정

  • 메모리 텔레메트리 보고가 잘못된 값을 보고하는 문제 수정

버전 2.0.0-alpha06

2023년 11월 1일

androidx.games:games-performance-tuner:2.0.0-alpha06이 출시되었습니다. 버전 2.0.0-alpha06에 포함된 커밋을 확인하세요.

버전 2.0.0-alpha05

2023년 8월 23일

androidx.games:games-performance-tuner:2.0.0-alpha05이 출시되었습니다. 버전 2.0.0-alpha05에 포함된 커밋을 확인하세요.

새로운 기능

  • Protobuf 라이브러리를 Protobuf lite로 이전했습니다.

버그 수정

  • 현수 포인터 관련 문제가 수정되었습니다.

버전 2.0.0-alpha04

2023년 4월 19일

androidx.games:games-performance-tuner:2.0.0-alpha04이 출시되었습니다. 버전 2.0.0-alpha04에 포함된 커밋을 확인하세요.

새로운 기능

  • 라이브러리의 텔레메트리 수집 기능을 업데이트하여 프레임 렌더링 시간을 더 세부적으로 보고할 수 있습니다.

버그 수정

  • 최대 계측 키가 히스토그램 수보다 많은 경우 라이브러리가 비정상 종료되는 버그가 수정되었습니다.

버전 2.0.0-alpha03

2023년 2월 22일

androidx.games:games-performance-tuner:2.0.0-alpha03이 출시되었습니다. 버전 2.0.0-alpha03에 포함된 커밋을 확인하세요.

버그 수정

  • Games-Performance-Tuner를 새로운 출시 프로세스로 이동했습니다. 동작 변경사항은 없습니다.

버전 2.0.0-alpha02

2023년 2월 8일

androidx.games:games-performance-tuner:2.0.0-alpha02가 출시되었습니다. 버전 2.0.0-alpha02에 포함된 커밋을 확인하세요.

API 변경사항

  • 사용할 올바른 품질 수준/충실도 매개변수를 예측하는 데 도움이 되는 TuningFork_predictQualityLevels API를 추가했습니다.

Games Performance Tuner 1.6

버전 1.6.1-alpha01

2022년 11월 9일

androidx.games:games-performance-tuner:1.6.1-alpha01이 출시되었습니다. 버전 1.6.1-alpha01에 포함된 커밋을 확인하세요.

새로운 기능

  • 새로운 변경사항이 없음

버전 1.6.0

2022년 6월 15일

androidx.games:games-performance-tuner:1.6.0이 출시되었습니다. 버전 1.6.0에 포함된 커밋을 확인하세요.

1.5.0 이후 중요 변경사항

  • 메모리 원격 분석을 가져오려고 시도하는 동안 getpid가 0을 반환하는 문제를 해결했습니다.
  • 활성 로드 그룹이 없는 경우 StopLoadingGroup의 실행을 중단했습니다.

Games Performance Tuner 1.5.0

버전 1.5.0

2022년 2월 9일

androidx.games:games-performance-tuner:1.5.0이 출시되었습니다. 버전 1.5.0에 포함된 커밋을 확인하세요.

1.4.0 이후 중요 변경사항

  • 초기 설정에서 하드코딩되지 않고 프로그래매틱 방식으로 업로드 간 간격을 변경합니다.
    • TuningFork_setAggregationStrategyInterval 함수를 추가했습니다.
  • API<=23에서 API 키의 메모리 손상을 수정합니다.

버전 1.5.0-rc01

2022년 1월 26일

androidx.games:games-performance-tuner:1.5.0-rc01이 출시되었습니다. 버전 1.5.0-rc01에 포함된 커밋을 확인하세요.

버그 수정

  • API 23 이하에서 API 키의 메모리 손상을 수정합니다.

버전 1.5.0-beta02

2021년 12월 15일

androidx.games:games-performance-tuner:1.5.0-beta02가 출시되었습니다. 버전 1.5.0-beta02에 포함된 커밋을 확인하세요.

API 변경사항

  • TuningFork_Settings에서 ABI 브레이킹 체인지를 삭제합니다.

버전 1.5.0-beta01

2021년 9월 29일

androidx.games:games-performance-tuner:1.5.0-beta01이 출시되었습니다. 버전 1.5.0-beta01에 포함된 커밋을 확인하세요.

새로운 기능

  • 알파 버전에서 변경된 사항이 없습니다. 알파 버전에 포함된 사항은 다음과 같습니다.
    • 초기 설정에서 하드코딩되지 않고 프로그래매틱 방식으로 업로드 간 간격을 변경합니다.

API 변경사항

  • 알파 버전에서 변경된 사항이 없습니다. 알파 버전에 포함된 사항은 다음과 같습니다.
    • 새 함수: TuningFork_setAggregationStrategyInterval
    • TuningFork_Settings: aggregation_strategy_intervalms_or_count의 새 필드

버전 1.5.0-alpha01

2021년 8월 18일

androidx.games:games-performance-tuner:1.5.0-alpha01이 출시되었습니다. 버전 1.5.0-alpha01에 포함된 커밋을 확인하세요.

새로운 기능

  • 이제 설정 파일을 사용하는 대신 프로그래매틱 방식으로 APT 업로드 간의 간격을 설정할 수 있습니다.

API 변경사항

  • TuningFork_setAggregationStrategyInterval 함수를 추가했습니다.
  • TuningFork_Settings 구조체 aggregation_strategy_intervalms_or_count를 필드에 추가했습니다.

Games-Activity 버전 1.0.0

버전 1.0.0

2021년 8월 4일

androidx.games:games-activity:1.0.0, androidx.games:games-controller:1.0.0 및 androidx.games:games-text-input:1.0.0이 출시되었습니다. 버전 1.0.0에 포함된 커밋을 확인하세요.

1.0.0의 주요 기능

Games-Activity, Games-Controller 및 Games-Text-Input의 초기 안정화 버전입니다. 자세한 내용은 AGDK 홈페이지를 참고하세요.

버전 1.0.0-rc01

2021년 7월 12일

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

버그 수정

  • GameActivityCallbacks::onSaveInstanceState의 반환 유형을 수정했습니다.

버전 1.0.0-beta01

2021년 6월 30일

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

API 변경사항

  • GameActivityInputInfo의 이름을 GameActivityPointerAxes로 바꿉니다.
  • 이제 onNativeWindowResized 콜백이 창의 너비와 높이를 제공합니다.
  • onContentRectChanged 콜백이 삭제되었습니다.
  • onLowMemory 이름을 onTrimMemory로 바꿨습니다.
  • GameActivity_setWindowFormat을 삭제했습니다.
  • GameActivityMotionEvents 및 GameActivityMotionEvent 포인터의 소유권 모델을 개선했습니다.
  • onSaveInstanceState 콜백에서 사용자 상태의 소유권 모델을 개선했습니다.

버전 1.0.0-alpha01

2021년 6월 16일

androidx.games:games-activity:1.0.0-alpha01이 출시되었습니다.

새로운 기능

  • Games-Activity는 NativeActivity를 대체하는 새로운 라이브러리로, C/C++ 게임을 Android와 통합하는 권장 방법입니다.

Games-Controller 버전 2.2

버전 2.2.0-alpha01

2025년 3월 26일

androidx.games:games-controller:2.2.0-alpha01, androidx.games:games-memory-advice:2.2.0-alpha01 및 androidx.games:games-performance-tuner:2.2.0-alpha01이 출시되었습니다. 버전 2.2.0-alpha01에는 이 커밋이 포함되어 있습니다.

새로운 기능

  • Gradle 8.8.1 (1ed0153)로 업그레이드
  • Java 17로 업그레이드 (1ed0153)
  • targetSdk를 35로 변경 (eddf605)

Games-Controller 버전 2.0

버전 2.0.2

2024년 6월 12일

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

버그 수정

  • Paddleboat_init 전에 이미 연결된 컨트롤러에 대해 컨트롤러 연결 콜백이 실행되지 않는 문제가 수정되었습니다.
  • 압력 축을 수동으로 사용 설정하지 않으면 게임 컨트롤러 터치패드에서 Paddleboat_processGameActivityMotionInputEvent의 터치패드 누르기가 등록되지 않는 문제가 해결되었습니다.
  • 게임 컨트롤러 트랙패드 이벤트가 Paddleboat_processGameActivityMotionInputEvent에 의해 사용된 것으로 표시되지 않는 문제를 수정했습니다.

버전 2.0.1

2023년 9월 20일

`androidx.games:games-controller:2.0.1 '이 출시되었습니다. 버전 2.0.1에 포함된 커밋을 확인하세요.

게임 컨트롤러 버그 수정:

  • onInputDeviceChanged 핸들러에서 드물게 발생하는 NullReferenceException 조건 수정
  • 특정 USB 키보드가 게임 컨트롤러로 잘못 등록되지 않도록 수정

버전 2.0.0

2023년 3월 8일

androidx.games:games-controller:2.0.0이 출시되었습니다. 버전 2.0.0에 포함된 커밋을 확인하세요.

2.0.0의 주요 기능

  • 하드웨어 키보드의 연결 상태를 감지하는 기능이 추가되었습니다.
  • 기본 기기 (핸드셋)와 컨트롤러에서 모션 데이터 (가속도계/자이로스코프)를 보고하는 기능을 추가했습니다.
  • 메모리 공간을 줄이고 추가 기능을 지원하도록 컨트롤러 정의 데이터베이스의 API와 형식이 변경되었습니다.

버전 2.0.0-alpha01

2023년 1월 11일

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

새로운 기능

  • 하드웨어 키보드 감지
  • 통합된 센서 움직임 데이터 보고 지원(즉, 휴대전화 자체에서 자이로스코프 및 가속도계 데이터 수신)
  • 새로운 최적화된 컨트롤러 매핑 데이터 형식

API 변경사항

  • 하드웨어 키보드의 새로운 API 호출: Paddleboat_getPhysicalKeyboardStatus 및 Paddleboat_setPhysicalKeyboardStatusCallback
  • 통합된 센서 움직임 데이터 보고를 위한 새로운 API 호출: Paddleboat_getIntegratedMotionSensorFlags 및 Paddleboat_setMotionDataCallbackWithIntegratedFlags
  • 수정된 컨트롤러 매핑 데이터 형식에 관한 새로운 API 호출: Paddleboat_addControllerRemapDataFromFd, Paddleboat_addControllerRemapDataFromFileBuffer
  • 지원 중단된 이전 매핑 API 호출: Paddleboat_addControllerRemapData 및 Paddleboat_getControllerRemapTableData

버그 수정

  • GameActivity 1.2.2 이상에서 모션 이벤트와의 호환성 문제를 수정했습니다.

Games-Controller 버전 1.1.0

버전 1.1.0

2022년 2월 23일

androidx.games:games-activity:1.1.0 및 androidx.games:games-controller:1.1.0이 출시되었습니다. 버전 1.1.0에 포함된 커밋을 확인하세요.

1.0.0 이후 중요 변경사항

게임 활동

  • WindowInsets는 노치 및 IME 응답을 수신 대기하고 쿼리합니다.
  • 키 및 모션 이벤트 필터를 추가합니다.
  • 버그 수정
    • NativeActivity와의 호환성을 위해 누락된 메시지를 추가합니다.
    • onNativeWindowResized의 서명을 수정합니다.
    • 입력 이벤트 손실을 수정합니다.

버전 1.1.0-rc01

2022년 2월 9일

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

버전 1.1.0-beta01

2022년 1월 26일

androidx.games:games-controller:1.1.0-beta01이 1.1.0-alpha01 이후 변경사항 없이 출시되었습니다. 버전 1.1.0-beta01에 포함된 커밋을 확인하세요.

버전 1.1.0-alpha01

2021년 12월 15일

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

새로운 기능

Android S 이상에서 실행할 때 지원되는 컨트롤러에 관한 배터리 상태, 이중 모터 진동, 조명 제어, 모션 축 보고 지원을 추가했습니다.

API 변경사항

  • 컨트롤러 모션 데이터 콜백을 등록하는 Paddleboat_setMotionDataCallback 함수를 추가했습니다.
  • 컨트롤러 조명 설정을 변경하는 Paddleboat_setControllerLight 함수를 추가했습니다.
  • Paddleboat_Controller_Data에 Paddleboat_Controller_Battery 구조를 추가했습니다.
  • 새 구조는 다음과 같습니다.
    • Paddleboat_Controller_Battery
    • Paddleboat_Motion_Data
  • 새 enum:
    • Paddleboat_BatteryStatus
    • Paddleboat_LightType
    • Paddleboat_Motion_Type
  • 새 컨트롤러 플래그는 다음과 같습니다.
    • PADDLEBOAT_CONTROLLER_FLAG_ACCELEROMETER
    • PADDLEBOAT_CONTROLLER_FLAG_GYROSCOPE
    • PADDLEBOAT_CONTROLLER_FLAG_LIGHT_PLAYER
    • PADDLEBOAT_CONTROLLER_FLAG_LIGHT_RGB
    • PADDLEBOAT_CONTROLLER_FLAG_BATTERY

버그 수정

  • PS4 컨트롤러용 대체 deviceId 데이터베이스 항목을 추가했습니다.
  • PS5 컨트롤러용 API 31 이상 데이터베이스 항목을 추가했습니다.

Games-Controller 버전 1.0.0

버전 1.0.0

2021년 8월 4일

androidx.games:games-activity:1.0.0, androidx.games:games-controller:1.0.0 및 androidx.games:games-text-input:1.0.0이 출시되었습니다. 버전 1.0.0에 포함된 커밋을 확인하세요.

1.0.0의 주요 기능

Games-Activity, Games-Controller 및 Games-Text-Input의 초기 안정화 버전입니다. 자세한 내용은 AGDK 홈페이지를 참고하세요.

버전 1.0.0-rc02

2021년 7월 21일

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

버그 수정

  • 사용되지 않은 빈 아키텍처/버전 순열에서 Prefab 가져오기가 실패하는 패키징 오류가 수정되었습니다.

버전 1.0.0-rc01

2021년 7월 12일

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

버그 수정

  • 최신 GameActivity와 호환되지 않는 문제가 수정되었습니다.

버전 1.0.0-beta01

2021년 6월 30일

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

API 변경사항

  • 성공 또는 실패를 정의하는 부울을 반환하는 함수가 이제 Paddleboat_Error_Code enum을 반환합니다.
  • Paddleboat_onPause 이름이 Paddleboat_onStop으로 바뀌었습니다.
  • Paddleboat_onResume 이름이 Paddleboat_onStart로 바뀌었습니다.
  • Paddleboat_processGameActivityEvent는 Paddleboat_processGameActivityKeyInputEvent와 Paddleboat_processGameActivityMotionInputEvent, 두 가지 기능으로 나뉩니다.
  • Android S SDK 미리보기를 따라 빌드하기 위해 필요한 확장 컨트롤러 기능을 삭제했습니다.
  • Paddleboat_getBackButtonConsumed 함수를 추가했습니다.
  • 컨트롤러 및 마우스 상태 콜백에 이제 사용자 정의 데이터를 가리키는 포인터의 선택적 매개변수가 포함됩니다.
  • 컨트롤러 이름 문자열을 기기 정보 구조의 외부로 이동했습니다. 이제 Paddleboat_getControllerName 함수를 통해 액세스합니다.

버그 수정

  • 처음에 자신을 컨트롤러로 보고하지 않지만, 나중에 onInputDeviceChanged 메시지를 통해 보고하는 컨트롤러가 컨트롤러 연결로 올바르게 감지되지 않는 문제가 해결되었습니다.

버전 1.0.0-alpha01

2021년 6월 16일

androidx.games:games-controller:1.0.0-alpha01이 출시되었습니다.

새로운 기능

  • Games-Controller는 게임 컨트롤러 기기에서 입력을 감지하고 읽고 기기와 상호작용하는 C API를 제공하는 새로운 라이브러리입니다.

Games-Text-Input 2.1

버전 2.1.0-alpha01

2023년 7월 26일

androidx.games:games-text-input:2.1.0-alpha01이 출시되었습니다. 버전 2.1.0-alpha01에 포함된 커밋을 확인하세요.

새로운 기능

  • 여러 줄 및 한 줄 모드 지원 추가

API 변경사항

  • isSoftwareKeyboardVisible 함수 추가
  • GameActivity_setImeEditorInfo의 비트필드 정의 추가
  • onEditorAction 콜백 추가

버그 수정

  • 하드웨어 및 소프트웨어 키보드의 동기화가 맞지 않는 문제 수정
  • 소프트 키보드가 숨겨지면 포커스 지우기

Games-Text-Input 2.0

버전 2.0.0

2023년 3월 8일

androidx.games:games-text-input:2.0.0이 출시되었습니다. 버전 2.0.0에 포함된 커밋을 확인하세요.

1.1.1 이후 중요 변경사항

  • 빌드 시스템 변경으로 인한 주 버전 업데이트입니다. 라이브러리/API 자체는 업데이트되지 않습니다.

Games-Text-Input 버전 1.1

버전 1.1.2-alpha01

2022년 11월 9일

androidx.games:games-text-input:1.1.2-alpha01이 출시되었습니다. 버전 1.1.2-alpha01에 포함된 커밋을 확인하세요.

새로운 기능

  • 새로운 변경사항이 없음

버전 1.1.1

2022년 7월 13일

androidx.games:games-text-input:1.1.1이 출시되었습니다. 버전 1.1.1에 포함된 커밋을 확인하세요.

버그 수정

  • 이전 버전에서 .aar 파일이 누락되는 문제를 수정했습니다.

버전 1.1.0

2022년 2월 9일

androidx.games:games-text-input:1.1.0이 출시되었습니다. 버전 1.1.0에 포함된 커밋을 확인하세요.

1.0.0 이후 중요 변경사항 - GameTextInput에 WindowInsets 수신 및 쿼리 기능이 추가되었습니다. - 누락된 gamecommon.h 헤더를 추가했습니다.

버전 1.1.0-rc01

2022년 1월 26일

androidx.games:games-text-input:1.1.0-rc01이 출시되었습니다. 버전 1.1.0-rc01에 포함된 커밋을 확인하세요.

버전 1.1.0-beta01

2021년 12월 15일

androidx.games:games-text-input:1.1.0-beta01이 출시되었습니다. 버전 1.1.0-beta01에 포함된 커밋을 확인하세요.

버그 수정

  • 폭포식 구조 및 IME 인셋을 수정합니다.
  • 누락된 gamecommon.h 헤더를 추가합니다.

버전 1.1.0-alpha01

2021년 10월 13일

androidx.games:games-text-input:1.1.0-alpha01이 출시되었습니다. 버전 1.1.0-alpha01에 포함된 커밋을 확인하세요.

API 변경사항

  • IME 인셋 기능을 GameTextInput에 추가했습니다.

Games-Text-Input 버전 1.0

버전 1.0.0

2021년 8월 4일

androidx.games:games-activity:1.0.0, androidx.games:games-controller:1.0.0 및 androidx.games:games-text-input:1.0.0이 출시되었습니다. 버전 1.0.0에 포함된 커밋을 확인하세요.

1.0.0의 주요 기능

Games-Activity, Games-Controller 및 Games-Text-Input의 초기 안정화 버전입니다. 자세한 내용은 AGDK 홈페이지를 참고하세요.

버전 1.0.0-rc01

2021년 7월 12일

androidx.games:games-text-input:1.0.0-rc01은 변경사항 없이 출시되었습니다. 버전 1.0.0-rc01에 포함된 커밋을 확인하세요.

버전 1.0.0-beta01

2021년 6월 30일

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

API 변경사항

  • GameTextInputState 객체의 소유권 모델을 개선했습니다.
  • NDK와 일관되도록 유형을 정리합니다.

버전 1.0.0-alpha01

2021년 6월 16일

androidx.games:games-text-input:1.0.0-alpha01이 출시되었습니다.

새로운 기능

  • Games-Text-Input은 게임 개발자가 C/C++의 Android 소프트 키보드 입력을 사용할 수 있도록 하는 새로운 라이브러리입니다.

Games Frame Pacing 버전 2.3

버전 2.3.0-alpha01

2025년 3월 26일

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

새로운 기능

  • Gradle 8.8.1 (1ed0153)로 업그레이드
  • Java 17로 업그레이드 (1ed0153)
  • targetSdk를 35로 변경 (eddf605)

버그 수정

Games Frame Pacing 버전 2.1

버전 2.1.3

2025년 7월 2일

androidx.games:games-frame-pacing:2.1.3이 출시되었습니다. 버전 2.1.3에는 이러한 커밋이 포함되어 있습니다.

버그 수정

  • 16KB 페이지 크기 지원을 사용 설정합니다.

버전 2.1.2

2024년 7월 24일

androidx.games:games-frame-pacing:2.1.2이 출시되었습니다. 버전 2.1.2에는 이러한 커밋이 포함되어 있습니다.

버그 수정

  • 이제 Swappy는 API 33의 AChoreographer_postVsyncCallback를 사용하여 프레젠테이션 시간을 더 정확하게 계산합니다. 이 패치는 프레임이 삭제되는 120Hz 기기의 버그를 수정합니다.

버전 2.1.1

2024년 7월 10일

androidx.games:games-frame-pacing:2.1.1이 출시되었습니다. 버전 2.1.1에는 이 커밋이 포함되어 있습니다.

버그 수정

  • 정지 방지를 위해 스와피에서 디스플레이 리스너를 적절하게 등록 해제
  • 삭제된 뮤텍스를 사용하여 ChoreographerFilter::onSettingsChanged에서 발생하는 비정상 종료 수정

버전 2.1.0

2023년 11월 15일

androidx.games:games-frame-pacing:2.1.0이 출시되었습니다. 버전 2.1.0에 포함된 커밋을 확인하세요.

버전 2.1.0-rc01

2023년 9월 20일

androidx.games:games-frame-pacing:2.1.0-rc01이 출시되었습니다. 버전 2.1.0-rc01에 포함된 커밋을 확인하세요.

버전 2.1.0-beta01

2023년 5월 24일

androidx.games:games-frame-pacing:2.1.0-beta01이 출시되었습니다. 버전 2.1.0-beta01에 포함된 커밋을 확인하세요.

버그 수정

  • NDKChoreographer 초기화 실패 시 제한 시간 (ef466d)
  • 시스템 (c85235)에서 SwappyGL_getSupportedRefreshPeriodsNS 쿼리 새로고침 빈도를 명시적으로 사용하는 경우

버전 2.1.0-alpha01

2023년 4월 5일

androidx.games:games-frame-pacing:2.1.0-alpha01이 출시되었습니다. 버전 2.1.0-alpha01에 포함된 커밋을 확인하세요.

새로운 기능

  • 프레임 페이싱 상태를 재설정하는 새로운 API
  • CPU 및 GPU 시간을 계속 관찰하면서도 swappy의 프레임 페이싱 영향을 사용 중지하는 새로운 API

API 변경사항

  • 이제 SwappyGL_resetFramePacing/SwappyVk_resetFramePacing를 사용하여 내부 프레임 페이싱 상태를 재설정할 수 있습니다. 이제 프레임 페이싱은 재설정 API가 호출된 시점의 데이터만 고려합니다.
  • 이제 SwappyGL_enableFramePacing/SwappyVk_enableFramePacing를 사용하여 Swappy의 프레임 페이싱을 사용 설정/중지할 수 있습니다. 사용 중지된 경우
  • SwappyGL_enableBlockingWait/SwappyVk_enableBlockingWait는 프레임 페이싱이 사용 중지되었을 때 마지막 프레임의 GPU 작업이 차단 대기되는지 여부를 제어하는 데 사용할 수 있습니다.

버그 수정

  • Swappy GL API를 사용할 때 GPU 바운드 사례의 성능이 개선됩니다.

Games Frame Pacing 버전 2.0

버전 2.0.0

2023년 3월 8일

androidx.games:games-frame-pacing:2.0.0이 출시되었습니다. 버전 2.0.0에 포함된 커밋을 확인하세요.

1.10.1 이후 중요 변경사항

  • 빌드 시스템이 크게 변경되어 SDK/NDK 버전당 여러 라이브러리가 아닌 하나의 라이브러리만 생성됩니다.
  • Vulkan 프레임 통계가 추가되었습니다.
  • 프레임 통계를 지우는 새로운 API가 추가되었습니다.
  • 로그는 출시 모드에서 모두 무음이며 디버그 모드에서 사용 설정할 수 있습니다.

버전 2.0.0-rc01

2023년 2월 22일

androidx.games:games-frame-pacing:2.0.0-rc01이 출시되었습니다. 버전 2.0.0-rc01에 포함된 커밋을 확인하세요.

새로운 기능

  • 이제 로깅이 컴파일 플래그 뒤에 숨겨져 있습니다. 기본적으로 라이브러리의 출시 빌드에는 로깅이 없고, 라이브러리의 디버그 출시에서는 모든 로깅이 사용 설정되어 있습니다.

버전 2.0.0-beta01

2023년 2월 8일

androidx.games:games-frame-pacing:2.0.0-beta01이 출시되었습니다. 버전 2.0.0-beta01에 포함된 커밋을 확인하세요.

새로운 기능

  • 프레임 통계를 지우는 새로운 API를 도입했습니다.

API 변경사항

  • SwappyGL_clearStats 및 SwappyGL_clearStats API를 추가했습니다.

버전 2.0.0-alpha01

2023년 1월 11일

androidx.games:games-frame-pacing:2.0.0-alpha01이 출시되었습니다. 버전 2.0.0-alpha01에 포함된 커밋을 확인하세요.

새로운 기능

  • vulkan 프레임 통계를 추가했습니다.

API 변경사항

  • 빌드 파일 리팩터링으로 인해 메이저 버전 증가합니다.
  • 새로운 API 3개(SwappyVk_enableStats, SwappyVk_recordFrameStart, SwappyVk_getStats)를 추가했습니다.

버그 수정

  • 자동 스왑 모드에서만 임곗값을 적용합니다. (Ic0786)

Games Frame Pacing 1.10

버전 1.10.2-alpha01

2022년 11월 9일

androidx.games:games-frame-pacing:1.10.2-alpha01이 출시되었습니다. 버전 1.10.2-alpha01에 포함된 커밋을 확인하세요.

새로운 기능

  • 새로운 변경사항이 없음

버전 1.10.1

2022년 6월 15일

androidx.games:games-frame-pacing:1.10.1이 출시되었습니다. 버전 1.10.1에 포함된 커밋을 확인하세요.

버그 수정

  • ndk 버전이 17보다 높고 23보다 낮은 경우 swappy가 빌드되지 않는 문제를 해결했습니다.
  • 디스플레이에서 지원하는 화면 재생 빈도를 가져오는 API를 노출했습니다.

버전 1.10.0

2022년 2월 23일

androidx.games:games-frame-pacing:1.10.0이 출시되었습니다. 버전 1.10.0에 포함된 커밋을 확인하세요.

1.9.0 이후 중요 변경사항

  • 오염된 choreographer 필터 입력을 무시하고 에뮬레이터에서 중단을 방지하기 위해 더 원활하게 처리합니다.
  • *_uninjectTracer 함수를 추가합니다.

버전 1.10.0-rc01

2022년 2월 9일

androidx.games:games-frame-pacing:1.10.0-rc01이 출시되었습니다. 버전 1.10.0-rc01에 포함된 커밋을 확인하세요.

버전 1.10.0-beta01

2022년 1월 26일

androidx.games:games-frame-pacing:1.10.0-beta01이 출시되었습니다. 버전 1.10.0-beta01에 포함된 커밋을 확인하세요.

버전 1.10.0-alpha01

2021년 12월 15일

androidx.games:games-frame-pacing:1.10.0-alpha01이 출시되었습니다. 버전 1.10.0-alpha01에 포함된 커밋을 확인하세요.

새로운 기능

  • SwappyGL_uninjectTracer 함수를 추가했습니다.

API 변경사항

  • SwappyGL_injectTracer를 통해 이전에 추가된 콜백을 SwappyGL_uninjectTracer(const SwappyTracer *t) API를 사용하여 삭제합니다.

Games Frame Pacing 1.9

버전 1.9.1

2021년 10월 13일

androidx.games:games-frame-pacing:1.9.1이 출시되었습니다. 버전 1.9.1에 포함된 커밋을 확인하세요.

버그 수정

버전 1.9.0

2021년 7월 12일

androidx.games:games-frame-pacing:1.9.0이 출시되었습니다. 버전 1.9.0에 포함된 커밋을 확인하세요.

1.7.0 이후 중요 변경사항

  • 내부 버전 관리 체계와 일치하도록 업데이트되었습니다.

Games Frame Pacing 1.7.0

버전 1.7.0

2021년 6월 30일

androidx.games:games-frame-pacing:1.7.0이 출시되었습니다. 버전 1.7.0에 포함된 커밋을 확인하세요.

버전 1.7.0-rc01

2021년 6월 2일

androidx.games:games-frame-pacing:1.7.0-rc01이 출시되었습니다. 버전 1.7.0-rc01에 포함된 커밋을 확인하세요.

버전 1.7.0-beta02

2021년 2월 24일

androidx.games:games-frame-pacing:1.7.0-beta02가 출시되었습니다.

버전 1.7.0-beta01

2020년 12월 16일

androidx.games:games-frame-pacing:1.7.0-beta01이 출시되었습니다.

Games Performance Tuner 1.4.3

버전 2.0.0-rc01

2024년 7월 24일

androidx.games:games-performance-tuner:2.0.0-rc01이 출시되었습니다. 버전 2.0.0-rc01에는 이 커밋이 포함되어 있습니다.

버전 1.4.3

2021년 7월 12일

androidx.games:games-performance-tuner:1.4.3이 출시되었습니다. 버전 1.4.3에 포함된 커밋을 확인하세요.

1.1.0 이후 중요 변경사항

  • 내부 버전 관리 체계와 일치하도록 업데이트되었습니다.

Games Performance Tuner 1.1.0

버전 1.1.0

2021년 6월 30일

androidx.games:games-performance-tuner:1.1.0이 출시되었습니다. 버전 1.1.0에 포함된 커밋을 확인하세요.

버전 1.1.0-rc01

2021년 6월 2일

androidx.games:games-performance-tuner:1.1.0-rc01이 출시되었습니다. 버전 1.1.0-rc01에 포함된 커밋을 확인하세요.

버전 1.1.0-beta03

2021년 4월 21일

androidx.games:games-performance-tuner:1.1.0-beta03이 출시되었습니다.

버전 1.1.0-beta02

2021년 2월 24일

androidx.games:games-performance-tuner:1.1.0-beta02가 출시되었습니다.

버전 1.1.0-beta01

2020년 12월 16일

androidx.games:games-performance-tuner:1.1.0-beta01이 출시되었습니다.

버전 1.1.0-alpha01

androidx.games:games-performance-tuner:1.1.0-alpha01이 출시되었습니다.

버전 1.0.0

버전 1.0.0-alpha02

2020년 8월 12일

Android 게이밍 라이브러리의 이름이 Android 게임 라이브러리로 변경되었습니다.

androidx.gaming -> androidx.games

버전 1.0.0-alpha01

2020년 6월 10일

androidx.games:1.0.0-alpha01이 출시되었습니다.