Skip to content

Releases: rickamaral94/Amaral-Driver-Lab

Amaral Driver Lab v0.13.0-alpha12 — Public Release

Choose a tag to compare

@github-actions github-actions released this 10 Aug 06:06
4aa7716

Amaral Driver Lab v0.13.0-alpha12

Amaral Driver Lab alpha12 is now promoted to a public release. This version combines a more demanding Recommended Full benchmark with clearer, correctly localized diagnostic results, making driver comparisons more useful for both users and Amaral driver development.

What's new

  • Recommended Full v5: nine focused stages covering visual correctness, shaders, frametime, mixed graphics/compute/synchronization behavior, and correctness checks before and after load.
  • GPU Stress 3D: a new mandatory 1280×720 visual stage with 768 procedural cubes, depth, four lights, multi-octave materials, and heavy post-processing. It carries 20% of the Recommended Full score.
  • Comparable history: Full profiles v1–v4 remain separate and verifiable; v5 results are never mixed into older ranking series.
  • Correct report language: Portuguese app locales generate Portuguese human-readable results. Every other app locale generates them in English.
  • Consistent exports: the language rule now applies to the result preview, detailed Full log, HTML report, and generated GitHub issue. Technical JSON fields, IDs, hashes, metrics, and benchmark contracts remain unchanged.

Quick tutorial: compare drivers

  1. Download and install the APK attached below.
  2. On the home screen, tap Import Turnip ZIP and select a valid AdrenoTools driver package.
  3. Choose Android system driver × Turnip candidate to compare against the stock driver, or Turnip reference × Turnip candidate to compare two imported drivers.
  4. Select the candidate and, when applicable, the reference driver.
  5. Prepare the device: close other apps, keep the same performance and cooling mode, stabilize temperature, and avoid charging during the run.
  6. Tap Start selected Full test and complete the nine stages, including the visual checkpoints.
  7. Open Test log to review the recommendation, performance and compatibility indices, weighted gain, blockers, and technical evidence.
  8. Use Export diagnostic ZIP to save the complete evidence package, or Send to project issue to prepare a report for the Amaral Driver Lab repository.

Quick tutorial: analyze emulator logs

  1. Open Emulator log report on the home screen.
  2. Tap Select log (.TXT / .LOG) and choose a log generated by your emulator.
  3. Review the detected device, emulator, game, GPU, graphics API, driver, and relevant errors. Sensitive data is redacted before the issue is prepared.
  4. Tap Open GitHub issue and review the report before submitting it to the project.

How these logs help Amaral drivers

Submitted benchmark and emulator evidence helps identify driver regressions on specific GPUs, Android versions, emulators, games, and graphics APIs. Driver hashes and controlled A/B comparisons show exactly which package produced each result, while visual checkpoints and performance metrics help separate rendering errors from shader, frametime, synchronization, or compatibility problems.

This evidence gives Amaral driver development a reproducible basis for prioritizing fixes, validating experimental changes, and deciding whether a new driver is safer or faster without sacrificing rendering correctness. When reporting a problem, include the diagnostic ZIP whenever possible and describe the emulator, game, tested driver, and steps needed to reproduce it.

Validation

  • Unit tests cover Portuguese and non-Portuguese report-language behavior.
  • Android tests, Vulkan shaders, native arm64 C++, and the APK were built in GitHub Actions.
  • APK SHA-256: 6b15f8eef261a782f0f73d794b8905411a933899f2f803ef00361bf2ad380f8a

The Advanced Full crash reported for RedMagic 11 Pro remains under investigation and still requires a reproducible diagnostic bundle or stack trace.

Amaral Driver Lab v0.13.0-alpha11

Pre-release

Choose a tag to compare

@github-actions github-actions released this 09 Aug 14:06
16aa40f

Amaral Driver Lab v0.13.0-alpha11

This prerelease introduces the new GPU Stress 3D visual benchmark and incorporates it into the recommended Full test.

New GPU Stress 3D workload

  • 1280×720 internal rendering;
  • 768 procedural 3D cubes and 27,648 vertices per frame;
  • depth testing, orbital camera, four lights and six-octave procedural materials;
  • a final post-processing pass with 19 texture samples;
  • deterministic checkpoints at frames 30, 90 and 150;
  • mandatory A/B visual correctness gate before performance conclusions.

Recommended Full v5

  • the Recommended Validation v2 profile now runs nine stages;
  • GPU Stress 3D is included as visual_gpu_stress with 20% weight;
  • total profile weight remains normalized to 100%;
  • Full v1–v3 and Recommended v4 remain verifiable historical series and are never mixed with v5 rankings.

