SDKs do Azure IoT

As tabelas a seguir listam os vários SDKs que você pode usar para criar soluções de IoT.

SDKs de dispositivo

Os SDKs de dispositivo IoT do Microsoft Azure contêm código que facilita a criação de aplicativos que se conectam e são gerenciados pelos serviços do Hub IoT do Azure. Esses SDKs podem ser executados em um dispositivo de computação geral baseado em MPU, como um PC, tablet, smartphone ou Raspberry Pi. Os SDKs suportam o desenvolvimento em C e em linguagens gerenciadas modernas, incluindo em C#, Node.JS, Python e Java.

Os SDKs estão disponíveis em vários idiomas , oferecendo a flexibilidade de escolher o que melhor se adapta à sua equipe e cenário.

Idioma Pacote Origem Guias de Início Rápido Exemplos Referência
.NET NuGet GitHub Conectar-se ao Hub IoT Amostras Referência
Python pip GitHub Conectar-se ao Hub IoT Amostras Referência
Node.js npm  GitHub Conectar-se ao Hub IoT Amostras Referência
Java Maven GitHub Conectar-se ao Hub IoT Amostras Referência
C Pacotes GitHub Conectar-se ao Hub IoT Amostras Referência

O SDK do dispositivo Java inclui exemplos para Android.

O SDK do dispositivo C inclui exemplos para iOS que usam CocoaPods.

Aviso

O Azure IoT C SDK não é adequado para aplicativos incorporados devido ao seu modelo de gerenciamento de memória e threading. Para obter opções de SDK de dispositivo incorporado, consulte os SDKs de dispositivo incorporado.

Use os SDKs de dispositivo para desenvolver código a ser executado em dispositivos IoT que se conectam ao Hub IoT ou ao IoT Central.

Para saber mais sobre como usar os SDKs de dispositivo, consulte O que é o desenvolvimento de dispositivos e aplicativos do Azure IoT?.

SDKs de dispositivos incorporados

Esses SDKs foram projetados e criados para serem executados em dispositivos com recursos limitados de computação e memória e são implementados usando a linguagem C.

Os SDKs de dispositivos incorporados estão disponíveis para vários sistemas operacionais, oferecendo a flexibilidade de escolher o que melhor se adapta ao seu cenário.

RTOS SDK Origem Exemplos Referência
Eclipse ThreadX Azure RTOS Middleware GitHub Inícios rápidos Referência
FreeRTOS FreeRTOS Middleware GitHub Amostras Referência
Metal nu SDK do Azure para C incorporado GitHub Amostras Referência

Use os SDKs de dispositivo incorporado para desenvolver código a ser executado em dispositivos IoT que se conectam ao Hub IoT ou ao IoT Central.

Para saber mais sobre quando usar os SDKs de dispositivo incorporado, consulte Cenários de uso do C SDK e do Embedded C SDK.

Ciclo de vida e suporte do SDK do dispositivo

Esta seção resume o ciclo de vida e a política de suporte do SDK do Dispositivo IoT do Azure. Para obter mais informações, consulte Ciclo de vida e política de suporte do SDK do Azure.

Ciclo de vida do pacote

Os pacotes são lançados nas seguintes categorias. Cada categoria tem uma estrutura de apoio definida.

  1. Beta - Também conhecido como Preview ou Release Candidate. Disponível para acesso antecipado e feedback e não é recomendado para uso em produção. O suporte à versão de visualização é limitado a problemas do GitHub. As versões de visualização normalmente permanecem ativas por menos de seis meses, após os quais são preteridas ou lançadas como ativas.

  2. Ativo - Geralmente disponível e totalmente suportado, recebe novas atualizações de recursos, bem como correções de bugs e segurança. Recomendamos que os clientes usem a versão mais recente porque essa versão recebe correções e atualizações.

  3. Preterido - Substituído por uma versão mais recente. A preterição ocorre ao mesmo tempo em que a nova versão fica ativa. As versões preteridas abordam as correções de bugs e correções de segurança mais críticas por mais 12 meses.

Obter suporte

