Android 게임

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

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

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

아티팩트 안정화 버전 출시 후보 버전 베타 버전 알파 버전
games-activity 1.2.2 2.0.0-rc01 - -
games-controller - 2.0.0-rc01 - -
games-frame-pacing 1.9.1 2.0.0-rc01 - -
games-memory-advice - - 2.0.0-beta01 -
games-text-input - 2.0.0-rc01 - -
games-performance-tuner - - - 2.0.0-alpha03
이 라이브러리는 2023년 2월 22일에 최종 업데이트되었습니다.

요구사항

games-memory-advice

MemoryAdvice API를 사용하려면 다음 NDK 버전 중 하나로 애플리케이션을 빌드해야 합니다.

  • r20.*
  • r21.*
  • 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.0.0"

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

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

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

    // To use the Games Text Input Library
    // Do not include this if games-activity has been included
    implementation "androidx.games:games-text-input:2.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.0.0")

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

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

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

    // To use the Games Text Input Library
    // Do not include this if games-activity has been included
    implementation("androidx.games:games-text-input:2.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.0.0

버전 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-Activity 버전 2.0

버전 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-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.0.

버전 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 버전 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.0

버전 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

버전 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이 출시되었습니다.