Menjalankan dan memperbaiki pengujian

Proyek pengujian MTP dibangun sebagai executable yang dapat dijalankan (atau di-debug) secara langsung. Tidak ada konsol atau perintah tambahan untuk pengujian. Aplikasi keluar dengan kode keluar selain nol jika ada kesalahan, yang khas untuk sebagian besar program yang dapat dieksekusi. Untuk informasi selengkapnya tentang kode keluar yang diketahui, lihat kode keluar MTP.

Petunjuk / Saran

Anda dapat mengabaikan kode keluar tertentu menggunakan opsi baris perintah --ignore-exit-code.

Anda juga dapat mengatur opsi baris perintah yang berlaku untuk project pengujian tertentu dalam file project menggunakan properti MSBuild TestingPlatformCommandLineArguments. Salah satu kasus penggunaan umum adalah untuk proyek pengujian yang mengabaikan semua pengujian, yang biasanya akan keluar dengan kode keluar 8 (sesi pengujian menjalankan nol pengujian). Dalam skenario ini, Anda dapat menambahkan yang berikut ini di bawah PropertyGroup dalam file project Anda:

<TestingPlatformCommandLineArguments>$(TestingPlatformCommandLineArguments) --ignore-exit-code 8</TestingPlatformCommandLineArguments>

Penting

Secara default, MTP mengumpulkan telemetri. Untuk informasi selengkapnya dan opsi untuk memilih keluar, lihat telemetri MTP.

Nota

Tersedia di MTP yang dimulai dengan versi 2.3.0.

Untuk menghentikan secara aman, tekan Ctrl+C sekali untuk mengirim permintaan pembatalan. Menjalankan pengujian dapat menyelesaikan proses teardown. Untuk segera mengakhiri, tekan Ctrl+C lagi.

.NET CLI

Menerbitkan project pengujian menggunakan dotnet publish dan menjalankan aplikasi secara langsung adalah cara lain untuk menjalankan pengujian Anda. Misalnya, menjalankan ./Contoso.MyTests.exe. Dalam beberapa skenario, juga layak untuk menggunakan dotnet build untuk menghasilkan yang dapat dieksekusi, tetapi mungkin ada kasus tepi yang perlu dipertimbangkan, seperti Native AOT.

Gunakan dotnet run

Perintah dotnet run dapat digunakan untuk membangun dan menjalankan project pengujian Anda. Ini adalah yang paling mudah, meskipun kadang-kadang paling lambat, cara untuk menjalankan tes Anda. Menggunakan dotnet run praktis saat Anda mengedit dan menjalankan pengujian secara lokal, karena memastikan bahwa project pengujian dibangun kembali saat diperlukan. dotnet run juga akan secara otomatis menemukan project di folder saat ini.

dotnet run --project Contoso.MyTests

Untuk informasi selengkapnya tentang dotnet run, lihat perintah 'dotnet run'.

Gunakan dotnet exec

Perintah dotnet exec atau dotnet digunakan untuk menjalankan (atau menjalankan) project pengujian yang sudah dibuat, ini adalah alternatif untuk menjalankan aplikasi secara langsung. dotnet exec memerlukan jalur ke dll project pengujian bawaan.

dotnet exec Contoso.MyTests.dll

or

dotnet Contoso.MyTests.dll

Nota

Menyediakan jalur ke project pengujian yang dapat dieksekusi (*.exe) mengakibatkan kesalahan:

Error:
  An assembly specified in the application dependencies manifest
  (Contoso.MyTests.deps.json) has already been found but with a different
  file extension:
    package: 'Contoso.MyTests', version: '1.0.0'
    path: 'Contoso.MyTests.dll'
    previously found assembly: 'S:\t\Contoso.MyTests\bin\Debug\net10.0\Contoso.MyTests.exe'

Untuk informasi selengkapnya tentang dotnet exec, lihat dotnet exec.

Gunakan dotnet test

Dimulai dengan .NET 10 SDK, dotnet test memiliki mode MTP khusus. Pilih MTP melalui global.json, atau gunakan variabel lingkungan DOTNET_TEST_RUNNER dengan .NET 11 Pratinjau 6 atau yang lebih baru. Mode khusus mendukung proyek, solusi, modul pengujian bawaan, dan jenis input tambahan dalam versi SDK yang lebih baru.

dotnet test --test-modules Contoso.MyTests.dll

Untuk pemilihan runner dan migrasi dari mode yang kompatibel dengan VSTest, lihat Pengujian dengan dotnet test.

Visual Studio

Pengujian MTP dapat dijalankan (dan di-debug) di Visual Studio, mereka terintegrasi dengan Test Explorer, dan juga dapat dijalankan langsung sebagai proyek startup.

Menjalankan aplikasi dengan Visual Studio

Proyek pengujian MTP dibangun sebagai executable, dan dapat dijalankan secara langsung. Ini menjalankan semua pengujian dalam executable yang diberikan, kecuali jika filter disediakan.

1. Navigasikan project pengujian yang ingin Anda jalankan di Penjelajah Solusi, pilih kanan dan pilih Set sebagai Startup Project.
2. Pilih Debug>Mulai tanpa Debugging (atau gunakan Ctrl+F5) untuk menjalankan project pengujian yang dipilih.

