Azure IoT SDKs
In den folgenden Tabellen sind die verschiedenen SDKs aufgeführt, die Sie zum Erstellen von IoT-Lösungen verwenden können.
Geräte-SDKs
Die Microsoft Azure IoT-Geräte-SDKs enthalten Code, der das Erstellen von Anwendungen erleichtert, die eine Verbindung mit Azure IoT Hub-Diensten herstellen und von ihnen verwaltet werden. Diese SDKs können auf einem allgemeinen MPU-basierten Computergerät wie einem PC, Tablet, Smartphone oder Raspberry Pi ausgeführt werden. Die SDKs unterstützen die Entwicklung in C sowie in modernen verwalteten Sprachen wie C#, Node.js, Python und Java.
Die SDKs sind in mehreren Sprachen verfügbar, sodass Sie sich flexibel für das SDK entscheiden können, das für Ihr Team und Ihr Szenario am besten geeignet ist.
| Sprache | Paket | `Source` | Schnellstarts | Beispiele | Verweis |
|---|---|---|---|---|---|
| .NET | NuGet | GitHub | Herstellen einer Verbindung mit IoT Hub | Beispiele | Referenz |
| Python | pip | GitHub | Herstellen einer Verbindung mit IoT Hub | Beispiele | Referenz |
| Node.js | npm | GitHub | Herstellen einer Verbindung mit IoT Hub | Beispiele | Referenz |
| Java | Maven | GitHub | Herstellen einer Verbindung mit IoT Hub | Beispiele | Referenz |
| C | packages | GitHub | Herstellen einer Verbindung mit IoT Hub | Beispiele | Referenz |
Das Java-Geräte-SDK enthält Beispiele für Android.
Das C-Geräte-SDK enthält Beispiele für iOS, die CocoaPods verwenden.
Warnung
Das Azure IoT-C-SDK ist aufgrund seines Speicherverwaltungs- und Threadingmodells für eingebettete Anwendungen nicht geeignet. SDK-Optionen für eingebettete Geräte finden Sie unter den SDKs für eingebettete Geräte.
Verwenden Sie die Geräte-SDKs, um Code für die Ausführung auf IoT-Geräten zu entwickeln, die eine Verbindung mit IoT Hub oder IoT Central herstellen.
Informationen zur Verwendung der Geräte-SDKs finden Sie unter Worum handelt es sich bei der Entwicklung von Azure IoT-Geräten und -Anwendungen?.
SDKs für eingebettete Geräte
Diese SDKs wurden für die Ausführung auf Geräten mit begrenzten Compute- und Arbeitsspeicherressourcen entwickelt und erstellt und werden mit der Programmiersprache C implementiert.
Die SDKs für eingebettete Geräte sind bei mehreren Betriebssystemen verfügbar, sodass Sie sich flexibel für das SDK entscheiden können, das für Ihr Szenario am besten geeignet ist.
| RTOS | SDK | `Source` | Beispiele | Verweis |
|---|---|---|---|---|
| Eclipse ThreadX | Azure RTOS-Middleware | GitHub | Schnellstarts | Referenz |
| FreeRTOS | FreeRTOS-Middleware | GitHub | Beispiele | Referenz |
| Bare Metal | Azure SDK für Embedded C | GitHub | Beispiele | Referenz |
Verwenden Sie die eingebetteten Geräte-SDKs, um Code für die Ausführung auf IoT-Geräten zu entwickeln, die eine Verbindung mit IoT Hub oder IoT Central herstellen.
Weitere Informationen zur Verwendung der eingebetteten Geräte-SDKs finden Sie in den Nutzungsszenarien für das C SDK und Embedded C SDK.
Lebenszyklus und Support für Geräte-SDKs
In diesem Abschnitt wird die Lebenszyklus- und Support-Richtlinie des Azure IoT-Geräte-SDKs beschrieben. Weitere Informationen finden Sie in der Lebenszyklus- und Support-Richtlinie des Azure-SDKs.
Paketlebenszyklus
Pakete werden in den folgenden Kategorien veröffentlicht. Jede Kategorie verfügt über eine definierte Unterstützungsstruktur.
Beta – Auch bekannt als Vorschau oder Release Candidate. Ist für den frühzeitigen Zugriff und Feedback verfügbar, und wird nicht für die Verwendung in der Produktion empfohlen. Der Support der Vorschauversion ist auf GitHub-Probleme beschränkt. Vorschauversionen sind in der Regel weniger als sechs Monate live, danach sind sie entweder veraltet oder werden als aktiv veröffentlicht.
Aktiv – Allgemein verfügbar und vollständig unterstützt, erhält neue Featureupdates sowie Fehlerkorrekturen und Sicherheits-Patches. Es wird empfohlen, dass Kunden die neueste Version verwenden, da diese Version Korrekturen und Updates erhält.
Veraltet – Ersetzt durch eine neuere Version. Die Unterstützung wird eingestellt, wenn die neue Version aktiv wird. Veraltete Versionen behandeln die kritischsten Fehlerkorrekturen und Sicherheits-Patches für weitere 12 Monate.
Support
Wenn bei der Verwendung der Azure IoT-SDKs Probleme auftreten, gibt es mehrere Möglichkeiten, um Support zu erhalten:
Melden von Fehlern – Alle Kunden können Fehler auf der Problemseite für das GitHub-Repository melden, das dem entsprechenden SDK zugeordnet ist.
Microsoft-Kundendienstteam: Benutzer mit einem Supportplan können direkt über das Azure-Portal ein Supportticket erstellen, um sich an das Microsoft-Kundendienstteam zu wenden.
IoT Hub-Dienst-SDKs
Die Azure IoT-Dienst-SDKs enthalten Code zum Erstellen von Anwendungen, die direkt mit IoT Hub interagieren, um Geräte und Sicherheit zu verwalten.
| Plattform | Paket | Coderepository | Beispiele | Verweis |
|---|---|---|---|---|
| .NET | NuGet | GitHub | Beispiele | Referenz |
| Java | Maven | GitHub | Beispiele | Referenz |
| Node | npm | GitHub | Beispiele | Referenz |
| Python | pip | GitHub | Beispiele | Referenz |
Weitere Informationen zur Verwendung der Dienst-SDKs für die Interaktion mit Geräten über einen IoT-Hub finden Sie im Leitfaden für IoT Plug & Play-Dienstentwickler.
IoT Hub-Verwaltungs-SDKs
Die IoT Hub-Verwaltungs-SDKs helfen Ihnen beim Erstellen von Back-End-Anwendungen zum Verwalten der IoT-Hubs in Ihrem Azure-Abonnement.
| Plattform | Paket | Coderepository | Verweis |
|---|---|---|---|
| .NET | NuGet | GitHub | Referenz |
| Java | Maven | GitHub | Referenz |
| Node.js | npm | GitHub | Referenz |
| Python | pip | GitHub | Referenz |
Alternativen zu den Verwaltungs-SDKs sind die Azure CLI, PowerShellund REST-API.
DPS-SDKs für Geräte
Die DPS-Geräte-SDKs stellen Implementierungen der Register-API und anderer bereit, die Geräte zur Bereitstellung über DPS aufrufen. Die Geräte-SDKs können auf allgemeinen MPU-basierten Computergeräten wie PCs, Tablets, Smartphones oder Raspberry Pi ausgeführt werden. Die SDKs unterstützen die Entwicklung in C sowie in modernen verwalteten Sprachen wie C#, Node.js, Python und Java.
| Plattform | Paket | Coderepository | Beispiele | Schnellstart | Verweis |
|---|---|---|---|---|---|
| .NET | NuGet | GitHub | Beispiele | Schnellstart | Referenz |
| C | apt-get, MBED, Arduino IDE oder iOS | GitHub | Beispiele | Schnellstart | Referenz |
| Java | Maven | GitHub | Beispiele | Schnellstart | Referenz |
| Node.js | npm | GitHub | Beispiele | Schnellstart | Referenz |
| Python | pip | GitHub | Beispiele | Schnellstart | Referenz |
Warnung
Das oben angegebene C SDK ist aufgrund seines Speicherverwaltungs- und Threadingmodells nicht für eingebettete Anwendungen geeignet. Informationen für eingebettete Geräte finden Sie unter SDKs für eingebettete Geräte.
SDKs für eingebettete DPS-Geräte
Diese SDKs wurden für die Ausführung auf Geräten mit begrenzten Compute- und Arbeitsspeicherressourcen entwickelt und erstellt und werden mit der Programmiersprache C implementiert.
| RTOS | SDK | `Source` | Beispiele | Verweis |
|---|---|---|---|---|
| Eclipse ThreadX | Azure RTOS-Middleware | GitHub | Schnellstarts | Referenz |
| FreeRTOS | FreeRTOS-Middleware | GitHub | Beispiele | Referenz |
| Bare Metal | Azure SDK für Embedded C | GitHub | Beispiele | Referenz |
Erfahren Sie mehr über die Geräte- und eingebetteten Geräte-SDKs in IoT-SDKs.
DPS-SDKs für Dienste
Die DPS-Dienst-SDKs helfen Ihnen beim Erstellen von Back-End-Anwendungen zum Verwalten von Registrierungen und Registrierungs-Datensätzen in DPS-Instanzen.
| Plattform | Paket | Coderepository | Beispiele | Schnellstart | Verweis |
|---|---|---|---|---|---|
| .NET | NuGet | GitHub | Beispiele | Schnellstart | Referenz |
| Java | Maven | GitHub | Beispiele | Schnellstart | Referenz |
| Node.js | npm | GitHub | Beispiele | Schnellstart | Referenz |
DPS-SDKs für die Verwaltung
Die DPS-Verwaltungs-SDKs helfen Ihnen beim Erstellen von Back-End-Anwendungen, die die DPS-Instanzen und ihre Metadaten in Ihrem Azure-Abonnement verwalten.
| Plattform | Paket | Coderepository | Verweis |
|---|---|---|---|
| .NET | NuGet | GitHub | Referenz |
| Java | Maven | GitHub | Referenz |
| Node.js | npm | GitHub | Referenz |
| Python | pip | GitHub | Referenz |
APIs für die Azure Digital Twins-Steuerungsebene
Bei den Steuerungsebenen-APIs handelt es sich um ARM-APIs, die verwendet werden, um Ihre Azure Digital Twins-Instanz als Ganzes zu verwalten, sodass sie Vorgänge wie das Erstellen oder Löschen Ihrer gesamten Instanz abdecken. Sie werden diese APIs auch zum Erstellen und Löschen von Endpunkten verwenden.
Um die APIs direkt aufzurufen, verweisen Sie auf den neuesten Swagger-Ordner im Swagger-Repository der Steuerungsebene. Dieser Ordner enthält auch einen Ordner mit Beispielen, die die Verwendung veranschaulichen.
Hier finden Sie die SDKs, die derzeit für die Azure Digital Twins-Steuerungsebenen-APIs verfügbar sind.
Azure Digital Twins-Datenebenen-APIs
Bei den Datenebenen-APIs handelt es sich um die Azure Digital Twins-APIs, die verwendet werden, um die Elemente innerhalb Ihrer Azure Digital Twins-Instanz zu verwalten. Dazu gehören Vorgänge wie das Erstellen von Routen, das Hochladen von Modellen, das Erstellen von Beziehungen und das Verwalten von Zwillingen. Sie können ganz allgemein in die folgenden Kategorien unterteilt werden:
DigitalTwinModels: Die Kategorie „DigitalTwinModels“ enthält APIs zum Verwalten der Modelle in einer Azure Digital Twins-Instanz. Zu den Verwaltungsaktivitäten gehören das Hochladen, Überprüfen, Abrufen und Löschen von Modellen, die in DTDL erstellt wurden.DigitalTwins: Die Kategorie „DigitalTwins“ enthält die APIs, mit denen Entwickler digitale Zwillinge und ihre Beziehungen in einer Azure Digital Twins-Instanz erstellen, ändern und löschen können.Query: Die Kategorie „Query“ ermöglicht es Entwicklern, Gruppen von digitalen Zwillingen im Zwillingsgraphen beziehungsübergreifend zu finden.Event Routes: Die Kategorie „Event Routes“ enthält APIs zur Weiterleitung von Daten, durch das System und zu Downstreamdiensten.Import Jobs– Mit der Import Jobs-API können Sie eine zeitintensive, asynchrone Aktion zum Bulk-Importieren von Modellen, Zwillingen und Beziehungen verwalten.Delete Jobs– Mit der Delete Jobs-API können Sie eine zeitintensive, asynchrone Aktion zum Löschen aller Modelle, Zwillinge und Beziehungen in einer Instanz verwalten.
Um die APIs direkt aufzurufen, verweisen Sie auf den neuesten Swagger-Ordner im Swagger-Repository der Datenebene. Dieser Ordner enthält auch einen Ordner mit Beispielen, die die Verwendung veranschaulichen. Sie können auch die Referenzdokumentation zur Datenebenen-API anzeigen.
Hier finden Sie die SDKs, die derzeit für die Azure Digital Twins-Datenebenen-APIs verfügbar sind.
Nächste Schritte
Beispiele für empfohlene nächste Schritte: