Ler em inglês

Partilhar via


Instalar o .NET no macOS

Este artigo ensina sobre quais versões do .NET são suportadas no macOS, como instalar o .NET e qual é a diferença entre o SDK e o tempo de execução.

A última versão do .NET é 9.

Versões suportadas

A tabela a seguir lista as versões do .NET suportadas e em qual macOS elas são suportadas. Essas versões permanecem suportadas até que a versão do .NET atinja o fim do suporte ou a versão do macOS não seja mais suportada.

Versão macOS .NET
macOS 15 "Sequoia" 9.0, 8.0
macOS 14 "Sonoma" 9.0, 8.0
macOS 13 "Ventura" 9.0, 8.0

As seguintes versões do .NET não são ❌ mais suportadas:

  • .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

Tempo de execução ou SDK

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, cabe ao usuário instalar o tempo de execução 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 aplicativos principais. Inclui o tempo de execução do .NET. Não está disponível como instalador.

  • Tempo de execução do .NET
    Isso executa aplicativos .NET normais, mas não aplicativos especializados, como aplicativos criados no ASP.NET Core.

O SDK é usado para criar e publicar aplicativos e bibliotecas .NET. O SDK mais recente oferece 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 .NET Runtime padrão e o ASP.NET Core Runtime. Por exemplo, se você tiver o .NET SDK 9.0 instalado, o .NET Runtime 9.0 e o ASP.NET Core 9.0 Runtime serão instalados. No entanto, qualquer outra versão de tempo de execução não seria instalada com o SDK e exigiria que você a instalasse separadamente.

Escolha como instalar o .NET

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

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

Programadores

Utilizadores e Programadores

  • Instalador do .NET

    Use o instalador autônomo para instalar o .NET. Esse método é a maneira típica de instalar o .NET em sua máquina de desenvolvedor ou usuário.

  • Instalar o .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 o .NET manualmente

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

Instalar o .NET

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

  1. Abra um browser e navegue para https://dotnet.microsoft.com/download/dotnet.

  2. Selecione o link para a versão do .NET que você deseja instalar, como o .NET 8.0.

    O site de download do .NET. As versões 6.0 a 9.0 estão listadas. Uma caixa vermelha destaca esses links de download.

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

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

    Gorjeta

    Se você não tiver certeza de qual versão baixar, escolha a versão marcada como mais recente.

  3. Esta página apresenta os links de download para o SDK e o Runtime. Aqui você baixa o .NET SDK ou .NET Runtime.

    O site de download do .NET mostrando os links de download do SDK e do Runtime. Os cabeçalhos SDK e Runtime são realçados com uma caixa vermelha. Cada caixa tem uma seta apontando para baixo para a seção macOS.

    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.

    • Secçã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 de tempo de execução. Observe que os links para a coluna Instaladores na linha do macOS estão vazios! Esta seção está vazia porque o ASP.NET Core Runtime só é fornecido no SDK ou por meio de instalação binária.

      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 de download do .NET. A linha do macOS é realçada 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.
  4. Quando o download for concluído, abra-o.

  5. Siga as etapas no instalador.

    Uma captura de tela mostrando apenas o instalador do .NET em execução no macOS.

Instalar o .NET manualmente

Como alternativa aos instaladores do macOS, você pode baixar e instalar manualmente o SDK e o tempo de execução. A instalação manual geralmente é realizada como automação de peças em um cenário de integração contínua. Os desenvolvedores e usuários geralmente querem usar o instalador.

