Gry na Androida

Biblioteka gier na Androida jest kopią pakietu SDK do gier na Androida, który jest dostępny do pobrania w formacie binarnym. Zamiast ręcznie pobierać i integrować pakiet SDK do gier na Androida z kompilacją, możesz użyć biblioteki androidx.

Więcej informacji o pakiecie SDK do gier na Androida znajdziesz w dokumentacji pakietu SDKinformacjach o wersji pakietu SDK.

Ta tabela zawiera listę wszystkich artefaktów w grupie androidx.games.

Artefakt Wersja stabilna Wersja kandydująca do publikacji Wersja Beta Wersja alfa
aktywność w grach 4.0.0 - - 4.2.0-alpha01
kontroler do gier 2.0.2 - - 2.2.0-alpha01
gry: kadrowanie i tempo 2.1.3 - - 2.3.0-alpha01
gry pamięciowe – porady 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
Ostatnia aktualizacja tej biblioteki: 2 lipca 2025 r.

Wymagania

games-memory-advice

Interfejs MemoryAdvice API wymaga, aby aplikacja była zbudowana przy użyciu NDK w wersji r23.* lub nowszej.

Deklarowanie zależności

Aby dodać zależność od gry, musisz dodać repozytorium Google Maven do projektu. Więcej informacji znajdziesz w repozytorium Maven Google.

Dodaj zależności dotyczące potrzebnych artefaktów w pliku build.gradle aplikacji lub modułu. Biblioteka games-activity ma zintegrowaną tę samą wersję biblioteki game-text-input, dlatego aplikacje GameActivity nie mogą ponownie uwzględniać zależności game-text-input:

Odlotowe

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")
}
}

Więcej informacji o zależnościach znajdziesz w artykule Dodawanie zależności kompilacji.

Dodawanie właściwości Gradle

Może być konieczne dodanie właściwości do pliku gradle.properties znajdującego się w tym samym katalogu co plik build.gradle aplikacji (lub modułu). Jeśli plikgradle.properties nie istnieje, utwórz go.

Jeśli używasz Androida Studio 4.0, upewnij się, że plik gradle.properties zawiera te wiersze:

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

Jeśli używasz Androida Studio 4.1 lub nowszego, upewnij się, że plik gradle.propertieszawiera te wiersze:

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

Dodawanie pakietów za pomocą CMake

Aby udostępnić zaimportowane pakiety pakietu SDK do gier, dodaj ten kod do pliku CMakeLists.txt głównej aplikacji:

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

Umożliwi to uwzględnienie w kodzie gry plików nagłówkowych z pakietu Android Game SDK:

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

W pliku CMakeLists.txt głównej aplikacji znajdź target_link_libraries głównej biblioteki udostępnionej. Dodaj odwołania do statycznych bibliotek pakietu Android Game SDK, aby uwzględnić je w bibliotece współdzielonej:

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

Opinia

Twoja opinia pomoże nam ulepszyć Jetpacka. Jeśli odkryjesz nowe problemy lub masz pomysły na ulepszenie tej biblioteki, daj nam znać. Zanim utworzysz nową kartę, zapoznaj się z dotychczasowymi problemami w tej bibliotece. Możesz dodać swój głos do istniejącego problemu, klikając przycisk gwiazdki.

Tworzenie nowego problemu

Więcej informacji znajdziesz w dokumentacji narzędzia Issue Tracker.

Games-Memory-Advice w wersji 2.1

Wersja 2.1.0-beta01

29 listopada 2023 r.

Zostanie wycofaneandroidx.games:games-memory-advice:2.1.0-beta01 Wersja 2.1.0-beta01 zawiera te zmiany.

Wersja 2.1.0-alpha01

15 listopada 2023 r.

Zostanie wycofaneandroidx.games:games-memory-advice:2.1.0-alpha01 Wersja 2.1.0-alpha01 zawiera te zmiany.

Nowe funkcje

  • Zaktualizowaliśmy model pamięci biblioteki, aby zwiększyć dokładność prognoz.

Zmiany w interfejsie API

  • Dodaliśmy nowy interfejs API getAvailableMemory(), który zwraca szacunkową ilość pamięci, jaką można bezpiecznie przydzielić (w bajtach).

Wersja 2.1.0-alpha01

26 lipca 2023 r.

Zostanie wycofaneandroidx.games:games-memory-advice:2.1.0-alpha01 Wersja 2.1.0-alpha01 zawiera te zmiany.

Zmiany w interfejsie API

  • Dodaj funkcjęGetAvailableMemory

Poprawki błędów

  • Aktualizowanie modelu Memory Advice
  • Poprawianie wspólnego memory_advice celu kompilacji

Gry-Pamięć-Porady w wersji 2.0

Wersja 2.0.1

20 września 2023 r.

Zostanie wycofaneandroidx.games:games-memory-advice:2.0.1 Wersja 2.0.1 zawiera te zmiany.

Poprawki błędów

  • Naprawiono awarię występującą w wątku obserwatora stanu, która była spowodowana tym, że wątek nie był dołączony do JVM.

Wersja 2.0.0

6 września 2023 r.

Zostanie wycofaneandroidx.games:games-memory-advice:2.0.0 Wersja 2.0.0 zawiera te zmiany.

Główne funkcje wersji 2.0.0

  • W tej wersji wytrenowaliśmy i udostępniliśmy nowy model ML.
  • Wdrożono interfejs API do przewidywania ilości wolnej pamięci.

Wersja 2.0.0-rc01

26 lipca 2023 r.

Zostanie wycofaneandroidx.games:games-memory-advice:2.0.0-rc01 Wersja 2.0.0-rc01 zawiera te zmiany.

Nowe funkcje

  • Dodaliśmy nowy model, który lepiej prognozuje pozostałą pamięć.

Poprawki błędów

  • Rozwiązanie problemu z nieprawidłowym działaniem funkcji Memory Advice w przypadku udostępnionego pliku STL.

Wersja 2.0.0-beta04

24 maja 2023 r.

Zostanie wycofaneandroidx.games:games-memory-advice:2.0.0-beta04 Wersja 2.0.0-beta04 zawiera te zmiany.

Nowe funkcje

  • Zaktualizowano model uczenia maszynowego, który obsługuje bibliotekę, co pozwoli uzyskać lepsze wyniki na nowszych telefonach.

Wersja 2.0.0-beta03

5 kwietnia 2023 r.

Zostanie wycofaneandroidx.games:games-memory-advice:2.0.0-beta03 Wersja 2.0.0-beta03 zawiera te zmiany.

Poprawki błędów

  • Naprawiliśmy błąd polegający na tym, że biblioteka nie mogła prawidłowo wczytać wymaganych komponentów TensorFlow Lite.

Wersja 2.0.0-beta02

22 marca 2023 r.

Zostanie wycofaneandroidx.games:games-memory-advice:2.0.0-beta02 Wersja 2.0.0-beta02 zawiera te zmiany.

Poprawki błędów

  • Naprawiliśmy błąd, który uniemożliwiał prawidłowe połączenie statycznej wersji biblioteki.

Wersja 2.0.0-beta01

22 lutego 2023 roku

Zostanie wycofaneandroidx.games:games-memory-advice:2.0.0-beta01 Wersja 2.0.0-beta01 zawiera te zmiany.

Nowe funkcje

  • Brak nowych zmian

Wersja 2.0.0-alpha01

8 lutego 2023 r.

Zostanie wycofaneandroidx.games:games-memory-advice:2.0.0-alpha01 Wersja 2.0.0-alpha01 zawiera te zmiany.

Zmiany w interfejsie API

  • Wzrost wersji głównej z powodu refaktoryzacji plików kompilacji.

Poprawki błędów

  • Nieprawidłowa konfiguracja komponentów biblioteki powoduje teraz błąd zamiast awarii.

