Catálogo de identificadores de entorno de ejecución (RID) de .NET

  • Artículo
  • Tiempo de lectura: 2 minutos

RID es la abreviatura de identificador de entorno de ejecución. Los valores de RID se usan para identificar las plataformas de destino donde se ejecuta la aplicación. Los paquetes de .NET los usan para presentar los recursos específicos de la plataforma en los paquetes de NuGet. Los valores siguientes son ejemplos de RID: linux-x64, ubuntu.14.04-x64, win7-x64 o osx.10.12-x64. En el caso de los paquetes con dependencias nativas, el RID designa las plataformas en las que se puede restauran el paquete.

Un único RID se puede establecer en el elemento <RuntimeIdentifier> del archivo del proyecto. Se pueden definir varios RID como una lista delimitada por punto y coma en el elemento <RuntimeIdentifiers> del archivo del proyecto. También se usan mediante la opción --runtime con los comandos de la CLI de .NET siguientes:

Los RID que representan sistemas operativos concretos normalmente siguen este patrón: [os].[version]-[architecture]-[additional qualifiers], donde:

  • [os] es el moniker del sistema operativo o de plataforma. Por ejemplo: ubuntu.

  • [version] es la versión del sistema operativo en formato de número de versión separado por punto (.). Por ejemplo: 15.10.

    • La versión no se debe tratar como versiones de marketing, debido a que, a menudo, representan varias versiones discretas del sistema operativo con un área expuesta de API de plataforma diferente.

  • [architecture] es la arquitectura de procesador. Por ejemplo: x86, x64, arm o arm64.

  • [additional qualifiers] diferencia aún más las distintas plataformas. Por ejemplo: aot.

Grafo de RID

El grado de RID o el grafo de reserva de entorno de ejecución es una lista de RID compatibles entre sí. Los RID se definen en el paquete Microsoft.NETCore.Platforms. Puede ver la lista de RID admitidos y el grafo de RID en el archivo runtime.json, que se encuentra en el repositorio dotnet/runtime. En este archivo puede ver que todos los RID, excepto el RID de base, contienen una instrucción "#import". Estas instrucciones indican los RID compatibles.

Cuando NuGet restaura los paquetes, intenta encontrar una coincidencia exacta para el entorno de ejecución especificado. Si no se encuentra una coincidencia exacta, NuGet vuelve al grafo hasta encontrar el sistema compatible más cercano según el grafo de RID.

El ejemplo siguiente es la entrada real del RID osx.10.12-x64:

"osx.10.12-x64": {
    "#import": [ "osx.10.12", "osx.10.11-x64" ]
}

El RID anterior especifica que osx.10.12-x64 importa osx.10.11-x64. Por tanto, cuando NuGet restaura los paquetes, intenta encontrar una coincidencia exacta para osx.10.12-x64 en el paquete. Si NuGet no puede encontrar el entorno de ejecución específico, puede restaurar, por ejemplo, los paquetes que especifican entornos de ejecución osx.10.11-x64.

En el ejemplo siguiente se muestra un grafo de RID ligeramente más grande que también se define en el archivo runtime.json:

    win7-x64    win7-x86
       |   \   /    |
       |   win7     |
       |     |      |
    win-x64  |  win-x86
          \  |  /
            win
             |
            any

A la larga, todos los RID se asignarán de vuelta al RID any raíz.

Hay algunas consideraciones sobre los RID que debe tener en cuenta cuando trabaja con ellos:

  • No intente analizar los RID para recuperar partes de componentes.
  • No compile RID mediante programación.
  • Use RID que ya estén definidos para la plataforma.
  • Los RID deben ser específicos, por lo que no se recomienda presuponer nada a partir del valor de RID real.

Uso de los RID

Para poder usar los RID, debe saber cuáles son los RID que existen. Se agregan valores nuevos a la plataforma de manera habitual. Para obtener la versión más reciente y completa, vea el archivo runtime.json en el repositorio dotnet/runtime.

Los RID que no están asociados a una versión específica o distribución del sistema operativo son la opción preferida, en especial cuando se trabaja con varias distribuciones de Linux, ya que la mayoría de los RID de distribución se asignan a RID que no son específicos de la distribución.

En la lista siguiente se muestra un pequeño subconjunto de los RID más comunes que se usan con cada sistema operativo.

RID de Windows

Solo se muestran los valores comunes. Para obtener la versión más reciente y completa, vea el archivo runtime.json en el repositorio dotnet/runtime.

  • Windows, no específico de la versión
    • win-x64
    • win-x86
    • win-arm
    • win-arm64
  • Windows 7/Windows Server 2008 R2
    • win7-x64
    • win7-x86
  • Windows 8.1/Windows Server 2012 R2
    • win81-x64
    • win81-x86
    • win81-arm
  • Windows 10/Windows Server 2016
    • win10-x64
    • win10-x86
    • win10-arm
    • win10-arm64

Para obtener más información, vea Dependencias y requisitos de .NET.

RID de Linux

Solo se muestran los valores comunes. Para obtener la versión más reciente y completa, vea el archivo runtime.json en el repositorio dotnet/runtime. Los dispositivos que ejecutan una distribución que no se muestran en la lista podrían funcionar con uno de los RID que no son específicos de la distribución. Por ejemplo, el destino de los dispositivos Raspberry Pi que ejecutan una distribución de Linux se puede establecer con linux-arm.

  • Linux, no específico de la distribución
    • linux-x64 (La mayoría de las distribuciones de escritorio como CentOS, Debian, Fedora, Ubuntu y derivados)
    • linux-musl-x64 (Distribuciones ligeras con musl como Alpine Linux)
    • linux-arm (Distribuciones de Linux que se ejecutan en ARM, como Raspbian en Raspberry Pi, modelo 2+)
    • linux-arm64 (Distribuciones de Linux que se ejecutan en ARM de 64 bits, como Ubuntu Server de 64 bits en Raspberry Pi, modelo 3+)
  • Red Hat Enterprise Linux
    • rhel-x64 (Se reemplaza por linux-x64 para RHEL por encima de la versión 6)
    • rhel.6-x64
  • Tizen
    • tizen
    • tizen.4.0.0
    • tizen.5.0.0

Para obtener más información, vea Dependencias y requisitos de .NET.

RID de macOS

Los RID de macOS usan la personalización de marca antigua "OSX". Solo se muestran los valores comunes. Para obtener la versión más reciente y completa, vea el archivo runtime.json en el repositorio dotnet/runtime.

  • macOS, no específico de la versión
    • osx-x64 (La versión mínima del sistema operativo es macOS 10.12 Sierra)
  • macOS 10.10 Yosemite
    • osx.10.10-x64
  • macOS 10.11 El Capitan
    • osx.10.11-x64
  • macOS 10.12 Sierra
    • osx.10.12-x64
  • macOS 10.13 High Sierra
    • osx.10.13-x64
  • macOS 10.14 Mojave
    • osx.10.14-x64
  • macOS 10.15 Catalina
    • osx.10.15-x64
  • macOS 11.0 Big Sur
    • osx.11.0-x64
    • osx.11.0-arm64

Para obtener más información, vea Dependencias y requisitos de .NET.

Vea también