Pengantar untuk proyek dan solusi

Artikel pengantar ini membahas apa yang dimaksud membuat solusi dan proyek di Visual Studio. Solusi adalah kontainer untuk mengatur satu atau beberapa proyek kode terkait, seperti proyek pustaka kelas .NET Framework dan proyek pengujian yang sesuai.

Sebagai latihan edukasi untuk memahami konsep proyek, Anda akan menciptakan solusi dan proyek dari awal. Biasanya, Anda akan menggunakan templat proyek Visual Studio untuk membuat proyek baru. Anda juga akan melihat properti proyek dan beberapa file yang dapat dimuatnya, dan membuat referensi dari satu proyek ke proyek lainnya.

Catatan

Mengembangkan aplikasi di Visual Studio tidak memerlukan solusi dan proyek. Anda cukup membuka folder yang berisi kode dan memulai pengodean, membangun, dan melakukan penelusuran kesalahan. Misalnya, repositori GitHub yang dikloning mungkin tidak berisi proyek dan solusi Visual Studio. Untuk informasi selengkapnya, lihat Mengembangkan kode di Visual Studio tanpa proyek atau solusi.

Jika Anda belum menginstal Visual Studio, buka halaman pengunduhan Visual Studio untuk menginstalnya secara gratis.

Solusi dan proyek

Di Visual Studio, solusi bukanlah "jawaban". Solusi hanyalah kontainer yang digunakan Visual Studio untuk mengatur satu atau beberapa proyek terkait. Saat Anda membuka solusi, Visual Studio otomatis memuat semua proyek yang berada dalam solusi.

Membuat solusi

Mulai eksplorasi Anda dengan membuat solusi kosong. Setelah mengenal Visual Studio, Anda mungkin tidak akan sering membuat solusi kosong. Saat Anda membuat proyek baru, Visual Studio otomatis membuat solusi untuk proyek kecuali solusi sudah dibuka.

1. Buka Visual Studio, dan pada jendela mulai, pilih Buat proyek baru.

2. Pada halaman Buat proyek baru, masukkan solusi kosong ke dalam kotak pencarian, pilih templat Solusi Kosong, lalu pilih Berikutnya.

   

   Tip

   Jika Anda memiliki beberapa beban kerja yang terinstal, templat Solusi Kosong mungkin tidak muncul di bagian atas daftar hasil pencarian Anda. Coba gulir melalui Hasil lain berdasarkan pencarian Anda untuk menemukan templat tersebut.

3. Pada halaman Konfigurasikan proyek baru, beri nama solusi sebagai QuickSolution, lalu pilih Buat.

   Solusi QuickSolution muncul di Penjelajah Solusi di sisi kanan jendela Visual Studio. Anda akan sering menggunakan Penjelajah Solusi untuk menelusuri konten proyek.

Menambahkan proyek

Sekarang mari tambahkan proyek pertama ke solusi. Mulailah dengan proyek kosong, dan tambahkan item yang dibutuhkan.

1. Klik kanan 'QuickSolution' Solusi di Penjelajah Solusi, dan pilih Tambahkan>Proyek Baru dari menu pintasan.

2. Pada halaman Tambahkan proyek baru, ketik kosong ke dalam kotak pencarian di bagian atas, dan pilih C# pada Semua bahasa.

3. Pilih templat Proyek Kosong (.NET Framework) C#, lalu pilih Berikutnya.

   Catatan

   Visual Studio menggunakan penginstalan berbasis beban kerja untuk hanya menginstal komponen yang Anda butuhkan untuk jenis pengembangan yang Anda lakukan. Jika tidak melihat templat Proyek Kosong (.NET Framework), Anda perlu menginstal beban kerja Visual Studio pengembangan desktop .NET.

   Cara mudah untuk menginstal beban kerja baru saat Anda membuat proyek baru adalah dengan memilih link Instal alat dan fitur lainnya di bawah teks Tidak menemukan yang Anda cari?. Di Alat Penginstal Visual Studio, pilih beban kerja pengembangan desktop .NET, lalu pilih Ubah.

   

4. Pada halaman Konfigurasikan proyek baru, beri nama proyek sebagai QuickDate, lalu pilih Buat.

   Proyek QuickDate muncul di bagian solusi di Penjelajah Solusi. Proyek berisi simpul Referensi dan satu file bernama App.config.

Menambahkan item ke proyek

Tambahkan file kode ke proyek kosong Anda.

1. Dari menu klik kanan atau menu pintasan proyek QuickDate di Penjelajah Solusi, pilih Tambahkan>Item Baru.

   Kotak dialog Tambahkan Item Baru terbuka. Pilih Perlihatkan Semua Templat jika dialog terbuka dalam tampilan ringkas.

2. Luaskan Item Visual C#, lalu pilih Kode. Di panel tengah, pilih templat item Kelas. Di bawah Nama, ketik Kalender, lalu pilih Tambahkan.

   Visual Studio menambahkan file bernama Calendar.cs ke proyek. .cs di akhir adalah ekstensi file untuk file kode C#. File Calendar.cs muncul dalam hierarki proyek visual Penjelajah Solusi, dan file terbuka di editor.

