Bagikan melalui


Pengantar proyek dan solusi

Dalam tutorial ini, Anda menjelajahi apa artinya membuat solusi dan proyek di Visual Studio. Solusinya adalah kontainer untuk mengatur satu atau beberapa proyek kode terkait, seperti proyek pustaka kelas dan proyek pengujian yang sesuai. Anda membuat referensi dari satu proyek ke proyek lainnya dalam solusi. Tutorial ini juga menjelaskan properti proyek dan beberapa file yang dapat dikandungnya.

Sebagai latihan untuk memahami konsep proyek, Anda membuat solusi dan proyek dari awal. Biasanya, Anda akan menggunakan proyek Visual Studio templat untuk membuat proyek baru.

Dalam tutorial ini, Anda mempelajari cara:

  • Menambahkan item ke proyek
  • Menambahkan proyek kedua
  • Menambahkan referensi proyek
  • Menambahkan kode pengujian
  • Menampilkan properti Proyek

Prasyarat

  • Jika Anda tidak memiliki Visual Studio 2019, kunjungi Unduhan Visual Studio untuk menginstalnya secara gratis.

Solusi dan proyek

Di Visual Studio, solusi bukan jawaban . Solusinya hanyalah kontainer yang digunakan Visual Studio untuk mengatur satu atau beberapa proyek terkait. Saat Anda membuka solusi, Visual Studio secara otomatis memuat semua proyek yang dimuat solusi.

Nota

Mengembangkan aplikasi di Visual Studio tidak memerlukan solusi dan proyek. Anda hanya dapat membuka folder yang berisi kode dan mulai mengodekan, membangun, dan men-debug. Misalnya, repositori github kloning mungkin tidak berisi proyek dan solusi Visual Studio. Untuk informasi selengkapnya, lihat Mengembangkan kode di Visual Studio tanpa proyek atau 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 secara otomatis membuat solusi untuk proyek kecuali solusi sudah terbuka.

  1. Buka Visual Studio.

  2. Pada jendela mulai, pilih Buat proyek baru.

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

    Cuplikan layar yang memperlihatkan templat Solusi Kosong dipilih di Visual Studio 2019.

    Saran

    Jika Anda memiliki beberapa beban kerja yang terinstal, templat Solusi Kosong mungkin tidak muncul di bagian atas daftar hasil pencarian Anda. Coba gulir ke Hasil lain berdasarkan bagian pencarian Anda dari daftar. Seharusnya muncul di sana.

  4. Beri nama solusi QuickSolution, lalu pilih Buat.

    Solusi muncul di Penjelajah Solusi di sisi kanan jendela Visual Studio. Anda mungkin akan sering menggunakan Solution Explorer, untuk menelusuri konten proyek Anda.

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

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

    Cuplikan layar yang memperlihatkan templat Solusi Kosong dipilih di Visual Studio.

    Saran

    Jika Anda memiliki beberapa beban kerja yang terinstal, templat Solusi Kosong mungkin tidak muncul di bagian atas daftar hasil pencarian Anda. Cobalah menggulir melalui hasil lain berdasarkan pencarian Anda untuk menemukan templatnya.

  3. Pada halaman Mengonfigurasi proyek baru Anda, beri nama solusi QuickSolution, lalu pilih Buat.

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

Menambahkan proyek

Sekarang tambahkan proyek pertama Anda ke solusi. Mulailah dengan proyek kosong, dan tambahkan item yang Anda butuhkan.

  1. Di Penjelajah Solusi, klik kanan Solusi'QuickSolution'. Di menu konteks, pilih Tambahkan>Proyek Baru.

    Kotak dialog terbuka yang mengatakan Tambahkan proyek baru.

  2. Masukkan teks kosong ke dalam kotak pencarian di bagian atas, lalu pilih C# di bawah Bahasa.

  3. Pilih templat Empty Project (.NET Framework), lalu pilih Berikutnya.

  4. Beri nama proyek QuickDate, lalu pilih Buat.

    Proyek bernama QuickDate muncul di bawah solusi di Penjelajah Solusi. Saat ini berisi satu file yang disebut App.config.

    Nota

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

    Cara mudah untuk menginstal beban kerja baru saat Anda membuat proyek baru adalah dengan memilih tautan Menginstal lebih banyak alat dan fitur di bawah teks yang mengatakan Tidak menemukan apa yang Anda cari?. Setelah Penginstal Visual Studio diluncurkan, pilih pengembangan desktop .NET beban kerja lalu tombol Ubah.

    Cuplikan layar yang menampilkan tautan Buka Penginstal Visual Studio.

  1. Di Penjelajah Solusi, klik kanan Solusi'QuickSolution'. Di menu konteks, pilih Tambahkan>Proyek Baru.

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

  3. Pilih templat C# Empty Project (.NET Framework), lalu pilih Berikutnya.

    Nota

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

    Cara mudah untuk menginstal beban kerja baru saat Anda membuat proyek baru adalah dengan memilih tautan Menginstal lebih banyak alat dan fitur di bawah teks yang mengatakan Tidak menemukan apa yang Anda cari?. Di Penginstal Visual Studio, pilih beban kerja pengembangan desktop .NET, lalu pilih Ubah.

    Cuplikan layar yang menampilkan tautan Buka Penginstal Visual Studio.

  4. Pada halaman Mengonfigurasi proyek baru Anda, beri nama proyek QuickDate, kemudian pilih Buat.

    Proyek QuickDate muncul di bawah solusi di Solution Explorer. Proyek ini berisi node Referensi dan satu file bernama App.config.

