Instalar .NET no macOS

Instalar no Windows
Instalar no macOS
Instalar no Linux

Este artigo ensina quais versões de .NET têm suporte no macOS, como instalar .NET e qual é a diferença entre o SDK e o runtime.

A versão mais recente do .NET é 10.

Download .NET

Versões suportadas

A tabela a seguir lista as versões de .NET com suporte e em qual macOS eles têm suporte. Essas versões permanecem com suporte até que a versão do .NET atinja o fim do suporte ou a versão do macOS não seja mais compatível.

Versão do macOS.	.NET
macOS 26 "Tahoe"	10.0, 9.0, 8.0
macOS 15 "Sequóia"	10.0, 9.0, 8.0
macOS 14 "Sonoma"	9.0, 8.0

As seguintes versões de .NET ❌ não têm mais suporte:

.NET 7
.NET 6
.NET 5
.NET Core 3.1
.NET Core 3.0
.NET Core 2.2
.NET Core 2.1
.NET Core 2.0

Runtime ou SDK

O runtime é usado para executar aplicativos criados com .NET. Quando um autor de aplicativo publica um aplicativo, ele pode incluir o runtime com seu aplicativo. Se eles não incluirem o runtime, cabe ao usuário instalar o runtime correto.

Há dois tempos de execução que você pode instalar no macOS, e ambos estão incluídos no SDK.

ASP.NET Core Runtime
Executa ASP.NET Core aplicativos. Inclui o .NET runtime. Não disponível como instalador.
.NET Runtime
Isso executa aplicativos .NET normais, mas não aplicativos especializados, como aplicativos criados em ASP.NET Core.

O SDK é usado para criar e publicar .NET aplicativos e bibliotecas. O SDK mais recente dá suporte à criação de aplicativos para versões anteriores do .NET. Em circunstâncias normais, você só precisaria do SDK mais recente instalado.

A instalação do SDK inclui o runtime de .NET padrão e o runtime do ASP.NET Core. Por exemplo, se você tiver .NET SDK 9.0 instalado, .NET Runtime 9.0 e ASP.NET Core 9.0 Runtime serão instalados. No entanto, qualquer outra versão de runtime não seria instalada com o SDK e exigiria que você a instalasse separadamente.

Escolha como instalar .NET

Há diferentes maneiras de instalar .NET e alguns produtos podem gerenciar sua própria versão do .NET. Se você instalar .NET por meio de software que gerencia sua própria versão do .NET, ele pode não estar habilitado em todo o sistema. Entenda as implicações da instalação de .NET por meio de outros softwares.

Se você não tiver certeza de qual método deve escolher depois de examinar as listas nas seções a seguir, provavelmente deseja usar o pacote .NET Installer.

Desenvolvedores

Visual Studio Code – Kit de Desenvolvimento em C#

Instale a extensão C# Dev Kit para o Visual Studio Code para desenvolver aplicativos .NET. A extensão pode usar um SDK já instalado ou instalar um para você.

Usuários e desenvolvedores

.NET Installer

Use o instalador autônomo para instalar .NET. Esse método é a maneira típica de instalar .NET em seu desenvolvedor ou computador de usuário.
Instalar .NET com um script

Um script bash que pode automatizar a instalação do SDK ou Runtime. Você pode escolher qual versão do .NET instalar.
Instalar .NET manualmente

Use esse método de instalação quando precisar instalar .NET em uma pasta específica e executá-lo além de outras cópias de .NET.

Instalar .NET

Os pacotes do instalador estão disponíveis para macOS, uma maneira fácil de instalar .NET.

Abra um navegador e navegue até .
Selecione o link para a versão .NET que você deseja instalar, como .NET 10.0.

Este link leva você para a página com links para baixar essa versão do .NET

Se você quiser instalar o SDK, escolha a versão mais recente do .NET. O SDK dá suporte à criação de aplicativos para versões anteriores do .NET.

Dica

Se você não tiver certeza de qual versão baixar, escolha a versão marcada como mais recente.
Esta página apresenta os links de download para o SDK e o Runtime. Aqui você baixa o SDK do .NET ou .NET Runtime.

Há duas seções destacadas na imagem anterior. Se você estiver baixando o SDK, consulte a seção 1. Para o .NET Runtime, consulte a seção 2.
- Seção 1 (SDK)
  
  Esta seção é a área de download do SDK. Na coluna Instaladores da linha macOS duas arquiteturas são listadas: Arm64 e x64.
  - Se você estiver executando um processador Apple, como um M1 ou um M3 Pro, selecione Arm64.
  - Se você estiver executando um processador Intel, selecione x64.
- Seção 2 (Tempo de Execução)
  
  Esta seção contém os downloads runtime. Observe que os links para a coluna Instaladores na linha macOS estão vazios! Esta seção está vazia porque o ASP.NET Core Runtime, é fornecido apenas no SDK ou por meio da instalação binary.
  
  Role mais para baixo para encontrar o .NET Runtime padrão para download.
  
  Uma captura de tela mostrando apenas a tabela de download do .NET Runtime do site oficial de download do .NET. A linha correspondente ao macOS está destacada com uma caixa vermelha.
  - Se você estiver executando um processador Apple, como um M1 ou um M3 Pro, selecione Arm64.
  - Se você estiver executando um processador Intel, selecione x64.
Quando o download for concluído, abra-o.
Siga os passos no instalador.

Instalar .NET manualmente

Como alternativa aos instaladores do macOS, você pode fazer download e instalar manualmente o SDK e o tempo de execução. A instalação manual geralmente é realizada como parte da automação em um cenário de integração contínua. Desenvolvedores e usuários geralmente desejam usar o instalador.

Dica

Use o script install-dotnet.sh para executar essas etapas automaticamente.

Abra um navegador e navegue até .
Selecione o link para a versão .NET que você deseja instalar, como .NET 8.0.

Este link leva você para a página com links para baixar essa versão do .NET

Se você quiser instalar o SDK, escolha a versão mais recente do .NET. O SDK dá suporte à criação de aplicativos para versões anteriores do .NET.

Dica

Se você não tiver certeza de qual versão baixar, escolha a versão marcada como mais recente.
Selecione o link para o SDK ou Runtime que deseja instalar. Procure a coluna Binários na linha correspondente ao macOS.
- Se você estiver executando um processador Apple, como um M1 ou um M3 Pro, selecione Arm64.
- Se você estiver executando um processador Intel, selecione x64.
Abra um terminal e navegue até onde o binário .NET foi baixado.
Extraia o tarball para o local onde você deseja instalar o .NET no seu sistema. O exemplo a seguir usa o diretório HOME .
```
mkdir -p ~/Applications/.dotnet
tar -xf "dotnet-sdk-9.0.100-rc.2.24474.11-osx-arm64.tar" -C ~/Applications/.dotnet/
```

Teste se .NET está funcionando alterando o diretório para onde .NET foi instalado e execute o comando dotnet --info:

chdir ~/Applications/.dotnet/
./dotnet --info

Instalar .NET com um script

Os scripts dotnet-install são usados para automação e instalações não elevadas do runtime. É possível baixar o script em .

O script usa como padrão a instalação da versão long term support (LTS) mais recente, que é .NET 8. Você pode escolher uma versão específica definindo a opção . Inclua a opção para instalar um runtime. Caso contrário, o script instala o SDK.

Dica

Esses comandos são fornecidos com um trecho de script no final deste procedimento.

Abra um terminal.
Navegue até uma pasta onde você deseja baixar o script, como ~/Downloads.
Se não tiver o comando, instale-o com Brew
```
brew install wget
```
Execute o seguinte comando para baixar o script:
```
wget https://dot.net/v1/dotnet-install.sh
```
Conceder permissões de execução ao script
```
chmod +x dotnet-install.sh
```
Execute o script para instalar .NET.

O script é padronizado para instalar o SDK mais recente no diretório .
```
./dotnet-install.sh
```

Aqui estão todos os comandos como um único script bash:

chdir ~/Downloads
brew install wget
wget https://dot.net/v1/dotnet-install.sh
chmod +x dotnet-install.sh
./dotnet-install.sh

Teste .NET navegando até a pasta ~/.dotnet e executando o comando dotnet --info:

chdir ~/.dotnet
./dotnet --info

Importante

Alguns programas podem usar variáveis de ambiente para encontrar .NET em seu sistema e usar o comando dotnet pode não funcionar ao abrir um novo terminal. Para obter ajuda para resolver esse problema, consulte a seção Make .NET disponível em todo o sistema.

Instalar .NET para Visual Studio Code

Visual Studio Code é um editor de código-fonte poderoso e leve que é executado em sua área de trabalho. Visual Studio Code pode usar o SDK já instalado em seu sistema. Além disso, a extensão C# Dev Kit instalará .NET se ainda não estiver instalada.

Para obter instruções sobre como instalar .NET por meio de Visual Studio Code, consulte Getting Started with C# in VS Code.

Reconhecimento de Firma

O software criado para macOS distribuído com uma ID de Desenvolvedor deve ser autenticado em cartório, incluindo aplicativos feitos com .NET.

Se você executar um aplicativo não anotado, será exibida uma janela de erro semelhante à imagem a seguir:

Alerta de autenticação do macOS Catalina

Para obter mais informações sobre como a notarização imposta afeta o .NET (e seus aplicativos .NET), consulte Trabalhando com a Notarização no macOS Catalina.

Validação

Depois de fazer o download de um instalador ou de uma versão binária, verifique se o arquivo não foi alterado ou corrompido. Você pode verificar o checksum no seu computador e depois compará-lo com o que foi relatado no site de download.

Quando você baixa o arquivo de uma página oficial de download, a soma de verificação do arquivo é exibida em uma caixa de texto. Selecione o botão Copiar a fim de copiar o valor de soma de verificação para a área de transferência.

A página de download .NET com soma de verificação

Use o comando para imprimir a soma de verificação do arquivo que você baixou. Por exemplo, o comando a seguir relata a soma de verificação do arquivo dotnet-sdk-9.0.306-osx-x64.tar.gz :

$ shasum -a 512 dotnet-sdk-9.0.306-osx-x64.tar.gz
a9700f98e5aa4f70b2a08ddba2b1c6085106b0d17828bd719fdcef460b06c890b32d752fbff8e4659cd1ca4174b4b211b301fe682439ea9a24b6521ca5a64c69  dotnet-sdk-9.0.306-osx-x64.tar.gz

Compare a soma de verificação com o valor fornecido pelo site de download.

Usar um arquivo de soma de verificação para validar

As notas de versão .NET contêm um link para um arquivo de soma de verificação que você pode usar para validar o arquivo baixado. As etapas a seguir descrevem como baixar o arquivo de soma de verificação e validar um binário de instalação .NET:

A página de notas de versão do .NET 9 no GitHub em https://github.com/dotnet/core/tree/main/release-notes/9.0#releases contém uma seção chamada Releases. A tabela nessa seção contém links para os downloads e arquivos de checksum para cada versão do .NET 9. A imagem a seguir mostra a tabela de lançamento do .NET 8 como referência:
Selecione o link para a versão do .NET que você baixou.

A seção anterior usou .NET SDK 9.0.306, que está na versão .NET 9.0.10.
Na página de versão, você pode ver a versão do .NET Runtime e do .NET SDK, e um link para o arquivo de soma de verificação. A imagem a seguir mostra a tabela de lançamento do .NET 8 como referência:
Clique com o botão direito do mouse no link Checksum e copie-o para a área de transferência.
Abra um terminal.
Use para baixar o arquivo de soma de verificação.

Substitua o link no comando a seguir pelo link que você copiou.
```
curl -O https://builds.dotnet.microsoft.com/dotnet/checksums/9.0.10-sha.txt
```
Com o arquivo de soma de verificação e o arquivo de versão .NET baixado no mesmo diretório, use o comando shasum -a 512 -c {file} para validar o arquivo baixado.

Quando a validação for aprovada, você verá o arquivo impresso com o status OK:
```
$ shasum -a 512 -c 9.0.10-sha.txt
dotnet-sdk-9.0.306-osx-x64.tar.gz: OK
```
Se você vir o arquivo marcado como COM FALHA, o arquivo baixado não será válido e não deverá ser usado.
```
$ shasum -a 512 -c 9.0.10-sha.txt
dotnet-sdk-9.0.306-osx-x64.tar.gz: FAILED
shasum: WARNING: 1 computed checksum did NOT match
```

Macs baseados em ARM

As seções a seguir descrevem as coisas que você deve considerar ao instalar .NET em um Mac baseado em Arm.

Diferenças de caminho

Em um Mac baseado em Arm, todas as versões do Arm64 de .NET são instaladas na pasta /usr/local/share/do tnet/ normal. No entanto, quando você instala a versão x64 do SDK .NET, ela é instalada na pasta /usr/local/share/do tnet/x64/do tnet/.

Variáveis de caminho

Variáveis de ambiente que adicionam .NET ao caminho do sistema, como a variável PATH, talvez precisem ser alteradas se você tiver as versões x64 e Arm64 do SDK .NET instaladas. Além disso, algumas ferramentas dependem da variável de ambiente DOTNET_ROOT, que também precisaria ser atualizada para apontar para a pasta de instalação do SDK .NET apropriada.

Solução de problemas

As seções a seguir estão disponíveis para ajudar a solucionar problemas:

Macs baseados em Arm
Make .NET disponível em todo o sistema

Disponibilizar .NET em todo o sistema

Às vezes, os aplicativos em seu sistema, incluindo o terminal, precisam encontrar onde .NET está instalado. O pacote .NET macOS Installer deve configurar automaticamente o sistema. No entanto, se você usou o método de instalação manual ou o script de instalação .NET, você deverá adicionar o diretório em que .NET foi instalado à variável PATH.

Alguns aplicativos podem procurar a variável DOTNET_ROOT ao tentar determinar onde .NET está instalado.

Há muitos shells diferentes disponíveis para macOS e cada um tem um perfil diferente. Por exemplo:

Shell Bash: ~/.profile, /etc/profile
Korn Shell: ~/.kshrc ou .profile
Z Shell: ~/.zshrc ou .zprofile

Defina as duas variáveis de ambiente a seguir no perfil de shell:

DOTNET_ROOT

Essa variável é definida como a pasta na qual o .NET foi instalado, como $HOME/.dotnet:
```
export DOTNET_ROOT=$HOME/.dotnet
```
PATH

Essa variável deve incluir tanto a pasta quanto a pasta :
```
export PATH=$PATH:$DOTNET_ROOT:$DOTNET_ROOT/tools
```

Como verificar se .NET já está instalado.
Trabalhando com a autenticação do macOS Catalina.
Tutorial: criar um aplicativo de console .NET.
Tutorial: conteinerize um aplicativo .NET.

Comentários

Esta página foi útil?

Last updated on 2026-03-06