Instal .NET SDK dengan Snap

Artikel ini menjelaskan cara menginstal paket snap .NET SDK. Paket snap .NET SDK disediakan oleh dan dikelola oleh Canonical. Snaps adalah alternatif yang bagus untuk manajer paket yang dibangun ke dalam distribusi Linux Anda.

Snap adalah bundel aplikasi dan dependensinya yang berfungsi di berbagai distribusi Linux. Snap dapat ditemukan dan dapat diinstal dari Snap Store. Untuk informasi selengkapnya tentang Snap, lihat Tur mulai cepat.

Prasyarat

• Distribusi Linux yang mendukung snap.
• snapd daemon snap.

Distribusi Linux Anda mungkin sudah menyertakan snap. Coba jalankan snap dari terminal untuk melihat apakah perintah berfungsi. Untuk daftar distribusi Linux yang didukung, dan instruksi tentang cara menginstal snap, lihat Menginstal snapd.

Rilis .NET

Microsoft menerbitkan .NET di bawah dua kebijakan dukungan yang berbeda, Dukungan Jangka Panjang (LTS) dan Dukungan Jangka Standar (STS). Kualitas semua rilis sama. Satu-satunya perbedaan adalah panjang dukungan. Rilis LTS mendapatkan dukungan dan patch gratis selama tiga tahun. Rilis STS mendapatkan dukungan dan patch gratis selama 18 bulan. Untuk informasi selengkapnya, lihat Kebijakan Dukungan .NET.

Versi .NET yang saat ini didukung oleh Microsoft adalah:

• 9.0 (STS)—Dukungan berakhir Mei 2026.
• 8.0 (LTS)—Dukungan berakhir pada 10 November 2026.

Entitas lain yang membangun dan merilis .NET mungkin memperkenalkan kebijakan dukungan yang berbeda. Pastikan untuk memeriksanya untuk memahami bagaimana .NET didukung.

1. Instal SDK

Paket snap untuk .NET SDK semuanya diterbitkan di bawah pengidentifikasi yang sama: dotnet-sdk. Versi tertentu dari SDK dapat diinstal dengan menentukan saluran. SDK mencakup runtime ASP.NET Core dan .NET, versi ke SDK.

1. Buka terminal.

2. Gunakan snap install untuk menginstal paket snap .NET SDK. Misalnya, perintah berikut menginstal latest/stable saluran, yang merupakan default.

   sudo snap install dotnet-sdk --classic
   

   • Parameter --classic diperlukan.
   • --channel Gunakan parameter untuk menentukan versi mana yang akan diinstal. Jika parameter ini dihilangkan, latest/stable digunakan. Misalnya, --channel 8.0/stable menginstal .NET SDK 8.0.

dotnet Alias snap secara otomatis dibuat dan dipetakan ke perintah paket dotnet snap.

Tabel berikut mencantumkan saluran paket yang bisa Anda instal:

2. Ekspor lokasi penginstalan

Variabel DOTNET_ROOT lingkungan sering digunakan oleh alat untuk menentukan di mana .NET diinstal. Saat .NET diinstal melalui Snap, variabel lingkungan ini tidak dikonfigurasi. Anda harus mengonfigurasi variabel lingkungan DOTNET_ROOT di profil Anda. Jalur ke snap menggunakan format berikut: /snap/{package}/current.

export DOTNET_ROOT=/snap/dotnet-sdk/current

Mengekspor variabel lingkungan secara permanen

Perintah sebelumnya export hanya mengatur variabel lingkungan untuk sesi terminal tempatnya dijalankan.

Anda dapat mengedit profil shell untuk menambahkan perintah secara permanen. Ada banyak shell berbeda yang tersedia untuk Linux dan masing-masing memiliki profil yang berbeda. Contohnya:

• Bash Shell: ~/.bash_profile, ~/.bashrc
• Korn Shell: ~/.kshrc atau .profile
• Z Shell: _~/.zshrc* atau .zprofile

Edit file sumber yang sesuai untuk shell Anda dan tambahkan export DOTNET_ROOT=/snap/dotnet-sdk/current.

3. Gunakan .NET CLI

Buka terminal dan ketik dotnet.

dotnet

Output berikut ditampilkan:

Usage: dotnet [options]
Usage: dotnet [path-to-application]

Options:
  -h|--help         Display help.
  --info            Display .NET information.
  --list-sdks       Display the installed SDKs.
  --list-runtimes   Display the installed runtimes.

