Catálogo de RIDs do .NET Core.NET Core RID Catalog

  • 4 minutos para ler

RID é a abreviação de Identificador de Tempo de Execução.RID is short for Runtime IDentifier. Os valores do RID são usados para identificar plataformas de destino onde o aplicativo é executado.RID values are used to identify target platforms where the application runs. Eles são usados por pacotes .NET para representar ativos específicos de plataforma em pacotes NuGet.They're used by .NET packages to represent platform-specific assets in NuGet packages. Os seguintes valores são exemplos de RIDs: linux-x64, ubuntu.14.04-x64, win7-x64 ou osx.10.12-x64.The following values are examples of RIDs: linux-x64, ubuntu.14.04-x64, win7-x64, or osx.10.12-x64. Para os pacotes com dependências nativas, o RID designará as plataformas em que o pacote pode ser restaurado.For the packages with native dependencies, the RID designates on which platforms the package can be restored.

Um único RID pode ser definido no elemento <RuntimeIdentifier> do arquivo de projeto.A single RID can be set in the <RuntimeIdentifier> element of your project file. Vários RIDs podem ser definidos como uma lista separada por ponto-e-vírgula no elemento <RuntimeIdentifiers> do arquivo de projeto.Multiple RIDs can be defined as a semicolon-delimited list in the project file's <RuntimeIdentifiers> element. Eles também são usados por meio da opção --runtime com os seguintes comandos da CLI do .NET Core:They're also used via the --runtime option with the following .NET Core CLI commands:

RIDs que representem sistemas operacionais concretos geralmente seguem este padrão: [os].[version]-[architecture]-[additional qualifiers] em que:RIDs that represent concrete operating systems usually follow this pattern: [os].[version]-[architecture]-[additional qualifiers] where:

  • [os] é o moniker do sistema operacional/plataforma.[os] is the operating/platform system moniker. Por exemplo, ubuntu.For example, ubuntu.

  • [version] é a versão do sistema operacional na forma de um separado de versão separado por ponto (.).[version] is the operating system version in the form of a dot-separated (.) version number. Por exemplo, 15.10.For example, 15.10.

    • A versão não deve ser uma versão de marketing, pois essas geralmente representam várias versões distintas do sistema operacional com diferentes áreas de superfície de API da plataforma.The version shouldn't be marketing versions, as they often represent multiple discrete versions of the operating system with varying platform API surface area.

  • [architecture] é a arquitetura do processador.[architecture] is the processor architecture. Por exemplo: x86, x64, arm ou arm64.For example: x86, x64, arm, or arm64.

  • [additional qualifiers] distingue diferentes plataformas.[additional qualifiers] further differentiate different platforms. Por exemplo: aot.For example: aot.

Gráfico RIDRID graph

O gráfico RID ou gráfico de fallback de runtime é uma lista de RIDs que são compatíveis entre si.The RID graph or runtime fallback graph is a list of RIDs that are compatible with each other. Os RIDs são definidos no pacote Microsoft.NETCore.Platforms.The RIDs are defined in the Microsoft.NETCore.Platforms package. Você pode ver a lista de RIDs suportados e o gráfico RID no arquivo runtime.json, que está localizado no repositório CoreFX.You can see the list of supported RIDs and the RID graph in the runtime.json file, which is located at the CoreFX repo. Nesse arquivo, você pode ver todos os RIDs, exceto para a base um, que contém uma instrução "#import".In this file, you can see that all RIDs, except for the base one, contain an "#import" statement. Essas instruções indicam RIDs compatíveis.These statements indicate compatible RIDs.

Quando o NuGet restaura pacotes, ele tenta encontrar uma correspondência exata para o runtime especificado.When NuGet restores packages, it tries to find an exact match for the specified runtime. Se uma correspondência exata não for encontrada, o NuGet voltará ao gráfico até encontrar o sistema compatível mais próximo de acordo com o gráfico RID.If an exact match is not found, NuGet walks back the graph until it finds the closest compatible system according to the RID graph.