3. Ganti konten file Calendar.cs dengan kode berikut:

   using System;
   
   namespace QuickDate
   {
       internal class Calendar
       {
           static void Main(string[] args)
           {
               DateTime now = GetCurrentDate();
               Console.WriteLine($"Today's date is {now}");
               Console.ReadLine();
           }
   
           internal static DateTime GetCurrentDate()
           {
               return DateTime.Now.Date;
           }
       }
   }
   

   Anda belum perlu memahami semua yang dilakukan kode. Jalankan aplikasi dengan menekan Ctrl+F5, dan lihat bahwa aplikasi mencetak tanggal hari ini ke jendela konsol, atau output standar. Kemudian, tutup jendela konsol.

Menambahkan proyek kedua

Solusi biasanya berisi lebih dari satu proyek, dan proyek tersebut sering kali saling merujuk. Beberapa proyek dalam solusi dapat berupa pustaka kelas, beberapa mungkin aplikasi yang dapat dieksekusi, dan beberapa mungkin merupakan proyek pengujian unit atau situs web.

Untuk menambahkan proyek pengujian unit ke solusi Anda, mulai dari templat proyek sehingga Anda tidak perlu menambahkan file kode lain ke proyek.

1. Dari menu klik kanan atau menu pintasan 'QuickSolution' Solusi in Penjelajah Solusi, pilih Tambahkan>Proyek Baru.

2. Dalam kotak dialog Tambahkan proyek baru, ketik pengujian unit ke dalam kotak pencarian di bagian atas, lalu pilih C# pada Semua bahasa.

3. Pilih templat proyek Unit Test Project (.NET Framework) C#, lalu pilih Berikutnya.

4. Pada halaman Konfigurasikan proyek baru beri nama proyek sebagai QuickTest, lalu pilih Buat.

   Visual Studio menambahkan proyek QuickTest ke Penjelajah Solusi, dan file UnitTest1.cs terbuka di editor.

   

Menambahkan referensi proyek

Anda akan menggunakan proyek pengujian unit baru untuk menguji metode Anda di proyek QuickDate, sehingga Anda perlu menambahkan referensi QuickDate ke proyek QuickTest. Menambahkan referensi akan membuat dependensi build antara kedua proyek, yang berarti bahwa saat Anda membangun solusi, QuickDate dibangun sebelum QuickTest.

1. Di Penjelajah Solusi, klik kanan node Referensi proyek QuickTest, dan pilih Tambahkan Referensi dari menu pintasan.

2. Dalam kotak dialog Manajer Referensi, pilih Proyek. Di panel tengah, pilih kotak centang di samping QuickDate, lalu pilih OK.

   Referensi proyek QuickDate muncul pada proyek QuickTest di Penjelajah Solusi.

   

Menambahkan kode pengujian

1. Sekarang tambahkan kode pengujian ke file kode pengujian C#. Ganti konten UnitTest1.cs dengan kode berikut:

   using System;
   using Microsoft.VisualStudio.TestTools.UnitTesting;
   
   namespace QuickTest
   {
       [TestClass]
       public class UnitTest1
       {
           [TestMethod]
           public void TestGetCurrentDate()
           {
               Assert.AreEqual(DateTime.Now.Date, QuickDate.Calendar.GetCurrentDate());
           }
       }
   }
   

   Garis berlekuk merah muncul di bawah beberapa kode. Anda dapat memperbaiki kesalahan ini dengan menjadikan proyek pengujian sebagai rakitan teman untuk proyek QuickDate.

2. Dalam file Calendar.cs, tambahkan menggunakan pernyataan dan atribut InternalsVisibleToAttribute berikut ke bagian atas file untuk mengatasi kesalahan dalam proyek pengujian.

   using System.Runtime.CompilerServices;
   
   [assembly: InternalsVisibleTo("QuickTest")]
   

   Kode Calendar.cs akan tampak seperti cuplikan layar ini:

   

Menjalankan pengujian unit

Jika Anda ingin memeriksa apakah pengujian unit berfungsi, pilih Pengujian>Jalankan Semua Pengujian dari bilah menu. Jendela Test Explorer terbuka, dan Anda akan melihat bahwa pengujian TestGetCurrentDate lulus.

Tip

Anda juga dapat membuka Test Explorer dengan memilih Test>Explorer dari bilah menu.

Properti proyek

Baris dalam file Calendar.cs yang berisi atribut InternalsVisibleToAttribute mereferensikan nama rakitan atau nama file proyek QuickTest. Nama rakitan mungkin tidak selalu sama dengan nama proyek. Untuk menemukan nama rakitan proyek, gunakan properti proyek. Halaman properti berisi berbagai pengaturan untuk proyek.

1. Di Penjelajah Solusi, klik kanan proyek QuickTest dan pilih Properti, atau pilih proyek dan tekan Alt+Enter.

   Halaman properti untuk proyek terbuka di tab Aplikasi. Nama rakitan dari proyek QuickTest tentu saja QuickTest.

   Jika mau, Anda dapat mengubah namanya di sini. Saat Anda membuat proyek pengujian, nama file biner yang dihasilkan kemudian berubah dari QuickTest.dll menjadi <NewName>.dll.

   

2. Jelajahi beberapa tab lain dari halaman properti proyek, seperti Build dan Pengaturan. Tab tersebut berbeda untuk berbagai jenis proyek.

Baca juga

• Bekerja dengan proyek dan solusi
• Mengembangkan kode di Visual Studio tanpa proyek dan solusi
• Mengelola properti proyek dan solusi
• Mengelola referensi dalam proyek