Despliegue de aplicaciones .NET en computadoras de placa única ARM

La implementación de aplicaciones .NET en equipos de una sola placa es idéntica a la de cualquier otra plataforma. La aplicación puede ejecutarse como modos de implementación independientes o dependientes del marco . Hay ventajas para cada estrategia. Para obtener más información, consulte Introducción a la publicación de aplicaciones .NET.

Implementación de una aplicación dependiente del marco

Para implementar la aplicación como una aplicación dependiente del marco, complete los pasos siguientes:

1. Asegúrese de que SSH está habilitado en el dispositivo. Para Raspberry Pi, consulte Configuración de un servidor SSH en la documentación de Raspberry Pi.

2. Instale .NET en el dispositivo mediante los scripts dotnet-install. Ejecuta los pasos siguientes en un terminal Bash en el dispositivo (local o SSH):

   1. Ejecute el siguiente comando para instalar .NET:

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

      Nota:

      Este comando instala la versión más reciente. Si necesita una versión específica, reemplace el parámetro por --channel STS, donde --version <VERSION> es la versión de compilación específica, por ejemplo<VERSION>.8.0.404 Para obtener una lista de versiones, consulte SDK de .NET para Visual Studio. Para determinar el número de compilación completo, consulte la columna SDK de Visual Studio 2026 .

   2. Para simplificar la resolución de rutas de acceso, agregue una DOTNET_ROOT variable de entorno y agregue el directorio .dotnet a $PATH con los siguientes comandos:

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

   3. Compruebe la instalación de .NET con el comando siguiente:

      dotnet --version
      

      Compruebe que la versión mostrada coincide con la versión instalada.

3. Publique la aplicación en el equipo de desarrollo como se indica a continuación, en función del entorno de desarrollo.

   • Si usa Visual Studio, implemente la aplicación en una carpeta local. Antes de publicar, seleccione Editar en el resumen del perfil de publicación y seleccione la pestaña Configuración . Asegúrese de que el modo de implementación está establecido en Dependiente del marco y El tiempo de ejecución de destino está establecido en Portable.
   • Si usa la CLI de .NET, use el comando dotnet publish . No se requieren argumentos adicionales.

4. Con un cliente SFTP como scp, copie los archivos de la ubicación de publicación en el equipo de desarrollo en una nueva carpeta del SBC.

   Por ejemplo, para usar el comando scp para copiar archivos desde el equipo de desarrollo a su SBC, abra la terminal de comandos y ejecute lo siguiente:

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

   Where:

   • La -r opción indica scp que copie los archivos de forma recursiva.
   • /publish-location/ es la carpeta en la que se publicó en el paso anterior.
   • pi@raspberrypi es el nombre de usuario y de host en el formato <username>@<hostname>.
   • /home/pi/deployment-location/ es la nueva carpeta en el SBC.

   Sugerencia

   Las versiones recientes de Windows tienen OpenSSH, que incluye scp, preinstalado.

5. Desde un símbolo del sistema de Bash en Raspberry Pi (local o SSH), ejecute la aplicación. Para ello, establezca la carpeta de implementación como directorio actual y ejecute el siguiente comando (donde HelloWorld.dll es el punto de entrada de la aplicación):

   dotnet HelloWorld.dll
   

Implementación de una aplicación independiente

Para implementar la aplicación como una aplicación independiente, complete los pasos siguientes:

1. Asegúrese de que SSH está habilitado en el dispositivo. Para Raspberry Pi, consulte Configuración de un servidor SSH en la documentación de Raspberry Pi.

2. Publique la aplicación en el equipo de desarrollo como se indica a continuación, en función del entorno de desarrollo.

   • Si usa Visual Studio, implemente la aplicación en una carpeta local. Antes de publicar, seleccione Editar en el resumen del perfil de publicación y seleccione la pestaña Configuración . Asegúrese de que el modo de implementación esté establecido en Autocontenida y el entorno de ejecución de destino esté establecido en linux-arm64.

   • Si usa la CLI de .NET, utilice el comando dotnet publish con los argumentos --runtime linux-arm64 y --self-contained.

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

   Importante

   Si usa un sistema operativo de 32 bits, debe tener como destino el linux-arm entorno de ejecución.

3. Con un cliente SFTP como scp, copie los archivos de la ubicación de publicación en el equipo de desarrollo en una nueva carpeta del SBC.

   Por ejemplo, para usar el comando scp para copiar archivos desde el equipo de desarrollo a tu SBC, abre la consola de comandos y ejecuta lo siguiente:

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

   Where:

   • La -r opción indica scp que copie los archivos de forma recursiva.
   • /publish-location/ es la carpeta en la que se publicó en el paso anterior.
   • pi@raspberrypi son los nombres de usuario y host con el formato <username>@<hostname>.
   • /home/pi/deployment-location/ es la nueva carpeta en el SBC.

   Sugerencia

   Las versiones recientes de Windows tienen OpenSSH, que incluye scp, preinstalado.

4. Desde un símbolo del sistema de Bash en el dispositivo (local o SSH), ejecute la aplicación. Para ello, establezca el directorio actual en la ubicación de implementación y complete los pasos siguientes:

   1. Asigne al ejecutable permiso de ejecución (donde HelloWorld es el nombre del archivo ejecutable).

      chmod +x HelloWorld
      

   2. Ejecute el ejecutable.

      ./HelloWorld