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.

Prasyarat

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

Menerbitkan aplikasi

Mulai Visual Studio Code.
Buka folder proyek HelloWorld yang Anda buat di Membuat aplikasi konsol .NET menggunakan Visual Studio Code.
Pilih >Lihat Terminal dari menu utama.

Terminal terbuka di folder HelloWorld.
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:
```
Restore complete (1.1s)
  HelloWorld net10.0 succeeded (7.8s) → bin\Release\net10.0\publish\

Build succeeded in 10.3s
```

Buka GitHub Codespace yang Anda buat di Membuat aplikasi konsol .NET menggunakan Visual Studio Code.
Tambahkan baris kode berikut ke bagian atas HelloWorld.cs:
```
#:property PublishAot=false
```
Direktif properti ini, menonaktifkan kompilasi native ahead-of-time (AOT) dan aplikasi akan menggunakan kompilator just-in-time (JIT) standar pada runtime. Output yang diterbitkan akan bergantung pada kerangka kerja.
Di terminal, pastikan Anda berada di folder tutorial .

Jalankan perintah berikut:

dotnet publish HelloWorld.cs

Perintah membuat executable independen.

Output perintah mirip dengan contoh berikut:

Restore complete (0.5s)
  HelloWorld net10.0 succeeded (4.0s) → artifacts\HelloWorld\

Build succeeded in 5.1s

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.

Pilih Explorer di bilah navigasi kiri.
Perluas bin/Release/net10.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.

Untuk aplikasi file tunggal, proses penerbitan membuat direktori artefak dengan file rakitan yang dikompilasi. Aplikasi yang diterbitkan dapat dijalankan menggunakan dotnet perintah .

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

Pilih Explorer di bilah navigasi kiri.
Perluas artefak/HelloWorld.

Seperti yang ditunjukkan gambar, output yang diterbitkan mencakup file berikut:
- HelloWorld
  
  Ini adalah versi aplikasi yang dapat dieksekusi yang bergantung pada kerangka kerja . File ini khusus untuk sistem operasi. Codespace berjalan di Linux, jadi ini dapat dieksekusi Linux.
- 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.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.
Klik kanan dan pilih Unduh... untuk mengunduh file dari Codespace ke komputer lokal Anda.

Menjalankan aplikasi yang diterbitkan

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

Menu konteks
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.
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.

Di Explorer, klik kanan folder artefak/HelloWorld dan pilih Buka di Terminal Terintegrasi.
Jalankan aplikasi dengan menggunakan executable. Masukkan ./HelloWorld lalu tekan Enter.
Masukkan nama sebagai respons terhadap perintah, dan tekan Masukkan untuk keluar.

Sumber daya tambahan

Membersihkan sumber daya

GitHub secara otomatis menghapus Codespace Anda setelah 30 hari tidak aktif. Jika Anda berencana untuk menjelajahi lebih banyak tutorial di seri ini, Anda dapat membiarkan Codespace Anda tetap tersedia. Jika Anda siap untuk mengunjungi situs .NET untuk mengunduh .NET SDK, Anda dapat menghapus Codespace Anda. Untuk menghapus Codespace Anda, buka jendela browser dan navigasikan ke Codespace Anda. Anda melihat daftar codespace Anda di jendela. Pilih tiga titik (...) dalam entri untuk ruang kode tutorial pembelajaran. Lalu pilih "hapus".

Langkah berikutnya

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

Membuat pustaka kelas .NET menggunakan Visual Studio Code

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2026-02-05