Se você tiver problemas ao usar os SDKs do Azure IoT, há várias maneiras de buscar suporte:

  • Relatar bugs - Todos os clientes podem relatar bugs na página de problemas do repositório GitHub associado ao SDK relevante.

  • Equipe de Suporte ao Cliente Microsoft - Os usuários que têm um plano de suporte podem envolver a equipe de Suporte ao Cliente Microsoft criando um tíquete de suporte diretamente do portal do Azure.

SDKs de serviço do Hub IoT

Os SDKs do serviço IoT do Azure contêm código para facilitar a criação de aplicativos que interagem diretamente com o Hub IoT para gerenciar dispositivos e segurança.

Plataforma Pacote Repositório de Código Exemplos Referência
.NET NuGet GitHub Amostras Referência
Java Maven GitHub Amostras Referência
npm GitHub Amostras Referência
Python pip GitHub Amostras Referência

Para saber mais sobre como usar os SDKs de serviço para interagir com dispositivos por meio de um hub IoT, consulte Guia do desenvolvedor do serviço IoT Plug and Play.

SDKs de gerenciamento do Hub IoT

Os SDKs de gerenciamento do Hub IoT ajudam você a criar aplicativos de back-end que gerenciam os hubs IoT em sua assinatura do Azure.

Plataforma Pacote Repositório de código Referência
.NET NuGet GitHub Referência
Java Maven GitHub Referência
Node.js npm GitHub Referência
Python pip GitHub Referência

As alternativas aos SDKs de gerenciamento incluem a CLI do Azure, o PowerShell e a API REST.

SDKs de dispositivo DPS

Os SDKs de dispositivo DPS fornecem implementações da API de registro e outras que os dispositivos chamam para provisionar por meio do DPS. Os SDKs de dispositivo podem ser executados em dispositivos de computação baseados em MPU em geral, como um PC, tablet, smartphone ou Raspberry Pi. Os SDKs suportam o desenvolvimento em C e em linguagens gerenciadas modernas, incluindo em C#, Node.JS, Python e Java.

Plataforma Pacote Repositório de código Exemplos Início Rápido Referência
.NET NuGet GitHub Amostras Início rápido Referência
C apt-get, MBED, Arduino IDE ou iOS GitHub Amostras Início rápido Referência
Java Maven GitHub Amostras Início rápido Referência
Node.js npm GitHub Amostras Início rápido Referência
Python pip GitHub Amostras Início rápido Referência

Aviso

O C SDK listado acima não é adequado para aplicativos incorporados devido ao seu modelo de gerenciamento de memória e threading. Para dispositivos incorporados, consulte os SDKs de dispositivo incorporado.

SDKs de dispositivos incorporados DPS

Esses SDKs foram projetados e criados para serem executados em dispositivos com recursos limitados de computação e memória e são implementados usando a linguagem C.

RTOS SDK Origem Exemplos Referência
Eclipse ThreadX Azure RTOS Middleware GitHub Inícios rápidos Referência
FreeRTOS FreeRTOS Middleware GitHub Amostras Referência
Metal nu SDK do Azure para C incorporado GitHub Amostras Referência

Saiba mais sobre os SDKs de dispositivo e dispositivo incorporado em SDKs de IoT.

SDKs de serviço DPS

Os SDKs de serviço DPS ajudam a criar aplicativos de back-end para gerenciar registros e registros de registro em instâncias DPS.

Plataforma Pacote Repositório de código Exemplos Início Rápido Referência
.NET NuGet GitHub Amostras Início rápido Referência
Java Maven GitHub Amostras Início rápido Referência
Node.js npm GitHub Amostras Início rápido Referência

SDKs de gerenciamento DPS

Os SDKs de gerenciamento de DPS ajudam você a criar aplicativos de back-end que gerenciam as instâncias do DPS e seus metadados em sua assinatura do Azure.

Plataforma Pacote Repositório de código Referência
.NET NuGet GitHub Referência
Java Maven GitHub Referência
Node.js npm GitHub Referência
Python pip GitHub Referência

APIs do plano de controle do Azure Digital Twins

