영어로 읽기

다음을 통해 공유


.NET RID 카탈로그

RID는 Runtime Identifier(런타임 식별자)의 약어입니다. RID 값은 애플리케이션을 실행하는 대상 플랫폼을 식별하는 데 사용됩니다. NuGet 패키지에서 .NET 패키지의 플랫폼 관련 자산을 나타내는 데 사용됩니다. RID 값의 예로 linux-x64, win-x64, osx-x64 등을 들 수 있습니다. 기본 종속성이 있는 패키지의 경우 RID는 패키지를 복원할 수 있는 플랫폼을 지정합니다.

단일 RID는 프로젝트 파일의 <RuntimeIdentifier> 요소에 설정할 수 있습니다. 여러 RID는 프로젝트 파일의 <RuntimeIdentifiers> 요소에서 세미콜론으로 구분된 목록으로 정의할 수 있습니다. --runtime 옵션을 통해 다음과 같은 .NET CLI 명령에서도 사용됩니다.

구체적인 운영 체제를 나타내는 RID는 일반적으로 [os].[version]-[architecture]-[additional qualifiers]의 패턴을 따릅니다. 각각은 다음과 같습니다.

  • [os] - 운영 체제/플랫폼 모니커입니다. 예: ubuntu.

  • [version] - 점으로 구분된(.) 버전 번호 형식의 운영 체제 버전입니다. 예: 15.10.

    버전은 마케팅 버전이어서는 안 됩니다. 마케팅 버전은 종종 다양한 플랫폼 API 노출 영역이 있는 운영 체제의 여러 개별 버전을 나타내기 때문입니다.

  • [architecture] - 프로세서 아키텍처입니다. 예를 들면 x86, x64, arm, arm64 등입니다.

  • [additional qualifiers] - 다른 플랫폼을 추가로 구분합니다. 예: aot

RID 그래프

RID 그래프 또는 런타임 Fallback 그래프는 서로 호환되는 RID 목록입니다.

이러한 RID는 dotnet/runtime 리포지토리의 PortableRuntimeIdentifierGraph.json에 정의됩니다. 이 파일에서 기본 RID를 제외하고 모든 RID에 "#import" 문이 포함되어 있음을 알 수 있습니다. 이러한 문은 호환되는 RID를 나타냅니다.

.NET 8 이전에는 버전별 및 배포판별 RID가 dotnet/runtime 리포지토리에 있는 runtime.json 파일에 정기적으로 추가되었습니다. 이 그래프는 더 이상 업데이트되지 않으며 이전 버전과의 호환성 옵션으로 존재합니다. 개발자는 버전과 배포판에 국한되지 않은 RID를 사용해야 합니다.

NuGet에서 패키지를 복원할 때 지정된 런타임에 대한 정확한 일치를 찾으려고 합니다. 정확한 일치를 찾을 수 없는 경우 NuGet은 RID 그래프에 따라 가장 가까운 호환 시스템을 찾을 때까지 그래프를 다시 검색합니다.

다음 예제는 osx-x64 RID의 실제 항목입니다.

"osx-x64": {
    "#import": [ "osx", "unix-x64" ]
}

위의 RID는 osx-x64unix-x64를 가져오도록 지정합니다. 따라서 NuGet에서 패키지를 복원할 때 패키지에서 osx-x64와 정확히 일치하는 값을 찾으려고 합니다. NuGet이 특정 런타임을 찾을 수 없는 경우 예를 들어 unix-x64 런타임을 지정하는 패키지를 복원할 수 있습니다.

다음 예제에서는 마찬가지로 runtime.json 파일에 정의된 약간 더 큰 RID 그래프를 보여 줍니다.

    linux-arm64     linux-arm32
         |     \   /     |
         |     linux     |
         |       |       |
    unix-arm64   |    unix-x64
             \   |   /
               unix
                 |
                any

또는 RidGraph 도구를 사용하여 RID 그래프(또는 그래프의 하위 집합)를 쉽게 시각화할 수 있습니다.

모든 RID는 결국 루트 any RID에 다시 매핑됩니다.

RID를 사용할 때는 RID에 대한 다음과 같은 몇 가지 고려 사항을 알고 있어야 합니다.

  • 구성 요소 파트를 검색하기 위해 RID를 구문 분석하지 않습니다.

  • 플랫폼에 대해 이미 정의된 RID를 사용합니다.

  • RID는 구체적이어야 하므로 실제 RID 값에서 어느 것도 가정하지 마세요.

  • 반드시 필요한 경우가 아니면 프로그래밍 방식으로 RID를 빌드하지 마세요.

    일부 앱은 프로그래밍 방식으로 RID를 컴퓨팅해야 합니다. 그렇다면 컴퓨팅된 RID는 대/소문자를 포함하여 카탈로그와 정확히 일치해야 합니다. 대/소문자가 다른 RID는 OS가 대/소문자를 구분할 때(예: Linux) 문제가 발생합니다. 출력 경로와 같은 항목을 생성할 때 값이 자주 사용되기 때문입니다. 예를 들어 솔루션 구성 관리자 및 프로젝트 속성의 정보를 사용하는 Visual Studio의 사용자 지정 게시 마법사를 떠올려 보세요. 솔루션 구성이 잘못된 값(예: arm64 대신 ARM64)을 전달하는 경우와 같이 win-ARM64 같은 잘못된 RID가 발생할 수 있습니다.

RID 사용

RID를 사용할 수 있으려면 어떤 RID가 있는지 알아야 합니다. 완전한 최신 버전을 보려면 dotnet/runtime 리포지토리에서 PortableRuntimeIdentifierGraph.json을 확인하세요.

'이식 가능'으로 간주되는 RID( 즉, 특정 버전 또는 OS 배포에 연결되지 않음)를 선택하는 것이 좋습니다. 즉, 플랫폼별 애플리케이션을 빌드하고 RID 관련 자산을 사용하여 NuGet 패키지를 만드는 데 이식 가능한 RID를 사용해야 합니다.

.NET 8부터 .NET SDK 및 런타임의 기본 동작은 버전 및 배포판에 국한되지 않은 RID만 고려하는 것입니다. 복원하고 빌드할 때 SDK는 더 작은 이식 가능한 RID 그래프를 사용합니다. RuntimeInformation.RuntimeIdentifier 런타임이 빌드된 플랫폼을 반환합니다. 런타임에 .NET은 알려진 이식 가능한 RID 집합을 사용하여 RID 관련 자산을 찾습니다. 런타임에 무시될 수 있는 RID 관련 자산을 사용하여 애플리케이션을 빌드할 때 SDK는 경고(NETSDK1206)를 내보냅니다.

특정 OS 버전 또는 배포판에 대한 자산 로드

.NET은 더 이상 OS 버전 또는 배포판과 관련된 종속성을 확인하기 위한 고급 지원을 제공하지 않습니다. 애플리케이션 또는 패키지가 OS 버전 또는 배포판에 따라 다른 자산을 로드해야 하는 경우 자산을 조건부로 로드하는 논리를 구현해야 합니다.

플랫폼에 대한 정보를 얻으려면 System.OperatingSystem API를 사용합니다. Windows 및 macOS에서 Environment.OSVersion운영 체제 버전을 반환합니다. Linux에서는 이것이 커널 버전일 수 있습니다. Linux 배포판 이름 및 버전 정보를 가져오려면 /etc/os-release 파일을 읽는 것이 좋습니다.

.NET은 로딩 논리를 사용자 지정하기 위한 다양한 확장 지점(예: NativeLibrary.SetDllImportResolver(Assembly, DllImportResolver), AssemblyLoadContext.ResolvingUnmanagedDll, AssemblyLoadContext.Resolving, AppDomain.AssemblyResolve)을 제공합니다. 현재 플랫폼에 해당하는 자산을 로드하는 데 사용할 수 있습니다.

알려진 RID

다음 목록에서는 각 OS에 사용되는 일반적인 RID의 몇 가지 예를 보여줍니다. 완전한 최신 버전을 보려면 dotnet/runtime 리포지토리에서 PortableRuntimeIdentifierGraph.json을 확인하세요.

Windows RID

  • win-x64
  • win-x86
  • win-arm64

자세한 내용은 Windows에 .NET 설치를 참조하세요.

Linux RID

  • linux-x64(CentOS Stream, Debian, Fedora, Ubuntu 및 파생 버전을 비롯한 대부분의 데스크톱 배포)
  • linux-musl-x64 (Alpine Linux와 같이 musl을 사용하는 간단한 배포)
  • linux-musl-arm64(64비트 ARM v8 및 최소 기본 이미지용 Docker 이미지를 빌드하는 데 사용됨)
  • linux-arm(Raspberry Pi 모델 2+의 Raspbian과 같이 ARM에서 실행되는 Linux 배포판)
  • linux-arm64(Raspberry Pi 모델 3+의 Ubuntu Server 64비트와 같이 64비트 ARM에서 실행되는 Linux 배포판)
  • linux-bionic-arm64(Android의 bionic libc를 사용하는 배포판(예: Termux)
  • linux-loongarch64 (LoongArch64에서 실행되는 Linux 배포판)

자세한 내용은 .NET 종속성 및 요구 사항을 참조하세요.

macOS RID

macOS RID는 이전 "OSX" 브랜딩을 사용합니다.

  • osx-x64 (최소 OS 버전: macOS 10.12 Sierra)
  • osx-arm64

자세한 내용은 .NET 종속성 및 요구 사항을 참조하세요.

iOS RID

  • ios-arm64
  • iossimulator-arm64
  • iossimulator-x64

Android RID

  • android-arm64
  • android-arm
  • android-x64
  • android-x86

참고 항목