Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Tutorial ini membawa Anda melalui pengalaman interaktif membangun solusi sampel langkah demi langkah untuk mempelajari konsep pengujian unit.
Artikel ini berisi tentang menguji proyek .NET Core. Jika Anda menguji proyek ASP.NET Core, lihat pengujian Integrasi di ASP.NET Core.
Prerequisites
- .NET 10 SDK atau versi yang lebih baru.
- Editor teks atau editor kode pilihan Anda.
TUnit dibangun sepenuhnya di atas Microsoft.Testing.Platform (MTP) dan tidak mendukung VSTest. Tutorial ini menggunakan mode MTP , dotnet testyang memerlukan .NET 10 SDK.
Membuat proyek sumber
Buka jendela shell. Buat direktori yang disebut unit-testing-vb-tunit untuk menyimpan solusi. Di dalam direktori baru ini, jalankan perintah berikut untuk membuat file solusi baru untuk pustaka kelas dan proyek pengujian:
dotnet new sln
Selanjutnya, buat direktori PrimeService. Kerangka berikut menunjukkan struktur file sejauh ini:
/unit-testing-vb-tunit
unit-testing-vb-tunit.slnx
/PrimeService
Jadikan PrimeService sebagai direktori aktif dan jalankan perintah berikut untuk membuat proyek sumber:
dotnet new classlib -lang VB
Ganti nama Class1.vb menjadi PrimeService.vb. Anda membuat implementasi yang gagal dari kelas PrimeService:
Namespace Prime.Services
Public Class PrimeService
Public Function IsPrime(candidate As Integer) As Boolean
Throw New NotImplementedException("Please create a test first.")
End Function
End Class
End Namespace
Ubah direktori kembali ke direktori unit-testing-vb-tunit . Jalankan perintah berikut untuk menambahkan proyek pustaka kelas ke solusi:
dotnet sln add ./PrimeService/PrimeService.vbproj
Membuat proyek pengujian
Selanjutnya, buat direktori PrimeService.Tests. Kerangka berikut menunjukkan struktur direktori:
/unit-testing-vb-tunit
unit-testing-vb-tunit.slnx
/PrimeService
Source Files
PrimeService.vbproj
/PrimeService.Tests
Templat proyek TUnit tidak disertakan dalam SDK .NET. Instal semuanya dengan perintah berikut:
dotnet new install TUnit.Templates
Jadikan direktori PrimeService.Tests sebagai direktori saat ini dan buat proyek baru menggunakan perintah berikut:
dotnet new TUnit -lang VB
Note
Nama pendek templat peka huruf besar/kecil. Gunakan TUnit, bukan tunit.
Perintah dotnet new membuat proyek pengujian yang menggunakan TUnit sebagai pustaka pengujian. File PrimeService.Tests.vbproj yang dihasilkan adalah proyek yang dapat dieksekusi yang mereferensikan paket TUnit, yang mencakup kerangka kerja pengujian, pustaka asersi, dan runner pengujian MTP, sehingga proyek tidak memerlukan paket pengujian lain.
Template juga menambahkan contoh pengujian. Hapus semua file .vb dan direktori Data dari direktori PrimeService.Tests , karena tutorial ini menggantinya dengan pengujiannya sendiri.
Sekarang, tambahkan pustaka kelas PrimeService sebagai dependensi lain ke proyek. Gunakan perintah dotnet reference add:
dotnet reference add ../PrimeService/PrimeService.vbproj
Anda memiliki tata letak solusi akhir berikut:
/unit-testing-vb-tunit
unit-testing-vb-tunit.slnx
/PrimeService
Source Files
PrimeService.vbproj
/PrimeService.Tests
Test Source Files
PrimeService.Tests.vbproj
Jalankan perintah berikut di direktori unit-testing-vb-tunit :
dotnet sln add ./PrimeService.Tests/PrimeService.Tests.vbproj
Mengonfigurasi mode MTP dotnet test
Karena TUnit tidak mendukung VSTest, dotnet test harus berjalan dalam mode MTP-nya. Di direktori unit-testing-vb-tunit , buat file global.json dengan konten berikut:
{
"test": {
"runner": "Microsoft.Testing.Platform"
}
}
Untuk informasi selengkapnya, lihat mode MTP dari dotnet test.
Membuat pengujian pertama
Anda menulis satu pengujian yang gagal, membuatnya lulus, lalu mengulangi prosesnya. Di direktori PrimeService.Tests , buat file PrimeService_IsPrimeShould.vb dengan kode berikut:
Imports TUnit.Assertions
Imports TUnit.Assertions.Extensions
Imports TUnit.Core
Namespace PrimeService.Tests
Public Class PrimeService_IsPrimeShould
Private ReadOnly _primeService As Prime.Services.PrimeService = New Prime.Services.PrimeService()
<Test>
Public Async Function IsPrime_InputIs1_ReturnFalse() As Task
Dim result As Boolean = _primeService.IsPrime(1)
Await Assert.That(result).IsFalse()
End Function
End Class
End Namespace
Atribut <Test> menunjukkan metode yang dijalankan oleh runner pengujian. TUnit tidak memerlukan atribut di kelas . Pernyataan TUnit bersifat asinkron, sehingga pengujian adalah Async Function yang mengembalikan Task dan menunggu Assert.That.
Visual Basic menempatkan kode di setiap proyek di bawah namespace akar proyek, sehingga kelas PrimeService berada dalam namespace PrimeService.Prime.Services. Pengujian ini menyebutnya sebagai Prime.Services.PrimeService karena, di dalam namespace proyek pengujian, namanya PrimeService mengacu pada namespace daripada ke kelas .
Dari direktori unit-testing-vb-tunit, jalankan dotnet test untuk membangun pengujian dan pustaka kelas lalu jalankan pengujian. Proyek pengujian TUnit berisi titik masuk program untuk menjalankan pengujian Anda.
dotnet test memulai aplikasi pengujian menggunakan proyek pengujian unit yang telah Anda buat.
Tes anda gagal. Anda belum membuat implementasi. Buat lulus pengujian ini dengan menulis kode paling sederhana di kelas PrimeService yang berfungsi:
Public Function IsPrime(candidate As Integer) As Boolean
If candidate = 1 Then
Return False
End If
Throw New NotImplementedException("Please create a test first.")
End Function
Di direktori unit-testing-vb-tunit, jalankan dotnet test lagi. Perintah dotnet test menjalankan build untuk proyek PrimeService lalu untuk proyek PrimeService.Tests. Setelah membangun kedua proyek, sistem menjalankan pengujian tunggal ini. Ini berlalu.
Menambahkan lebih banyak fitur
Sekarang setelah Anda menyelesaikan satu kali uji coba, saatnya menulis lebih banyak. Ada beberapa kasus sederhana lainnya untuk bilangan prima: 0, -1. Anda dapat menambahkan kasus-kasus tersebut sebagai pengujian baru dengan atribut <Test>, tetapi itu dengan cepat menjadi melelahkan. TUnit menyediakan <Arguments> atribut untuk membuat serangkaian pengujian yang menjalankan kode yang sama tetapi memiliki argumen input yang berbeda.
Alih-alih membuat pengujian baru, terapkan atribut ini untuk membuat satu pengujian berbasis data. Ganti fungsi IsPrime_InputIs1_ReturnFalse dengan kode berikut, yang menguji beberapa nilai kurang dari dua, bilangan prima terkecil:
<Test>
<Arguments(-1)>
<Arguments(0)>
<Arguments(1)>
Public Async Function IsPrime_ValuesLessThan2_ReturnFalse(value As Integer) As Task
Dim result As Boolean = _primeService.IsPrime(value)
Await Assert.That(result).IsFalse()
End Function
Jalankan dotnet test, dan dua pengujian ini gagal. Untuk membuat semua tes lulus, ubah If klausul di awal IsPrime metode dalam file PrimeService.vb :
If candidate < 2 Then
Lanjutkan iterasi dengan menambahkan lebih banyak pengujian dan lebih banyak kode di pustaka utama.
Anda telah membangun perpustakaan kecil dan serangkaian unit pengujian untuk perpustakaan tersebut. Anda telah menyusun solusi sehingga menambahkan paket dan pengujian baru adalah bagian dari alur kerja normal. Anda telah memkonsentasikan sebagian besar waktu dan upaya Anda untuk menyelesaikan tujuan aplikasi.
Baca juga
- Dokumentasi TUnit
- dotnet reference add (perintah untuk menambahkan referensi)
- pengujian dotnet