path-to-application:
  The path to an application .dll file to execute.

Untuk mempelajari cara menggunakan .NET CLI, lihat gambaran umum .NET CLI.

Pemecahan Masalah

• Perintah terminal dotnet tidak berfungsi
• Tidak dapat menginstal Snap di WSL2
• Tidak dapat mengatasi perintah dotnet atau SDK
• Kesalahan Sertifikat TLS/SSL

Perintah terminal dotnet tidak berfungsi

Paket snap dapat memetakan alias ke perintah yang disediakan oleh paket. Secara default, paket snap .NET SDK membuat alias untuk dotnet perintah . Jika alias tidak dibuat atau sebelumnya dihapus, perintah berikut menunjukkan cara memetakan alias:

sudo snap alias dotnet-sdk.dotnet dotnet

Tidak dapat menginstal Snap di WSL2

systemd harus diaktifkan pada instans WSL2 sebelum Snap dapat diinstal.

1. Buka /etc/wsl.conf di editor teks pilihan Anda.

2. Tempelkan dalam konfigurasi berikut:

   [boot]
   systemd=true
   

3. Simpan file dan mulai ulang instans WSL2 melalui PowerShell. Gunakan perntah wsl.exe --shutdown.

Tidak dapat mengatasi perintah dotnet atau SDK

Umum untuk aplikasi lain, seperti IDE kode atau ekstensi di Visual Studio Code, untuk mencoba menyelesaikan lokasi .NET SDK. Biasanya, penemuan DOTNET_ROOT dilakukan dengan memeriksa variabel lingkungan, atau mencari tahu di mana dotnet executable berada. .NET SDK yang diinstal snap mungkin membingungkan aplikasi ini. Saat aplikasi ini tidak dapat mengatasi .NET SDK, kesalahan yang mirip dengan salah satu pesan berikut ditampilkan:

• SDK 'Microsoft.NET.Sdk' yang ditentukan tidak dapat ditemukan
• SDK 'Microsoft.NET.Sdk.Web' yang ditentukan tidak dapat ditemukan
• SDK 'Microsoft.NET.Sdk.Razor' yang ditentukan tidak dapat ditemukan

Coba langkah-langkah berikut untuk memperbaiki masalah:

1. Pastikan Anda mengekspor DOTNET_ROOT variabel lingkungan secara permanen.

2. Cobalah untuk menautkan simbolis snap dotnet executable ke lokasi yang dicari program.

   Dua jalur umum yang dicari dotnet perintah adalah:

   • /usr/local/bin/dotnet
   • /usr/share/dotnet

   Gunakan perintah berikut untuk membuat tautan simbolis ke paket snap:

   ln -s /snap/dotnet-sdk/current/dotnet /usr/local/bin/dotnet
   

Kesalahan Sertifikat TLS/SSL

Ketika .NET diinstal melalui Snap, ada kemungkinan bahwa pada beberapa distribusi sertifikat .NET TLS/SSL mungkin tidak ditemukan dan Anda mungkin menerima kesalahan selama restore:

Processing post-creation actions...
Running 'dotnet restore' on /home/myhome/test/test.csproj...
  Restoring packages for /home/myhome/test/test.csproj...
/snap/dotnet-sdk/27/sdk/2.2.103/NuGet.targets(114,5): error : Unable to load the service index for source https://api.nuget.org/v3/index.json. [/home/myhome/test/test.csproj]
/snap/dotnet-sdk/27/sdk/2.2.103/NuGet.targets(114,5): error :   The SSL connection could not be established, see inner exception. [/home/myhome/test/test.csproj]
/snap/dotnet-sdk/27/sdk/2.2.103/NuGet.targets(114,5): error :   The remote certificate is invalid according to the validation procedure. [/home/myhome/test/test.csproj]

Untuk mengatasi masalah ini, atur beberapa variabel lingkungan:

export SSL_CERT_FILE=[path-to-certificate-file]
export SSL_CERT_DIR=/dev/null

Lokasi sertifikat bervariasi menurut distribusi. Berikut adalah lokasi untuk distribusi tempat masalah telah diamati:

Konten terkait

• Gambaran umum .NET CLI
• Cara mengaktifkan penyelesaian TAB untuk .NET CLI.
• Tutorial: Membuat aplikasi konsol dengan .NET SDK menggunakan Visual Studio Code