dotnetup으로 리포지토리용 SDK 설치

Note

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

SDK 채널을 제공하지 않으면 dotnetup sdk install는 현재 디렉터리에서 파일 시스템 루트 방향으로 검색합니다. 가장 가까운 기존 global.json 파일을 사용합니다. 해당 파일의 형식이 잘못된 경우 부모 디렉터리를 검색하는 대신 명령이 실패합니다. 파일이 없으면 latest을(를) 사용합니다.

리포지토리 요구 사항을 설치

리포지토리 디렉터리에서 다음을 실행합니다.

dotnetup sdk install

이 global.json 파일의 경우 dotnetup은 기능 밴드를 추적합니다 10.0.1xx .

{
  "sdk": {
    "version": "10.0.103",
    "rollForward": "latestPatch"
  }
}

global.json 경로는 저장된 요구 사항의 원본입니다. 다음을 사용하여 소스 및 설치된 버전을 볼 수 있습니다.

dotnetup list

롤 포워드 매핑 이해

10.0.103와 같은 SDK 버전의 경우 dotnetup은 다음과 같이 rollForward에 매핑됩니다.

rollForward 값	저장된 dotnetup 채널
생략 또는 latestPatch	10.0.1xx
latestFeature	10.0
latestMinor	10
latestMajor	latest
disable, patch, feature, minor 또는 major	정확한 버전 10.0.103

정확한 요구 사항이 고정되어 있으며 dotnetup update에 의해 변경되지 않습니다. allowPrerelease 속성은 dotnetup이 파생하는 채널에 영향을 주지 않습니다.

sdk.paths 사용

sdk.paths에 global.json이 포함된 경우, dotnetup은 --install-path 옵션이 없는 경우 첫 번째 경로를 사용합니다. global.json를 포함하는 디렉터리에서 상대 값을 해석합니다.

설치 경로 우선 순위는 다음과 같습니다.

1. --install-path
2. 첫 번째 sdk.paths 항목
3. 기본 dotnetup에서 관리하는 .NET 설치 루트

미리 보기 제한 사항

현재 공개-미리 보기 빌드는 첫 번째 sdk.paths 항목을 경로로 처리합니다. $host$를 sentinel로 해석하지 않으며 빈 항목을 건너뛰지 않습니다. 기본 dotnetup 관리 설치 루트를 사용하려면 sdk.paths를 생략하거나 --install-path를 명시적으로 설정합니다.

업데이트 global.json

rollForward 또는 sdk.version를 변경한 후 리포지토리 디렉터리에서 dotnetup sdk install를 실행하여 새 요구 사항을 적용합니다. 가비지 수집이 변경된 global.json 소스를 dotnetup sdk update 새로 고치기 전에 프로세스가 요구 사항을 저장하므로 첫 번째 패스는 이전 요구 사항을 계속 사용할 수 있습니다.

파생 채널에 최신 버전을 설치하고 해당 버전을 global.json에 다시 기록하려면 다음을 실행합니다.

dotnetup sdk install --update-global-json

나중에 추적된 모든 리포지토리 요구 사항 및 해당 파일을 다음 내용으로 업데이트합니다.

dotnetup sdk update --update-global-json

업데이트는 sdk.version만 변경합니다. 기존 서식, 기타 속성 및 감지된 텍스트 인코딩을 유지합니다.

일치하는 리포지토리 요구 사항 제거

제거 명령은 선택한 설치 루트에서 일치하는 globaljson 모든 사양을 제거합니다. 하나의 리포지토리를 대상으로 하지 않습니다. 기본 루트에서 일치하는 요구 사항을 제거하려면 다음을 실행합니다.

dotnetup sdk uninstall 10.0.1xx --source globaljson

사용자 지정 설치 루트를 선택하려면 --install-path를 추가합니다:

dotnetup sdk uninstall 10.0.1xx --source globaljson --install-path <INSTALL_PATH>

dotnetup는 남아 있는 어떤 요구 사항도 해당 파일을 필요로 하지 않을 때만 파일을 제거합니다.

또한, 다음을 참조하세요.

• 리포지토리 및 global.json 통합
• dotnetup sdk install
• 추적된 설치를 업데이트