Bagikan melalui

Tutorial: Menerbitkan aplikasi konsol .NET

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.

Prasyarat

Menerbitkan aplikasi

  1. Mulai Visual Studio.

  2. Buka proyek HelloWorld yang Anda buat di Buat aplikasi konsol .NET.

  3. Pastikan Visual Studio menggunakan konfigurasi build Rilis. Jika perlu, ubah pengaturan konfigurasi build pada toolbar dari Debug menjadi Rilis.

    Visual Studio toolbar dengan build release yang dipilih.

  4. Klik kanan proyek HelloWorld (bukan solusi HelloWorld) dan pilih Terbitkan dari menu.

    Visual Studio Terbitkan menu konteks.

  5. Pada tab Target dari halaman Terbitkan, pilih Folder, lalu pilih Berikutnya.

    Pick target penerbitan di Visual Studio.

  6. Pada tab Target Spesifik dari Halaman Publikasi, pilih Folder, lalu pilih Berikutnya.

    Pick target penerbitan tertentu di Visual Studio.

  7. Pada tab Lokasi dari halaman Terbitkan, pilih Selesai.

    Visual Studio Terbitkan tab Lokasi halaman.

  8. Pada halaman kemajuan pembuatan profil Terbitkan , pilih Tutup.

  9. Pada tab Terbitkan dari jendela Terbitkan , pilih Terbitkan.

    Jendela Pemublikasian Visual Studio.

  1. Mulai Visual Studio Code.

  2. Buka folder proyek HelloWorld yang Anda buat di Buat aplikasi konsol .NET.

  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:

    Restore complete (1.1s)
  HelloWorld net10.0 succeeded (7.8s) → bin\Release\net10.0\publish\

Build succeeded in 10.3s

  1. Buka GitHub Codespace yang Anda buat di Buat aplikasi konsol .NET.

  2. 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.

  3. Di terminal, pastikan Anda berada di folder tutorial .

  4. 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 terinstal. Pengguna dapat menjalankan aplikasi yang diterbitkan dengan mengklik dua kali file executable atau memberikan perintah dari command prompt.

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

  1. Di Penjelajah Solusi, pilih Tampungkan Semua File.

    opsi Penjelajah Solusi untuk Menampilkan Semua Berkas.

  2. Di folder proyek, perluas bin/Release/{net}/publish. (Di mana {net} adalah folder kerangka kerja target, seperti net10.0.)

    Penjelajah Solusi memperlihatkan berkas yang dipublikasikan.

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

    • HelloWorld.deps.json

      Ini adalah file dependensi yang diperlukan saat aplikasi berjalan. 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 versi aplikasi bergantung pada kerangka kerja. Untuk menjalankan pustaka tautan dinamis ini, masukkan pada prompt perintah. Metode menjalankan aplikasi ini berfungsi pada platform apa pun yang memiliki runtime .NET terinstal.

    • HelloWorld.exe

      Ini adalah versi aplikasi yang dapat dieksekusi yang bergantung pada kerangka kerja . Untuk menjalankannya, masukkan pada prompt perintah. 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 bahwa aplikasi Anda dibangun untuk dijalankan. Anda juga dapat menambahkan opsi konfigurasi ke dalamnya. Untuk informasi selengkapnya, lihat pengaturan konfigurasi runtime .NET.

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 terinstal. Untuk menjalankan aplikasi yang diterbitkan, Anda dapat menggunakan file yang dapat dieksekusi atau menjalankan perintah 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/net10.0/publish.

    Explorer menampilkan file terbitan

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

    • HelloWorld.deps.json

      Ini adalah file dependensi yang diperlukan saat aplikasi berjalan. 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 versi aplikasi bergantung pada kerangka kerja. Untuk menjalankan pustaka tautan dinamis ini, masukkan pada prompt perintah. Metode menjalankan aplikasi ini berfungsi pada platform apa pun yang memiliki runtime .NET terinstal.

    • 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 bahwa aplikasi Anda dibangun untuk dijalankan. Anda juga dapat menambahkan opsi konfigurasi ke dalamnya. Untuk informasi lebih lanjut, 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 perintah .

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

  1. Pilih Explorer di bilah navigasi kiri.

  2. Perluas artefak/HelloWorld.

    Explorer menampilkan file terbitan

    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 yang diperlukan saat aplikasi berjalan. 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 versi aplikasi bergantung pada kerangka kerja. Untuk menjalankan pustaka tautan dinamis ini, masukkan pada prompt perintah. Metode menjalankan aplikasi ini berfungsi pada platform apa pun yang memiliki runtime .NET terinstal.

    • 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 bahwa 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

  1. Di Penjelajah Solusi, klik kanan folder publish, dan pilih Copy Full Path.

  2. Buka prompt perintah dan navigasikan ke folder terbitkan. Untuk melakukannya, masukkan lalu tempelkan jalur lengkap. Contohnya:

    cd C:\Projects\HelloWorld\bin\Release\net10.0\publish\

  3. Jalankan aplikasi dengan menggunakan executable:

    1. Masukkan dan tekan Enter.

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

  4. Jalankan aplikasi dengan menggunakan perintah :

    1. Masukkan dan tekan Enter.

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

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

    Menu konteks menampilkan Buka di Terminal

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

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

    2. Di Linux, masukkan 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 :

    1. Masukkan dan tekan Enter.

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

  1. Di Explorer, klik kanan folder artefak/HelloWorld dan pilih Buka di Terminal Terintegrasi.

  2. Jalankan aplikasi dengan menggunakan executable. Masukkan lalu tekan Enter.

  3. 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 SDK .NET, 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 selanjutnya

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

Buat pustaka kelas .NET

  • Last updated on