As APIs do plano de controle são APIs ARM usadas para gerenciar sua instância do Azure Digital Twins como um todo, portanto, abrangem operações como criar ou excluir toda a instância. Você também usará essas APIs para criar e excluir pontos de extremidade.

Para chamar as APIs diretamente, consulte a pasta Swagger mais recente no repositório Swagger do plano de controle. Esta pasta também inclui uma pasta de exemplos que mostram o uso.

Aqui estão os SDKs atualmente disponíveis para as APIs do plano de controle do Azure Digital Twins.

Idioma do SDK Link do pacote Documentação de referência Código fonte
.NET (C#) Azure.ResourceManager.DigitalTwins no NuGet Referência para o SDK do Azure DigitalTwins para .NET Biblioteca de cliente de gerenciamento do Microsoft Azure Digital Twins para .NET no GitHub
Java azure-resourcemanager-digitaltwins no Maven Referência para Gestão de Recursos - Digital Twins Biblioteca de cliente AzureDigitalTwins do Azure Resource Manager para Java no GitHub
JavaScript Biblioteca de cliente AzureDigitalTwinsManagement para JavaScript no npm Biblioteca de cliente AzureDigitalTwinsManagement para JavaScript no GitHub
Python azure-mgmt-digitaltwins no PyPI SDK do Microsoft Azure para Python no GitHub
Go azure-sdk-for-go/services/digitaltwins/mgmt SDK do Azure para Go no GitHub

APIs do plano de dados do Azure Digital Twins

As APIs do plano de dados são as APIs do Azure Digital Twins usadas para gerenciar os elementos em sua instância do Azure Digital Twins. Eles incluem operações como criar rotas, carregar modelos, criar relacionamentos e gerenciar gêmeos, e podem ser divididos nas seguintes categorias:

  • DigitalTwinModels - A categoria DigitalTwinModels contém APIs para gerenciar os modelos em uma instância do Azure Digital Twins. As atividades de gerenciamento incluem upload, validação, recuperação e exclusão de modelos criados na DTDL.
  • DigitalTwins - A categoria DigitalTwins contém as APIs que permitem aos desenvolvedores criar, modificar e excluir gêmeos digitais e seus relacionamentos em uma instância do Azure Digital Twins.
  • Query - A categoria Consulta permite que os desenvolvedores encontrem conjuntos de gêmeos digitais no gráfico de gêmeos entre relacionamentos.
  • Event Routes - A categoria Rotas de Eventos contém APIs para rotear dados, através do sistema e para serviços downstream.
  • Import Jobs - A API de Trabalhos de Importação permite gerenciar uma ação assíncrona de longa duração para importar modelos, gêmeos e relacionamentos em massa.
  • Delete Jobs - A API Delete Jobs permite gerenciar uma ação assíncrona de longa duração para excluir todos os modelos, gêmeos e relacionamentos em uma instância.

Para chamar as APIs diretamente, faça referência à pasta Swagger mais recente no repositório Swagger do plano de dados. Esta pasta também inclui uma pasta de exemplos que mostram o uso. Você também pode visualizar a documentação de referência da API do plano de dados.

Aqui estão os SDKs atualmente disponíveis para as APIs do plano de dados do Azure Digital Twins.

Idioma do SDK Link do pacote Documentação de referência Código fonte
.NET (C#) Azure.DigitalTwins.Core no NuGet Referência para a biblioteca de cliente do Azure IoT Digital Twins para .NET Biblioteca de cliente do Azure IoT Digital Twins para .NET no GitHub
Java com.azure:azure-digitaltwins-core no Maven Referência para o SDK do Azure Digital Twins para Java Biblioteca de cliente do Azure IoT Digital Twins para Java no GitHub
JavaScript Biblioteca de cliente do Azure Azure Digital Twins Core para JavaScript no npm Reference for @azure/digital-twins-core Biblioteca de cliente do Azure Azure Digital Twins Core para JavaScript no GitHub
Python Biblioteca de cliente do Azure Azure Digital Twins Core para Python no PyPI Referência para azure-digitaltwins-core Biblioteca de cliente do Azure Azure Digital Twins Core para Python no GitHub

Próximos passos

As próximas etapas sugeridas incluem: