Uyumluluk
TestDetta'nın neye ihtiyaç duyduğu ve neyle test edildiği. Bu tabloların dışında kalan bir şey desteklenmiyor demek değildir, ancak uçtan uca test edilmemiştir.
Gereksinimler
| Öğe | Gereksinim |
|---|---|
| .NET SDK | TestDetta'nın kendisini .NET 10 SDK çalıştırır. Testleriniz, deponuzun zaten kullandığı SDK ve runner ile çalışmaya devam eder. |
| Git geçmişi | Merge base'in bulunabilmesi için branch'inizin ve hedef branch'inin tam geçmişi. Shallow clone'larla çalışmaz. |
| İşletim sistemi | Windows x64 ve Linux x64 (CI'ımız her pull request'te tüm test paketini ikisinde de çalıştırır) ve macOS arm64 (değerlendirme). Diğer mimariler test edilmedi. |
| Eski tip proje dosyaları | packages.config kullanan SDK olmayan .csproj dosyaları tam MSBuild ile geri yüklenir ve derlenir: Windows'ta Visual Studio ya da Build Tools (vswhere ile bulunur), macOS ve Linux'ta Mono'nun msbuild'i, ya da TESTDETTA_MSBUILD'in gösterdiği çalıştırılabilir dosya. Testleri, derlenmiş assembly'den vstest.console.exe'nin motoru olan VSTest ile çalışır. macOS'ta Mono ile test edildi. |
Test framework'leri ve runner'lar
dotnet test'in her iki runner'ı da çalışır. Runner, tıpkı dotnet test'in yaptığı gibi global.json dosyasından okunur. Aşağıdaki kombinasyonlar kayıt dahil uçtan uca, her framework'ün kendi paralelleştirmesi açıkken de test edilmiştir:
| Framework | VSTest | Microsoft.Testing.Platform |
|---|---|---|
| xUnit v2 | Test edildi | – |
| xUnit v3 | – | Test edildi (.NET 10 SDK üzerinde xUnit v3 için gereklidir) |
| NUnit | Test edildi | Test edildi; kayıt sırasında başarısız testlerin bilinmesi için Microsoft.Testing.Extensions.TrxReport ekleyin |
| MSTest | Test edildi | Test edildi |
| TUnit | – | Test edildi |
Değerlendirme korpusundaki test projeleri .NET 8 ile .NET 10 arasını hedefler. .NET Framework test projeleri bu korpusa dahil değildir.
Hedef framework'ler
Test edilen kod herhangi bir framework'ü hedefleyebilir: TestDetta kaynak kodunu okur ve kayıt sırasında derlenmiş assembly'lerini neyi hedeflerlerse hedeflesinler yeniden yazar. Sınırı test projesi belirler, çünkü kayıt onun test host'unda çalışır.
| Hedef | Durum |
|---|---|
| Test edilen kod: .NET Framework 3.5 ve üzeri, .NET Standard 1.0 ve üzeri, .NET Core, .NET 5 ve üzeri | Destekleniyor; .NET Framework 4.8 testleri altındaki bir .NET Framework 3.5 kütüphanesi test edildi |
| .NET 8 ve üzerindeki test projeleri | Test edildi, değerlendirme korpusunun tamamı |
| .NET 6 ve 7'deki test projeleri | .NET 6, xUnit v2, NUnit 3 ve MSTest 3 ile, Microsoft.NET.Test.Sdk 17.13 (onlar için son sürüm) üzerinde test edildi |
| .NET Framework 4.6.2 ile 4.8.1 arasındaki test projeleri | Windows'ta xUnit v2 (4.6.2 ve 4.8) ve MSTest 1 ve 3 (4.8) ile, SDK olmayan eski tip çözümler dahil test edildi; aynıları macOS'ta Mono altında da. NUnit 2 adaptörü henüz desteklenmiyor. |
| .NET Framework 3.5 ile 4.6.1 arasındaki test projeleri | Desteklenmiyor: güncel test platformları .NET Framework 4.6.2 gerektirir |
Birden fazla framework'ü hedefleyen bir test projesinde td record testleri tek bir framework için çalıştırır: -f'in belirttiği ya da yoksa TargetFrameworks içinde makinede çalışabilen ilk framework (.NET Framework yalnızca Windows'ta). -f olmadan projenin diğer framework'lerinin, aynı derlemenin onlar için de ürettiği üretilmiş kodunu ve derleme girdilerini de okur; böylece bir değişiklik her framework'ün kendi derlemesiyle karşılaştırılır. Bir değişikliğin neyi seçeceği bu durumda testlerinizin hangi framework'ler için çalıştığına bağlıdır; bkz. Sınırlamalar.
Diller
| Dil | Değişiklikler nasıl ele alınır |
|---|---|
| C#, Visual Basic | Üye düzeyine kadar analiz edilir: söz dizimi ağaçları, kapsam haritaları ve isim izleme. Visual Basic isimleri büyük/küçük harf ayrımı gözetmeden eşleştirilir ve derleyicinin yaptığı gibi projenin kök ad alanı uygulanır. |
| F# | C# gibi üye düzeyine kadar analiz edilir. Derleyicinin oluşturduğu gibi modüller sınıf, let fonksiyonları da üye sayılır; girinti de koddan sayılır. inline bir fonksiyon onu çağıranların içine derlendiği için çağıranlar isimle bulunur. İmza dosyaları (.fsi) analiz edilmez: birindeki değişiklik, projesine bağımlı her şeyi çalıştırır. |
CI sistemleri
Her CI aynı üç şeye ihtiyaç duyar: tam geçmiş, fetch edilmiş hedef branch ve kapsam haritalarını varsayılan branch ile pull request'ler arasında tutacak bir yer.
| CI | Kurulum | Haritaların tutulduğu yer | Özet |
|---|---|---|---|
| GitHub Actions | Action, iki adım | Actions önbelleği, commit başına bir kayıt | Job summary, sizin için yazılır |
| GitLab CI | td aracı, td record ve td test | --maps-dir aracılığıyla paylaşılan bir klasör ya da nesne depolama | --summary-file, Markdown gösterebilen her CI için Markdown yazar |
| Jenkins | |||
| Azure DevOps | |||
| Bitbucket Pipelines |