O exemplo a seguir é a entrada real para o RID osx.10.12-x64:The following example is the actual entry for the osx.10.12-x64 RID:

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

O RID acima especifica que osx.10.12-x64 importa osx.10.11-x64.The above RID specifies that osx.10.12-x64 imports osx.10.11-x64. Desse modo, quando o NuGet restaura pacotes, ele tenta encontrar uma correspondência exata para osx.10.12-x64 no pacote.So, when NuGet restores packages, it tries to find an exact match for osx.10.12-x64 in the package. Se o NuGet não puder encontrar o tempo de execução específico, ele poderá restaurar pacotes que especificam tempos de execução osx.10.11-x64, por exemplo.If NuGet cannot find the specific runtime, it can restore packages that specify osx.10.11-x64 runtimes, for example.

O seguinte exemplo mostra um gráfico RID ligeiramente maior, também definido no arquivo runtime.json:The following example shows a slightly bigger RID graph also defined in the runtime.json file:

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

Todos os RIDs eventualmente mapeiam para a raiz de any RID.All RIDs eventually map back to the root any RID.

Há algumas considerações sobre RIDs das quais você precisa se lembrar ao trabalhar com eles:There are some considerations about RIDs that you have to keep in mind when working with them:

  • Os RIDs são cadeias de caracteres opacas e devem ser tratados como caixas pretas.RIDs are opaque strings and should be treated as black boxes.
  • Não crie RIDs de modo programático.Don't build RIDs programmatically.
  • Use RIDs que já estão definidos para a plataforma.Use RIDs that are already defined for the platform.
  • Os RIDs precisam ser específicos, portanto, não presuma nada usando o valor RID real.The RIDs need to be specific, so don't assume anything from the actual RID value.

Usando RIDsUsing RIDs

Para poder usar RIDs, você precisa saber quais RIDs existem.To be able to use RIDs, you have to know which RIDs exist. Novos RIDs são adicionados regularmente à plataforma.New values are added regularly to the platform. Para obter a versão completa e mais recente, confira o arquivo runtime.json no repositório CoreFX.For the latest and complete version, see the runtime.json file on CoreFX repo.

O SDK do .NET Core 2.0 apresenta o conceito de RIDs portáteis..NET Core 2.0 SDK introduces the concept of portable RIDs. Eles são novos valores adicionados ao gráfico RID que não estão associados a uma versão específica ou distribuição de SO e são a opção preferida ao usar o .NET Core 2.0 e posterior.They are new values added to the RID graph that aren't tied to a specific version or OS distribution and are the preferred choice when using .NET Core 2.0 and higher. Eles são particularmente úteis ao lidar com várias distribuições Linux, já que a maioria dos RIDs de distribuição são mapeados para os RIDs portáteis.They're particularly useful when dealing with multiple Linux distros since most distribution RIDs are mapped to the portable RIDs.

A lista a seguir mostra um pequeno subconjunto dos RIDs mais comuns usados para cada SO.The following list shows a small subset of the most common RIDs used for each OS.

RIDs do WindowsWindows RIDs

Apenas os valores comuns são listados.Only common values are listed. Para obter a versão completa e mais recente, confira o arquivo runtime.json no repositório CoreFX.For the latest and complete version, see the runtime.json file on CoreFX repo.

  • Portátil (.NET Core 2.0 ou versões posteriores)Portable (.NET Core 2.0 or later versions)
    • win-x64
    • win-x86
    • win-arm
    • win-arm64
  • Windows 7 / Windows Server 2008 R2Windows 7 / Windows Server 2008 R2
    • win7-x64
    • win7-x86
  • Windows 8.1 / Windows Server 2012 R2Windows 8.1 / Windows Server 2012 R2
    • win81-x64
    • win81-x86
    • win81-arm
  • Windows 10 / Windows Server 2016Windows 10 / Windows Server 2016
    • win10-x64
    • win10-x86
    • win10-arm
    • win10-arm64