Games-Memory-Advice w wersji 1.0.0

Wersja 1.0.0-beta03

9 listopada 2022 r.

Zostanie wycofaneandroidx.games:games-memory-advice:1.0.0-beta03 Wersja 1.0.0-beta03 zawiera te zmiany.

Nowe funkcje

  • Brak nowych zmian

Wersja 1.0.0-beta01

9 marca 2022 r.

Zostanie wycofaneandroidx.games:games-memory-advice:1.0.0-beta01 Wersja 1.0.0-beta01 zawiera te zmiany.

  • Brak zmian od wersji 1.0.0-alpha01.

Wersja 1.0.0-alpha01

23 lutego 2022 r.

Zostanie wycofaneandroidx.games:games-memory-advice:1.0.0-alpha01 Wersja 1.0.0-alpha01 zawiera te zmiany.

Nowe funkcje

  • Ta biblioteka C umożliwia wysyłanie zapytań i otrzymywanie wywołań zwrotnych dotyczących zmian w stanie pamięci urządzenia, na którym uruchomiona jest gra.

Zmiany w interfejsie API

  • To pierwsza wersja biblioteki porad dotyczących pamięci. Pełną listę interfejsów API znajdziesz w pliku nagłówkowym include/memory_advice/memory_advice.h.

Wkład zewnętrzny

Games-Text-Input w wersji 3.0

Wersja 3.0.4

7 sierpnia 2024 r.

Zostanie wycofaneandroidx.games:games-text-input:3.0.4 Wersja 3.0.4 zawiera te zmiany.

Poprawki błędów

  • Poprawiono działanie usuwania z zaznaczonym tekstem i bez niego.

Gry – aktywność w wersji 4.0

Wersja 4.2.0-alpha01

26 marca 2025 r.

androidx.games:games-activity:4.2.0-alpha01androidx.games:games-text-input:4.2.0-alpha01 zostały opublikowane. Wersja 4.2.0-alpha01 zawiera te zmiany.

Nowe funkcje

  • Uaktualnienie do Gradle 8.8.1 (1ed0153)
  • Uaktualnienie do Javy 17 (1ed0153)

Poprawki błędów

  • Naprawienie błędu w GameActivity, w którym getLocaleScript, getLocaleCountrygetLocaleVariant zgłaszały język ustawiony w lokalizacji zamiast żądanej wartości (1198bb0).
  • Naprawiliśmy błąd w GameActivity, który powodował nieprawidłowe raportowanie zdarzeń otwierania i zamykania klawiatury ekranowej. (a63ecca)
  • Naprawiono błąd w GameTextInput związany z obsługą emotikonów wielobajtowych (9d54c68).

Wersja 4.0.0

12 lutego 2025 r.

androidx.games:games-activity:4.0.0androidx.games:games-text-input:4.0.0 zostały opublikowane. Wersja 4.0.0 zawiera te zmiany.