Gorjeta

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

  1. Abra um browser e navegue para https://dotnet.microsoft.com/download/dotnet.

  2. Selecione o link para a versão do .NET que você deseja instalar, como o .NET 8.0.

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

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

    Gorjeta

    Se você não tiver certeza de qual versão baixar, escolha a versão marcada como mais recente.

    O site de download do .NET. As versões 6.0 a 9.0 estão listadas. Uma caixa vermelha destaca esses links de download.

  3. Selecione o link para o SDK ou Runtime que você deseja instalar. Procure a coluna Binários na linha macOS .

    O site de download do .NET mostrando os links de download do SDK. O cabeçalho do SDK é realçado com uma caixa vermelha. A caixa tem uma seta apontando para baixo para a seção 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.
  4. Abra um terminal e navegue até onde o binário .NET foi baixado.

  5. Extraia o tarball para onde você deseja .NET em seu sistema. O exemplo a seguir usa o diretório ~/Applications/.dotnetHOME .

    mkdir -p ~/Applications/.dotnet
    tar -xf "dotnet-sdk-9.0.100-rc.2.24474.11-osx-arm64.tar" -C ~/Applications/.dotnet/
    

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

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

Instalar o .NET com um script

Os scripts dotnet-install são usados para automação e instalações não elevadas do tempo de execução. Você pode baixar o script de https://dot.net/v1/dotnet-install.sh.

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.

Gorjeta

Esses comandos recebem um trecho de script no final deste procedimento.

  1. Abra um terminal.

  2. Navegue até uma pasta onde deseja baixar o script, como ~/Downloads.

  3. Se você não tiver o comando, instale-o com o wget Brew

    brew install wget
    
  4. Execute o seguinte comando para baixar o script:

    wget https://dot.net/v1/dotnet-install.sh
    
  5. Dê permissões de execução ao script

    chmod +x dotnet-install.sh
    
  6. Execute o script para instalar o .NET.

    O script assume como padrão a instalação do SDK mais recente no ~/.dotnet 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 o .NET navegando até a ~/.dotnet pasta e executando o dotnet --info comando:

chdir ~/.dotnet
./dotnet --info

Importante

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

Instalar o .NET para Visual Studio Code

O 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 do C# Dev Kit instalará o .NET para você se ainda não estiver instalado.

Para obter instruções sobre como instalar o .NET por meio do Visual Studio Code, consulte Introdução ao C# no VS Code.

Reconhecimento de firma

O software criado para macOS que é distribuído com um ID de desenvolvedor deve ser reconhecido em cartório, incluindo aplicativos feitos com .NET.

Se você executar um aplicativo não reconhecido em cartório, uma janela de erro semelhante à imagem a seguir será exibida:

Alerta de reconhecimento de firma do macOS Catalina

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.

Validação

Depois de baixar um instalador ou uma versão binária, 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 o arquivo de uma página de download oficial, a soma de verificação para o arquivo é exibida em uma caixa de texto. Selecione o botão Copiar para copiar o valor da soma de verificação para a área de transferência.

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

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:

  1. 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#releases 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:

    A tabela de versão das notas de versão do github para .NET

  2. 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.

  3. 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 tabela de download com somas de verificação para .NET

  4. Clique com o botão direito do mouse no link Soma de verificação e copie o link para a área de transferência.

  5. Abra um terminal.

  6. Use curl -O {link} para baixar o arquivo de soma de verificação.

    Substitua o link no comando a seguir pelo link copiado.

    curl -O https://dotnetcli.blob.core.windows.net/dotnet/checksums/8.0.0-sha.txt
    
  7. Com 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-missing comando 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: OK
    

    Se 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
    

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.

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/.

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 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.

Resolução de Problemas

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

Disponibilizar o .NET em todo o sistema

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

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

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_ROOT

    Essa variável é definida como a pasta para a qual o .NET foi instalado, como $HOME/.dotnet:

    export DOTNET_ROOT=$HOME/.dotnet
    
  • PATH

    Esta variável deve incluir a DOTNET_ROOT pasta e a DOTNET_ROOT/tools pasta:

    export PATH=$PATH:$DOTNET_ROOT:$DOTNET_ROOT/tools
    

System.Drawing.Common e libgdiplus

Aplicativos .NET que usam o System.Drawing.Common assembly precisam libgdiplus ser instalados.

Uma maneira fácil de obter libgdiplus é usando o gerenciador de pacotes Homebrew ("brew") para macOS. Depois de instalar o brew, instale libgdiplus executando os seguintes comandos no terminal:

brew update
brew install mono-libgdiplus