Menambahkan item ke proyek

Tambahkan file kode ke proyek kosong Anda.

  1. Di Solution Explorer, klik kanan proyek QuickDate. Dari menu konteks, pilih Tambahkan>Item Baru.

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

  2. Perluas Item Visual C#, lalu pilih kode . Di panel tengah, pilih templat item Kelas . Di bawah Nama, ketik Kalender, lalu pilih Tambah.

    Visual Studio menambahkan file bernama Calendar.cs ke proyek. .cs di akhir adalah ekstensi file untuk file kode C#. File Calendar.cs muncul di Penjelajah Solusi hierarki proyek visual, 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 tidak perlu memahami semua yang dilakukan kode. Jalankan aplikasi dengan menekan Ctrl+F5. Aplikasi mencetak tanggal hari ini ke jendela konsol , atau output standar. Kemudian, tutup jendela konsol.

Menambahkan proyek kedua

Solusi umumnya berisi lebih dari satu proyek, dan proyek-proyek ini sering saling mereferensikan. Beberapa proyek dalam solusi mungkin 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. Di Penjelajah Solusi, klik kanan Solusi'QuickSolution'. Dari menu konteks, pilih Tambahkan>Proyek Baru.

  2. Dalam kotak dialog Tambah proyek baru, masukkan teks uji unit ke dalam kotak pencarian di bagian atas, lalu pilih C# di bawah Bahasa.

  3. Pilih templat proyek Unit Test Project untuk .NET Core, lalu pilih Berikutnya.

    Nota

    Mulai visual Studio 2019 versi 16.9, nama templat proyek MSTest berubah dari MSTest Unit Test Project (.NET Core) menjadi Unit Test Project. Beberapa langkah dalam pembuatan proyek berubah dalam pembaruan ini.

  4. Beri nama proyek QuickTest, lalu pilih Berikutnya.

  5. Pilih kerangka kerja target yang direkomendasikan (.NET Core 3.1) atau .NET 5, lalu pilih Buat.

    Proyek kedua ditambahkan ke Solution Explorer, dan file bernama UnitTest1.cs terbuka di editor.

    Cuplikan layar yang memperlihatkan Penjelajah Solusi dengan dua proyek.

  1. Di Penjelajah Solusi, klik kanan Solusi'QuickSolution'. Dari menu konteks, pilih Tambahkan>Proyek Baru.

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

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

  4. Pada halaman Mengonfigurasi proyek baru Anda, beri nama proyek QuickTest, lalu pilih Buat.

    Visual Studio menambahkan proyek QuickTest ke Solution Explorer, dan file UnitTest1.cs terbuka di editor.

    Cuplikan layar yang memperlihatkan Penjelajah Solusi dengan dua proyek.

Menambahkan referensi proyek

Untuk menggunakan proyek pengujian unit baru untuk menguji metode Anda di proyek QuickDate, Anda perlu menambahkan referensi ke QuickDate ke proyek QuickTest. Menambahkan referensi membuat dependensi build antara kedua proyek. Saat Anda membangun solusi, QuickDate dibangun sebelum QuickTest.

  1. Klik kanan simpul Dependensi di proyek QuickTest. Dari menu konteks, pilih Tambahkan Referensi Proyek.

    Kotak dialog Reference Manager terbuka.

  2. Di panel kiri, perluas Proyek, lalu pilih solusi . Di panel tengah, pilih kotak centang di samping QuickDate, lalu pilih OK.

    Referensi ke proyek QuickDate ditambahkan.

    Cuplikan layar Penjelajah Solusi memperlihatkan referensi proyek di Visual Studio 2019.

  1. Di Penjelajah Solusi, klik kanan pada node Referensi dari proyek QuickTest. Dari menu konteks, pilih Tambahkan Referensi.

  2. Pada kotak dialog Reference Manager, pilih Projects. Di panel tengah, pilih kotak centang di samping QuickDate, lalu pilih OK.

    Referensi ke proyek QuickDate muncul di bawah proyek QuickTest di Solution Explorer.

    Cuplikan layar Penjelajah Solusi memperlihatkan referensi proyek.

Menambahkan kode pengujian

  1. Sekarang tambahkan kode pengujian ke file kode uji 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 bergelombang merah muncul di bawah beberapa kode. Anda dapat memperbaiki kesalahan ini dengan menjadikan proyek pengujian sebagai perakitan teman ke proyek QuickDate.

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

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

    Kode Calendar.cs akan terlihat seperti cuplikan layar ini:

    Cuplikan layar yang memperlihatkan kode C Sharp.

    Cuplikan layar yang memperlihatkan kode C Sharp.

Jalankan pengujian unit

Untuk memeriksa apakah pengujian unit Anda berfungsi, dari bilah menu, pilih Tes>Jalankan Semua Pengujian. Jendela Test Explorer terbuka, dan Anda akan melihat bahwa tes TestGetCurrentDate berhasil.

Cuplikan layar yang memperlihatkan Test Explorer dengan pengujian yang lulus.

Cuplikan layar yang memperlihatkan Test Explorer dengan pengujian yang lulus.

Saran

Anda juga dapat membuka Test Explorer dengan memilih Test>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 yang terbuka ke tab Aplikasi. Nama Rakitan proyek QuickTest memang QuickTest.

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

    Cuplikan layar yang memperlihatkan properti proyek.

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