Tutorial: Menerbitkan aplikasi konsol .NET menggunakan Visual Studio Code

Tutorial ini menunjukkan cara menerbitkan aplikasi konsol sehingga pengguna lain dapat menjalankannya. Penerbitan membuat kumpulan file yang diperlukan untuk menjalankan aplikasi. Untuk menyebarkan file, salin ke komputer target.

.NET CLI digunakan untuk menerbitkan aplikasi, sehingga Anda dapat mengikuti tutorial ini dengan editor kode selain Visual Studio Code jika Anda mau.

Prasyarat

• Tutorial ini berfungsi dengan aplikasi konsol yang Anda buat di Membuat aplikasi konsol .NET menggunakan Visual Studio Code.

Menerbitkan aplikasi

1. Mulai Visual Studio Code.

2. Buka folder proyek HelloWorld yang Anda buat di Membuat aplikasi konsol .NET menggunakan Visual Studio Code.

3. Pilih >Lihat Terminal dari menu utama.

   Terminal terbuka di folder HelloWorld.

4. Jalankan perintah berikut:

   dotnet publish
   

   Konfigurasi build default adalah Release, yang sesuai untuk situs yang disebarkan yang berjalan dalam lingkungan produksi. Output dari konfigurasi build rilis memiliki informasi debug simbolis yang minimal dan dioptimalkan sepenuhnya.

   Output perintah mirip dengan contoh berikut:

   Microsoft (R) Build Engine version 17.8.0+b89cb5fde for .NET
   Copyright (C) Microsoft Corporation. All rights reserved.
     Determining projects to restore...
     All projects are up-to-date for restore.
     HelloWorld -> C:\Projects\HelloWorld\bin\Release\net8.0\HelloWorld.dll
     HelloWorld -> C:\Projects\HelloWorld\bin\Release\net8.0\publish\
   

Memeriksa file

Secara default, proses penerbitan membuat penyebaran yang bergantung pada kerangka kerja, yang merupakan jenis penyebaran di mana aplikasi yang diterbitkan berjalan pada komputer yang memiliki runtime .NET yang diinstal. Untuk menjalankan aplikasi yang diterbitkan, Anda dapat menggunakan file yang dapat dieksekusi atau menjalankan perintah dotnet HelloWorld.dll dari prompt perintah.

Dalam langkah-langkah berikut, Anda akan melihat file yang dibuat oleh proses penerbitan.

1. Pilih Explorer di bilah navigasi kiri.

2. Perluas bin/Release/net8.0/publish.

   

   Seperti yang ditunjukkan gambar, output yang diterbitkan mencakup file berikut:

   • HelloWorld.deps.json

     Ini adalah file dependensi runtime untuk aplikasi. Ini mendefinisikan komponen .NET dan pustaka (termasuk pustaka tautan dinamis yang berisi aplikasi Anda) yang diperlukan untuk menjalankan aplikasi. Untuk informasi selengkapnya, lihat file konfigurasi runtime .

   • HelloWorld.dll

     Ini adalah penyebaran tergantung kerangka kerja versi aplikasi. Untuk menjalankan pustaka tautan dinamis ini, masukkan dotnet HelloWorld.dll pada prompt perintah. Metode menjalankan aplikasi ini berfungsi pada platform apa pun yang memiliki runtime .NET yang diinstal.

   • HelloWorld.exe (HelloWorld di Linux atau macOS.)

   Ini adalah versi aplikasi yang dapat dieksekusi yang bergantung pada kerangka kerja . File ini khusus untuk sistem operasi.

   • HelloWorld.pdb (opsional untuk penyebaran)

     Ini adalah file simbol debug. Anda tidak diharuskan untuk menyebarkan file ini bersama dengan aplikasi Anda, meskipun Anda harus menyimpannya jika Anda perlu men-debug versi aplikasi yang diterbitkan.

   • HelloWorld.runtimeconfig.json

     Ini adalah file konfigurasi runtime aplikasi. Ini mengidentifikasi versi .NET tempat aplikasi Anda dibangun untuk dijalankan. Anda juga dapat menambahkan opsi konfigurasi ke dalamnya. Untuk informasi selengkapnya, lihat pengaturan konfigurasi runtime .NET.

Menjalankan aplikasi yang diterbitkan

1. Di Explorer, klik kanan folder publish (Ctrl-klik pada macOS), dan pilih Buka di Terminal Terpadu.

   Menu konteks

2. Di Windows atau Linux, jalankan aplikasi dengan menggunakan executable.

   1. Di Windows, masukkan .\HelloWorld.exe dan tekan Enter.

   2. Di Linux, masukkan ./HelloWorld dan tekan Enter.

   3. Masukkan nama sebagai respons terhadap perintah, dan tekan Masukkan untuk keluar.

3. Pada platform apa pun, jalankan aplikasi dengan menggunakan perintah dotnet:

   1. Masukkan dotnet HelloWorld.dll dan tekan Enter.

   2. Masukkan nama sebagai respons terhadap perintah, dan tekan Masukkan untuk keluar.

Sumber daya tambahan

• Gambaran umum penerbitan aplikasi .NET
• dotnet publish
• Menggunakan .NET SDK di lingkungan integrasi berkelanjutan (CI)

Langkah berikutnya

Dalam tutorial ini, Anda menerbitkan aplikasi konsol. Dalam tutorial berikutnya, Anda membuat pustaka kelas.

Membuat pustaka kelas .NET menggunakan Visual Studio Code