Implantar aplicativos .NET em computadores ARM de placa única

A implantação de aplicativos .NET em computadores de placa única é idêntica à de qualquer outra plataforma. Seu aplicativo pode ser executado em modos de implantação autônomos ou dependentes de estrutura. Há vantagens para cada estratégia. Para obter mais informações, consulte .NET visão geral da publicação de aplicativos.

Implantando um aplicativo dependente de estrutura

Para implantar seu aplicativo como um aplicativo dependente da estrutura, conclua as seguintes etapas:

1. Verifique se o SSH está habilitado em seu dispositivo. Para Raspberry Pi, consulte Configurar um servidor SSH na documentação do Raspberry Pi.

2. Instale .NET no dispositivo usando os scripts dotnet-install. Siga as etapas a seguir a partir de um prompt Bash no dispositivo (local ou SSH):

   1. Execute o seguinte comando para instalar .NET:

      curl -sSL https://dot.net/v1/dotnet-install.sh | bash /dev/stdin --channel LTS
      

      Observação

      Esse comando instala a versão mais recente do LTS. Se você precisar de uma versão específica, substitua o parâmetro --channel LTS com --version <VERSION>, onde <VERSION> é a versão específica da compilação, por exemplo 10.0.103. Para obter uma lista de versões, consulte .NET SDKs para Visual Studio. Para determinar o número de build completo, consulte a coluna Visual Studio SDK 2026.

   2. Para simplificar a resolução do caminho, adicione uma DOTNET_ROOT variável de ambiente e adicione o diretório .dotnet ao $PATH com os seguintes comandos:

      echo 'export DOTNET_ROOT=$HOME/.dotnet' >> ~/.bashrc
      echo 'export PATH=$PATH:$HOME/.dotnet' >> ~/.bashrc
      source ~/.bashrc
      

   3. Verifique a instalação do .NET com o seguinte comando:

      dotnet --version
      

      Verifique se a versão exibida corresponde à versão instalada.

3. Publique o aplicativo no computador de desenvolvimento da seguinte maneira, dependendo do ambiente de desenvolvimento.

   • Se estiver usando Visual Studio, deplora o aplicativo para uma pasta local. Antes de publicar, selecione Editar no resumo do perfil de publicação e selecione a guia Configurações . Verifique se o modo de implantação está definido como dependente da estrutura e o runtime de destino está definido como Portátil.
   • Se estiver usando a CLI .NET, use o comando dotnet publish. Nenhum argumento adicional é necessário.

4. Usando um cliente SFTP como scp, copie os arquivos do local de publicação no computador de desenvolvimento para uma nova pasta no SBC.

   Por exemplo, para usar o scp comando para copiar arquivos do computador de desenvolvimento para seu SBC, abra um prompt de comando e execute o seguinte:

   scp -r /publish-location/* pi@raspberrypi:/home/pi/deployment-location/
   

   Em que:

   • A -r opção instrui scp a copiar arquivos recursivamente.
   • /publish-location/ é a pasta na qual você publicou na etapa anterior.
   • pi@raspberrypi são os nomes de usuário e anfitrião no formato <username>@<hostname>.
   • /home/pi/deployment-location/ é a nova pasta no SBC.

   Dica

   As versões recentes do Windows têm o OpenSSH, que inclui scp, pré-instalado.

5. Em um prompt bash no Raspberry Pi (local ou SSH), execute o aplicativo. Para fazer isso, defina a pasta de implantação como o diretório atual e execute o seguinte comando (em queHelloWorld.dll é o ponto de entrada do aplicativo):

   dotnet HelloWorld.dll
   

Como implantar um aplicativo independente

Para implantar seu aplicativo como um aplicativo autossuficiente, conclua as seguintes etapas:

1. Verifique se o SSH está habilitado em seu dispositivo. Para Raspberry Pi, consulte Configurar um servidor SSH na documentação do Raspberry Pi.

2. Publique o aplicativo no computador de desenvolvimento da seguinte maneira, dependendo do ambiente de desenvolvimento.

   • Se estiver usando Visual Studio, deplora o aplicativo para uma pasta local. Antes de publicar, selecione Editar no resumo do perfil de publicação e selecione a guia Configurações . Verifique se o modo de implantação está definido como autocontido e o runtime de destino está definido como linux-arm64.

   • Se estiver usando a CLI .NET, use o comando dotnet publish com os argumentos --runtime linux-arm64 e --self-contained:

     dotnet publish --runtime linux-arm64 --self-contained
     

   Importante

   Se você estiver usando um sistema operacional de 32 bits, precisará ter como destino o runtime do linux-arm.

3. Usando um cliente SFTP como scp, copie os arquivos do local de publicação no computador de desenvolvimento para uma nova pasta no SBC.

   Por exemplo, para usar o scp comando para copiar arquivos do computador de desenvolvimento para seu SBC, abra um prompt de comando e execute o seguinte:

   scp -r /publish-location/* pi@raspberrypi:/home/pi/deployment-location/
   

   Em que:

   • A -r opção instrui scp a copiar arquivos recursivamente.
   • /publish-location/ é a pasta na qual você publicou na etapa anterior.
   • pi@raspberrypi são os nomes de usuário e anfitrião no formato <username>@<hostname>.
   • /home/pi/deployment-location/ é a nova pasta no SBC.

   Dica

   As versões recentes do Windows têm o OpenSSH, que inclui scp, pré-instalado.

4. Em um prompt bash no dispositivo (local ou SSH), execute o aplicativo. Para fazer isso, defina o diretório atual para o local de implantação e conclua as seguintes etapas:

   1. Conceda permissão de execução ao executável .

      chmod +x HelloWorld
      

   2. Execute o executável.

      ./HelloWorld