Validation

  • Android unit tests executed in GitHub Actions;
  • Vulkan shaders compiled for Vulkan 1.0 by the Android NDK toolchain;
  • native C++ and arm64 debug APK built in GitHub Actions;
  • APK SHA-256 generated and verified against the uploaded release asset.

This is a prerelease intended for real-device validation, especially on the Odin 2 Portal, before promotion to a stable release.

Amaral Driver Lab v0.13.0-alpha9

Choose a tag to compare

@github-actions github-actions released this 05 Aug 19:50
75e5702

Amaral Driver Lab v0.13.0-alpha9

This release makes the emulator-log workflow explicitly accept .txt and .log files.

Changes

  • home-screen button and guidance now show .TXT / .LOG;
  • file names are validated case-insensitively before reading;
  • unsupported extensions receive a localized error;
  • Android document-provider compatibility is preserved for plain-text, log and generic stream MIME types;
  • unit tests cover lowercase and uppercase .txt/.log files and rejected formats.

Validation

  • Android CI run: 31040981978;
  • 107 tests, 0 failures, 0 ignored;
  • Android SDK, NDK, CMake and native Vulkan build passed;
  • APK generation and artifact upload passed.

Amaral Driver Lab v0.13.0-alpha8

Choose a tag to compare

@github-actions github-actions released this 05 Aug 19:06
d38421d

Amaral Driver Lab v0.13.0-alpha8

Esta versão adiciona à tela inicial um novo fluxo para transformar logs de emuladores em relatórios técnicos prontos para o GitHub Issues.

Nova seção: log do emulador

  1. Selecione um arquivo de log na página inicial.
  2. O aplicativo analisa o conteúdo localmente.
  3. Revise a prévia com ambiente, driver e falhas encontradas.
  4. Abra uma issue preparada no projeto Amaral Driver Lab.
  5. Relatórios muito grandes usam o fallback seguro pela área de transferência.

Informações detectadas

  • aparelho e versão do Android;
  • emulador e versão;
  • jogo/aplicativo e Title ID ou Program ID;
  • GPU e API gráfica;
  • identidade do driver Turnip, Mesa ou Qualcomm;
  • linhas fatais, erros, avisos e trechos relevantes.

Privacidade e segurança

  • análise totalmente local;
  • nenhum envio automático do log original;
  • remoção automática de e-mails, caminhos pessoais, tokens, segredos e endereços IPv4;
  • limite de importação de 2.000.000 bytes e indicação explícita de truncamento;
  • SHA-256 do conteúdo sanitizado para reprodução técnica;
  • o relatório não afirma automaticamente que o driver Turnip causou o problema.

Validação

  • 105 testes aprovados;
  • 0 falhas e 0 testes ignorados;
  • Android SDK 35;
  • NDK 27.2.12479018 e CMake 3.22.1;
  • compilação Vulkan nativa arm64 aprovada;
  • Source Snapshot aprovado;
  • Android APK workflow 31037497731;
  • APK artifact 8943215799.

Integridade

SHA-256 da APK: 3e7d52465cccf68d1d7540a03a824579c6fe9c5710fe9b02fed152468dd57886

Amaral Driver Lab v0.13.0-alpha7

Choose a tag to compare

@github-actions github-actions released this 05 Aug 10:20
9f40205

Amaral Driver Lab v0.13.0-alpha7

Correção emergencial do envio de relatórios para issues do GitHub.

Corrigido

  • elimina o erro Your request URL is too long ao enviar relatórios detalhados;
  • calcula o tamanho da URL depois da codificação de Markdown e Unicode;
  • relatórios curtos continuam abrindo preenchidos automaticamente;
  • relatórios extensos são copiados integralmente para a área de transferência;
  • o GitHub abre com uma URL curta e o título já preenchido;
  • o aplicativo orienta o usuário a colar o relatório na descrição;
  • remove cortes de 1.800 e 8.000 caracteres, evitando perda de dados;
  • aplica a correção às issues individuais e às issues de Qualification.

Validação

  • 101 testes JVM aprovados;
  • 0 falhas e 0 testes ignorados;
  • Source Snapshot aprovado;
  • Android SDK 35;
  • NDK 27.2.12479018 e CMake 3.22.1;
  • compilação Vulkan arm64 e APK aprovadas;
  • workflow Android APK 30996593269.

Integridade

SHA-256 da APK:

ed315a5d5a353aa10b2138693f3141f5751f114c7d47bcf53e871c93302a3c28

Esta continua sendo uma versão alpha. Depois de instalar, execute novamente o envio da issue no Odin 2 Portal e cole o conteúdo copiado no campo de descrição do GitHub.

