dotnetup을 사용하는 리포지토리 SDK 요구 사항

Note

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

dotnetup는 SDK 요구 사항을 리포지토리 또는 디렉터리 트리와 연결하기 위해 global.json를 사용합니다. 현재 디렉터리에서 시작해 상위 부모 디렉터리를 따라 검색하고 가장 가까운 기존 global.json를 읽습니다.

global.json에서 설치

채널 없이 SDK 설치 명령을 실행합니다.

dotnetup install

가장 가까운 global.json에 sdk.version가 있으면 dotnetup는 버전 및 rollForward 값에서 설치 사양을 파생합니다. 파일의 전체 경로를 사양 원본으로 기록합니다. global.json이 현재 디렉터리 또는 해당 부모 디렉터리에 없으면 명령은 latest 채널을 사용합니다. 가장 가까운 파일의 형식이 잘못되었거나 주석이 포함된 경우 구문 분석이 실패합니다. dotnetup은 부모 디렉터리를 검색하거나 latest 채널을 사용하기 위해 해당 파일을 건너뛰지 않습니다.

rollForward 매핑

dotnetup 는 SDK 선택 정책을 업데이트 가능한 채널에 매핑 global.json 합니다.

rollForward 값	SDK용으로 저장된 dotnetup 요구 사항 10.0.103
생략 또는 latestPatch	10.0.1xx
latestFeature	10.0
latestMinor	10
latestMajor	latest
disable, patch, feature, minor 또는 major	10.0.103

정확한 버전 매핑은 고정되며 업데이트로 변경되지 않습니다. 이 allowPrerelease 속성은 dotnetup이 파생하는 채널에 영향을 주지 않습니다.

global.json 설치 경로

dotnetup에 항목이 포함되어 있으면 sdk.paths는 첫 번째 경로를 사용합니다. global.json를 포함하는 디렉터리를 기준으로 상대 경로가 확인됩니다.

현재 공개 미리 보기 빌드에서는 dotnetup 첫 번째 항목을 경로로 처리합니다. sentinel로 해석 $host$ 되거나 빈 항목을 건너뛰지 않습니다.

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

1. --install-path;
2. 가장 가까운 sdk.paths의 첫 번째 global.json 항목입니다.
3. 기본 dotnetup에서 관리하는 .NET 설치 루트 경로입니다.

리포지토리 파일을 최신 상태로 유지

sdk.version를 전달하여 --update-global-json를 설치되었거나 업데이트된 실제 SDK 버전으로 바꿉니다:

dotnetup install --update-global-json
dotnetup sdk update --update-global-json

global.json원본 SDK 사양만 업데이트 워크플로에 의해 업데이트됩니다. 수정자는 다른 JSON 속성, 서식 및 감지된 텍스트 인코딩을 유지합니다.

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

가비지 수집 중에 추적된 global.json 사양이 새로 고쳐집니다. 파일이 더 이상 없거나 SDK 버전이 더 이상 포함되어 있지 않으면 사양이 제거됩니다.

채널별 사양을 제거하려면 globaljson 원본을 선택합니다. 이 명령은 선택한 설치 루트에서 일치하는 모든 사양을 제거하며, 하나의 리포지토리만 제거하는 것은 아닙니다.

dotnetup sdk uninstall 10.0.1xx --source globaljson

dotnetup list를 사용하여 저장된 채널, 원본 경로 및 설치 루트를 찾습니다. 사용자 지정 루트를 선택하려면 --install-path을 추가합니다.

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

• 리포지토리 SDK 요구 사항 관리
• global.json 개요
• dotnetup sdk install