Ekstensi VsTest Bridge
Ekstensi ini menyediakan lapisan kompatibilitas dengan VSTest yang memungkinkan kerangka kerja pengujian bergantung padanya untuk terus mendukung berjalan dalam mode VSTest (vstest.console.exe
, biasa dotnet test
, VSTest task
pada AzDo, Test Explorers visual Studio dan Visual Studio Code...). Ekstensi ini dikirim sebagai bagian dari paket Microsoft.Testing.Extensions.VSTestBridge .
Kompatibilitas dengan VSTest
Tujuan utama ekstensi ini adalah untuk menawarkan pengalaman peningkatan yang mudah dan lancar untuk pengguna VSTest dengan memungkinkan mode ganda di mana platform baru diaktifkan dan secara paralel mode kompatibilitas ditawarkan untuk memungkinkan alur kerja yang biasa terus berfungsi.
Dukungan runsettings
Ekstensi ini memungkinkan Anda untuk menyediakan file .runsettings VSTest, tetapi tidak semua opsi dalam file ini diambil oleh platform. Kami menjelaskan di bawah pengaturan, opsi konfigurasi, dan alternatif yang didukung dan tidak didukung untuk opsi konfigurasi VSTest yang paling banyak digunakan.
Saat diaktifkan oleh kerangka kerja pengujian, Anda dapat menggunakan --settings <SETTINGS_FILE>
untuk menyediakan .runsettings
file.
Elemen RunConfiguration
Elemen RunConfiguration dapat menyertakan elemen berikut. Tidak ada pengaturan ini yang dihormati oleh Microsoft.Testing.Platform
:
Simpul | Deskripsi | Alasan / Solusi |
---|---|---|
MaxCpuCount | Pengaturan ini mengontrol tingkat paralelisme pada tingkat proses. Gunakan 0 untuk mengaktifkan paralelisme tingkat proses maksimum. | Ketika Microsoft.Testing.Platform digunakan dengan MSBuild, opsi ini dilepaskan ke MSBuild. Ketika satu executable dijalankan, opsi ini tidak memiliki arti untuk Microsoft.Testing.Platform. |
ResultsDirectory | Direktori tempat hasil tes ditempatkan. Jalur relatif terhadap direktori yang berisi file .runsettings . | Gunakan opsi --results-directory baris perintah untuk menentukan direktori tempat hasil pengujian akan ditempatkan. Jika tidak ada, direktori yang ditentukan akan dibuat. Defaultnya ada TestResults di direktori yang berisi aplikasi pengujian. |
TargetFrameworkVersion | Pengaturan ini menentukan versi kerangka kerja, atau rangkaian kerangka kerja yang akan digunakan untuk menjalankan pengujian. | Opsi ini diabaikan. Properti <TargetFramework> atau <TargetFrameworks> MSBuild menentukan kerangka kerja target aplikasi. Pengujian dihosting di aplikasi akhir. |
TargetPlatform | Pengaturan ini menentukan arsitektur yang akan digunakan untuk menjalankan pengujian. | <RuntimeIdentifier> menentukan arsitektur aplikasi akhir yang menghosting pengujian. |
TreatTestAdapterErrorsAsWarnings | Menekan kesalahan adaptor pengujian untuk menjadi peringatan. | Microsoft.Testing.Platform hanya memungkinkan satu jenis pengujian dijalankan dari satu assembly, dan kegagalan untuk memuat kerangka kerja pengujian atau bagian infrastruktur lainnya akan menjadi kesalahan yang tidak dapat dilewati, karena menandakan bahwa beberapa pengujian tidak dapat ditemukan atau dijalankan. |
TestAdaptersPaths | Satu atau lebih jalur ke direktori tempat TestAdapters berada | Microsoft.Testing.Platform tidak menggunakan konsep adaptor pengujian dan tidak mengizinkan pemuatan ekstensi dinamis kecuali mereka adalah bagian dari build, dan terdaftar di Program.cs , baik secara otomatis melalui target build atau secara manual. |
TestCaseFilter | Filter untuk membatasi pengujian yang akan berjalan. | Untuk memfilter pengujian, gunakan --filter opsi baris perintah. |
TestSessionTimeout | Mengizinkan pengguna untuk menghentikan sesi pengujian saat melebihi batas waktu yang ditentukan. | Tidak ada opsi alternatif. |
DotnetHostPath | Tentukan jalur kustom ke host dotnet yang digunakan untuk menjalankan host pengujian. | Microsoft.Testing.Platform tidak melakukan penyelesaian tambahan dotnet. Ini tergantung sepenuhnya pada bagaimana dotnet menyelesaikan dirinya sendiri, yang dapat dikontrol oleh variabel lingkungan seperti DOTNET_HOST_PATH . |
TreatNoTestsAsError | Keluar dengan kode keluar bukan nol ketika tidak ada pengujian yang ditemukan. | Microsoft.Testing.Platform akan mengalami kesalahan secara default ketika tidak ada pengujian yang ditemukan atau dijalankan dalam aplikasi pengujian. Anda dapat mengatur berapa banyak pengujian yang ingin Anda temukan di perakitan dengan menggunakan --minimum-expected-tests parameter baris perintah, yang defaultnya menjadi 1. |
Elemen DataCollectors
Microsoft.Testing.Platform
tidak menggunakan pengumpul data. Sebaliknya memiliki konsep ekstensi dalam proses dan di luar proses. Setiap ekstensi dikonfigurasi oleh file konfigurasi masing-masing atau melalui baris perintah.
Yang terpenting adalah ekstensi macet dan crash , dan ekstensi cakupan kode.
Elemen LoggerRunSettings
Pencatat masuk dikonfigurasi Microsoft.Testing.Platform
melalui parameter baris perintah atau dengan pengaturan dalam kode.
Dukungan filter VSTest
Ekstensi ini juga menawarkan kemampuan untuk menggunakan mekanisme pemfilteran VSTest untuk menemukan atau menjalankan hanya pengujian yang cocok dengan ekspresi filter. Untuk informasi selengkapnya, lihat bagian Detail opsi filter atau untuk detail spesifik kerangka kerja lihat halaman Menjalankan pengujian unit selektif.
Saat diaktifkan oleh kerangka kerja pengujian, Anda dapat menggunakan --filter <FILTER_EXPRESSION>
.