Instalar o .NET no macOS
Neste artigo, você aprenderá a instalar o .NET no macOS. O .NET é composto pelo tempo de execução e pelo SDK. O tempo de execução é usado para executar um aplicativo .NET e pode ou não ser incluído com o aplicativo. O SDK é usado para criar aplicativos e bibliotecas .NET. O runtime .NET é sempre instalado com o SDK.
A última versão do .NET é 8.
Versões suportadas
Há dois tipos de versões suportadas: versões LTS (Long Term Support) e STS (Standard Term Support). A qualidade de todos os lançamentos é a mesma. A única diferença é a duração do apoio. As versões LTS recebem suporte e patches gratuitos por três anos. As versões STS recebem suporte e patches gratuitos por 18 meses. Para obter mais informações, consulte Política de suporte do .NET.
A tabela a seguir é uma lista das versões do .NET atualmente suportadas e das versões do macOS nas quais elas são suportadas:
| Sistema operativo | .NET 8 (LTS) | .NET 6 (LTS) |
|---|---|---|
| macOS 14.0 "Sonoma" | ✔️ 8,0 | ✔️ 6,0 |
| macOS 13.0 "Ventura" | ✔️ 8,0 | ✔️ 6,0 |
| macOS 12.0 "Monterey" | ✔️ 8,0 | ✔️ 6,0 |
| macOS 11.0 "Big Sur" | ❌ | ✔️ 6,0 |
| macOS 10.15 "Catalina" | ❌ | ✔️ 6,0 |
Para obter uma lista completa das versões do .NET e seu ciclo de vida de suporte, consulte Política de suporte do .NET.
Versões não suportadas
As seguintes versões do .NET não são ❌ mais suportadas:
- .NET 7
- .NET 5
- .NET Core 3.1
- .NET Core 3.0
- .NET Core 2.2
- .NET Core 2.1
- .NET Core 2.0
Informações sobre o tempo de execução
O tempo de execução é usado para executar aplicativos criados com .NET. Quando um autor de aplicativo publica um aplicativo, ele pode incluir o tempo de execução com seu aplicativo. Se eles não incluírem o tempo de execução, caberá ao usuário instalá-lo.
Há dois tempos de execução diferentes que você pode instalar no macOS:
Tempo de execução do ASP.NET Core
Executa ASP.NET aplicativos principais. Inclui o tempo de execução do .NET.Tempo de execução do .NET
Este tempo de execução é o tempo de execução mais simples e não inclui nenhum outro tempo de execução. É altamente recomendável que você instale o tempo de execução do ASP.NET Core para obter a melhor compatibilidade com aplicativos .NET.
Informações do SDK
O SDK é usado para criar e publicar aplicativos e bibliotecas .NET. A instalação do SDK inclui ambos os tempos de execução: ASP.NET Core e .NET.
Reconhecimento de firma
A partir do macOS Catalina (versão 10.15), todo o software criado após 1º de junho de 2019 que é distribuído com ID de desenvolvedor deve ser reconhecido em cartório. Esse requisito se aplica ao tempo de execução do .NET, ao SDK do .NET e ao software criado com o .NET.
Os instaladores de tempo de execução e SDK para .NET foram autenticados em cartório desde 18 de fevereiro de 2020. As versões lançadas anteriormente não são reconhecidas em cartório. Se você executar um aplicativo sem reconhecimento de firma, verá um erro semelhante à imagem a seguir:
Para obter mais informações sobre como a notarização imposta afeta o .NET (e seus aplicativos .NET), consulte Trabalhando com o macOS Catalina Notarization.
libgdiplus
Aplicativos .NET que usam o assembly System.Drawing.Common exigem que libgdiplus seja instalado.
Uma maneira fácil de obter libgdiplus é usando o gerenciador de pacotes Homebrew ("brew") para macOS. Depois de instalar o brew, instale o libgdiplus executando os seguintes comandos em um prompt do Terminal (comando):
brew update
brew install mono-libgdiplus
Instalação automatizada
O macOS tem instaladores independentes que podem ser usados para instalar o .NET:
Instalação manual
Como alternativa aos instaladores do macOS para .NET, você pode baixar e instalar manualmente o SDK e o tempo de execução. A instalação manual é geralmente realizada como parte de testes de integração contínua. Para um desenvolvedor ou usuário, geralmente é melhor usar um instalador.
Baixe uma versão binária para o SDK ou o tempo de execução de um dos seguintes sites. O SDK do .NET inclui o tempo de execução correspondente:
Extraia o arquivo baixado e use o export comando para definir DOTNET_ROOT o local da pasta extraída e, em seguida, verifique se o .NET está no PATH. A exportação DOTNET_ROOT disponibiliza os comandos da CLI do .NET no terminal. Para obter mais informações sobre variáveis de ambiente .NET, consulte Variáveis de ambiente .NET SDK e CLI.
Diferentes versões do .NET podem ser extraídas para a mesma pasta, que coexistem lado a lado.
Exemplo
Os comandos a seguir usam Bash para definir a variável DOTNET_ROOT de ambiente para o diretório de trabalho atual seguido por .dotnet. Esse diretório é criado se não existir. A DOTNET_FILE variável de ambiente é o nome do arquivo da versão binária do .NET que você deseja instalar. Este arquivo é extraído para o DOTNET_ROOT diretório. DOTNET_ROOT O diretório e seu tools subdiretório são adicionados à PATH variável de ambiente.
Importante
Se você executar esses comandos, lembre-se de alterar o DOTNET_FILE valor para o nome do binário .NET que você baixou.
DOTNET_FILE=dotnet-sdk-8.0.100-osx-x64.tar.gz
export DOTNET_ROOT=$(pwd)/.dotnet
mkdir -p "$DOTNET_ROOT" && tar zxf "$DOTNET_FILE" -C "$DOTNET_ROOT"
export PATH=$PATH:$DOTNET_ROOT
Você pode instalar mais de uma versão do .NET na mesma pasta.
Você também pode instalar o .NET no diretório base identificado pela HOME variável ou ~ caminho:
export DOTNET_ROOT=$HOME/.dotnet
Verificar binários baixados
Depois de baixar um instalador, verifique-o para certificar-se de que o arquivo não foi alterado ou corrompido. Você pode verificar a soma de verificação no seu computador e, em seguida, compará-la com o que foi relatado no site de download.
Quando você baixa um instalador ou binário de uma página de download oficial, a soma de verificação para o arquivo é exibida. Selecione o botão Copiar para copiar o valor da soma de verificação para a área de transferência.
Use o sha512sum 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-8.0.100-linux-x64.tar.gz :
$ sha512sum dotnet-sdk-8.0.100-linux-x64.tar.gz
13905ea20191e70baeba50b0e9bbe5f752a7c34587878ee104744f9fb453bfe439994d38969722bdae7f60ee047d75dda8636f3ab62659450e9cd4024f38b2a5 dotnet-sdk-8.0.100-linux-x64.tar.gz
Compare a soma de verificação com o valor fornecido pelo site de download.
Importante
Embora um arquivo Linux seja mostrado nesses exemplos, essas informações também se aplicam ao macOS.
Usar um arquivo de soma de verificação para validar
As notas de versão do .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 do .NET:
A página de notas de versão do .NET 8 no GitHub em https://github.com/dotnet/core/tree/main/release-notes/8.0 contém uma seção chamada Releases. A tabela nessa seção vincula aos downloads e arquivos de soma de verificação para cada versão do .NET 8:
Selecione o link para a versão do .NET que você baixou. A seção anterior usou o .NET SDK 8.0.100, que está na versão .NET 8.0.0.
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:
Copie o link para o arquivo de soma de verificação.
Use o script a seguir, mas substitua o link para baixar o arquivo de soma de verificação apropriado:
curl -O https://dotnetcli.blob.core.windows.net/dotnet/checksums/8.0.0-sha.txtCom o arquivo de soma de verificação e o arquivo de versão .NET baixados para o mesmo diretório, use o
sha512sum -c {file} --ignore-missingcomando para validar o arquivo baixado.Quando a validação for aprovada, você verá o arquivo impresso com o status OK :
$ sha512sum -c 8.0.0-sha.txt --ignore-missing dotnet-sdk-8.0.100-linux-x64.tar.gz: OKSe vir o ficheiro marcado como FALHOU, o ficheiro que transferiu não é válido e não deve ser utilizado.
$ sha512sum -c 8.0.0-sha.txt --ignore-missing dotnet-sdk-8.0.100-linux-x64.tar.gz: FAILED sha512sum: WARNING: 1 computed checksum did NOT match sha512sum: 8.0.0-sha.txt: no file was verified
Definir variáveis de ambiente em todo o sistema
Se você usou as instruções na seção Exemplo de instalação manual, as variáveis definidas se aplicam apenas à sua sessão de terminal atual. Adicione-os ao seu perfil de shell. Existem muitos shells diferentes disponíveis para macOS e cada um tem um perfil diferente. Por exemplo:
- Bash Shell: ~/.profile, /etc/profile
- Korn Shell: ~/.kshrc ou .profile
- Z Shell: ~/.zshrc ou .zprofile
Defina as duas variáveis de ambiente a seguir em seu perfil de shell:
DOTNET_ROOTEssa variável é definida como a pasta para a qual o .NET foi instalado, como
$HOME/.dotnet:export DOTNET_ROOT=$HOME/.dotnetPATHEsta variável deve incluir a
DOTNET_ROOTpasta e aDOTNET_ROOT/toolspasta:export PATH=$PATH:$DOTNET_ROOT:$DOTNET_ROOT/tools
Macs baseados em braço
As seções a seguir descrevem coisas que você deve considerar ao instalar o .NET em um Mac baseado em Arm.
O que é suportado
A tabela a seguir descreve quais versões do .NET são suportadas em um Mac baseado em Arm:
| Versão .NET | SDK | Runtime | Conflito de caminho |
|---|---|---|---|
| 8 | Sim | Sim | No |
| 8 | Sim | Sim | No |
| 6 | Sim | Sim | No |
| 6 | Sim | Sim | No |
As versões x64 e Arm64 do SDK do .NET existem independentemente uma da outra. Se uma nova versão for lançada, cada instalação precisará ser atualizada.
Diferenças de caminho
Em um Mac baseado em Arm, todas as versões Arm64 do .NET são instaladas na pasta normal /usr/local/share/dotnet/ . No entanto, quando você instala a versão x64 do SDK do .NET, ela é instalada na pasta /usr/local/share/dotnet/x64/dotnet/.
Conflitos de caminho
O x64 .NET SDK é instalado em seu próprio diretório, conforme descrito na seção anterior. Isso permite que as versões Arm64 e x64 do SDK do .NET existam na mesma máquina. No entanto, qualquer SDK x64 anterior ao .NET 6 não é suportado e é instalado no mesmo local que a versão Arm64, a pasta /usr/local/share/dotnet/ . Se você quiser instalar um SDK x64 não suportado, você precisa primeiro desinstalar a versão Arm64. O oposto também é verdadeiro, você precisa desinstalar o SDK x64 não suportado para instalar a versão Arm64.
Variáveis de caminho
As variáveis de ambiente que adicionam o .NET ao caminho do sistema, como a PATH variável, podem precisar ser alteradas se você tiver as versões x64 e Arm64 do SDK do .NET 6 instaladas. Além disso, algumas ferramentas dependem da variável de DOTNET_ROOT ambiente, que também precisaria ser atualizada para apontar para a pasta de instalação apropriada do SDK do .NET 6.
Instalar com o Visual Studio para Mac
Visual Studio para Mac instala o SDK do .NET quando a carga de trabalho do .NET é selecionada. Para começar a desenvolver o .NET no macOS, consulte Instalar o Visual Studio 2022 para Mac.
Importante
O Visual Studio para Mac está sendo desativado. Para obter mais informações, consulte O que está acontecendo com o Visual Studio para Mac?.
| Versão do SDK do .NET | Versão do Visual Studio |
|---|---|
| 8.0 | Visual Studio 2022 para Mac 17.6.1 ou superior. (Disponível apenas como funcionalidade de pré-visualização.) |
| 6,0 | Visual Studio 2022 para Mac 17.0 ou superior. |
Importante
A Microsoft anunciou a aposentadoria do Visual Studio para Mac. O Visual Studio para Mac não terá mais suporte a partir de 31 de agosto de 2024. As alternativas incluem:
- Visual Studio Code com o C# Dev Kit e extensões relacionadas, como .NET MAUI e Unity.
- Visual Studio em execução no Windows em uma VM no Mac.
- Visual Studio em execução no Windows em uma VM na nuvem.
Para obter mais informações, consulte Anúncio de desativação do Visual Studio para Mac.
Instalar junto com o Visual Studio Code
O Visual Studio Code é um editor de código-fonte poderoso e leve que é executado em sua área de trabalho. O Visual Studio Code está disponível para Windows, macOS e Linux.
Embora o Visual Studio Code não venha com um instalador .NET automatizado como o Visual Studio, adicionar suporte ao .NET é simples.
- Baixe e instale o Visual Studio Code.
- Baixe e instale o SDK do .NET.
- Instale a extensão C# do mercado Visual Studio Code.
Instale com automação bash
Os scripts dotnet-install são usados para automação e instalações não administrativas do tempo de execução. Você pode baixar o script da página de referência de script dotnet-install.
O script assume como padrão a instalação da versão mais recente de suporte de longo prazo (LTS), que é o .NET 8. Você pode escolher uma versão específica especificando o channel switch. Inclua o runtime switch para instalar um tempo de execução. Caso contrário, o script instalará o SDK.
O comando a seguir instala o tempo de execução do ASP.NET Core para máxima compatibilidade. O tempo de execução do ASP.NET Core também inclui o tempo de execução padrão do .NET.
./dotnet-install.sh --channel 8.0 --runtime aspnetcore
Para saber como usar a CLI do .NET, consulte Visão geral da CLI do .NET.
Docker
Os contêineres fornecem uma maneira leve de isolar seu aplicativo do resto do sistema host. Contêineres na mesma máquina compartilham apenas o kernel e usam recursos fornecidos ao seu aplicativo.
O .NET pode ser executado em um contêiner do Docker. As imagens oficiais do .NET Docker são publicadas no Microsoft Container Registry (MCR) e podem ser detetadas no repositório do Microsoft .NET Docker Hub. Cada repositório contém imagens para diferentes combinações do .NET (SDK ou Runtime) e do SO que você pode usar.
A Microsoft fornece imagens adaptadas para cenários específicos. Por exemplo, o repositório ASP.NET Core fornece imagens criadas para executar aplicativos ASP.NET Core em produção.
Para obter mais informações sobre como usar o .NET em um contêiner do Docker, consulte Introdução ao .NET e Docker e exemplos.
Próximos passos
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários