SDK de IoT de Azure
En las tablas siguientes, se enumeran los distintos SDK que puede usar para compilar soluciones de IoT.
SDK de dispositivo
Los SDK de dispositivos IoT de Microsoft Azure contienen código que facilita la compilación de aplicaciones que se conectan a servicios de Azure IoT Hub y que este administra. Estos SDK se pueden ejecutar en un dispositivo informático general basado en MPU, como un PC, una tablet, un smartphone o una Raspberry Pi. Los SDK admiten el desarrollo en C y en lenguajes administrados modernos, incluidos C#, Node.js, Python y Java.
Los SDK están disponibles en varios idiomas, lo que proporciona flexibilidad para elegir cuál se adapta mejor a su equipo y escenario.
| Idioma | Paquete | Source | Guías de inicio rápido | Ejemplos | Referencia |
|---|---|---|---|---|---|
| .NET | NuGet | GitHub | Conexión a IoT Hub | Muestras | Referencia |
| Python | pip | GitHub | Conexión a IoT Hub | Muestras | Referencia |
| Node.js | npm | GitHub | Conexión a IoT Hub | Muestras | Referencia |
| Java | Maven | GitHub | Conexión a IoT Hub | Muestras | Referencia |
| C | packages | GitHub | Conexión a IoT Hub | Muestras | Referencia |
El SDK de dispositivo Java incluye ejemplos para Android.
El SDK de dispositivo C incluye ejemplos para iOS que usan CocoaPods.
Advertencia
El SDK de C de Azure IoT no es adecuado para su uso con aplicaciones insertadas debido a su administración de memoria y modelo de subprocesos. Para conocer las opciones de SDK de dispositivos insertados, consulte SDK de dispositivos insertados.
Use los SDK de dispositivo para desarrollar código para ejecutarse en dispositivos IoT que se conectan a IoT Hub o IoT Central.
Para más información sobre cómo usar los SDK de dispositivo, consulte ¿Qué es el desarrollo de aplicaciones y dispositivos Azure IoT?.
SDK de dispositivos insertados
Estos SDK se han diseñado y creado para ejecutarse en dispositivos con recursos limitados de proceso y memoria, y se implementan con el lenguaje C.
Los SDK de dispositivos insertados están disponibles para varios sistemas operativos, lo que proporciona flexibilidad al elegir cuál se adapta mejor a su escenario.
| RTOS | SDK | Source | Ejemplos | Referencia |
|---|---|---|---|---|
| Eclipse ThreadX | Middleware de Azure RTOS | GitHub | Guías de inicio rápido | Referencia |
| FreeRTOS | FreeRTOS Middleware | GitHub | Muestras | Referencia |
| Bare Metal | SDK de Azure para C insertado | GitHub | Muestras | Referencia |
Use los SDK de dispositivo insertados para desarrollar código para ejecutarse en dispositivos IoT que se conectan a IoT Hub o IoT Central.
Para más información sobre cuándo usar los SDK de dispositivos insertados, consulte Escenarios de uso del SDK de C y SDK de C insertado.
Ciclo de vida y soporte técnico de SDK del dispositivo
En esta sección resume el ciclo de vida y la directiva de soporte técnico del SDK de dispositivo IoT de Azure. Para más información, consulte Ciclo de vida y directiva de soporte técnico del SDK de Azure.
Ciclo de vida del paquete
Los paquetes se publican en las siguientes categorías. Cada categoría tiene una estructura de compatibilidad definida.
Beta: También conocido como versión preliminar o versión candidata para lanzamiento. Disponible para fines de acceso anticipado y comentarios. Su uso en producción no es recomendable. La compatibilidad con la versión preliminar se limita a los problemas de GitHub. Las versiones preliminares suelen estar activas durante menos de seis meses, pasado ese plazo quedan en desuso o se publican como activas.
Activa: Generalmente disponible y totalmente compatible, recibe nuevas actualizaciones de características, así como correcciones de errores y de seguridad. A los clientes se les recomienda que usen la versión más reciente porque es la versión que recibe correcciones y actualizaciones.
En desuso: Reemplazada por una versión más reciente. Al mismo tiempo que la nueva versión se activa, una versión cambia a "en desuso". Las versiones en desuso abordan las correcciones de errores y correcciones de seguridad más críticas durante 12 meses más.
Obtención de soporte técnico
Si tiene problemas al usar los SDK de Internet de las cosas de Azure, hay varias maneras de buscar soporte técnico:
Informe de errores: Todos los clientes pueden informar errores en la página de problemas del repositorio de GitHub asociado con el SDK pertinente.
Equipo de soporte técnico al cliente de Microsoft: los usuarios que dispongan de un plan de soporte técnico pueden ponerse en contacto con este equipo creando una incidencia de soporte técnico directamente en Azure Portal.
SDK de servicios de IoT Hub
Los SDK de servicios IoT de Azure contienen código que facilitan la creación de aplicaciones que interactúan directamente con IoT Hub para administrar dispositivos y seguridad.
| Plataforma | Paquete | Repositorio de código | Ejemplos | Referencia |
|---|---|---|---|---|
| .NET | NuGet | GitHub | Muestras | Referencia |
| Java | Maven | GitHub | Muestras | Referencia |
| Nodo | npm | GitHub | Muestras | Referencia |
| Python | pip | GitHub | Muestras | Referencia |
Para más información sobre el uso de los SDK de servicio para interactuar con dispositivos a través de un centro de IoT, consulte la guía para desarrolladores del servicio IoT Plug and Play.
SDK de administración de IoT Hub
Los SDK de administración de IoT Hub ayudan a crear aplicaciones de back-end que administran los centros de IoT en la suscripción de Azure.
| Plataforma | Paquete | Repositorio de código | Referencia |
|---|---|---|---|
| .NET | NuGet | GitHub | Referencia |
| Java | Maven | GitHub | Referencia |
| Node.js | npm | GitHub | Referencia |
| Python | pip | GitHub | Referencia |
Entre las alternativas a los SDK de administración, se incluyen la CLI de Azure, PowerShell y la API de REST.
SDK de dispositivo de DPS
Los SDK de dispositivo de DPS proporcionan implementaciones de la API Register y otras que los dispositivos llaman para el aprovisionamiento a través de DPS. Estos SDK de dispositivo se pueden ejecutar en dispositivos informáticos generales basados en MPU, como PC, tabletas, smartphones o Raspberry Pi. Los SDK admiten el desarrollo en C y en lenguajes administrados modernos, incluidos C#, Node.js, Python y Java.
| Plataforma | Paquete | Repositorio de código | Ejemplos | Inicio rápido | Referencia |
|---|---|---|---|---|---|
| .NET | NuGet | GitHub | Muestras | Inicio rápido | Referencia |
| C | apt-get, MBED, Arduino IDE o iOS | GitHub | Muestras | Inicio rápido | Referencia |
| Java | Maven | GitHub | Muestras | Inicio rápido | Referencia |
| Node.js | npm | GitHub | Muestras | Inicio rápido | Referencia |
| Python | pip | GitHub | Muestras | Inicio rápido | Referencia |
Advertencia
El SDK de C mencionado anteriormente no es adecuado para las aplicaciones insertadas debido a su modelo de administración de memoria y subprocesos. Para los dispositivos insertados, consulte SDK de dispositivos insertados.
SDK de dispositivos insertados de DPS
Estos SDK se han diseñado y creado para ejecutarse en dispositivos con recursos limitados de proceso y memoria, y se implementan con el lenguaje C.
| RTOS | SDK | Source | Ejemplos | Referencia |
|---|---|---|---|---|
| Eclipse ThreadX | Middleware de Azure RTOS | GitHub | Guías de inicio rápido | Referencia |
| FreeRTOS | FreeRTOS Middleware | GitHub | Muestras | Referencia |
| Bare Metal | SDK de Azure para C insertado | GitHub | Muestras | Referencia |
Obtenga más información sobre los SDK de dispositivo y de dispositivo insertado en SDK de IoT.
SDK de servicio de DPS
Los SDK de servicio de DPS facilitan la creación de aplicaciones de back-end para administrar inscripciones y entradas de registro en instancias de DPS.
| Plataforma | Paquete | Repositorio de código | Ejemplos | Inicio rápido | Referencia |
|---|---|---|---|---|---|
| .NET | NuGet | GitHub | Muestras | Inicio rápido | Referencia |
| Java | Maven | GitHub | Muestras | Inicio rápido | Referencia |
| Node.js | npm | GitHub | Muestras | Inicio rápido | Referencia |
SDK de administración de DPS
Los SDK de administración de DPS facilitan la creación de aplicaciones de back-end que administran las instancias de DPS y sus metadatos en una suscripción de Azure.
| Plataforma | Paquete | Repositorio de código | Referencia |
|---|---|---|---|
| .NET | NuGet | GitHub | Referencia |
| Java | Maven | GitHub | Referencia |
| Node.js | npm | GitHub | Referencia |
| Python | pip | GitHub | Referencia |
API del plano de control de Azure Digital Twins
Las API del plano de control son las API de ARM que se usan para administrar la instancia de Azure Digital Twins como un todo, por lo que cubren operaciones como la creación o eliminación de toda la instancia. También usará estas API para crear y eliminar puntos de conexión.
Para llamar a las API directamente, haga referencia a la carpeta de Swagger más reciente en la repositorio de Swagger del plano de control. Esta carpeta también incluye una carpeta de ejemplos que muestran el uso.
Estos son los SDK disponibles actualmente para las API del plano de control de Azure Digital Twins.
API del plano de datos de Azure Digital Twins
Las API de plano de datos son las API de Azure Digital Twins que se usan para administrar los elementos de la instancia de Azure Digital Twins. Incluyen operaciones como la creación de rutas, la carga de modelos, la creación de relaciones y la administración de gemelos, y se pueden dividir ampliamente en las categorías siguientes:
DigitalTwinModels: la categoría DigitalTwinModels contiene API para administrar los modelos en una instancia de Azure Digital Twins. Las actividades de administración incluyen la carga, validación, recuperación y eliminación de modelos creados en DTDL.DigitalTwins: la categoría DigitalTwins contiene API que permiten a los desarrolladores crear, modificar y eliminar gemelos digitales y sus relaciones en una instancia de Azure Digital Twins.Query: la categoría Query permite a los desarrolladores localizar conjuntos de gemelos digitales en el grafo de gemelos entre las relaciones.Event Routes: la categoría Event Routes contiene API para enrutar datos por todo el sistema y hacia servicios de bajada.Import Jobs: La API Import Jobs permite administrar una acción asincrónica de larga duración para importar modelos, gemelos y relaciones de forma masiva.Delete Jobs- La API Delete Jobs le permite administrar una acción asincrónica de larga duración para eliminar todos los modelos, gemelos y relaciones de una instancia.
Para llamar a las API directamente, haga referencia a la carpeta de Swagger más reciente en la repositorio de Swagger del plano de datos. Esta carpeta también incluye una carpeta de ejemplos que muestran el uso. También puede consultar la documentación de referencia de API del plano de datos.
Estos son los SDK disponibles actualmente para las API del plano de datos de Azure Digital Twins.
Pasos siguientes
Entre los siguientes pasos sugeridos, se incluyen: