Erstellen einer allgemeinen Anwendung

  • Artikel

Die einfachste Möglichkeit zum Erstellen einer neuen allgemeinen Anwendung besteht darin, mit der Vorlage Leer aus der Azure Sphere-Erweiterung von Visual Studio Code zu beginnen und die Konfiguration anhand der folgenden Schritte an Ihr Projekt anzupassen:

  1. Starten Sie Visual Studio Code. Wählen Sie Befehlspalette anzeigen> aus, und geben Sie dann Azure Sphere: Neues Projekt generieren ein.

    Befehlsleiste in Visual Studio Code

  2. Wählen Sie HL Blank aus dem Menü Vorlagen aus.

    Popupmenü mit Vorlagennamen

  3. Visual Studio Code zeigt dann ein Explorer Fenster an. Navigieren Sie zu dem Ordner, in dem Sie die Leere Anwendung platzieren möchten, und geben Sie einen Namen für Ihr Projekt an, z. B. NewHLApp. Visual Studio Code erstellt den Ordner NewHLApp am ausgewählten Speicherort und generiert die Builddateien für die leere Anwendung. Es sollten Nachrichten von CMake angezeigt werden.

  4. Öffnen Sie die CMakeLists.txt Datei, und geben Sie den Ordner an, der Definitionen für die verwendete Hardware enthält. Standardmäßig enthält die HL Blank-Anwendung keine Hardwaredefinitionen. Beispielhardwaredefinitionen finden Sie im Azure Sphere-Beispielrepository, oder erstellen Sie eine, wie unter Hardwaredefinitionen beschrieben.

    Im Folgenden wird gezeigt, wie Sie die Beispielhardwaredefinitionen für das Seeed Azure Sphere MT3620 Development Kit hinzufügen:

    azsphere_target_hardware_definition(${PROJECT_NAME} TARGET_DIRECTORY "HardwareDefinitions/mt3620_rdb" TARGET_DEFINITION "sample_appliance.json")

    Diese Zeile sollte eingefügt werden, bevor der letzte Befehl beginnt azsphere_target_add_image_package.

Sie können auch eine neue allgemeine Anwendung aus einem der allgemeinen Azure Sphere-Beispiele erstellen:

  1. Klonen Sie das Beispielrepository , wenn Sie dies noch nicht getan haben. Kopieren Sie einen der allgemeinen Anwendungsordner, und benennen Sie ihn für Ihr Projekt um.

  2. Ändern Sie in der CMakeLists.txt-Datei den Projektnamen in den Namen Ihres neuen Ordners. Zum Beispiel:

    PROJECT(NewHLApp C)

Die einfachste Möglichkeit zum Erstellen einer neuen allgemeinen Anwendung besteht darin, mit der Vorlage Leer aus der Azure Sphere-Erweiterung von Visual Studio zu beginnen und die Konfiguration anhand der folgenden Schritte an Ihr Projekt anzupassen:

  1. Starten Sie Visual Studio, und wählen Sie Neues Projekt erstellen aus.

  2. Geben Sie Azure Sphere in das Suchfeld nach Vorlagen suchen ein. Wählen Sie in der zurückgegebenen Liste die Option Azure Sphere HLCore Blank aus, und wählen Sie dann Weiter aus.

  3. Geben Sie einen Projektnamen (z. B. NewHLApp), einen Projektdateispeicherort und einen Projektmappennamen an (der mit dem Projektnamen identisch sein kann), und wählen Sie dann Erstellen aus. Visual Studio erstellt den Ordner NewHLpp am ausgewählten Speicherort und generiert die Builddateien für die leere Anwendung. Es sollten Nachrichten von CMake angezeigt werden.

  4. Öffnen Sie die CMakeLists.txt Datei, und geben Sie den Ordner an, der Definitionen für die verwendete Hardware enthält. Standardmäßig enthält die HL Blank-Anwendung keine Hardwaredefinitionen. Beispielhardwaredefinitionen finden Sie im Azure Sphere-Beispielrepository, oder erstellen Sie eine, wie unter Hardwaredefinitionen beschrieben.

    Im Folgenden wird gezeigt, wie Sie die Beispielhardwaredefinitionen für das Seeed Azure Sphere MT3620 Development Kit hinzufügen:

    azsphere_target_hardware_definition(${PROJECT_NAME} TARGET_DIRECTORY "HardwareDefinitions/mt3620_rdb" TARGET_DEFINITION "sample_appliance.json")

    Diese Zeile sollte eingefügt werden, bevor der letzte Befehl beginnt azsphere_target_add_image_package.

Sie können auch eine neue allgemeine Anwendung aus einem der allgemeinen Azure Sphere-Beispiele erstellen:

  1. Klonen Sie das Beispielrepository , wenn Sie dies noch nicht getan haben. Kopieren Sie einen der allgemeinen Anwendungsordner, und benennen Sie ihn für Ihr Projekt um.

  2. Ändern Sie in der CMakeLists.txt-Datei den Projektnamen in den Namen Ihres neuen Ordners. Zum Beispiel:

    PROJECT(NewHLApp C)

Die einfachste Möglichkeit zum Erstellen einer neuen allgemeinen Anwendung besteht darin, mit einem der allgemeinen Azure Sphere-Beispiele zu beginnen:

  1. Klonen Sie das Beispielrepository , wenn Sie dies noch nicht getan haben. Kopieren Sie einen der allgemeinen Anwendungsordner, und benennen Sie ihn für Ihr Projekt um.

  2. Ändern Sie in der CMakeLists.txt-Datei den Projektnamen in den Namen Ihres neuen Ordners. Zum Beispiel:

    PROJECT(NewHLApp C)

Grundlegende Dateistruktur einer allgemeinen Anwendung

Unabhängig davon, wie Sie Ihre Anwendung erstellen, verwenden alle Azure Sphere-Anwendungen die folgenden Kerndateien:

  • Anwendungsquellcode in einer oder mehreren Dateien. Derzeit wird nur C-Quellcode unterstützt.
  • CMake-Builddateien. CMakeLists.txt ist erforderlich. CMake wird zusammen mit dem Hilfsprogramm Ninja Lightweight Build verwendet, um den Azure Sphere-Anwendungsbuildprozess zu steuern.
  • Eine App-Manifestdatei , die die für die Anwendung verfügbaren Funktionen beschreibt.

Allgemeine Anwendungen verfügen in der Regel über mindestens drei weitere Dateien:

  • Eine Datei "applibs-versions.h" zum Angeben der Versionsebenen verschiedener Azure Sphere-APIs
  • Zwei Hardwaredefinitionsdateien (eine bearbeitbare Version im JSON-Format und eine daraus generierte Includedatei in der C-Sprache), die eine bequeme Möglichkeit bieten, auf Hardwarekomponenten in Ihrem Code zu verweisen. Mit einem konsistenten Satz von Hardwaredefinitionsdateien können Sie hardwareunabhängigen Quellcode schreiben und dann Anwendungsimages für bestimmte Hardware erstellen, indem Sie einfach die entsprechende Hardwaredefinitionsdatei in Ihrer CMakeLists.txt-Datei neu festlegen.

Schreiben Des Codes

  1. Schreiben Sie Ihren Anwendungscode mithilfe der allgemeinen Azure Sphere-App-Beispiele als Leitfäden. In den folgenden Themen werden bestimmte Implementierungsszenarien beschrieben:
  2. In der CMakeLists.txt-Datei:
    • Angeben der Revision der Azure Sphere SDK-Tools
    • Angeben des Ziel-API-Satzes
    • Angeben der Zielhardware
  3. In der Datei app_manifest.json:
    • Legen Sie Name auf Ihren Projektnamen fest.
    • Fügen Sie alle anwendungsspezifischen Funktionen hinzu, die Ihr Code benötigt, z. B. Hardwareressourcen oder Verbindungen. Wenn die allgemeine App mit einer RTApp kommuniziert, fügen Sie der Funktion die Komponenten-ID der allgemeinen Anwendung hinzu AllowedApplicationConnections .

Wenn Sie Ihre allgemeine App zusammen mit einer Echtzeit-fähigen Partner-App bereitstellen möchten, fügen Sie die Komponenten-ID des Partners dem Feld partnerComponents des Konfigurationsabschnitts der Datei launch.vs.json (Visual Studio) oder der Datei .vscode/launch.json (Visual Studio Code) hinzu:

"partnerComponents": [ "25025d2c-66da-4448-bae1-ac26fcdd3627" ]

Siehe auch