O que é o formato de ficheiro TRX?
Um arquivo .trx é um arquivo de resultados de teste baseado em XML gerado pela infraestrutura de teste do Microsoft Visual Studio. O formato foi introduzido com o Visual Studio .NET 2003 e a estrutura MSTest, e continua sendo o formato de saída padrão tanto para o mstest.exe quanto para o executor multiplataforma dotnet test.
O arquivo é um documento XML UTF-8 simples cujo elemento raiz é <TestRun> dentro de um namespace XML específico da Microsoft. Internamente, ele registra <TestSettings> (configuração de execução), <TestDefinitions> (nomes de métodos de teste e assemblies), <Results> com um <UnitTestResult> por caso de teste (resultado, duração, carimbos de data/hora, mensagens de erro, rastreamentos de pilha) e um <ResultSummary> com contagens agregadas de Aprovados/Reprovados/Inconclusivos. O esquema é definido em vstst.xsd, que é fornecido com o Visual Studio no diretório Common7/IDE/.
Arquivos .trx não são criados automaticamente - eles exigem configuração explícita do logger. Para gerar um, passe --logger trx para o dotnet test, ou forneça a flag equivalente para o mstest.exe. O Azure DevOps e o TFS analisam arquivos .trx nativamente por meio da tarefa Publish Test Results, renderizando relatórios de aprovação/reprovação na UI do pipeline.
Como o .trx é um formato XML, qualquer editor de texto pode abri-lo. O Visual Studio Code com o C# Dev Kit fornece uma visualização mais rica. O formato é centrado na Microsoft; sistemas de CI multiplataforma, como GitHub Actions ou Jenkins, geralmente preferem relatórios de teste JUnit XML. Desde o Visual Studio 2022 e o .NET SDK, a geração de .trx também é suportada no Linux e macOS via dotnet test.
Segurança e proteção
RISCO: LOWArquivos TRX são XML UTF-8 simples - eles contêm resultados de testes, não código executável. Abri-los no Visual Studio, VS Code ou em um editor de texto é completamente seguro. Não use downloads de «visualizadores de TRX» de terceiros de origem desconhecida; eles são desnecessários e podem conter adware. O Visual Studio Community (gratuito) ou o VS Code (gratuito, código aberto) são abridores seguros e suficientes.
Detalhes do formato
em resumoProgramas que abrem arquivos TRX
Detalhes técnicos
especificação profunda| Tipo de arquivo | Documento XML UTF-8 (texto simples) |
| Elemento XML raiz | `<TestRun>` no namespace XML vstst da Microsoft |
| Arquivo de esquema | `vstst.xsd` - fornecido com o Visual Studio em `Common7/IDE/` |
| Comando gerador | `dotnet test --logger trx` ou `mstest.exe /logger:trx` |
| Tamanho típico do arquivo | 5 KB - 10 MB (varia com a contagem de testes e verbosidade do stack trace) |
| Elemento de registro por teste | `<UnitTestResult>` - armazena resultado, duração, carimbos de data/hora, mensagem de erro e rastreamento de pilha |
| Elemento de resumo | `<ResultSummary>` - contagens agregadas de Aprovados, Reprovados, Inconclusivos e Total |
| Contêiner de resultados | Elemento `<Results>` contendo todos os filhos `<UnitTestResult>` |
| Não gerado por padrão | Requer flag explícita `--logger trx`; não é criado em uma execução comum de `dotnet test` |
| Suporte de plataforma | Windows, Linux, macOS (via .NET SDK multiplataforma) |
| Integração com Azure DevOps | Analisado nativamente pela tarefa de pipeline Publish Test Results |
| Formato de CI multiplataforma | JUnit XML é preferido por sistemas de CI não-Microsoft (GitHub Actions, Jenkins, GitLab CI) |
| Variação de formato do gerador | O TRX do `mstest.exe` difere ligeiramente do TRX produzido pelo `dotnet test`; ambos são válidos |
| Compressão | Nenhuma - XML simples; suítes de teste grandes com rastreamentos de pilha podem produzir arquivos de vários MB |
| Lançado | 2003 (Visual Studio .NET 2003, MSTest framework) |
| Versão mais recente | vstst.xsd schema current as of Visual Studio 2022; vstest also generates TRX in .NET SDK 2026 |
| Especificação | learn.microsoft.com |
Conversões de TRX
Perguntas e Respostas da Comunidade
perguntado por usuáriosAinda não há perguntas - seja o primeiro a perguntar sobre arquivos TRX.