Co to jest format pliku TRX?
Plik .trx to oparty na formacie XML plik wyników testów generowany przez infrastrukturę testową Microsoft Visual Studio. Format ten został wprowadzony wraz z Visual Studio .NET 2003 i frameworkiem MSTest i pozostaje domyślnym formatem wyjściowym zarówno dla mstest.exe, jak i wieloplatformowego modułu uruchamiającego dotnet test.
Plik jest zwykłym dokumentem XML w kodowaniu UTF-8, którego elementem głównym jest <TestRun> w obrębie przestrzeni nazw XML specyficznej dla Microsoft. Wewnątrz rejestruje on <TestSettings> (konfiguracja przebiegu), <TestDefinitions> (nazwy metod testowych i zestawy), <Results> z jednym elementem <UnitTestResult> na przypadek testowy (wynik, czas trwania, znaczniki czasu, komunikaty o błędach, ślady stosu) oraz <ResultSummary> z zagregowaną liczbą testów zakończonych sukcesem, niepowodzeniem lub nierozstrzygniętych. Schemat jest zdefiniowany w pliku vstst.xsd, który jest dostarczany wraz z Visual Studio w katalogu Common7/IDE/.
Pliki .trx nie są tworzone automatycznie - wymagają jawnej konfiguracji rejestratora (loggera). Aby go wygenerować, należy przekazać parametr --logger trx do polecenia dotnet test lub podać odpowiednią flagę do mstest.exe. Azure DevOps i TFS analizują pliki .trx natywnie poprzez zadanie Publish Test Results, renderując raporty sukcesów/niepowodzeń w interfejsie użytkownika potoku.
Ponieważ .trx jest formatem XML, może go otworzyć dowolny edytor tekstu. Visual Studio Code z rozszerzeniem C# Dev Kit zapewnia bogatszą wizualizację. Format ten jest skoncentrowany na ekosystemie Microsoft; wieloplatformowe systemy CI, takie jak GitHub Actions lub Jenkins, zazwyczaj preferują raporty testowe JUnit XML. Od wersji Visual Studio 2022 i .NET SDK generowanie plików .trx jest również obsługiwane w systemach Linux i macOS za pośrednictwem dotnet test.
Bezpieczeństwo
RYZYKO: LOWPliki TRX to zwykły XML w kodowaniu UTF-8 - zawierają wyniki testów, a nie kod wykonywalny. Otwieranie ich w Visual Studio, VS Code lub edytorze tekstu jest całkowicie bezpieczne. Nie należy używać zewnętrznych programów typu „TRX viewer” z nieznanych źródeł; są one niepotrzebne i mogą zawierać oprogramowanie reklamowe. Visual Studio Community (bezpłatne) lub VS Code (bezpłatny, open source) to bezpieczne i wystarczające narzędzia.
Szczegóły formatu
w pigułceProgramy otwierające pliki TRX
Szczegóły techniczne
specyfikacja| Typ pliku | Dokument XML UTF-8 (zwykły tekst) |
| Główny element XML | `<TestRun>` w przestrzeni nazw XML Microsoft vstst |
| Plik schematu | `vstst.xsd` - dostarczany z Visual Studio w `Common7/IDE/` |
| Polecenie generatora | `dotnet test --logger trx` lub `mstest.exe /logger:trx` |
| Typowy rozmiar pliku | 5 KB - 10 MB (skaluje się wraz z liczbą testów i szczegółowością śladu stosu) |
| Element rekordu pojedynczego testu | `<UnitTestResult>` - przechowuje wynik, czas trwania, znaczniki czasu, komunikat o błędzie i ślad stosu |
| Element podsumowania | `<ResultSummary>` - zagregowane liczby: sukcesy, niepowodzenia, nierozstrzygnięte i suma |
| Kontener wyników | Element `<Results>` zawierający wszystkie elementy podrzędne `<UnitTestResult>` |
| Brak automatycznego generowania | Wymaga jawnej flagi `--logger trx`; nie jest tworzony przy zwykłym uruchomieniu `dotnet test` |
| Obsługa platform | Windows, Linux, macOS (poprzez wieloplatformowy .NET SDK) |
| Integracja z Azure DevOps | Natywnie analizowany przez zadanie potoku Publish Test Results |
| Wieloplatformowy format CI | JUnit XML jest preferowany przez systemy CI inne niż Microsoft (GitHub Actions, Jenkins, GitLab CI) |
| Wariacje formatu generatora | TRX z `mstest.exe` różni się nieznacznie od TRX produkowanego przez `dotnet test`; oba są poprawne |
| Kompresja | Brak - zwykły XML; duże zestawy testów ze śladami stosu mogą generować pliki o rozmiarze wielu MB |
| Wydano | 2003 (Visual Studio .NET 2003, MSTest framework) |
| Najnowsza wersja | vstst.xsd schema current as of Visual Studio 2022; vstest also generates TRX in .NET SDK 2026 |
| Specyfikacja | learn.microsoft.com |
Konwersje TRX
Pytania i odpowiedzi społeczności
pytania użytkownikówBrak pytań - bądź pierwszą osobą, która zapyta o pliki TRX.