Pemecahan masalah dotnetup

Note

dotnetup tersedia dalam pratinjau publik. Fitur-fitur dan perilakunya mungkin berubah sebelum GA.

Artikel ini menjelaskan masalah umum dotnetup dan cara memperbaikinya.

Mengumpulkan informasi diagnostik

Sebelum Anda memecahkan masalah, kumpulkan informasi ini:

  • dotnetup Tampilkan versi, arsitektur, pengidentifikasi runtime, dan penginstalan terverifikasi:

    dotnetup --info

  • Tampilkan spesifikasi penginstalan dan instalasi yang dilacak, dan verifikasi file pada disk:

    dotnetup list

  • Bandingkan konfigurasi lingkungan tersimpan dengan lingkungan saat ini:

    dotnetup env show

  • Jalankan perintah yang gagal lagi dengan output terperinci. Contohnya:

    dotnetup sdk install 10.0 --verbosity detailed

Proyek gagal di-build atau aplikasi tidak dimulai setelah penyiapan

Gejala: Setelah Anda menyiapkan dotnetup dalam mode everywhere di Windows, proyek yang sebelumnya berhasil dibangun sekarang gagal dibangun. Atau, aplikasi yang bergantung pada kerangka kerja menunjukkan kesalahan ini:

You must install or update .NET to run this application.

Penyebab: Dalam mode everywhere, penginstalan yang dikelola dotnetup lebih diutamakan daripada penginstalan di seluruh komputer dalam Program Files. SDK dan runtime yang hanya ada di penginstalan untuk seluruh sistem tidak tersedia.

Solusi: Migrasikan SDK dan runtime di seluruh sistem ke dalam penginstalan yang dikelola dotnetup:

dotnetup sdk install --migrate-from-system
dotnetup runtime install --migrate-from-system

Atau, ubah ke mode akses shell atau none. Untuk informasi selengkapnya, lihat Pertimbangan mode Everywhere.

dotnet tidak menggunakan penginstalan yang dikelola dotnetup

Gejala: Perintah dotnet di terminal Anda tidak menggunakan SDK yang diinstal oleh dotnetup.

Penyebab: Terminal sudah terbuka sebelum dotnetup mengubah lingkungan, atau konfigurasi lingkungan tidak cocok dengan konfigurasi tersimpan.

Solution:

  1. Buka terminal baru. Perubahan pada profil shell atau ke variabel lingkungan Windows tidak memengaruhi terminal yang sudah terbuka.

  2. Jalankan dotnetup env show. Jika itu melaporkan penyimpangan, jalankan dotnetup env set untuk menerapkan konfigurasi tersimpan lagi.

  3. Untuk mengonfigurasi terminal saat ini saja, evaluasi output dari dotnetup env script. Misalnya, di Bash atau zsh:

    eval "$(dotnetup env script)"

    Di PowerShell:

    dotnetup env script --shell pwsh | Invoke-Expression

Untuk informasi selengkapnya, lihat Mengelola lingkungan dotnetup.

Jalur penginstalan sudah berisi instalasi yang tidak terlacak

Gejala: Perintah penginstalan gagal dengan kesalahan ini:

The install path '<path>' already contains a .NET installation that is not tracked by dotnetup. To avoid conflicts, use a different install path, remove the existing installation first, or use the --untracked option to install without tracking.

Penyebab:dotnetup tidak menginstal file terlacak ke dalam folder yang berisi penginstalan .NET yang tidak dilacak. Pemeriksaan ini mencegah dotnetup mencampur filenya dengan file yang dimiliki alat lain.

Solusi: Lakukan salah satu hal berikut ini:

  • Pilih folder lain dengan opsi --install-path.
  • Hapus instalasi yang ada di folder tersebut.
  • Jika alat lain memiliki folder, gunakan opsi --untracked. dotnetup tidak mencantumkan, memperbarui, atau menghapus file yang tidak terlacak.

Untuk informasi selengkapnya, lihat Mengelola akar penginstalan kustom.

Executable dotnet sedang digunakan

Gejala: Pada Windows, perintah instal menunjukkan peringatan yang mirip dengan pesan ini:

Warning: Could not update dotnet executable at '<path>' - it is currently in use by another process. Close all running .NET applications and try again. The existing muxer will be retained. ...

Penyebab: Proses yang sedang berjalan menggunakan executable dotnet, sehingga dotnetup tidak dapat menggantinya. Penginstalan berlanjut dengan executable yang ada dotnet. Runtime baru mungkin memerlukan executable dotnet yang lebih baru.

Solusi: Tutup semua aplikasi .NET, IDE, dan server build yang sedang berjalan. Kemudian, jalankan perintah instal lagi. Untuk membuat perintah gagal alih-alih melanjutkan dengan peringatan, gunakan --require-muxer-update opsi .

Proses dotnetup lain sedang berjalan

Gejala: Perintah memperlihatkan pesan ini dan menunggu:

Another dotnetup process is running. Waiting for it to finish...

Penyebab:dotnetup membuat perubahan pada status penginstalan bersama diproses secara berurutan. Perintah lain dotnetup mengubah status yang sama.

Solusi: Tunggu hingga perintah lain selesai. Jika tidak ada proses lain dotnetup yang berjalan, cari proses dotnetup yang berhenti merespons, dan akhiri proses tersebut.

Manifest rusak

Gejala: Perintah gagal dengan kesalahan ini:

The dotnetup manifest at <path> is corrupt. Consider deleting it and re-running the install.

Pesan juga dapat mengatakan bahwa file dimodifikasi di luar dotnetup.

Penyebab: File dotnetup_manifest.json tidak valid. Proses lain atau pengeditan manual mungkin telah mengubah file.

Solusi: Hapus file manifes dan file .sha256 terkaitnya dari direktori data dotnetup. Kemudian, instal ulang SDK dan runtime yang Anda butuhkan. Karena manifes tidak lagi melacak akar penginstalan yang ada, Anda mungkin juga perlu menghapus folder tersebut terlebih dahulu. Untuk lokasi direktori data, lihat Memperbarui atau menghapus dotnetup.

Note

Jangan mengedit file manifes. Gunakan perintah dotnetup untuk mengubah status terlacak.

File konfigurasi rusak

Gejala: Perintah menunjukkan peringatan ini:

Warning: The dotnetup config file at <path> appears to be corrupted and could not be read: ...

Penyebab: File dotnetup.config.json tidak valid. dotnetup mengabaikan file.

Solusi: Jalankan dotnetup env set dengan mode akses yang Anda inginkan, atau jalankan dotnetup init lagi. Perintah ini menulis konfigurasi baru.

Profil shell berisi blok dotnetup yang salah bentuk

Gejala: Perintah env gagal dengan kesalahan yang mirip dengan pesan ini:

The shell profile '<path>' contains a malformed dotnetup block: '<begin marker>' does not have a matching '<end marker>'. Remove or repair the block manually and try again.

Alasan:dotnetup menandai baris yang ditambahkannya ke profil shell dengan komentar awal dan akhir. Salah satu dari komentar ini hilang.

Solusi: Buka profil shell di editor teks. Hapus blok dotnetup yang tidak lengkap, atau tambahkan penanda yang hilang. Kemudian, jalankan perintah lagi.

Ketinggian dibatalkan

Gejala: Pada Windows, perintah yang mengaktifkan atau menonaktifkan mode everywhere memperlihatkan pesan ini:

Elevation was cancelled. The system PATH was not modified.

Penyebab: Perubahan pada sistem PATH memerlukan hak administrator. Dialog Kontrol Akun Pengguna (UAC) dibatalkan.

Solusi: Jalankan perintah lagi dan setujui dialog UAC. Atau, pilih mode akses shell atau none, yang tidak memerlukan hak admin.

Manifes rilis telah kedaluwarsa

Gejala: Penginstalan atau pembaruan gagal selama verifikasi manifes rilis dengan ExpiredNow kode kegagalan.

Penyebab: Waktu sistem saat ini adalah pada atau setelah waktu kedaluwarsa manifes. Manifes mungkin kedaluwarsa, atau jam sistem mungkin salah. Tanda tangan yang valid tidak membuat manifes yang kedaluwarsa menjadi dapat diterima.

Solution:

  1. Periksa tanggal dan waktu sistem Anda. Perbaiki jam jika perlu.
  2. Ulangi perintah. Jika proksi melayani metadata rilis yang di-cache, minta administrator Anda untuk memeriksa apakah proksi tersebut melayani manifes yang kedaluwarsa.
  3. Jika jam sudah benar dan kegagalan berlanjut, laporkan masalah dengan output terperinci perintah.

Jangan mengedit manifest atau mengubah jam untuk melewati pemeriksaan kedaluwarsa. Untuk informasi selengkapnya, lihat Kedaluwarsa manifes.

Pemasangan diblokir oleh kebijakan TI

Gejala: Penginstalan build harian atau prarilis gagal dengan pesan yang mengatakan bahwa kebijakan TI memerlukan unduhan yang ditandatangani kode.

Penyebab: Administrator memblokir unduhan yang tidak ditandatangani pada komputer.

Solusi: Instal versi yang dirilis, atau minta administrator Anda untuk menghapus setelan kebijakan. Untuk informasi selengkapnya, lihat Cara dotnetup memverifikasi unduhan.

Laporkan masalah

Jika artikel ini tidak menyelesaikan masalah Anda, cari masalah dotnetup yang ada. Jika Anda tidak menemukan kecocokan, buka masalah baru di repositori dotnet/sdk dengan templat masalah dotnetup . Sertakan output dari dotnetup --info dan output perintah yang gagal dengan --verbosity detailed.

Untuk pertanyaan dan saran, gunakan diskusi dotnetup.

Baca juga

  • Terakhir diperbarui pada