Share via

Was ist eine Komponenten-ID?

  • Artikel

Jede Azure Sphere-Anwendung muss über eine eindeutige Komponenten-ID verfügen, damit sie leicht identifiziert werden kann. Die Komponenten-ID ist ein Universally Unique Identifier (UUID), der auch als GUID (Globally Unique Identifier) bezeichnet wird. Dabei handelt es sich um eine Zeichenfolge, die einen Satz von Hexadezimalziffern enthält. Beispiel: 02ce3860-3126-42af-8ac7-c2a661134129. Jede Anwendung verfügt über eine andere Komponenten-ID, um mögliche Konflikte zu vermeiden.

Generieren einer Komponenten-ID

Wenn Sie ein CMake-Projekt zum ersten Mal in Visual Studio oder Visual Studio Code öffnen, wird die CMakeLists-Generierung automatisch ausgeführt und legt die Komponenten-ID für die Anwendung in der Datei app_manifest.json fest. Wenn Sie die Anwendung ohne Komponenten-ID ausführen, tritt beim Build ein Fehler auf. Bei Bedarf können Sie manuell eine GUID/UUID generieren und die Anwendungsmanifesteinstellung aktualisieren.

So generieren Sie eine GUID oder UUID:

  1. Wählen Sie im Menü Extras die Option GUID erstellen aus.
  2. Wählen Sie im GUID-Generatorprogramm die Optionsschaltfläche Registrierungsformat aus, wählen Sie die Schaltfläche Kopieren und dann die Schaltfläche Beenden aus.

Fügen Sie die generierte GUID/UUID in das ComponentId Feld der datei app_manifest.json der Anwendung ein. Zum Beispiel: "ComponentId": "a5e23798-9bef-4bb0-9ae9-45643e788cb7"

Ermitteln der Komponenten-ID

Die Komponenten-ID einer Anwendung ist zum Identifizieren einer Anwendung erforderlich. Sie können die Komponenten-ID für eine Anwendung auf folgende Weise finden:

  • Überprüfen Sie die Komponenten-ID im ComponentId Feld der Datei app_manifest.json der Anwendung.
  • Verwenden Sie den Befehl azsphere device app show-status, um die status und die Komponenten-ID der Anwendung auf dem angeschlossenen Gerät aufzulisten.
  • Verwenden Sie den Befehl azsphere device image list-installed , um die Images aufzulisten, die sich derzeit auf dem angefügten Gerät befinden. Notieren Sie sich die Komponenten-ID der erforderlichen Anwendung.