Notas da versão

Esta página descreve as mudanças para cada versão das bibliotecas do Android Game Development Kit (AGDK). Ele era chamado de SDK para jogos do Android até a versão v1.2.4.

2023.3.0.0 (2 de junho de 2023)

Esta versão inclui várias correções de bugs.

GameActivity (link em inglês)

corrigido Correções de estabilidade em GameActivityEvents.

Biblioteca Android Memory Advice

recurso Atualização do modelo de machine learning que alimenta a biblioteca, o que pode permitir resultados melhores para smartphones mais recentes.

Android Performance Tuner

corrigido Correção de um bug em que a biblioteca falhava se o máximo de chaves de instrumentação fosse maior que a contagem de histograma.
recurso Atualização dos recursos de coleta de telemetria na biblioteca, permitindo relatórios mais granulares de tempos de renderização de frames.

2023.2.0.0 (27 de abril de 2023)

Esta versão inclui várias correções de bugs.

GameActivity (link em inglês)

corrigido Correção da liberação antecipada de memória com historyEventTimes.
corrigido Foi corrigido um problema com o históricoEventTimesNanos sobrecarregado em sistemas de 32 bits.

Biblioteca Android Memory Advice

corrigido Correção de um bug que impedia a versão estática da biblioteca ser vinculada corretamente.
corrigido Correção de um bug em que a biblioteca não conseguia carregar corretamente os recursos necessários do TensorFlow Lite.

2023.1.0.0 (15 de março de 2023)

Esta versão principal tem atualizações do sistema de build para criar bibliotecas mais rapidamente a partir do código-fonte.

GameActivity (link em inglês)

alterado A interface de horários de eventos históricos foi alterada para ultrapassar a limitação de 32 bits.
recurso Forneceu acesso de usuário para mudanças de configuração.
recurso Otimização da maioria das chamadas JNI no tratamento de eventos de toque.
corrigido Correção do processamento padrão do SO para eventos de toque, como o processamento de botões do sistema.

GameController

recurso Foi adicionada a capacidade de detectar o status de conexão de teclados de hardware.
recurso Foi adicionado o recurso de relatar dados de movimento (acelerômetro/giroscópio) do dispositivo principal (celular), assim como controles.
alterado A API e o formato do banco de dados de definição do controlador foram alterados para reduzir o consumo de memória e oferecer suporte a outros recursos.

Biblioteca Android Frame Pacing

recurso As estatísticas de frame do Vulkan foram adicionadas.
recurso Foi adicionada uma nova API para limpar as estatísticas de frames.
alterado Os registros são todos silenciosos no modo de lançamento e podem ser ativados no modo de depuração.

2022.0.0 (15 de março de 2022)

Essa versão principal inclui a biblioteca de aconselhamento sobre memória e várias correções para outras bibliotecas.

GameActivity (link em inglês)

recurso Foi adicionado o processamento de encartes para posicionamento da interface do jogo ao redor do IME e dos cortes
recurso Adição de filtros de eventos de movimento e teclas.
corrigido Correções para evitar perdas de eventos de entrada e impedir o consumo de todos os eventos de entrada.

Android Performance Tuner

alterado Os relatórios de memória agora são como séries temporais em vez de histogramas
recurso Permitir a definição programática do intervalo de upload
corrigido Correção do bug de chave de API corrompido

Biblioteca Android Frame Pacing

recurso Melhorias no modo automático
recurso Adicionar funções "uninjectTracer"

Biblioteca Android Memory Advice

recurso Adição da biblioteca Memory Advice

2021.1.0 (12 de julho de 2021)

Antes nos referimos a esse produto como SDK do Android Game, agora ele é chamado de Android Game Development Kit. Essa versão principal inclui várias novas bibliotecas, além de pequenas correções de bugs nas bibliotecas Android Frame Pacing e Android Performance Tuner.

recurso A GameActivity é um novo componente que substitui e melhora a NativeActivity do NDK.
recurso GameTextInput é um novo componente que melhora a interação com o teclado de software do Android.
recurso O GameController é um novo componente que facilita a interação e o gerenciamento de controles externos.

1.2.4 (21 de abril de 2021)

Esta é uma versão de correção de bug do Android Performance Tuner.

Android Performance Tuner

corrigido Correção do tempo de carregamento e da duração da gravação em dispositivos com CLOCK_BOOTTIME inconsistente.

1.2.3 (10 de março de 2021)

Nesta versão, a Oboe foi adicionada ao SDK para jogos. Não há mudanças na biblioteca Android Frame Pacing e no Android Performance Tuner.

A Oboe é uma biblioteca C++ de código aberto para áudio de alto desempenho no Android. Ela fornece uma única API nativa que funciona no Android 4.1 (API de nível 16) e versões mais recentes.

1.2.2 (12 de fevereiro de 2021)

Esta versão apresenta melhorias na API de tempos de carregamento para o Android Performance Tuner e várias correções de bugs. Não há mudanças na biblioteca Android Frame Pacing.

Android Performance Tuner

recurso Os eventos de carregamento agora precisam ser agrupados com chamadas para TuningFork_startLoadingGroup e TuningFork_stopLoadingGroup.
corrigido Chamar TuningFork_flush faz upload imediato dos dados em vez de colocá-los na fila para fazer upload mais tarde.
corrigido A falha intermitente no upload devido à formatação JSON de horários.
corrigido Um problema com uploads nos builds de lançamento.

1.2.1 (16 de dezembro de 2020)