Główne funkcje wersji 4.0.0

  • Pliki AAR zawierają teraz wstępnie skompilowane biblioteki statyczne. Kod aplikacji powinien teraz korzystać z tych bibliotek za pomocą prefabrykatów i zawierać tylko nagłówki (np. #include "GameActivity.h"), a nie implementację (np. #include "GameActivity.cpp").
  • Informacje o języku Androida są teraz dostępne dla kodu natywnego, który korzysta z GameActivity.

Poprawki błędów

  • Naprawiliśmy liczne błędy w GameTextInput. Biblioteka jest teraz bardziej stabilna i działa z wieloma popularnymi klawiaturami programowymi i sprzętowymi.

Wersja 4.0.0-rc01

29 stycznia 2025 r.

androidx.games:games-activity:4.0.0-rc01androidx.games:games-text-input:4.0.0-rc01 zostały opublikowane. Wersja 4.0.0-rc01 zawiera te zmiany.

Wersja 4.0.0-beta01

15 stycznia 2025 r.

androidx.games:games-activity:4.0.0-beta01androidx.games:games-text-input:4.0.0-beta01 zostały opublikowane. Wersja 4.0.0-beta01 zawiera te zmiany.

Poprawki błędów

  • Lepsza dokumentacja nowo dodanych funkcji związanych z ustawieniami regionalnymi.
  • Dodaliśmy typy pomocnicze do wszystkich typów wyliczeniowych.

Wersja 4.0.0-alpha01

16 października 2024 r.

androidx.games:games-activity:4.0.0-alpha01androidx.games:games-text-input:4.0.0-alpha01 zostały opublikowane. Wersja 4.0.0-alpha01 zawiera te zmiany.

Nowe funkcje

  • GameTextInput obsługuje teraz klawisze strzałek w lewo i w prawo.

Zmiany w interfejsie API

  • Usunięto przestarzałe interfejsy Java w GameTextInput.
  • W przypadku prefabrykatów GameActivityGameTextInput wszystkie pliki źródłowe są teraz uwzględniane. #include <GameActivity.cpp> nie jest już zalecane. Zamiast tego utwórz link do odpowiedniej biblioteki statycznej lub dynamicznej, np. game-activity::game-activity_staticCMake. Te biblioteki są dostarczane w pliku AAR.

Poprawki błędów

  • Wprowadziliśmy liczne poprawki w GameTextInput. Naprawiliśmy funkcję pisania i usuwania.
  • Zwiększyliśmy zgodność z najpopularniejszymi klawiaturami programowymi.
  • Poprawiliśmy obsługę znaków specjalnych na klawiaturach sprzętowych.
  • Naprawiono rzadki błąd dostępu do wskaźnika zerowego w GameActivity.

Gry-Aktywność w wersji 3.0

Wersja 3.0.5

7 sierpnia 2024 r.

Zostanie wycofaneandroidx.games:games-activity:3.0.5 Wersja 3.0.5 zawiera te zmiany.

Poprawki błędów

  • Nowa wersja GameActivity, która jest zgodna z wersją 3.0.4 GameTextInput (poprawiono funkcję usuwania tekstu w polach wejściowych).

Wersja 3.0.4

10 lipca 2024 r.

Zostanie wycofaneandroidx.games:games-activity:3.0.4 Wersja 3.0.4 zawiera te zmiany.

Poprawki błędów

  • Poprawiono obsługę wskaźników o wartości null.
  • Naprawiliśmy brakujące aktualizacje stanu w przypadku niektórych stanów w wywołaniu zwrotnym onConfiguration().

Wersja 3.0.3

17 kwietnia 2024 r.

androidx.games:games-activity:3.0.3androidx.games:games-text-input:3.0.3 zostały opublikowane. Wersja 3.0.3 zawiera te zmiany.

Poprawki błędów

  • Rozwiązaliśmy problemy ze zgodnością z niektórymi klawiaturami ekranowymi.

Wersja 3.0.2

3 kwietnia 2024 r.

androidx.games:games-activity:3.0.2androidx.games:games-text-input:3.0.2 zostały opublikowane. Wersja 3.0.2 zawiera te zmiany.

Poprawki błędów

  • Wprowadziliśmy kilka poprawek w GamesTextInput, które mają na celu ulepszenie obsługi klawiatur programowych i sprzętowych. Naprawiliśmy też błąd, który uniemożliwiał używanie GameTextInput bez GameActivity.

Wersja 3.0.1

20 marca 2024 r.

androidx.games:games-activity:3.0.1androidx.games:games-text-input:3.0.1 zostały opublikowane. Wersja 3.0.1 zawiera te zmiany.

Poprawki błędów

  • Rozwiązaliśmy problem z wpisywaniem i wyświetlaniem znaków specjalnych.

Wersja 3.0.0

6 marca 2024 roku

androidx.games:games-activity:3.0.0androidx.games:games-text-input:3.0.0 zostały opublikowane. Wersja 3.0.0 zawiera te zmiany.

Główne funkcje wersji 3.0.0

  • GameTextInput zostało zmodyfikowane, aby można było go używać w grach.
  • W porównaniu z wersją 2.0.0 niektóre interfejsy w obu bibliotekach zostały zmienione.

Poprawki błędów

  • Rozwiązaliśmy problemy ze zgodnością ze starszymi wersjami NDK.
  • Rozwiązaliśmy problemy z kompilacją w systemie Windows

Wersja 3.0.0-rc01

21 lutego 2024 r.

androidx.games:games-activity:3.0.0-rc01androidx.games:games-text-input:3.0.0-rc01 zostały opublikowane. Wersja 3.0.0-rc01 zawiera te zmiany.

Poprawki błędów

  • Rozwiązaliśmy problem z zawieszaniem się, który występował, gdy pętla nieprawidłowo obsługiwała zdarzenia klawiatury.

Wersja 3.0.0-beta01

29 listopada 2023 r.

androidx.games:games-activity:3.0.0-beta01androidx.games:games-text-input:3.0.0-beta01 zostały opublikowane. Wersja 3.0.0-beta01 zawiera te zmiany.

Wersja 3.0.0-alpha01

15 listopada 2023 r.

androidx.games:games-activity:3.0.0-alpha01androidx.games:games-text-input:3.0.0-alpha01 zostały opublikowane. Wersja 3.0.0-alpha01 zawiera te zmiany.

Zmiany w interfejsie API

  • Rozmiary struktur GameActivityMotionEventGameActivityCallbacks uległy zmianie.
  • onEditorAction zmienia typ zwracany z wartości logicznej na pusty.
  • setImeEditorInfo oczekuje teraz parametrów enum, a nie liczb całkowitych.
  • funkcje wewnętrzne GameActivityEvents są przenoszone do GameActivityEvents_internal.h.
  • Typy danych wejściowych funkcji GameTextInput to też wyliczenia, a nie liczby całkowite.

Gry i aktywności w wersji 2.1

Wersja 2.1.0-alpha02

6 września 2023 r.

androidx.games:games-activity:2.1.0-alpha02androidx.games:games-text-input:2.1.0-alpha02 zostały opublikowane. Wersja 2.1.0-alpha02 zawiera te zmiany.

Poprawki błędów

  • Poprawiliśmy zgodność z urządzeniami 32-bitowymi.

Wersja 2.1.0-alpha01

26 lipca 2023 r.

Zostanie wycofaneandroidx.games:games-activity:2.1.0-alpha01 Wersja 2.1.0-alpha01 zawiera te zmiany.

Nowe funkcje

  • Umożliwia zastąpienie tworzenia instancji SurfaceView.
  • Dodawanie raportowania wersji pakietu SDK

Zmiany w interfejsie API

  • Używaj int64_t zamiast long w przypadku historicalEventTimes, aby uniknąć przekroczenia limitu w systemach 32-bitowych.
  • Dodaj metodę GameActivity_restartInput
  • Dodawanie wywołania zwrotnego natywnego do obsługi zmiany widoczności klawiatury ekranowej

Poprawki błędów

  • Optymalizacja obsługi zdarzeń dotknięcia
  • Poprawianie zniszczenia GameActivityMotionEven
  • Naprawianie obliczania indeksu GameActivityMotionEvent_getHistoricalAxisValue
  • Naprawianie masek bitowych filtra ruchu

Gry-aktywności w wersji 2.0

Wersja 2.0.2

24 maja 2023 r.

Zostanie wycofaneandroidx.games:games-activity:2.0.2 Wersja 2.0.2 zawiera te zmiany.

Poprawki błędów

  • Poprawki stabilności w GameActivityEvents (b/278017467)

Wersja 2.0.1

5 kwietnia 2023 r.

Zostanie wycofaneandroidx.games:games-activity:2.0.1 Wersja 2.0.1 zawiera te zmiany.

Poprawki błędów

  • Naprawiliśmy przedwczesne zwalnianie pamięci w przypadku historicalEventTimes.
  • Rozwiązaliśmy problem z przekraczaniem limitu znaków w przypadku historicalEventTimesNanos w systemach 32-bitowych.

Wersja 2.0.0

8 marca 2023 r.

Zostanie wycofaneandroidx.games:games-activity:2.0.0 Wersja 2.0.0 zawiera te zmiany.

Główne funkcje wersji 2.0.0

  • Zmieniliśmy interfejs czasów zdarzeń historycznych, aby przekroczyć limit 32 bitów.
  • Umożliwia użytkownikom wprowadzanie zmian w konfiguracji, np. orientacji.
  • Zadbaj o to, by informacje w contentRect były aktualne.
  • Ułatwiono dostosowywanie domyślnych SurfaceView.
  • Stała domyślna obsługa zdarzeń dotykowych przez system operacyjny, np. obsługa przycisków systemowych.
  • Zoptymalizowano większość wywołań JNI w obsłudze zdarzeń dotykowych, co wcześniej wpływało na wydajność.

Wersja 2.0.0-rc01

22 lutego 2023 roku

Zostanie wycofaneandroidx.games:games-activity:2.0.0-rc01 Wersja 2.0.0-rc01 zawiera te zmiany.

Wersja 2.0.0-beta01

8 lutego 2023 r.

Zostanie wycofaneandroidx.games:games-activity:2.0.0-beta01 Wersja 2.0.0-beta01 zawiera te zmiany.

Poprawki błędów

  • Poprawiono obsługę przycisków systemowych. (2a103e)

Wersja 2.0.0-alpha01

11 stycznia 2023 r.

androidx.games:games-activity:2.0.0-alpha01 zostaje opublikowany bez zmian. Wersja 2.0.0-alpha01 zawiera te zmiany.

Games-Activity Version 1.2

Wersja 1.2.2

7 grudnia 2022 r.

Zostanie wycofaneandroidx.games:games-activity:1.2.2 Wersja 1.2.2 zawiera te zmiany.

Poprawki błędów

  • Maksymalną liczbę zdarzeń związanych z ruchem można teraz ustawić w czasie działania.

Wersja 1.2.2-alpha01

9 listopada 2022 r.

Zostanie wycofaneandroidx.games:games-activity:1.2.2-alpha01 Wersja 1.2.2-alpha01 zawiera te zmiany.

Zmiany w interfejsie API

  • Interfejs API zawiera teraz też informacje o wersji w formie GAMEACTIVITY_PACKED_VERSION. (I287e6)
  • Dodano wywołanie zwrotne onContentRectChanged, które jest wywoływane, gdy zmieni się prostokąt w oknie, w którym mają być umieszczone treści. (I81396)

Poprawki błędów

  • Naprawiono przepełnienie bufora zdarzeń. Zarówno inputBuffer->keyEvents, jak i motionEvents to teraz bufory przydzielane dynamicznie. (Ic00f6)
  • W przypadku braku pamięci funkcja działa bez błędów. Dodano obsługę błędów realloc() podczas zmiany rozmiaru buforów.

Wersja 1.2.1

13 lipca 2022 r.

Zostanie wycofaneandroidx.games:games-activity:1.2.1 Wersja 1.2.1 zawiera te zmiany.

Poprawki błędów

  • Rozwiązaliśmy problemy z brakującym plikiem .aar w poprzedniej wersji.

Wersja 1.2.0

15 czerwca 2022 r.

Zostanie wycofaneandroidx.games:games-activity:1.2.0 Wersja 1.2.0 zawiera te zmiany.

Ważne zmiany od wersji 1.1.0

  • Zezwól klasom pochodnym GameActivity na obsługę wczytywania biblioteki natywnej.
  • Zawsze wczytuj bibliotekę natywną w metodzie GameActivity.onCreate.
  • Jeśli nie znaleziono innej biblioteki, nastąpi powrót do wczytywania biblioteki o nazwie „main”.

Gry-aktywności w wersji 1.1

Wersja 1.1.0

23 lutego 2022 r.

androidx.games:games-activity:1.1.0androidx.games:games-controller:1.1.0 zostały opublikowane. Wersja 1.1.0 zawiera te zmiany.

Ważne zmiany od wersji 1.0.0

Aktywność w grach:

  • Nasłuchiwanie WindowInsets i wysyłanie zapytań dotyczących wycięcia i odpowiedzi IME
  • Dodawanie filtrów kluczowych zdarzeń i zdarzeń ruchu
  • Poprawki błędów:
    • Dodawanie brakujących wiadomości w celu zapewnienia zgodności z klasą NativeActivity
    • Poprawianie podpisu funkcji onNativeWindowResized
    • Rozwiązywanie problemów z utratą zdarzeń wejściowych

Wersja 1.1.0-rc01

9 lutego 2022 r.

androidx.games:games-activity:1.1.0-rc01androidx.games:games-controller:1.1.0-rc01 zostały opublikowane. Wersja 1.1.0-rc01 zawiera te zmiany.

Wersja 1.1.0-beta03

26 stycznia 2022 r.

Zostanie wycofaneandroidx.games:games-activity:1.1.0-beta03 Wersja 1.1.0-beta03 zawiera te commity.

Poprawki błędów

  • Napraw podpis onNativeWindowResized
  • Zachowaj uchwyt do natywnego okna w onSurfaceChanged

Wersja 1.1.0-beta02

15 grudnia 2021 roku

Zostanie wycofaneandroidx.games:games-activity:1.1.0-beta02 Wersja 1.1.0-beta02 zawiera te zmiany.

Poprawki błędów

  • Naprawiono wyścig w ustawieniu filtra zdarzeń.

Wersja 1.1.0-beta01

17 listopada 2021 r.

Zostanie wycofaneandroidx.games:games-activity:1.1.0-beta01 Wersja 1.1.0-beta01 zawiera te zmiany.

Nowe funkcje

  • Dodaliśmy obsługę zapytań dotyczących wcięć okna i nasłuchiwania zmian w tych wcięciach. Dzięki temu gry mogą reagować na pojawienie się narzędzia IME i radzić sobie z wcięciami na aparat i wcięciami w kształcie wodospadu.

Zmiany w interfejsie API

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

Poprawki błędów

  • Unikanie korzystania ze wszystkich kluczowych zdarzeń: głośność, aparat itp. są teraz przekazywane do systemu.

Wersja 1.1.0-alpha01

29 września 2021 r.

Zostanie wycofaneandroidx.games:games-activity:1.1.0-alpha01 Wersja 1.1.0-alpha01 zawiera te zmiany.

Zmiany w interfejsie API

  • Dodano wywołanie zwrotne onContentRectChanged do funkcji GameActivityCallbacks

Poprawki błędów

  • Dodano brakujące wiadomości do pliku android_native_app_glue.h:
    • APP_CMD_CONTENT_RECT_CHANGED
    • APP_CMD_WINDOW_REDRAW_NEEDED

Games Performance Tuner 2.0

Wersja 2.0.0

7 sierpnia 2024 r.

Zostanie wycofaneandroidx.games:games-performance-tuner:2.0.0 Wersja 2.0.0 zawiera te zmiany.

Główne funkcje wersji 2.0.0

  • Od wersji 2.0.0beta01 nie wprowadziliśmy żadnych większych zmian. Oznaczamy tę wersję jako stabilną.

Wersja 2.0.0-beta01

10 stycznia 2024 r.

androidx.games:games-performance-tuner:2.0.0-beta01 nie zawiera zmian w porównaniu z ostatnią wersją alfa. Wersja 2.0.0-beta01 zawiera te zmiany.

Wersja 2.0.0-alpha07

29 listopada 2023 r.

Zostanie wycofaneandroidx.games:games-performance-tuner:2.0.0-alpha07 Wersja 2.0.0-alpha07 zawiera te zmiany.

Poprawki błędów

  • Naprawiono problem z raportowaniem danych telemetrycznych pamięci, które czasami zawierały nieprawidłowe wartości.

Wersja 2.0.0-alpha06

1 listopada 2023 roku

Zostanie wycofaneandroidx.games:games-performance-tuner:2.0.0-alpha06 Wersja 2.0.0-alpha06 zawiera te zmiany.

Wersja 2.0.0-alpha05

23 sierpnia 2023 r.

Zostanie wycofaneandroidx.games:games-performance-tuner:2.0.0-alpha05 Wersja 2.0.0-alpha05 zawiera te zmiany.

Nowe funkcje

  • Przeniesiono bibliotekę Protobuf do Protobuf lite.

Poprawki błędów

  • Rozwiązaliśmy problemy z wiszącym wskaźnikiem.

Wersja 2.0.0-alpha04

19 kwietnia 2023 r.

Zostanie wycofaneandroidx.games:games-performance-tuner:2.0.0-alpha04 Wersja 2.0.0-alpha04 zawiera te zmiany.

Nowe funkcje

  • Zaktualizowaliśmy funkcje zbierania danych telemetrycznych w bibliotece, co umożliwia bardziej szczegółowe raportowanie czasu renderowania klatek.

Poprawki błędów

  • Usunęliśmy błąd, który powodował awarię biblioteki, gdy maksymalna liczba kluczy instrumentacji była większa niż liczba histogramów.

Wersja 2.0.0-alpha03

22 lutego 2023 roku

Zostanie wycofaneandroidx.games:games-performance-tuner:2.0.0-alpha03 Wersja 2.0.0-alpha03 zawiera te zmiany.

Poprawki błędów

  • Narzędzie Games-Performance-Tuner zostało przeniesione do nowego procesu publikowania. Nie powinno to powodować żadnych zmian w działaniu.

Wersja 2.0.0-alpha02

8 lutego 2023 r.

Zostanie wycofaneandroidx.games:games-performance-tuner:2.0.0-alpha02 Wersja 2.0.0-alpha02 zawiera te zmiany.

Zmiany w interfejsie API

  • TuningFork_predictQualityLevels Dodano interfejs API, który pomoże przewidzieć prawidłowy poziom jakości lub parametry wierności.

Games Performance Tuner 1.6

Wersja 1.6.1-alpha01

9 listopada 2022 r.

Zostanie wycofaneandroidx.games:games-performance-tuner:1.6.1-alpha01 Wersja 1.6.1-alpha01 zawiera te zmiany.

Nowe funkcje

  • Brak nowych zmian

Wersja 1.6.0

15 czerwca 2022 r.

Zostanie wycofaneandroidx.games:games-performance-tuner:1.6.0 Wersja 1.6.0 zawiera te zmiany.

Ważne zmiany od wersji 1.5.0

  • Naprawiono problem z funkcją getpid zwracającą wartość 0 podczas próby pobrania danych telemetrycznych dotyczących pamięci.
  • Zatrzymano wykonywanie funkcji StopLoadingGroup bez aktywnej grupy ładowania.

Games Performance Tuner 1.5.0

Wersja 1.5.0

9 lutego 2022 r.

Zostanie wycofaneandroidx.games:games-performance-tuner:1.5.0 Wersja 1.5.0 zawiera te zmiany.

Ważne zmiany od wersji 1.4.0

  • Programowe zmienianie interwału między przesyłaniem, zamiast zakodowania go na stałe w ustawieniach początkowych.
    • Dodana funkcja: TuningFork_setAggregationStrategyInterval
  • Poprawka dotycząca uszkodzenia pamięci w kluczu interfejsu API na urządzeniu API<=23

Wersja 1.5.0-rc01

26 stycznia 2022 r.

Zostanie wycofaneandroidx.games:games-performance-tuner:1.5.0-rc01 Wersja 1.5.0-rc01 zawiera te zmiany.

Poprawki błędów

  • Poprawka dotycząca uszkodzenia pamięci w kluczu interfejsu API na urządzeniach z Androidem w wersji 23 lub starszej

Wersja 1.5.0-beta02

15 grudnia 2021 roku

Zostanie wycofaneandroidx.games:games-performance-tuner:1.5.0-beta02 Wersja 1.5.0-beta02 zawiera te zmiany.

Zmiany w interfejsie API

  • Usuń zmianę powodującą niezgodność interfejsu ABI z TuningFork_Settings.

Wersja 1.5.0-beta01

29 września 2021 r.

Zostanie wycofaneandroidx.games:games-performance-tuner:1.5.0-beta01 Wersja 1.5.0-beta01 zawiera te zmiany.

Nowe funkcje

  • Brak zmian w stosunku do wersji alfa. Ta wersja zawierała:
    • Programowe zmienianie interwału między przesyłaniem, zamiast zakodowania go na stałe w ustawieniach początkowych.

Zmiany w interfejsie API

  • Brak zmian w stosunku do wersji alfa. Ta wersja zawierała:
    • Nowa funkcja: TuningFork_setAggregationStrategyInterval
    • Nowe pole w TuningFork_Settings: aggregation_strategy_intervalms_or_count

Wersja 1.5.0-alpha01

18 sierpnia 2021 r.

Zostanie wycofaneandroidx.games:games-performance-tuner:1.5.0-alpha01 Wersja 1.5.0-alpha01 zawiera te zmiany.

Nowe funkcje

  • Interwał między przesyłaniem plików APT można teraz ustawiać automatycznie, a nie za pomocą pliku ustawień.

Zmiany w interfejsie API

  • Dodana funkcja: TuningFork_setAggregationStrategyInterval
  • Dodano pole do struktury TuningFork_Settings: aggregation_strategy_intervalms_or_count

Gry-aktywności w wersji 1.0.0

Wersja 1.0.0

4 sierpnia 2021 r.

androidx.games:games-activity:1.0.0, androidx.games:games-controller:1.0.0androidx.games:games-text-input:1.0.0 są zwalniane. Wersja 1.0.0 zawiera te zmiany.

Główne funkcje wersji 1.0.0

Jest to pierwsza stabilna wersja bibliotek Games-Activity, Games-Controller i Games-Text-Input. Więcej informacji znajdziesz na stronie głównej AGDK.

Wersja 1.0.0-rc01

12 lipca 2021 roku

Zostanie wycofaneandroidx.games:games-activity:1.0.0-rc01 Wersja 1.0.0-rc01 zawiera te zmiany.

Poprawki błędów

  • Popraw typ zwrotu GameActivityCallbacks::onSaveInstanceState

Wersja 1.0.0-beta01

30 czerwca 2021 r.

Zostanie wycofaneandroidx.games:games-activity:1.0.0-beta01 Wersja 1.0.0-beta01 zawiera te zmiany.

Zmiany w interfejsie API

  • Zmień nazwę GameActivityInputInfo na GameActivityPointerAxes.
  • Wywołanie zwrotne onNativeWindowResized podaje teraz szerokość i wysokość okna.
  • Wywołanie zwrotne onContentRectChanged zostało usunięte.
  • Nazwa onLowMemory została zmieniona na onTrimMemory.
  • Opcja GameActivity_setWindowFormat została usunięta.
  • Ulepszony model własności wskaźników GameActivityMotionEventsGameActivityMotionEvent.
  • Ulepszony model własności stanu użytkownika w wywołaniu zwrotnym onSaveInstanceState.

Wersja 1.0.0-alpha01

16 czerwca 2021 r.

Zostanie wycofaneandroidx.games:games-activity:1.0.0-alpha01

Nowe funkcje

  • Games-Activity to nowa biblioteka, która zastępuje NativeActivity jako zalecany sposób integrowania gier w C/C++ z Androidem.

Gry – kontroler, wersja 2.2

Wersja 2.2.0-alpha01

26 marca 2025 r.

androidx.games:games-controller:2.2.0-alpha01, androidx.games:games-memory-advice:2.2.0-alpha01androidx.games:games-performance-tuner:2.2.0-alpha01 są zwalniane. Wersja 2.2.0-alpha01 zawiera te zmiany.

Nowe funkcje

  • Uaktualnienie do Gradle 8.8.1 (1ed0153)
  • Uaktualnienie do Javy 17 (1ed0153)
  • Zmień wartość targetSdk na 35 (eddf605)

Games-Controller w wersji 2.0

Wersja 2.0.2

12 czerwca 2024 r.

Zostanie wycofaneandroidx.games:games-controller:2.0.2 Wersja 2.0.2 zawiera te zmiany.

Poprawki błędów

  • Rozwiązaliśmy problem polegający na tym, że wywołania zwrotne połączonego kontrolera nie były wywoływane w przypadku kontrolerów połączonych przed Paddleboat_init.
  • Rozwiązaliśmy problem polegający na tym, że touchpady kontrolerów do gier nie rejestrowały naciśnięć w Paddleboat_processGameActivityMotionInputEvent bez ręcznego włączania osi nacisku.
  • Rozwiązaliśmy problem polegający na tym, że zdarzenia touchpada kontrolera do gier nie były oznaczane jako wykorzystane przez Paddleboat_processGameActivityMotionInputEvent.

Wersja 2.0.1

20 września 2023 r.

`androidx.games:games-controller:2.0.1 ' została wydana. Wersja 2.0.1 zawiera te zmiany.

Poprawki błędów kontrolera gier:

  • Napraw rzadki warunek NullReferenceException w procedurze obsługi onInputDeviceChanged.
  • Poprawka zapobiegająca nieprawidłowemu rejestrowaniu niektórych klawiatur USB jako kontrolerów do gier.

Wersja 2.0.0

8 marca 2023 r.

Zostanie wycofaneandroidx.games:games-controller:2.0.0 Wersja 2.0.0 zawiera te zmiany.

Główne funkcje wersji 2.0.0

  • Dodaliśmy możliwość wykrywania stanu połączenia klawiatur sprzętowych.
  • Dodano możliwość raportowania danych o ruchu (akcelerometr/żyroskop) z urządzenia głównego (czyli telefonu) oraz kontrolerów.
  • Zmieniliśmy interfejs API i format bazy danych definicji kontrolera, aby zmniejszyć zużycie pamięci i obsługiwać dodatkowe funkcje.

Wersja 2.0.0-alpha01

11 stycznia 2023 r.

Zostanie wycofaneandroidx.games:games-controller:2.0.0-alpha01 Wersja 2.0.0-alpha01 zawiera te zmiany.

Nowe funkcje

  • Wykrywanie klawiatury sprzętowej
  • Zintegrowana obsługa raportowania danych o ruchu z czujników (czyli odbieranie danych z żyroskopu i akcelerometru z samego telefonu)
  • Nowy zoptymalizowany format danych mapowania kontrolera

Zmiany w interfejsie API

  • Nowe wywołania interfejsu API dla klawiatury sprzętowej: Paddleboat_getPhysicalKeyboardStatusPaddleboat_setPhysicalKeyboardStatusCallback
  • Nowe wywołania interfejsu API do raportowania zintegrowanych danych o ruchu z czujników: Paddleboat_getIntegratedMotionSensorFlagsPaddleboat_setMotionDataCallbackWithIntegratedFlags
  • Nowe wywołania interfejsu API dla zmienionego formatu danych mapowania kontrolera: Paddleboat_addControllerRemapDataFromFd,Paddleboat_addControllerRemapDataFromFileBuffer
  • Wycofane stare wywołania interfejsu API mapowania: Paddleboat_addControllerRemapDataPaddleboat_getControllerRemapTableData

Poprawki błędów

  • Rozwiązaliśmy problem ze zgodnością z wydarzeniami związanymi z ruchem w GameActivity w wersji 1.2.2 i nowszych.

Games-Controller w wersji 1.1.0

Wersja 1.1.0

23 lutego 2022 r.

androidx.games:games-activity:1.1.0androidx.games:games-controller:1.1.0 zostały opublikowane. Wersja 1.1.0 zawiera te zmiany.

Ważne zmiany od wersji 1.0.0

Aktywność w grach:

  • Nasłuchiwanie WindowInsets i wysyłanie zapytań dotyczących wycięcia i odpowiedzi IME
  • Dodawanie filtrów kluczowych zdarzeń i zdarzeń ruchu
  • Poprawki błędów:
    • Dodawanie brakujących wiadomości w celu zapewnienia zgodności z klasą NativeActivity
    • Poprawianie podpisu funkcji onNativeWindowResized
    • Rozwiązywanie problemów z utratą zdarzeń wejściowych

Wersja 1.1.0-rc01

9 lutego 2022 r.

Zostanie wycofaneandroidx.games:games-controller:1.1.0-rc01 Wersja 1.1.0-rc01 zawiera te zmiany.

Wersja 1.1.0-beta01

26 stycznia 2022 r.

androidx.games:games-controller:1.1.0-beta01 zostaje opublikowany bez zmian od 1.1.0-alpha01. Wersja 1.1.0-beta01 zawiera te zmiany.

Wersja 1.1.0-alpha01

15 grudnia 2021 roku

Zostanie wycofaneandroidx.games:games-controller:1.1.0-alpha01 Wersja 1.1.0-alpha01 zawiera te zmiany.

Nowe funkcje

Dodano obsługę stanu baterii, wibracji dwóch silników, sterowania oświetleniem i raportowania osi ruchu na obsługiwanych kontrolerach w systemie Android S lub nowszym.

Zmiany w interfejsie API

  • Dodano funkcję Paddleboat_setMotionDataCallback do rejestrowania wywołań zwrotnych danych o ruchu kontrolera.
  • Dodano funkcję Paddleboat_setControllerLight do zmiany ustawień oświetlenia kontrolera.
  • Do kampanii Paddleboat_Controller_Data dodano strukturę Paddleboat_Controller_Battery
  • Nowe struktury:
    • Paddleboat_Controller_Battery
    • Paddleboat_Motion_Data
  • Nowe wyliczenia:
    • Paddleboat_BatteryStatus
    • Paddleboat_LightType
    • Paddleboat_Motion_Type
  • Nowe flagi kontrolera:
    • PADDLEBOAT_CONTROLLER_FLAG_ACCELEROMETER
    • PADDLEBOAT_CONTROLLER_FLAG_GYROSCOPE
    • PADDLEBOAT_CONTROLLER_FLAG_LIGHT_PLAYER
    • PADDLEBOAT_CONTROLLER_FLAG_LIGHT_RGB
    • PADDLEBOAT_CONTROLLER_FLAG_BATTERY

Poprawki błędów

  • Dodano alternatywny wpis w bazie danych deviceId dla kontrolera PS4
  • Dodano wpis w bazie danych interfejsu API >=31 dla kontrolera PS5

Games-Controller w wersji 1.0.0

Wersja 1.0.0

4 sierpnia 2021 r.

androidx.games:games-activity:1.0.0, androidx.games:games-controller:1.0.0androidx.games:games-text-input:1.0.0 są zwalniane. Wersja 1.0.0 zawiera te zmiany.

Główne funkcje wersji 1.0.0

Jest to pierwsza stabilna wersja bibliotek Games-Activity, Games-Controller i Games-Text-Input. Więcej informacji znajdziesz na stronie głównej AGDK.

Wersja 1.0.0-rc02

21 lipca 2021 r.

Zostanie wycofaneandroidx.games:games-controller:1.0.0-rc02 Wersja 1.0.0-rc02 zawiera te zmiany.

Poprawki błędów

  • Naprawiliśmy błąd pakowania, który powodował, że importowanie prefabrykatów kończyło się niepowodzeniem w przypadku pustych, nieużywanych permutacji architektury lub wersji.

Wersja 1.0.0-rc01

12 lipca 2021 roku

Zostanie wycofaneandroidx.games:games-controller:1.0.0-rc01 Wersja 1.0.0-rc01 zawiera te zmiany.

Poprawki błędów

  • Rozwiązaliśmy problem z niezgodnością z najnowszą wersją GameActivity.

Wersja 1.0.0-beta01

30 czerwca 2021 r.

Zostanie wycofaneandroidx.games:games-controller:1.0.0-beta01 Wersja 1.0.0-beta01 zawiera te zmiany.

Zmiany w interfejsie API

  • Funkcje, które zwracały wartość logiczną oznaczającą powodzenie lub niepowodzenie, zwracają teraz wyliczenie Paddleboat_Error_Code.
  • Zmieniono nazwę na Paddleboat_onPausePaddleboat_onStop
  • Zmieniono nazwę na Paddleboat_onResumePaddleboat_onStart
  • Funkcja Paddleboat_processGameActivityEvent została podzielona na 2 funkcje: Paddleboat_processGameActivityKeyInputEventPaddleboat_processGameActivityMotionInputEvent.
  • Usunięto rozszerzone funkcje kontrolera, które wymagały kompilacji z użyciem wersji testowej pakietu SDK Androida S.
  • Dodano funkcję Paddleboat_getBackButtonConsumed
  • Wywołania zwrotne stanu kontrolera i myszy mają teraz opcjonalny parametr wskaźnika danych zdefiniowanych przez użytkownika.
  • Przeniesiono ciąg znaków z nazwą kontrolera poza strukturę informacji o urządzeniu. Dostęp do niego jest teraz możliwy za pomocą funkcji Paddleboat_getControllerName.

Poprawki błędów

  • Rozwiązaliśmy problem polegający na tym, że kontroler, który początkowo nie zgłaszał się jako kontroler, ale później robił to za pomocą komunikatu onInputDeviceChanged, nie był prawidłowo wykrywany jako połączenie kontrolera.

Wersja 1.0.0-alpha01

16 czerwca 2021 r.

Zostanie wycofaneandroidx.games:games-controller:1.0.0-alpha01

Nowe funkcje

  • Games-Controller to nowa biblioteka, która udostępnia interfejs C API do wykrywania kontrolerów do gier, odczytywania danych wejściowych z nich i interakcji z nimi.

Games-Text-Input 2.1

Wersja 2.1.0-alpha01

26 lipca 2023 r.

Zostanie wycofaneandroidx.games:games-text-input:2.1.0-alpha01 Wersja 2.1.0-alpha01 zawiera te zmiany.

Nowe funkcje

  • Dodanie obsługi trybów wielowierszowego i jednowierszowego

Zmiany w interfejsie API

  • Dodawanie funkcji isSoftwareKeyboardVisible
  • Dodaj definicje pól bitowych dla GameActivity_setImeEditorInfo
  • Dodawanie wywołania zwrotnego onEditorAction

Poprawki błędów

  • Poprawka dotycząca braku synchronizacji klawiatur sprzętowych i programowych
  • Usuwanie zaznaczenia po ukryciu klawiatury ekranowej

Games-Text-Input 2.0

Wersja 2.0.0

8 marca 2023 r.

Zostanie wycofaneandroidx.games:games-text-input:2.0.0 Wersja 2.0.0 zawiera te zmiany.

Ważne zmiany od wersji 1.1.1

  • Aktualizacja do nowej wersji ze względu na zmiany w systemie kompilacji. Sama biblioteka ani interfejs API nie zostały zaktualizowane.

Games-Text-Input Version 1.1

Wersja 1.1.2-alpha01

9 listopada 2022 r.

Zostanie wycofaneandroidx.games:games-text-input:1.1.2-alpha01 Wersja 1.1.2-alpha01 zawiera te zmiany.

Nowe funkcje

  • Brak nowych zmian

Wersja 1.1.1

13 lipca 2022 r.

Zostanie wycofaneandroidx.games:games-text-input:1.1.1 Wersja 1.1.1 zawiera te zmiany.

Poprawki błędów

  • Rozwiązaliśmy problemy z brakującym plikiem .aar w poprzedniej wersji.

Wersja 1.1.0

9 lutego 2022 r.

Zostanie wycofaneandroidx.games:games-text-input:1.1.0 Wersja 1.1.0 zawiera te zmiany.

Ważne zmiany od wersji 1.0.0 - Dodano funkcję nasłuchiwania i wykonywania zapytań WindowInsets do GameTextInput - Dodano brakujący nagłówek gamecommon.h

Wersja 1.1.0-rc01

26 stycznia 2022 r.

Zostanie wycofaneandroidx.games:games-text-input:1.1.0-rc01 Wersja 1.1.0-rc01 zawiera te zmiany.

Wersja 1.1.0-beta01

15 grudnia 2021 roku

Zostanie wycofaneandroidx.games:games-text-input:1.1.0-beta01 Wersja 1.1.0-beta01 zawiera te zmiany.

Poprawki błędów

  • Poprawianie wcięć kaskadowych i IME
  • Dodawanie brakującego pliku nagłówkowego gamecommon.h

Wersja 1.1.0-alpha01

13 października 2021 r.

Zostanie wycofaneandroidx.games:games-text-input:1.1.0-alpha01 Wersja 1.1.0-alpha01 zawiera te zmiany.

Zmiany w interfejsie API

  • Dodano funkcję wstawiania IME do GameTextInput

Games-Text-Input w wersji 1.0

Wersja 1.0.0

4 sierpnia 2021 r.

androidx.games:games-activity:1.0.0, androidx.games:games-controller:1.0.0androidx.games:games-text-input:1.0.0 są zwalniane. Wersja 1.0.0 zawiera te zmiany.

Główne funkcje wersji 1.0.0

Jest to pierwsza stabilna wersja bibliotek Games-Activity, Games-Controller i Games-Text-Input. Więcej informacji znajdziesz na stronie głównej AGDK.

Wersja 1.0.0-rc01

12 lipca 2021 roku

androidx.games:games-text-input:1.0.0-rc01 zostaje opublikowany bez zmian. Wersja 1.0.0-rc01 zawiera te zmiany.

Wersja 1.0.0-beta01

30 czerwca 2021 r.

Zostanie wycofaneandroidx.games:games-text-input:1.0.0-beta01 Wersja 1.0.0-beta01 zawiera te zmiany.

Zmiany w interfejsie API

  • Ulepszony model własności obiektów GameTextInputState.
  • Uporządkowanie typów, aby były zgodne z NDK.

Wersja 1.0.0-alpha01

16 czerwca 2021 r.

Zostanie wycofaneandroidx.games:games-text-input:1.0.0-alpha01

Nowe funkcje

  • Games-Text-Input to nowa biblioteka, która pomaga deweloperom gier korzystać z wprowadzania tekstu za pomocą klawiatury ekranowej Androida w językach C/C++.

Frame Pacing w grach w wersji 2.3

Wersja 2.3.0-alpha01

26 marca 2025 r.

Zostanie wycofaneandroidx.games:games-frame-pacing:2.3.0-alpha01 Wersja 2.3.0-alpha01 zawiera te zmiany.

Nowe funkcje

  • Uaktualnienie do Gradle 8.8.1 (1ed0153)
  • Uaktualnienie do Javy 17 (1ed0153)
  • Zmień wartość targetSdk na 35 (eddf605)

Poprawki błędów

Games Frame Pacing w wersji 2.1

Wersja 2.1.3

2 lipca 2025 r.

Zostanie wycofaneandroidx.games:games-frame-pacing:2.1.3 Wersja 2.1.3 zawiera te zmiany.

Poprawki błędów

  • Włącza obsługę stron o rozmiarze 16 KB.

Wersja 2.1.2

24 lipca 2024 r.

Zostanie wycofaneandroidx.games:games-frame-pacing:2.1.2 Wersja 2.1.2 zawiera te zmiany.

Poprawki błędów

  • Swappy korzysta teraz z AChoreographer_postVsyncCallback z interfejsu API 33, aby dokładniej obliczać czas wyświetlania. Rozwiązuje to problem z urządzeniami 120 Hz, w których przypadku dochodziło do utraty klatek.

Wersja 2.1.1

10 lipca 2024 r.

Zostanie wycofaneandroidx.games:games-frame-pacing:2.1.1 Wersja 2.1.1 zawiera te zmiany.

Poprawki błędów

  • Prawidłowe wyrejestrowanie odbiornika wyświetlania z swappy, aby uniknąć zawieszenia.
  • Naprawianie awarii w ChoreographerFilter::onSettingsChanged spowodowanej zniszczonym muteksem.

Wersja 2.1.0

15 listopada 2023 r.

Zostanie wycofaneandroidx.games:games-frame-pacing:2.1.0 Wersja 2.1.0 zawiera te zmiany.

Wersja 2.1.0-rc01

20 września 2023 r.

Zostanie wycofaneandroidx.games:games-frame-pacing:2.1.0-rc01 Wersja 2.1.0-rc01 zawiera te zmiany.

Wersja 2.1.0-beta01

24 maja 2023 r.

Zostanie wycofaneandroidx.games:games-frame-pacing:2.1.0-beta01 Wersja 2.1.0-beta01 zawiera te zmiany.

Poprawki błędów

  • Przekroczenie limitu czasu w przypadku niepowodzenia inicjowania NDKChoreographer (ef466d)
  • Gdy używasz SwappyGL_getSupportedRefreshPeriodsNS częstotliwości odświeżania zapytań bezpośrednio z systemu (c85235)

Wersja 2.1.0-alpha01

5 kwietnia 2023 r.

Zostanie wycofaneandroidx.games:games-frame-pacing:2.1.0-alpha01 Wersja 2.1.0-alpha01 zawiera te zmiany.

Nowe funkcje

  • Nowy interfejs API do resetowania stanu synchronizacji klatek.
  • Nowy interfejs API, który umożliwia wyłączenie wpływu swappy na tempo klatek przy jednoczesnym obserwowaniu czasu procesora i GPU.

Zmiany w interfejsie API

  • SwappyGL_resetFramePacing/SwappyVk_resetFramePacing można teraz używać do resetowania wewnętrznego stanu tempa klatek. Pacing klatek będzie teraz uwzględniać tylko dane od momentu wywołania interfejsu API resetowania.
  • SwappyGL_enableFramePacing/SwappyVk_enableFramePacing może teraz służyć do włączania i wyłączania synchronizacji klatek swappy. Gdy jest wyłączona:
  • SwappyGL_enableBlockingWait/SwappyVk_enableBlockingWait może służyć do określania, czy w przypadku wyłączenia synchronizacji klatek ma nastąpić blokujące oczekiwanie na zakończenie pracy GPU w ostatniej klatce.

Poprawki błędów

  • W przypadku korzystania z interfejsu Swappy GL API wprowadzono ulepszenia wydajności w przypadkach, w których wydajność jest ograniczona przez procesor graficzny.

Games Frame Pacing w wersji 2.0

Wersja 2.0.0

8 marca 2023 r.

Zostanie wycofaneandroidx.games:games-frame-pacing:2.0.0 Wersja 2.0.0 zawiera te zmiany.

Ważne zmiany od wersji 1.10.1

  • System kompilacji przeszedł poważne zmiany, w wyniku których generowana jest tylko jedna biblioteka zamiast wielu bibliotek na wersję pakietu SDK lub NDK.
  • Dodane zostaną statystyki klatek Vulkan.
  • Dodano nowy interfejs API do czyszczenia statystyk klatek.
  • W trybie produkcyjnym logi są wyciszone, ale można je włączyć w trybie debugowania.

Wersja 2.0.0-rc01

22 lutego 2023 roku

Zostanie wycofaneandroidx.games:games-frame-pacing:2.0.0-rc01 Wersja 2.0.0-rc01 zawiera te zmiany.

Nowe funkcje

  • Logowanie jest teraz ukryte za flagą kompilacji. Domyślnie wersja biblioteki przeznaczona do publikacji nie zawiera logowania, a wersja debugowania ma włączone wszystkie funkcje logowania.

Wersja 2.0.0-beta01

8 lutego 2023 r.

Zostanie wycofaneandroidx.games:games-frame-pacing:2.0.0-beta01 Wersja 2.0.0-beta01 zawiera te zmiany.

Nowe funkcje

  • Wprowadziliśmy nowy interfejs API do czyszczenia statystyk klatek.

Zmiany w interfejsie API

  • Dodano interfejsy API SwappyGL_clearStatsSwappyGL_clearStats.

Wersja 2.0.0-alpha01

11 stycznia 2023 r.

Zostanie wycofaneandroidx.games:games-frame-pacing:2.0.0-alpha01 Wersja 2.0.0-alpha01 zawiera te zmiany.

Nowe funkcje

  • Dodano statystyki klatek Vulkan

Zmiany w interfejsie API

  • Zwiększenie wersji głównej z powodu refaktoryzacji plików kompilacji
  • Dodano 3 nowe interfejsy API : SwappyVk_enableStats, SwappyVk_recordFrameStartSwappyVk_getStats

Poprawki błędów

  • Stosowanie progu tylko w trybie automatycznego przełączania (Ic0786)

Games Frame Pacing 1.10

Wersja 1.10.2-alpha01

9 listopada 2022 r.

Zostanie wycofaneandroidx.games:games-frame-pacing:1.10.2-alpha01 Wersja 1.10.2-alpha01 zawiera te zmiany.

Nowe funkcje

  • Brak nowych zmian

Wersja 1.10.1

15 czerwca 2022 r.

Zostanie wycofaneandroidx.games:games-frame-pacing:1.10.1 Wersja 1.10.1 zawiera te zmiany.

Poprawki błędów

  • Poprawka dotycząca kompilacji swappy z NDK w wersji <23 i >17.
  • Udostępniony interfejs API do pobierania częstotliwości odświeżania obsługiwanych przez wyświetlacz.

Wersja 1.10.0

23 lutego 2022 r.

Zostanie wycofaneandroidx.games:games-frame-pacing:1.10.0 Wersja 1.10.0 zawiera te zmiany.

Ważne zmiany od wersji 1.9.0

  • Ignorowanie zanieczyszczonych danych wejściowych filtra choreografa i większe wygładzanie, aby zapobiec zawieszaniu się emulatora
  • Dodaj funkcje *_uninjectTracer.

Wersja 1.10.0-rc01

9 lutego 2022 r.

Zostanie wycofaneandroidx.games:games-frame-pacing:1.10.0-rc01 Wersja 1.10.0-rc01 zawiera te zmiany.

Wersja 1.10.0-beta01

26 stycznia 2022 r.

Zostanie wycofaneandroidx.games:games-frame-pacing:1.10.0-beta01 Wersja 1.10.0-beta01 zawiera te zmiany.

Wersja 1.10.0-alpha01

15 grudnia 2021 roku

Zostanie wycofaneandroidx.games:games-frame-pacing:1.10.0-alpha01 Wersja 1.10.0-alpha01 zawiera te zmiany.

Nowe funkcje

  • Dodanie funkcji SwappyGL_uninjectTracer.

Zmiany w interfejsie API

  • Usuń wywołania zwrotne, które zostały wcześniej dodane za pomocą interfejsu API SwappyGL_injectTracer, używając interfejsu API SwappyGL_uninjectTracer(const SwappyTracer *t).

Games Frame Pacing 1.9

Wersja 1.9.1

13 października 2021 r.

Zostanie wycofaneandroidx.games:games-frame-pacing:1.9.1 Wersja 1.9.1 zawiera te zmiany.

Poprawki błędów

Wersja 1.9.0

12 lipca 2021 roku

Zostanie wycofaneandroidx.games:games-frame-pacing:1.9.0 Wersja 1.9.0 zawiera te zmiany.

Ważne zmiany od wersji 1.7.0

  • Zaktualizowano, aby pasowała do wewnętrznego schematu wersji.

Games Frame Pacing 1.7.0

Wersja 1.7.0

30 czerwca 2021 r.

Zostanie wycofaneandroidx.games:games-frame-pacing:1.7.0 Wersja 1.7.0 zawiera te zmiany.

Wersja 1.7.0-rc01

2 czerwca 2021 r.

Zostanie wycofaneandroidx.games:games-frame-pacing:1.7.0-rc01 Wersja 1.7.0-rc01 zawiera te zmiany.

Wersja 1.7.0-beta02

24 lutego 2021 r.

Zostanie wycofaneandroidx.games:games-frame-pacing:1.7.0-beta02

Wersja 1.7.0-beta01

16 grudnia 2020 roku

Zostanie wycofaneandroidx.games:games-frame-pacing:1.7.0-beta01

Games Performance Tuner 1.4.3

Wersja 2.0.0-rc01

24 lipca 2024 r.

Zostanie wycofaneandroidx.games:games-performance-tuner:2.0.0-rc01 Wersja 2.0.0-rc01 zawiera te commity.

Wersja 1.4.3

12 lipca 2021 roku

Zostanie wycofaneandroidx.games:games-performance-tuner:1.4.3 Wersja 1.4.3 zawiera te zmiany.

Ważne zmiany od wersji 1.1.0

  • Zaktualizowano, aby pasowała do wewnętrznego schematu wersji.

Games Performance Tuner 1.1.0

Wersja 1.1.0

30 czerwca 2021 r.

Zostanie wycofaneandroidx.games:games-performance-tuner:1.1.0 Wersja 1.1.0 zawiera te zmiany.

Wersja 1.1.0-rc01

2 czerwca 2021 r.

Zostanie wycofaneandroidx.games:games-performance-tuner:1.1.0-rc01 Wersja 1.1.0-rc01 zawiera te zmiany.

Wersja 1.1.0-beta03

21 kwietnia 2021 r.

Zostanie wycofaneandroidx.games:games-performance-tuner:1.1.0-beta03

Wersja 1.1.0-beta02

24 lutego 2021 r.

Zostanie wycofaneandroidx.games:games-performance-tuner:1.1.0-beta02

Wersja 1.1.0-beta01

16 grudnia 2020 roku

Zostanie wycofaneandroidx.games:games-performance-tuner:1.1.0-beta01

Wersja 1.1.0-alpha01

Wydano wersję androidx.games:games-performance-tuner:1.1.0-alpha01.

Wersja 1.0.0

Wersja 1.0.0-alpha02

12 sierpnia 2020 roku

Biblioteka gier na Androida została zmieniona na Bibliotekę gier na Androida.

androidx.gaming -> androidx.games

Wersja 1.0.0-alpha01

10 czerwca 2020 r.

Wydano bibliotekę androidx.games w wersji 1.0.0-alpha01.