Bereitstellen von .NET-Apps auf ARM-Computern mit einem Einzigen Board

Die Bereitstellung von .NET-Apps auf Single-Board-Computern ist identisch mit der einer anderen Plattform. Ihre App kann als eigenständige oder frameworkabhängige Bereitstellungsmodi ausgeführt werden. Für jede Strategie gibt es Vorteile. Weitere Informationen finden Sie in der Übersicht über die .NET-Anwendungsveröffentlichung.

Bereitstellen einer frameworkabhängigen App

Führen Sie die folgenden Schritte aus, um Ihre App als frameworkabhängige App bereitzustellen:

1. Stellen Sie sicher, dass SSH auf Ihrem Gerät aktiviert ist. Zur Einrichtung eines SSH-Servers auf dem Raspberry Pi lesen Sie bitte den Abschnitt "Einen SSH-Server einrichten" in der Raspberry-Pi-Dokumentation.

2. Installieren Sie .NET auf dem Gerät mithilfe der dotnet-install-Skripts. Führen Sie die folgenden Schritte aus einer Bash-Eingabeaufforderung auf dem Gerät (lokal oder SSH) aus:

   1. Führen Sie den folgenden Befehl aus, um .NET zu installieren:

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

      Hinweis

      Mit diesem Befehl wird die neueste Version installiert. Wenn Sie eine bestimmte Version benötigen, ersetzen Sie den --channel STS Parameter durch --version <VERSION>, wobei <VERSION> es sich um die spezifische Buildversion handelt, z. B 8.0.404. . Eine Liste der Versionen finden Sie unter .NET SDKs für Visual Studio. Um die vollständige Buildnummer zu ermitteln, schauen Sie in die Visual Studio 2026 SDK-Spalte.

   2. Um die Pfadauflösung zu vereinfachen, fügen Sie eine DOTNET_ROOT Umgebungsvariable hinzu und fügen Sie das Verzeichnis .dotnet zu $PATH mit den folgenden Befehlen hinzu:

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

   3. Überprüfen Sie die .NET-Installation mit dem folgenden Befehl:

      dotnet --version
      

      Überprüfen Sie, ob die angezeigte Version mit der version übereinstimmt, die Sie installiert haben.

3. Veröffentlichen Sie die App auf dem Entwicklungscomputer wie folgt, je nach Entwicklungsumgebung.

   • Wenn Sie Visual Studio verwenden, stellen Sie die App in einem lokalen Ordner bereit. Wählen Sie vor der Veröffentlichung in der Zusammenfassung des Veröffentlichungsprofils "Bearbeiten" und dann die Registerkarte " Einstellungen " aus. Stellen Sie sicher, dass der Bereitstellungsmodus auf Framework-abhängig festgelegt ist und die Ziellaufzeit auf Portabel festgelegt ist.
   • Wenn Sie die .NET CLI verwenden, verwenden Sie den Dotnet-Veröffentlichungsbefehl . Es sind keine zusätzlichen Argumente erforderlich.

4. Kopieren Sie die Dateien mit einem SFTP Client wie scp vom Speicherort auf dem Entwickler-Computer in einen neuen Ordner auf dem SBC.

   Wenn Sie z. B. den scp Befehl verwenden möchten, um Dateien vom Entwicklungscomputer auf Ihren SBC zu kopieren, öffnen Sie eine Eingabeaufforderung, und führen Sie Folgendes aus:

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

   Wo:

   • Die -r Option weist scp an, Dateien rekursiv zu kopieren.
   • /publish-location/ ist der Ordner, in dem Sie im vorherigen Schritt veröffentlicht haben.
   • pi@raspberrypi ist der Benutzer- und Hostname im Format <username>@<hostname>.
   • /home/pi/deployment-location/ ist der neue Ordner auf dem SBC.

   Tipp

   Aktuelle Versionen von Windows verfügen über OpenSSH, das vorinstalliert ist, einschließlich scp.

5. Führen Sie aus einer Bash-Eingabeaufforderung auf dem Raspberry Pi (lokal oder SSH) die App aus. Legen Sie dazu den Bereitstellungsordner als aktuelles Verzeichnis fest, und führen Sie den folgenden Befehl aus (wobei HelloWorld.dll der Einstiegspunkt der App ist):

   dotnet HelloWorld.dll
   

Bereitstellen einer eigenständigen App

Führen Sie die folgenden Schritte aus, um Ihre App als eigenständige App bereitzustellen:

1. Stellen Sie sicher, dass SSH auf Ihrem Gerät aktiviert ist. Zur Einrichtung eines SSH-Servers auf dem Raspberry Pi lesen Sie bitte den Abschnitt "Einen SSH-Server einrichten" in der Raspberry-Pi-Dokumentation.

2. Veröffentlichen Sie die App auf dem Entwicklungscomputer wie folgt, je nach Entwicklungsumgebung.

   • Wenn Sie Visual Studio verwenden, stellen Sie die App in einem lokalen Ordner bereit. Wählen Sie vor der Veröffentlichung in der Zusammenfassung des Veröffentlichungsprofils "Bearbeiten" und dann die Registerkarte " Einstellungen " aus. Stellen Sie sicher, dass der Bereitstellungsmodus auf "Eigenständig " festgelegt ist und die Ziellaufzeit auf "linux-arm64" festgelegt ist.

   • Wenn Sie die .NET CLI verwenden, verwenden Sie den Dotnet-Veröffentlichungsbefehl mit den folgenden --runtime linux-arm64--self-contained Argumenten:

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

   Wichtig

   Wenn Sie ein 32-Bit-Betriebssystem verwenden, müssen Sie die linux-arm Laufzeit als Ziel festlegen.

3. Kopieren Sie die Dateien mit einem SFTP Client wie scp vom Speicherort auf dem Entwickler-Computer in einen neuen Ordner auf dem SBC.

   Wenn Sie z. B. den scp Befehl verwenden möchten, um Dateien vom Entwicklungscomputer auf Ihren SBC zu kopieren, öffnen Sie eine Eingabeaufforderung, und führen Sie Folgendes aus:

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

   Wo:

   • Die -r Option weist scp an, Dateien rekursiv zu kopieren.
   • /publish-location/ ist der Ordner, in dem Sie im vorherigen Schritt veröffentlicht haben.
   • pi@raspberrypi ist der Benutzer- und Hostname im Format <username>@<hostname>.
   • /home/pi/deployment-location/ ist der neue Ordner auf dem SBC.

   Tipp

   Aktuelle Versionen von Windows verfügen über OpenSSH, das vorinstalliert ist, einschließlich scp.

4. Führen Sie über eine Bash-Eingabeaufforderung auf dem Gerät (lokal oder SSH) die App aus. Legen Sie dazu das aktuelle Verzeichnis auf den Bereitstellungsort fest, und führen Sie die folgenden Schritte aus:

   1. Geben Sie der ausführbaren Datei Ausführungsrechte (bei HelloWorld handelt es sich um den Dateinamen der ausführbaren Datei).

      chmod +x HelloWorld
      

   2. Führen Sie die ausführbare Datei aus.

      ./HelloWorld