dotnetup 시작하기

Note

dotnetup 는 공개 미리 보기로 제공됩니다. 해당 기능 및 동작은 정식 출시 전에 변경될 수 있습니다.

dotnetup는 사용자 수준 .NET 설치를 위한 플랫폼 간 도구 체인 관리자입니다. 시스템 패키지 관리자를 사용하지 않고 .NET SDK 및 런타임을 설치, 업데이트 및 제거합니다.

Prerequisites

• 다음 운영 체제 및 아키텍처 중 하나입니다.

  운영 체제	Architectures
  Windows	x64, Arm64
  macOS	x64, Arm64
  Linux(glibc)	x64, Arm64
  Linux(musl) (예: Alpine Linux)	x64, Arm64

• 터미널.

• macOS 또는 Linux의 Bash 또는 Windows PowerShell에서 다운로드 스크립트를 실행합니다.

• macOS 또는 Linux에서 파일을 다운로드하려면 curl 또는 wget을 사용하고, 확인하려면 sha512sum 또는 shasum을 사용합니다.

dotnetup에는 .NET 런타임과 동일한 운영 체제 요구 사항이 있습니다. OS 관련 요구 사항은 Windows .NET 설치, macOS에 .NET 설치 또는 Linux에 .NET 설치를 참조하세요.

Important

Windows에서는 기본 설정이 everywhere 액세스 모드를 사용합니다. 이 모드

• 시스템을 PATH업데이트하려면 권한 상승이 필요합니다.
• dotnetup 관리형 설치가 Visual Studio가 설치하는 .NET 설치와 같은 컴퓨터 전체 .NET 설치보다 우선하도록 합니다. dotnetup에 의해 함께 설치되지 않는 머신 전체 SDK 또는 런타임이 필요한 프로젝트 및 앱도 빌드하거나 실행하지 못합니다.
• 시스템을 PATH변경합니다. 이는 모든 사용자에게 적용됩니다. 다른 사용자가 시작한 상승된 프로세스는 사용자 프로필에서 .NET을 찾을 수 있습니다.

이러한 효과를 방지하려면 설치 중 none 또는 shell 액세스 모드를 선택합니다. everywhere을(를) 선택한 경우 설치 프로그램에서 제안하면 기존 설치를 마이그레이션합니다. 자세한 내용은 Everywhere 모드 고려 사항을 참조하세요.

dotnetup 다운로드

다운로드 스크립트는 기본적으로 최신 preview 빌드를 설치합니다. 다운로드한 실행 파일을 해당 SHA-512 체크섬으로 검증하고 ~/.dotnetup에 설치합니다.

macOS 또는 Linux에서 다음을 실행합니다.

curl -fsSL https://aka.ms/dotnetup/get-dotnetup.sh | bash

Windows에서는 다음을 실행하세요:

irm https://aka.ms/dotnetup/get-dotnetup.ps1 | iex

macOS 또는 Linux에 최신 daily 빌드를 설치하려면 다음을 실행합니다.

curl -fsSL https://aka.ms/dotnetup/get-dotnetup.sh |
  bash -s -- --quality daily

Windows 최신 daily 빌드를 설치하려면 다음을 실행합니다.

iex "& { $(irm https://aka.ms/dotnetup/get-dotnetup.ps1) } -Quality daily"

Important

매일 빌드가 릴리스 유효성 검사를 완료하지 않았으며 코드 서명되지 않았습니다. 단기 테스트에만 일일 빌드를 사용합니다.

스크립트는 PATH에 dotnetup를 추가하는 방법에 대한 지침을 출력합니다. 지침을 적용한 후 새 터미널을 엽니다.

초기 설정 실행

대화형 설정을 실행하세요:

> dotnetup init
Welcome to dotnetup!

SDK Channel: latest
Mode: <recommended-mode> (Suggested)

<recommended-mode> modifies <configuration-target> to set PATH and DOTNET_ROOT to prefer <install-path>.

Would you like to install .NET with the recommended settings?
> Yes, proceed with defaults and install

Installing SDK <resolved-version> to <install-path>...
<download and installation progress>
Installed at <install-path>:
  SDK <resolved-version>
<mode-specific environment guidance>
Setup complete!

경로, 진행률 표시 및 환경 지침은 시스템 및 선택한 모드에 따라 달라집니다.

권장 액세스 모드는 Windows에서 everywhere입니다. macOS 및 Linux에서는 shell가 지원되는 셸을 감지하면 none, 그렇지 않으면 dotnetup입니다.

아니요, 설정 사용자 지정을 선택하여 SDK 채널, 액세스 모드 및 마이그레이션 옵션을 선택합니다.

SDK 채널을 선택하세요

SDK 채널은 dotnetup에 어떤 SDK를 설치하고 이를 어떻게 업데이트할지 알려줍니다.

채널 양식	Example	Result
안정적인 최신 버전	latest	최신 활성 안정 버전 SDK
최신 LTS	lts	최신 활성화된 안정 버전의 LTS SDK
최신 미리보기	preview	최신 미리보기 SDK
최신 일간	daily	사용 가능한 최신 일일 SDK
중요	10	지정된 주 버전에 대한 최신 SDK
주요 및 보조	10.0	지정된 주 버전 및 부 버전에 대한 최신 SDK
기능 리본	10.0.1xx	지정된 기능 대역의 최신 SDK
정확한 버전	10.0.103	지정된 SDK 버전만
초기 SDK 없음	none	설정 중 설치 건너뛰기

정확한 버전은 업데이트 중에 증가하지 않습니다. 허용되는 모든 형식은 dotnetup 채널 및 버전을 참조하세요.

.NET에 액세스하는 방법 선택

액세스 모드는 터미널 및 애플리케이션이 dotnetup 관리 .NET 설치를 찾는 방법을 제어합니다.

액세스 모드	행동
none	이러한 환경 변수는 수정하지 않습니다. .NET을 dotnetup dotnet로 실행합니다.
shell	이러한 환경 변수를 설정하도록 셸 프로필을 수정합니다. 해당 셸에서 시작된 프로세스는 dotnetup에 의해 설치된 .NET SDK 및 런타임을 사용합니다.
everywhere	시스템을 PATH 수정하고 사용자 수준 DOTNET_ROOT 환경 변수를 설정합니다. Windows에서만 사용할 수 있습니다.

everywhere 모드에 대한 자세한 내용 및 고려 사항은 dotnetup 환경 구성을 참조하세요.

기존 설치를 마이그레이션하세요

설치 프로그램은 기존 컴퓨터 전체 .NET SDK 및 런타임 설치를 dotnetup 관리형 설치로 마이그레이션할 수 있는 옵션을 제공할 수 있습니다. 모드에서 마이그레이션이 특히 중요한 이유는 everywhere을 참조하세요.

설치 확인

설정으로 환경이 변경된 후 새 터미널을 엽니다.

shell 또는 everywhere 모드의 경우 다음을 실행합니다.

dotnet --version
dotnetup list

none 모드의 경우 다음을 실행합니다:

dotnetup dotnet -- --version
dotnetup list

dotnetup init을 다시 실행하여 설정을 변경합니다.

dotnetup을 최신 상태로 유지

도구 자체를 업데이트하려면 dotnetup self update를 실행합니다. 일일 빌드의 경우 dotnetup self update --channel daily를 사용합니다. 이러한 명령은 관리되는 SDK 또는 런타임을 업데이트하지 않습니다. 옵션 및 이전 버전 복구 방법은 dotnetup 업데이트 또는 제거를 참조하세요.