Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Cette référence répertorie les SDK Azure que vous pouvez utiliser pour créer des solutions IoT, notamment des kits SDK d’appareil, de service et de gestion pour les kits sdk de IoT Hub et device Provisioning Service (DPS), les kits SDK en préversion pour la gestion des certificats et les liens vers Azure Digital Twins plan de contrôle et les API de plan de données.
Kits de développement logiciel (SDK) d’appareil
Les sdk d’appareil Microsoft Azure IoT contiennent du code qui facilite la création d’applications qui se connectent et sont gérées par Azure IoT Hub services. Ces kits SDK peuvent s’exécuter sur un appareil basé sur MPU, tel qu’un PC, une tablette, un smartphone ou Raspberry Pi. Les kits SDK prennent en charge le développement en C et dans les langages managés modernes, notamment en C#, Node.js, Python et Java.
Les kits SDK sont disponibles dans plusieurs langages, ce qui vous permet de choisir celui qui convient le mieux à votre équipe et à votre scénario.
| Language | Package | Origine | Démarrages rapides | Échantillons | Référence |
|---|---|---|---|---|---|
| .NET | NuGet | GitHub | Connect à IoT Hub | Samples | Référence |
| Python | pip | GitHub | Connect à IoT Hub | Samples | Référence |
| Node.js | npm | GitHub | Connect à IoT Hub | Samples | Référence |
| Java | Maven | GitHub | Connect à IoT Hub | Samples | Référence |
| C | packages | GitHub | Connect à IoT Hub | Samples | Référence |
Le SDK d’appareil Java inclut samples pour Android.
Le SDK d’appareil C inclut samples pour iOS qui utilisent CocoaPods.
Avertissement
Le sdk C Azure IoT C ne convient pas aux applications incorporées en raison de son modèle de gestion de la mémoire et de thread. Pour consulter les options de Kit de développement logiciel (SDK) d’appareil intégré, reportez-vous aux Kits de développement logiciel (SDK) d’appareils intégrés.
Utilisez les kits SDK d’appareil pour développer du code pour s’exécuter sur des appareils IoT qui se connectent à IoT Hub ou IoT Central.
Kits SDK pour appareil embarqué
Ces kits SDK ont été conçus et créés pour s’exécuter sur des appareils avec des ressources de calcul et de mémoire limitées, et sont implémentés à l’aide du langage C.
Les Kits de développement logiciel (SDK) pour appareils intégrés sont disponibles pour plusieurs systèmes d’exploitation, ce qui vous permet de choisir celui qui convient le mieux à votre scénario.
| RTOS | SDK | Origine | Échantillons | Référence |
|---|---|---|---|---|
| Eclipse ThreadX | intergiciel Azure RTOS | GitHub | Démarrages rapides | Référence |
| FreeRTOS | Middleware FreeRTOS | GitHub | Samples | Référence |
| Métal Nu | Kit de développement logiciel (SDK) Azure pour Embedded C | GitHub | Samples | Référence |
Utilisez les kits SDK d’appareil incorporés pour développer du code pour s’exécuter sur des appareils IoT qui se connectent à IoT Hub ou à IoT Central.
Pour en savoir plus sur l’utilisation des kits SDK d’appareil incorporé, consultez Scénarios d’usage du SDK C et du SDK Embedded C.
Support et cycle de vie des kits SDK d’appareil
Cette section récapitule le cycle de vie du KIT de développement logiciel (SDK) d’appareil Azure IoT et la stratégie de prise en charge. Pour plus d’informations, consultez Kit de développement logiciel (SDK) Azure Politique de support et de cycle de vie.
Cycle de vie des packages
Les packages sont publiés dans les catégories suivantes. Chaque catégorie a une structure de support définie.
Bêta : également appelée préversion ou version finale (RC) Elle est disponible à des fins d’accès anticipé et de commentaires et n’est pas recommandée pour une utilisation en production. La prise en charge de la version préliminaire est limitée à GitHub problèmes. Les préversions sont généralement en cours d’utilisation pendant moins de six mois, après quoi elles sont déconseillées ou publiées comme actives.
Active : disponible pour tous et entièrement prise en charge, reçoit les nouvelles mises à jour des fonctionnalités, ainsi que les correctifs de bogues et de sécurité. Utilisez la dernière version , car cette version reçoit des correctifs et des mises à jour.
Déconseillé : remplacé par une version plus récente. La mise en obsolescence coïncide avec le moment où la nouvelle version devient active. Les versions déconseillées prennent en charge les correctifs de bogues et les correctifs de sécurité les plus critiques pendant 12 mois supplémentaires.
Obtenir du support
Si vous rencontrez des problèmes lors de l’utilisation des sdk Azure IoT, recherchez la prise en charge par le biais des options suivantes :
Reporting bugs : tous les clients peuvent signaler des bogues sur la page des problèmes du référentiel GitHub associé au Kit de développement logiciel (SDK) approprié.
Microsoft équipe du support client : les utilisateurs disposant d’un plan de supportpeuvent impliquer l’équipe du support technique Microsoft en créant un ticket de support directement à partir du< portail Azure/c2>.
Kits de développement logiciel (SDK) de service IoT Hub
Les sdk de service Azure IoT contiennent du code pour faciliter la création d’applications qui interagissent directement avec IoT Hub pour gérer les appareils et la sécurité.
| Plate-forme | Package | Référentiel de code | Échantillons | Référence |
|---|---|---|---|---|
| .NET | NuGet | GitHub | Samples | Référence |
| Java | Maven | GitHub | Samples | Référence |
| Nœud | npm | GitHub | Samples | Référence |
| Python | pip | GitHub | Samples | Référence |
Pour en savoir plus sur l’utilisation des kits sdk de service pour interagir avec les appareils via un hub IoT, consultez IoT Plug-and-Play guide du développeur de services.
Kits de développement logiciel (SDK) de gestion IoT Hub
Les sdk de gestion IoT Hub vous aident à créer des applications back-end qui gèrent les hubs IoT dans votre abonnement Azure.
| Plate-forme | Package | Référentiel de code | Référence |
|---|---|---|---|
| .NET | NuGet | GitHub | Référence |
| Java | Maven | GitHub | Référence |
| Node.JS | npm | GitHub | Référence |
| Python | pip | GitHub | Référence |
Les solutions alternatives aux kits sdk de gestion incluent les kits de développement logiciel (SDK) Azure CLI, PowerShell et l’API REST.
Kits de développement logiciel (SDK) d’appareil DPS
Les kits de développement logiciel (SDK) d’appareil DPS fournissent des implémentations de l’API Register et d’autres que les appareils appellent à approvisionner via DPS. Ces kits SDK d’appareil peuvent s’exécuter sur un appareil basé sur MPU, tel qu’un PC, une tablette, un smartphone ou Raspberry Pi. Les kits SDK prennent en charge le développement en C et dans les langages managés modernes, notamment en C#, Node.js, Python et Java.
Le tableau suivant répertorie les kits SDK d’appareil disponibles pour chaque langue prise en charge.
| Plate-forme | Package | Référentiel de code | Échantillons | Démarrage rapide | Référence |
|---|---|---|---|---|---|
| .NET | NuGet | GitHub | Samples | Démarrage rapide | Référence |
| C | apt-get, MBED, IDE Arduino ou iOS | GitHub | Samples | Démarrage rapide | Référence |
| Java | Maven | GitHub | Samples | Démarrage rapide | Référence |
| Node.JS | npm | GitHub | Samples | Démarrage rapide | Référence |
| Python | pip | GitHub | Samples | Démarrage rapide | Référence |
Avertissement
Le kit SDK C listé ci-dessus ne convient pas aux applications embarquées en raison de son modèle de gestion de thread et de mémoire. Pour les appareils embarqués, reportez-vous aux kits SDK pour appareils embarqués.
Kits SDK d’appareil embarqué DPS
Ces kits SDK ont été conçus et créés pour s’exécuter sur des appareils avec des ressources de calcul et de mémoire limitées, et sont implémentés à l’aide du langage C.
| RTOS | SDK | Origine | Échantillons | Référence |
|---|---|---|---|---|
| Eclipse ThreadX | intergiciel Azure RTOS | GitHub | Démarrages rapides | Référence |
| FreeRTOS | Middleware FreeRTOS | GitHub | Samples | Référence |
| Métal Nu | Kit de développement logiciel (SDK) Azure pour Embedded C | GitHub | Samples | Référence |
En savoir plus sur les kits SDK d’appareil et d’appareil incorporés dans Kits de développement logiciel (SDK) IoT.
Kits de développement logiciel (SDK) de service DPS
Les kits SDK de service DPS vous aident à créer des applications back-end pour gérer les inscriptions et les enregistrements d’inscription dans les instances DPS.
| Plate-forme | Package | Référentiel de code | Échantillons | Démarrage rapide | Référence |
|---|---|---|---|---|---|
| .NET | NuGet | GitHub | Samples | Démarrage rapide | Référence |
| Java | Maven | GitHub | Samples | Démarrage rapide | Référence |
| Node.JS | npm | GitHub | Samples | Démarrage rapide | Référence |
Kits de développement logiciel (SDK) de gestion DPS
Les sdk de gestion DPS vous aident à créer des applications back-end qui gèrent les instances DPS et leurs métadonnées dans votre abonnement Azure.
| Plate-forme | Package | Référentiel de code | Référence |
|---|---|---|---|
| .NET | NuGet | GitHub | Référence |
| Java | Maven | GitHub | Référence |
| Node.JS | npm | GitHub | Référence |
| Python | pip | GitHub | Référence |
Kits de développement logiciel (SDK) de gestion des certificats (préversion)
Pour les kits SDK qui prennent en charge la gestion des certificats X.509 Microsoft en préversion, suivez les instructions et exemples suivants. Pour utiliser les kits SDK de gestion des certificats en préversion, vous devez utiliser Azure IoT Hub avec une instance DPS liée, et les appareils doivent provisionner via DPS.
Kits de développement logiciel (SDK) de l’appareil de gestion des certificats (préversion)
Le tableau suivant répertorie les kits SDK de plateforme qui prennent actuellement en charge la gestion des certificats X.509 soutenu par Microsoft en préversion.
| Language | Package | Source/Branche | Échantillons |
|---|---|---|---|
| .NET | NuGet | Azure/azure-iot-sdk-csharp à feature/iot-csr-preview | CertificateSigningRequestSample |
| Python | pip | Azure/azure-iot-sdk-python à feature/iot-csr-preview | exemples cert-mgmt |
| Node.JS | npm | Non disponible | Non disponible |
| Java | Maven | Azure/azure-iot-sdk-java à feature/csr | certificate-signing-sample |
| C | packages | Azure/azure-iot-sdk-c at feature/dps-csr-preview | iothub_ll_client_sample_certificate_signing_request |
Sdk d’appareils incorporés de gestion des certificats (préversion)
Le tableau suivant répertorie les kits SDK incorporés qui prennent actuellement en charge la gestion des certificats X.509 soutenus par Microsoft en préversion.
| RTOS | SDK | Origine | Échantillons |
|---|---|---|---|
| FreeRTOS | Middleware FreeRTOS | Azure/azure-iot-middleware-freertos at feature/dps-csr-preview | Non disponible |
| Métal Nu | Kit de développement logiciel (SDK) Azure pour Embedded C | Azure/azure-sdk-for-c at feature/dps-csr-preview | paho_iot_hub_csr_sample.c |
API du plan de contrôle Azure Digital Twins
Les API du plan de contrôle sont ARM API utilisées pour gérer votre instance Azure Digital Twins dans son ensemble, afin qu’elles couvrent les opérations telles que la création ou la suppression de votre instance entière. Vous utiliserez également ces API afin de créer et de supprimer des points de terminaison.
Pour appeler directement les API, référencez le dossier Swagger le plus récent dans le dépôt Swagger du plan de contrôle . Ce dossier contient également un dossier d’exemples qui en montrent l’utilisation.
Voici les KITS SDK actuellement disponibles pour les API de plan de contrôle Azure Digital Twins.
| Langage du SDK | Lien du package | Documentation de référence | Code source |
|---|---|---|---|
| .NET (C#) | Azure. ResourceManager.DigitalTwins sur NuGet | Reference pour Azure Kit de développement logiciel (SDK) DigitalTwins pour .NET | bibliothèque de client de gestion Microsoft Azure Digital Twins pour .NET sur GitHub |
| Java | azure-resourcemanager-digitaltwins sur Maven | Référence pour la gestion des ressources - Digital Twins | Azure Resource Manager bibliothèque de client AzureDigitalTwins pour Java sur GitHub |
| JavaScript | Bibliothèque de client AzureDigitalTwinsManagement pour JavaScript sur npm | bibliothèque cliente AzureDigitalTwinsManagement pour JavaScript sur GitHub | |
| Python | azure-mgmt-digitaltwins sur PyPI | Microsoft Kit de développement logiciel (SDK) Azure pour Python sur GitHub | |
| Allez | azure-sdk-for-go/services/digitaltwins/mgmt | Kit de développement logiciel (SDK) Azure pour Go on GitHub |
API de plan de données Azure Digital Twins
Les API de plan de données sont les API Azure Digital Twins utilisées pour gérer les éléments au sein de votre instance de Azure Digital Twins. Elles incluent des opérations telles que la création d’itinéraires, le chargement de modèles, la création de relations et la gestion de jumeaux, lesquelles peuvent être réparties dans les catégories suivantes :
-
DigitalTwinModels- La catégorie DigitalTwinModels contient des API pour gérer les models dans une instance de Azure Digital Twins. Les activités de gestion incluent le chargement, la validation, la récupération et la suppression des modèles créés dans DTDL. -
DigitalTwins- La catégorie DigitalTwins contient les API qui permettent aux développeurs de créer, de modifier et de supprimer des jumeaux digital et leurs relations dans une instance Azure Digital Twins. -
Query- La catégorie Query permet aux développeurs de trouver des jeux de jumeaux numériques dans le graphe jumeau parmi les relations. -
Event Routes- La catégorie Event Routes contient des API permettant d’acheminer des données via le système et vers les services en aval. -
Import Jobs– L’API Import Jobs vous permet de gérer une action asynchrone de longue durée pour importer des modèles, des jumeaux et des relations en bloc. -
Delete Jobs– L’API Delete Jobs vous permet de gérer une action asynchrone de longue durée pour supprimer des modèles, des jumeaux et des relations dans une instance.
Pour appeler directement les API, référencez le dernier dossier Swagger dans le dépôt Swagger du plan data plane Swagger. Ce dossier contient également un dossier d’exemples qui en montrent l’utilisation. Vous pouvez également consulter la documentation de référence de l’API du plan de données.
Voici les KITS SDK actuellement disponibles pour les API de plan de données Azure Digital Twins.
| Langage du SDK | Lien du package | Documentation de référence | Code source |
|---|---|---|---|
| .NET (C#) | Azure. DigitalTwins.Core sur NuGet | Reference pour Azure IoT bibliothèque cliente Digital Twins pour .NET | Azure IoT bibliothèque de client Digital Twins pour .NET sur GitHub |
| Java | com.azure:azure-digitaltwins-core sur Maven | Reference pour Azure Digital Twins SDK pour Java | Azure IoT bibliothèque de client Digital Twins pour Java sur GitHub |
| JavaScript | Azure Azure Digital Twins Bibliothèque cliente principale pour JavaScript sur npm | Reference for @azure/digital-twins-core | bibliothèque cliente Azure Azure Digital Twins Core pour JavaScript sur GitHub |
| Python | bibliothèque de client Azure Azure Digital Twins Core pour Python sur PyPI | Référence pour azure-digitaltwins-core | bibliothèque de client Azure Azure Digital Twins Core pour Python sur GitHub |
Étapes suivantes
Étapes suivantes suggérées :