Baca dalam bahasa Inggris

Bagikan melalui


dotnet vstest

Artikel ini berlaku untuk: ️ .NET Core 3.1 SDK dan versi yang lebih baru

Penting

Perintah dotnet vstest digantikan oleh dotnet test, yang sekarang dapat digunakan untuk menjalankan rakitan. Lihat pengujian dotnet.

Nama

dotnet vstest - Menjalankan pengujian dari rakitan yang ditentukan.

Sinopsis

.NET CLI
dotnet vstest [<TEST_FILE_NAMES>] [--Blame] [--Diag <PATH_TO_LOG_FILE>]
    [--Framework <FRAMEWORK>] [--InIsolation] [-lt|--ListTests <FILE_NAME>]
    [--logger <LOGGER_URI/FRIENDLY_NAME>] [--Parallel]
    [--ParentProcessId <PROCESS_ID>] [--Platform] <PLATFORM_TYPE>
    [--Port <PORT>] [--ResultsDirectory<PATH>] [--Settings <SETTINGS_FILE>]
    [--TestAdapterPath <PATH>] [--TestCaseFilter <EXPRESSION>]
    [--Tests <TEST_NAMES>] [[--] <args>...]]

dotnet vstest -?|--Help

Deskripsi

dotnet vstest Perintah menjalankan VSTest.Console aplikasi baris perintah untuk menjalankan pengujian unit otomatis.

Argumen

  • TEST_FILE_NAMES

    Jalankan pengujian dari rakitan yang ditentukan. Pisahkan beberapa nama rakitan pengujian dengan spasi. Penggunaan wildcard didukung.

Opsi

  • --Blame

    Menjalankan tes dalam mode menyalahkan. Opsi ini sangat membantu dalam mengisolasi tes bermasalah yang menyebabkan host pengujian crash. Ini membuat file output di direktori saat ini sebagai Sequence.xml yang menangkap urutan eksekusi pengujian sebelum crash.

  • --Diag <PATH_TO_LOG_FILE>

    Mengaktifkan log verbose untuk platform pengujian. Log ditulis ke file yang disediakan.

  • --Framework <FRAMEWORK>

    Targetkan versi .NET Framework yang digunakan untuk eksekusi pengujian. Contoh nilai yang valid adalah .NETFramework,Version=v4.6 atau .NETCoreApp,Version=v1.0. Nilai lain yang didukung adalah Framework40, Framework45, FrameworkCore10, dan FrameworkUap10.

  • --InIsolation

    Menjalankan pengujian dalam proses yang terisolasi. Hal ini membuat prosesvstest.console.exe cenderung tidak dihentikan pada kesalahan dalam pengujian, tetapi pengujian mungkin berjalan lebih lambat.

  • -lt|--ListTests <FILE_NAME>

    Mencantumkan semua pengujian yang ditemukan dari kontainer pengujian yang diberikan.

  • --logger <LOGGER_URI/FRIENDLY_NAME>

    Tentukan pencatat untuk hasil pengujian.

    • Untuk menerbitkan hasil pengujian ke Team Foundation Server, gunakan penyedia pencatat TfsPublisher :

      Console
      /logger:TfsPublisher;
          Collection=<team project collection url>;
          BuildName=<build name>;
          TeamProject=<team project name>
          [;Platform=<Defaults to "Any CPU">]
          [;Flavor=<Defaults to "Debug">]
          [;RunTitle=<title>]
      
    • Untuk mencatat hasil ke File Hasil Pengujian Visual Studio (TRX), gunakan penyedia pencatat trx . Sakelar ini membuat file di direktori hasil pengujian dengan nama file log yang diberikan. Jika LogFileName tidak disediakan, nama file unik dibuat untuk menyimpan hasil pengujian.

      Console
      /logger:trx [;LogFileName=<Defaults to unique file name>]
      
  • --Parallel

    Jalankan pengujian secara paralel. Secara default, semua inti yang tersedia pada komputer tersedia untuk digunakan. Tentukan jumlah eksplisit inti dengan mengatur MaxCpuCount properti di bawah simpul RunConfiguration dalam file runsettings .

  • --ParentProcessId <PROCESS_ID>

    ID proses dari proses induk yang bertanggung jawab untuk meluncurkan proses saat ini.

  • --Platform <PLATFORM_TYPE>

    Arsitektur platform target yang digunakan untuk eksekusi pengujian. Nilai yang valid adalah x86, x64, dan ARM.

  • --Port <PORT>

    Menentukan port untuk koneksi soket dan menerima pesan peristiwa.

  • --ResultsDirectory:<PATH>

    Direktori hasil pengujian akan dibuat di jalur yang ditentukan jika tidak ada.

  • --Settings <SETTINGS_FILE>

    Pengaturan yang digunakan saat menjalankan pengujian.

  • --TestAdapterPath <PATH>

    Gunakan adaptor pengujian kustom dari jalur tertentu (jika ada) dalam uji coba.

  • --TestCaseFilter <EXPRESSION>

    Jalankan pengujian yang cocok dengan ekspresi yang diberikan. <EXPRESSION> adalah format <property>Operator<value>[|&<EXPRESSION>], di mana Operator adalah salah satu dari =, !=, atau ~. Operator ~ memiliki semantik 'berisi' dan berlaku untuk properti string seperti DisplayName. () Tanda kurung digunakan untuk mengelompokkan subekspresi. Untuk informasi selengkapnya, lihat Filter TestCase.

  • --Tests <TEST_NAMES>

    Jalankan pengujian dengan nama yang cocok dengan nilai yang disediakan. Pisahkan beberapa nilai dengan koma.

  • -?|--Help

    Mencetak bantuan singkat untuk perintah.

  • @<file>

    Membaca file respons untuk opsi lainnya.

  • args

    Menentukan argumen tambahan untuk diteruskan ke adapter. Argumen ditentukan sebagai pasangan nama-nilai formulir <n>=<v>, di mana <n> adalah nama argumen dan <v> merupakan nilai argumen. Gunakan spasi untuk memisahkan beberapa argumen.

Contoh

Jalankan pengujian di mytestproject.dll:

.NET CLI
dotnet vstest mytestproject.dll

Jalankan pengujian di mytestproject.dll, mengekspor ke folder kustom dengan nama kustom:

.NET CLI
dotnet vstest mytestproject.dll --logger:"trx;LogFileName=custom_file_name.trx" --ResultsDirectory:custom/file/path

Jalankan pengujian di mytestproject.dll dan myothertestproject.exe:

.NET CLI
dotnet vstest mytestproject.dll myothertestproject.exe

Jalankan TestMethod1 pengujian:

.NET CLI
dotnet vstest /Tests:TestMethod1

Jalankan TestMethod1 dan TestMethod2 uji:

.NET CLI
dotnet vstest /Tests:TestMethod1,TestMethod2

Lihat juga