Esta é uma versão de recursos internos do Android Performance Tuner e promove as bibliotecas do Jetpack da versão Alfa para a Beta. Não há mudanças nas APIs Android Frame Pacing ou Android Performance Tuner.

As bibliotecas do SDK para jogos agora precisam ser referenciadas individualmente ao vinculá-las, em vez de vincular à biblioteca genérica "gamesdk". Veja as configurações de build para Android Frame Pacing: OpenGL, Android Frame Pacing: Vulkan e Android Performance Tuner.

Android Performance Tuner

recurso Quando um jogador coloca o jogo em segundo plano durante o carregamento, um evento é enviado para analisar o abandono do carregamento mais tarde.

1.2.0 (29 de outubro de 2020)

A principal mudança nesta versão foi a inclusão de um mecanismo para registrar os tempos de carregamento. Também houve algumas correções de bugs. O SDK para jogos agora está disponível na biblioteca do Jetpack das bibliotecas do AGDK.

Biblioteca Android Frame Pacing

recurso Compatibilidade com a alternância da taxa de atualização no modo automático.
Para oferecer compatibilidade com várias taxas de atualização no Android 11, usando o modo automático ou não, é preciso chamar SwappyGL_setWindow ou SwappyVk_setWindow.
corrigido Correções de bugs no modo automático.
corrigido Correções de bugs do Vulkan.

Android Performance Tuner

recurso Tempos de carregamento.
As novas funções TuningFork_startRecordingLoadingTime e TuningFork_stopRecordingLoadingTime precisam ser chamadas para registrar eventos de tempo de carregamento anotados. O tempo entre a inicialização do app até a TuningFork_init e a primeira marcação são registrados automaticamente.
alterado O método anterior que definia uma anotação de tempo de carregamento não funcionará mais.
recurso Eventos de ciclo de vida.
É preciso chamar TuningFork_reportLifecycleEvent no método Java onCreate correto (entre outros) que está sendo chamado. Isso permite gerar relatórios de erros detalhados no Android Performance Tuner.
alterado Agora, mais métricas de memória são registradas quando TuningFork_enableMemoryRecording(true) é chamado.
alterado Mudança do modelo de memória.
O número máximo de métricas de cada tipo agora é especificado durante a inicialização, em vez de alocar espaço para todas as combinações de anotações possíveis. Consulte TuningFork_MetricLimits em tuningfork.h.
corrigido Sem uploads em conexões limitadas.

1.1.0 (10 de junho de 2020)

Esta versão das bibliotecas do AGDK contém a biblioteca de ajuste de qualidade e relatórios de métricas Android Performance Tuner (também conhecida como Tuning Fork). Essa biblioteca está disponível para mecanismos de jogos nativos e do Unity e inclui os seguintes recursos:

recurso Integração com a biblioteca Android Frame Pacing para registrar automaticamente os tempos para a renderização de frames e outras métricas de renderização.
recurso As informações de tempo para a renderização do frame são registradas em histogramas e enviadas periodicamente.
recurso Anotação de dados de tempo com o estado atual do jogo.
recurso As características do dispositivo, anotações e configurações de qualidade são enviadas com os dados de tempo para permitir a análise em diferentes seções.
recurso Tratamento especial de anotações que indicam o tempo de carregamento de nível. Os dados de marcação de frame não são registrados durante o carregamento, mas a duração de cada período de carregamento é.
recurso Capacidade de gravar informações de tempo personalizadas, usando startTrace e endTrace.

1.0.2 (30 de março de 2020)

Essa versão inclui correções de bugs e alterações no comportamento do modo automático.

corrigido Correções de bugs para a destruição e a reinicialização do Swappy.
alterado O pipeline agora é ativado por padrão. Se o pipeline automático estiver ativado, o Swappy ainda poderá desativá-lo quando a carga de trabalho for muito baixa.
alterado Quando o modo automático estiver ativado, o Swappy decidirá mudar o intervalo de troca somente depois que 15% dos frames em uma janela de dois segundos forem mais rápidos ou mais lentos que o esperado. O Swappy nunca mudará para um intervalo de troca mais lento que o especificado pelo usuário.

1.0.1 (19 de fevereiro de 2020)

Essa versão é principalmente para a correção de bug.

corrigido Limpeza de recursos na saída do caminho de código SwappyFallback no Vulkan.
corrigido SwappyVk_destroySwapchain não destruirá mais os recursos do dispositivo se houver mais de uma cadeia de troca.
corrigido A versão do Swappy agora é exibida em logcat.
corrigido Falhas e impasses em Swappy_destroy para o nível de API 24 e anteriores.
recurso Compatibilidade com gerenciadores de linhas de execução personalizados (Swappy_setThreadFunctions).
recurso Compatibilidade com hooks de funções Vulkan (SwappyVk_setFunctionProvider).

1.0.0 (5 de dezembro de 2019)

Esta versão inicial das bibliotecas do AGDK apresenta a biblioteca Android Frame Pacing.

recurso Exibe a sincronização de buffer.
recurso Modo de taxa de atualização automática e compatibilidade com pipeline.
recurso Coleção de estatísticas de renderização de frames.
recurso Seleção avançada de comportamento no tempo de execução, dependendo da presença dos recursos do Android, OpenGL e Vulkan necessários para o Swappy.
recurso Vinculação estática e dinâmica da biblioteca.
recurso Compatibilidade com dispositivos com várias taxas de atualização.