Amaral Driver Lab v0.13.0-alpha6

Choose a tag to compare

@github-actions github-actions released this 05 Aug 09:12
e732e71

Amaral Driver Lab v0.13.0-alpha6

Primeira publicação consolidada das Fases 1–13 do Amaral Driver Lab.

Destaques

  • fluxo principal simplificado para comparação Sistema × Turnip e Turnip × Turnip;
  • identificação explícita de DRIVER CANDIDATO e DRIVER DE REFERÊNCIA;
  • placar geral por etapas e por rodadas;
  • medianas, médias, P95, P99, coeficiente de variação e amostras;
  • diferenças absolutas, deltas normalizados, razões e intervalo de confiança de 95%;
  • comparação visual, auditoria dos loaders, hardware, SoC e GPU;
  • relatório de issue do GitHub voltado à otimização dos drivers Amaral Turnip;
  • localização completa do aplicativo;
  • Full Qualification v3, diagnósticos profundos, cenas Vulkan, traces e telemetria opcional.

Validação automatizada

  • 98 testes JVM aprovados;
  • 0 falhas e 0 testes ignorados;
  • Android SDK 35;
  • NDK 27.2.12479018 e CMake 3.22.1;
  • compilação Vulkan nativa arm64 aprovada;
  • APK debug gerada pelo workflow 30989506232.

Integridade

SHA-256 da APK:

a6d4c3b109308631a9247b294786ccc8c7a4bcd936d941bd18947a5dfca49dc9

Esta é uma versão alpha. A validação automatizada foi concluída; testes físicos adicionais no Odin 2 Portal continuam recomendados.

Amaral Driver Lab v0.13.0-alpha10

Choose a tag to compare

@github-actions github-actions released this 05 Aug 20:06
7f4de78

Amaral Driver Lab v0.13.0-alpha10

This release fixes .log files appearing disabled in some Android document pickers.

Changes

  • removes Intent.EXTRA_MIME_TYPES from the emulator-log picker;
  • opens the Android picker with */*, allowing unknown and vendor-specific .log MIME classifications to remain selectable;
  • preserves strict app-side validation for only .txt and .log, case-insensitively;
  • preserves local privacy redaction, log summarization and prepared GitHub issue creation.

Validation

  • issue reproduced on a real Android handheld from the alpha9 picker;
  • Android CI run: 31042238251;
  • 107 tests, 0 failures, 0 ignored;
  • Android SDK, NDK, CMake and native Vulkan build passed;
  • APK generation and artifact upload passed.

Amaral Driver Lab v0.1.1 MVP

Choose a tag to compare

@github-actions github-actions released this 03 Aug 16:11

Atualização visual e de documentação do Amaral Driver Lab.

Novidades

  • novo ícone oficial baseado no avatar A / AMARAL;
  • ícones quadrado, circular e adaptativo para diferentes launchers Android;
  • tutorial completo de instalação, importação, comparação A/B e exportação no README;
  • versão do aplicativo atualizada para 0.1.1-mvp.

O workload e o cálculo do benchmark permanecem iguais aos da v0.1.0-mvp.

Compatibilidade

  • Android 9 / API 28 ou superior;
  • dispositivos arm64-v8a;
  • pacotes Vulkan no formato AdrenoTools documentado pelo projeto.

Instalação

Este é um APK experimental de depuração. Se a v0.1.0-mvp estiver instalada, exporte resultados importantes e desinstale-a antes, pois builds de depuração gerados em execuções diferentes podem usar assinaturas incompatíveis.

Amaral Driver Lab v0.1.0 MVP

Choose a tag to compare

@github-actions github-actions released this 03 Aug 14:35

Primeira versão pública do Amaral Driver Lab para testes comparativos e reproduzíveis de drivers Vulkan no Android.

Recursos incluídos

  • importação e validação de pacotes ZIP compatíveis com AdrenoTools;
  • seleção do driver do sistema ou de um driver candidato;
  • testes stock, candidato e A/B com alternância AB/BA;
  • captura de métricas, informações do dispositivo, temperatura e logs;
  • exportação do resultado em JSON e integração opcional com GitHub Issues.

Compatibilidade

  • Android 9 / API 28 ou superior;
  • dispositivos arm64-v8a;
  • drivers Vulkan empacotados no formato documentado pelo projeto.

Importante

Este é um APK experimental de depuração. O driver selecionado é carregado somente no processo de teste do aplicativo e não substitui o driver do sistema. Use apenas pacotes de driver próprios ou com hash verificado.