Consulte Pré-requisitos para o .NET Core no Windows para obter mais informações.See Prerequisites for .NET Core on Windows for more information.

RIDs do LinuxLinux RIDs

Apenas os valores comuns são listados.Only common values are listed. Para obter a versão completa e mais recente, confira o arquivo runtime.json no repositório CoreFX.For the latest and complete version, see the runtime.json file on CoreFX repo. Os dispositivos que executam uma distribuição não listada abaixo podem funcionar com um dos RIDs Portáteis.Devices running a distribution not listed below may work with one of the Portable RIDs. Por exemplo, os dispositivos Raspberry Pi executando uma distribuição Linux não listada podem ser direcionados com linux-arm.For example, Raspberry Pi devices running a Linux distribution not listed can be targeted with linux-arm.

  • Portátil (.NET Core 2.0 ou versões posteriores)Portable (.NET Core 2.0 or later versions)
    • linux-x64 (A maioria das distribuições de área de trabalho como CentOS, Debian, Fedora, Ubuntu e derivados)linux-x64 (Most desktop distributions like CentOS, Debian, Fedora, Ubuntu and derivatives)
    • linux-musl-x64 (Distribuições leves usando musl, como o Alpine Linux)linux-musl-x64 (Lightweight distributions using musl like Alpine Linux)
    • linux-arm (Distribuições Linux em execução em ARM, como Raspberry Pi)linux-arm (Linux distributions running on ARM like Raspberry Pi)
  • Red Hat Enterprise LinuxRed Hat Enterprise Linux
    • rhel-x64 (Substituído por linux-x64 para RHEL acima da versão 6)rhel-x64 (Superseded by linux-x64 for RHEL above version 6)
    • rhel.6-x64 (.NET Core 2.0 ou versões posteriores)rhel.6-x64 (.NET Core 2.0 or later versions)
  • Tizen (.NET Core 2.0 ou versões posteriores)Tizen (.NET Core 2.0 or later versions)
    • tizen
    • tizen.4.0.0
    • tizen.5.0.0

Consulte Pré-requisitos para o .NET Core no Linux para obter mais informações.See Prerequisites for .NET Core on Linux for more information.

RIDs do macOSmacOS RIDs

Os RIDs do macOS usam a identidade visual “OSX” mais antiga.macOS RIDs use the older "OSX" branding. Apenas os valores comuns são listados.Only common values are listed. Para obter a versão completa e mais recente, confira o arquivo runtime.json no repositório CoreFX.For the latest and complete version, see the runtime.json file on CoreFX repo.

  • Portátil (.NET Core 2.0 ou versões posteriores)Portable (.NET Core 2.0 or later versions)
    • osx-x64 (A versão mínima do sistema operacional é macOS 10.12 Sierra)osx-x64 (Minimum OS version is macOS 10.12 Sierra)
  • macOS 10.10 YosemitemacOS 10.10 Yosemite
    • osx.10.10-x64
  • macOS 10.11 El CapitanmacOS 10.11 El Capitan
    • osx.10.11-x64
  • macOS 10.12 Sierra (.NET Core 1.1 ou versões posteriores)macOS 10.12 Sierra (.NET Core 1.1 or later versions)
    • osx.10.12-x64
  • macOS 10.13 High Sierra (.NET Core 1.1 ou versões posteriores)macOS 10.13 High Sierra (.NET Core 1.1 or later versions)
    • osx.10.13-x64
  • macOS 10.14 Mojave (.NET Core 1.1 ou versões posteriores)macOS 10.14 Mojave (.NET Core 1.1 or later versions)
    • osx.10.14-x64

Consulte Pré-requisitos para o .NET Core no macOS para obter mais informações.See Prerequisites for .NET Core on macOS for more information.

Consulte tambémSee also