Jendela konsol muncul dengan proses dan ringkasan pengujian Anda.

Debug aplikasi langsung di Visual Studio

Proyek pengujian MTP dapat di-debug secara langsung. Untuk melakukan debug semua pengujian dalam executable yang diberikan, kecuali jika filter disediakan:

1. Navigasikan project pengujian yang ingin Anda jalankan di Penjelajah Solusi, pilih kanan dan pilih Set sebagai Startup Project.
2. Atur titik henti ke dalam pengujian yang ingin Anda debug.
3. Buka Debug>Mulai Debugging (atau tekan F5) untuk men-debug project pengujian yang dipilih.

Semua pengujian dijalankan hingga pengujian Anda dengan titik jeda tercapai. Ikuti tes Anda untuk men-debugnya. Setelah selesai men-debug aplikasi, lanjutkan menjalankan semua pengujian yang tersisa, kecuali Anda menghentikannya.

Menggunakan Test Explorer

Untuk menjalankan pengujian, navigasikan ke Test Explorer, pilih pengujian (atau pengujian) yang akan dijalankan. Klik kanan, lalu pilih Jalankan. Untuk mendebug pengujian, pilih pengujian (atau beberapa pengujian) di Test Explorer, klik kanan dan pilih Debug.

Nota

Pembaruan otomatis pengujian tanpa membangun proyek tidak tersedia.

Visual Studio Code

Ekstensi C# bersama dengan C# Dev Kit memungkinkan Anda untuk men-debug/menjalankan pengujian dalam kode Visual Studio, serta menambahkan integrasi dengan Test Explorer Visual Studio Code.

Menjalankan aplikasi dengan kode Visual Studio

Proyek pengujian MTP dibangun sebagai executable, dan dapat dijalankan secara langsung. Ini menjalankan semua pengujian dalam executable yang diberikan, kecuali jika filter disediakan.

1. Navigasi ke file pengujian yang ingin Anda jalankan pengujiannya.
2. Gunakan Ctrl+F5 untuk menjalankan project pengujian yang dipilih. Jika Anda memiliki beberapa proyek, popup akan meminta Anda untuk memilih proyek yang akan dijalankan.

Jendela konsol muncul dengan proses dan ringkasan pengujian Anda.

Men-debug aplikasi langsung di Kode Visual Studio

Proyek pengujian MTP dibangun sebagai executable, dan dapat dijalankan secara langsung. Ini menjalankan semua pengujian dalam executable yang diberikan, kecuali jika filter disediakan.

1. Navigasi ke file pengujian yang ingin Anda jalankan pengujiannya.
2. Gunakan F5 untuk men-debug project pengujian yang dipilih. Jika Anda memiliki beberapa proyek, popup akan meminta Anda untuk memilih proyek yang akan dijalankan.

Petunjuk / Saran

Ada beberapa cara lain untuk menjalankan project dotnet menggunakan C# DevKit, seperti menjalankan dari solution explorer atau membuat konfigurasi peluncuran yang sesuai. Ini ditentukan dalam dokumentasi kode Visual Studio.

Saat proyek dijalankan, tab output muncul dengan hasil eksekusi dan ringkasan pengujian Anda.

Menggunakan Test Explorer

Untuk menjalankan pengujian, navigasikan ke Test Explorer, pilih pengujian (atau pengujian) yang akan dijalankan. Klik kanan, lalu pilih Jalankan. Untuk mendebug pengujian, pilih pengujian (atau beberapa pengujian) di Test Explorer, klik kanan dan pilih Debug.

Nota

Pembaruan otomatis pengujian tanpa membangun proyek tidak tersedia.

integrasi berkelanjutan (CI)

• Untuk menjalankan satu project pengujian di CI, tambahkan satu langkah untuk setiap pengujian yang dapat dieksekusi yang ingin Anda jalankan, seperti berikut ini di Azure DevOps:

  - task: CmdLine@2
    displayName: "Run Contoso.MyTests"
    inputs:
      script: '.\Contoso.MyTests\bin\Debug\net10.0\Contoso.MyTests.exe'
  

• Jalankan dotnet test perintah secara manual, mirip dengan alur kerja lokal biasa:

  - task: CmdLine@2
    displayName: "Run tests"
    inputs:
      script: 'dotnet test' # add command-line options as needed
  

• Jalankan menggunakan tugas DotNetCoreCLI Azure dengan perintah uji. Ini memerlukan global.json file di akar repositori Anda yang menentukan MTP sebagai runner pengujian:

  {
      "test": {
          "runner": "Microsoft.Testing.Platform"
      }
  }
  

  - task: DotNetCoreCLI@2
    displayName: "Run tests"
    inputs:
      command: test
  

  Nota

  Dukungan untuk MTP in DotNetCoreCLI ditambahkan dalam versi tugas 2.263.0 .

Baca juga

• Gambaran umum MTP
• Referensi opsi MTP CLI
• Pengujian dengan dotnet test
• dotnet test dengan MTP
• Menjalankan pengujian dengan MSTest