Periksa dukungan Visual Studio Code untuk pengujian unit

Selesai

Sebelum Anda dapat menghasilkan pengujian unit dengan GitHub Copilot, proyek Anda memerlukan kerangka kerja pengujian yang berfungsi dan cara untuk menjalankan pengujian di dalam Visual Studio Code. Visual Studio Code, SDK .NET, dan ekstensi C# Dev Kit menyediakan lingkungan yang menghosting pengujian unit Anda, sementara GitHub Copilot berfokus pada pembuatan dan penyempurnaan kode pengujian. Memahami lingkungan yang mendasar membuat alur kerja GitHub Copilot jauh lebih mudah diikuti.

Unit ini memeriksa fitur Visual Studio Code dan alat C# yang mendukung pengujian unit. Unit selanjutnya berfokus pada bagaimana GitHub Copilot menghasilkan dan memelihara kode pengujian yang berjalan di lingkungan ini.

Dukungan untuk uji unit di Visual Studio Code

Untuk membuat dan menjalankan pengujian unit C# di Visual Studio Code, Anda memerlukan sumber daya berikut:

  • SDK .NET 8.0 atau yang lebih baru.
  • Ekstensi C# Dev Kit untuk Visual Studio Code.
  • Paket kerangka kerja pengujian ditambahkan ke proyek Anda.

Dukungan C# Dev Kit untuk pengujian unit

Ekstensi C# Dev Kit menyediakan fitur pengujian yang Anda gunakan di seluruh modul ini:

  • Test Explorer: Tampilan pohon yang menampilkan semua kasus pengujian di ruang kerja Anda. Anda dapat membuka Test Explorer dengan memilih ikon beaker pada bilah Aktivitas.
  • Jalankan/Debug kasus uji: Tombol jalankan berwarna hijau muncul di editor di samping setiap kelas dan metode uji. Klik kanan tombol putar untuk melihat opsi lainnya.
  • Lihat hasil pengujian: Setelah pengujian berjalan, hasilnya tercermin dalam dekorasi editor dan di Test Explorer. Memilih tautan pada jejak tumpukan akan membuka lokasi sumber.
  • Perintah pengujian: Perintah seperti Test: Run All Tests tersedia di Palet Perintah. Cari Test: untuk melihat daftar lengkapnya.
  • Pengaturan pengujian: Pengaturan yang mengontrol penemuan pengujian dan perilaku runtime tersedia di editor Pengaturan. Cari Testing untuk melihat opsi yang tersedia.

C# Dev Kit mendukung kerangka kerja pengujian berikut:

  • xUnit
  • NUnit
  • MSTest

Membuat proyek pengujian menggunakan Palet Perintah

Palet Perintah di Visual Studio Code menyediakan cara term mudah untuk membuat proyek pengujian yang menggunakan kerangka kerja yang didukung. Anda dapat membuka Palet Perintah dengan cara berikut:

  • Tekan tombol Ctrl + Shift + P (Windows/Linux) atau Cmd + Shift + P (macOS).
  • Buka menu Tampilan, lalu pilih Palet Perintah.
  • Buka tampilan Penjelajah Solusi, klik kanan folder solusi, lalu pilih Proyek Baru. Opsi ini membuka Palet Perintah dengan perintah .NET: New Project... yang sudah dipilih.

Bagian berikut menunjukkan cara membuat proyek pengujian untuk setiap kerangka kerja yang didukung.

xUnit

Buka Palet Perintah dan pilih .NET: Project Baru... , pilih xUit Test Project, lalu berikan nama dan lokasi untuk project baru. Perintah ini membuat proyek yang menggunakan xUnit sebagai pustaka pengujian dan mengonfigurasi runner pengujian dengan menambahkan elemen berikut <PackageReference /> ke file proyek:

  • Microsoft.NET.Test.Sdk
  • xUnit
  • xunit.runner.visualstudio
  • coverlet.collector

Dari Terminal terintegrasi, Anda dapat menambahkan referensi dari proyek pengujian ke proyek yang sedang diuji:

dotnet add [location of your test csproj file] reference [location of the csproj file for project to be tested]

NUnit

Buka Palet Perintah dan pilih .NET: Project Baru... , pilih NUnit3 Test Project, lalu berikan nama dan lokasi untuk project baru. Perintah ini membuat proyek yang menggunakan NUnit sebagai pustaka pengujian dan menambahkan elemen berikut <PackageReference /> ke file proyek:

  • Microsoft.NET.Test.Sdk
  • NUnit
  • NUnit3TestAdapter

Tambahkan referensi ke proyek yang sedang diuji dari Terminal:

dotnet add [location of your test csproj file] reference [location of the csproj file for project to be tested]

MSTest

Buka Palet Perintah dan pilih .NET: Project Baru... , pilih MSTest Test Project, lalu berikan nama dan lokasi untuk project baru. Perintah ini menambahkan elemen berikut <PackageReference /> ke file proyek:

  • Microsoft.NET.Test.Sdk
  • MSTest.TestAdapter
  • MSTest.TestFramework
  • coverlet.collector

Tambahkan referensi ke proyek yang sedang diuji dari Terminal:

dotnet add [location of your test csproj file] reference [location of the csproj file for project to be tested]

Menjalankan dan mengelola pengujian unit di Visual Studio Code

Setelah proyek pengujian ada, Visual Studio Code dan C# Dev Kit memberi Anda beberapa cara untuk menjalankan dan mengelola pengujian:

  • Jalankan/Debug dari editor: Pilih tombol putar hijau di samping kelas atau metode untuk menjalankan target tersebut. Klik kanan tombol putar untuk melihat opsi seperti Jalankan Pengujian dan Uji Debug.
  • Test Explorer: Jalankan atau debug pengujian individu, grup, atau rangkaian lengkap dari tampilan pohon. Hasil pengujian, termasuk ikon dan durasi lulus/gagal, muncul di samping setiap item.
  • Lihat hasil pengujian: Dekorasi editor dan Test Explorer mencerminkan status saat ini dari setiap pengujian setelah eksekusi. Pilih tautan dalam stack trace untuk langsung menuju ke baris yang menyebabkan error.
  • Perintah pengujian: Gunakan perintah seperti Test: Run All Tests, Test: Debug Failed Tests, dan Test: Show Output dari Palet Perintah.
  • Pengaturan pengujian: Cari Testing di editor Pengaturan untuk mengonfigurasi perilaku seperti menjalankan otomatis saat menyimpan atau menguji pemformatan hasil.

Alur kerja pengujian unit dengan GitHub Copilot

Saat Anda menggabungkan Visual Studio Code dengan GitHub Copilot, proses pengujian unit memecah menjadi tiga tahap:

  1. Siapkan lingkungan: Gunakan Visual Studio Code, .NET SDK, dan C# Dev Kit untuk membuat proyek pengujian dan mereferensikan proyek yang sedang diuji. Anda menyelesaikan tahap ini di unit ini.
  2. Buat kode pengujian: Gunakan GitHub Copilot dalam tampilan Obrolan untuk menghasilkan pengujian unit untuk kode aplikasi Anda. Unit-unit berikutnya mencakup tahap ini.
  3. Buat dan pertahankan pengujian: Gunakan Test Explorer dan C# Dev Kit untuk menjalankan pengujian, lalu gunakan GitHub Copilot untuk memperluas cakupan dan memperbaiki pengujian yang gagal.

Unit yang tersisa berfokus pada alat GitHub Copilot yang mendukung tahap 2 dan 3.