Compartilhar via


SDKs do Azure IoT

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

SDKs de dispositivo

Os SDKs de dispositivos IoT do Microsoft Azure contêm códigos que facilitam 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 baseado em MPU geral, como um pc, tablet, smartphone ou Raspberry Pi. Os SDKs oferecem suporte ao desenvolvimento em C e em linguagens gerenciadas modernas, incluindo C#, Node.js, Python e Java.

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

Linguagem Pacote Fonte Inícios rápidos Exemplos Referência
.NET NuGet GitHub Conectar ao Hub IoT Amostras Referência
Python pip GitHub Conectar ao Hub IoT Amostras Referência
Node.js npm  GitHub Conectar ao Hub IoT Amostras Referência
Java Maven GitHub Conectar ao Hub IoT Amostras Referência
C pacotes GitHub Conectar 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 SDK do C para a Internet das Coisas do Azure, devido ao modelo de threading e ao gerenciamento de memória dele, não é adequado para aplicativos inseridos. Para opções do SDK de dispositivos inseridos, veja os SDKs de dispositivos inseridos.

Use os SDKs do dispositivo para desenvolver código para executar em dispositivos do IoT que se conectam ao Hub IoT ou ao IoT Central.

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

SDKs de dispositivos inseridos

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

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

RTOS . Fonte Exemplos Referência
Eclipse ThreadX Middleware do Azure RTOS GitHub Inícios Rápidos Referência
FreeRTOS Middleware FreeRTOS GitHub Amostras Referência
Bare-metal SDK do Azure para C inserido GitHub Amostras Referência

Use os SDKs do dispositivo inserido para desenvolver código para executar em dispositivos IoT que se conectam ao Hub IoT ou ao IoT Central.

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

Ciclo de vida e suporte de SDK do dispositivo

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

Ciclo de vida do pacote

Os pacotes são lançados nas categorias a seguir. Cada categoria tem uma estrutura de suporte definida.

  1. Beta – Também conhecido como Versão Prévia ou Release Candidate. Disponível para fins de acesso antecipado e comentários e não é recomendado para uso em produção. O suporte à versão prévia é limitado a problemas do GitHub. As versões prévias normalmente ficam ativas por menos de seis meses. Após disso são preteridas ou lançadas como ativas.

  2. Ativa – Geralmente disponível e totalmente compatível, 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. Preterida – substituído por uma versão mais recente. A substituição ocorre ao mesmo tempo em que a nova versão se torna 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 o serviço de SDKs de Internet das Coisas do Azure, há várias maneiras de buscar o suporte:

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

  • Equipe de suporte ao cliente Microsoft – Usuários que tenham um plano de suporte podem acionar a equipe de suporte ao cliente Microsoft, criando um tíquete de suporte diretamente no portal do Azure.

SDKs do serviço de Hub IoT

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

Plataforma Pacote Repositório de códigos 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 do 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ódigos Referência
.NET NuGet GitHub Referência
Java Maven GitHub Referência
Node.js npm GitHub Referência
Python pip GitHub Referência

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

SDKs de dispositivo do Serviço de Provisionamento de Dispositivos

Os SDKs de dispositivo do 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 baseado em MPU gerais, como um pc, tablet, smartphone ou Raspberry Pi. Os SDKs oferecem suporte ao desenvolvimento em C e em linguagens gerenciadas modernas, incluindo C#, Node.js, Python e Java.

Plataforma Pacote Repositório de códigos 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 SDK do C listado acima, devido ao modelo de threading e ao gerenciamento de memória dele, não é adequado para aplicativos inseridos. Para dispositivos inseridos, confira os SDKs de dispositivos inseridos.

SDKs de dispositivos incorporados DPS

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

RTOS . Fonte Exemplos Referência
Eclipse ThreadX Middleware do Azure RTOS GitHub Inícios Rápidos Referência
FreeRTOS Middleware FreeRTOS GitHub Amostras Referência
Bare-metal SDK do Azure para C inserido GitHub Amostras Referência

Saiba mais sobre os SDKs do dispositivo e do dispositivo inserido em SDKs de IoT.

SDKs de serviço do Serviço de Provisionamento de Dispositivos

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

Plataforma Pacote Repositório de códigos 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 do Serviço de Provisionamento de Dispositivos

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ódigos Referência
.NET NuGet GitHub Referência
Java Maven GitHub Referência
Node.js npm GitHub Referência
Python pip GitHub Referência

APIs de plano de controle dos Gêmeos Digitais do Azure

As APIs de painel de controle são APIs do ARM usadas para gerenciar sua instância dos Gêmeos Digitais do Azure como um todo, de modo que englobam operações como criar e excluir toda a sua instância. Você também usará essas APIs para criar e excluir pontos de extremidade.

Para chamar as APIs diretamente, referencie a pasta mais recente do Swagger no repositório Swagger do painel de controle. Essa pasta também inclui outra pasta de exemplos de uso.

Aqui estão os SDKs atualmente disponíveis para as APIs de plano de controle dos Gêmeos Digitais do Azure.

Linguagem do SDK Link de pacote Documentação de referência Código-fonte
.NET (C#) Azure.ResourceManager.DigitalTwins no NuGet Referência ao SDK do Azure DigitalTwins para .NET Biblioteca de clientes de gerenciamento dos Gêmeos Digitais do Microsoft Azure para .NET no GitHub
Java azure-resourcemanager-digitaltwins no Maven Referência para gerenciamento de recursos – Gêmeos Digitais do Azure Biblioteca de clientes do AzureDigitalTwins do Azure Resource Manager para Java no GitHub
JavaScript Biblioteca de clientes do AzureDigitalTwinsManagement para JavaScript no npm Biblioteca de clientes do 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 linguagem Go no GitHub

APIs de plano de dados dos Gêmeos Digitais do Azure

As APIs de plano de dados são as APIs dos Gêmeos Digitais do Azure usadas para gerenciar os elementos dentro de sua instância dos Gêmeos Digitais do Azure. Elas incluem operações como criar rotas, carregar modelos, criar relações e gerenciar gêmeos e podem ser amplamente divididas nas seguintes categorias:

  • DigitalTwinModels – a categoria DigitalTwinModels contém APIs para gerenciar os modelos em uma instância dos Gêmeos Digitais do Azure. As atividades de gerenciamento incluem carregamento, validação, recuperação e exclusão de modelos criados na DTDL.
  • DigitalTwins – a categoria DigitalTwins contém as APIs que permitem que os desenvolvedores criem, modifiquem e excluam gêmeos digitais e as relações deles em uma instância dos Gêmeos Digitais do Azure.
  • Query – a categoria Consulta permite que os desenvolvedores encontrem conjuntos de gêmeos digitais no grafo de gêmeos entre diferentes relações.
  • Event Routes – a categoria Rotas de Eventos contém APIs para rotear dados pelo sistema e para serviços downstream.
  • Import Jobs – A API de Importação de Trabalhos permite gerenciar uma ação assíncrona de execução prolongada para importar modelos, gêmeos e relações em massa.
  • Delete Jobs – A API de Exclusão de Trabalhos permite gerenciar uma ação assíncrona de execução prolongada para excluir todos os modelos, gêmeos e relações em uma instância.

Para chamar as APIs diretamente, referencie a pasta mais recente do Swagger no repositório Swagger do plano de dados. Essa pasta também inclui outra pasta de exemplos de uso. Você também pode exibir a documentação de referência da API do plano de dados.

Aqui estão os SDKs atualmente disponíveis para as APIs de plano de dados dos Gêmeos Digitais do Azure.

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

Próximas etapas

As próximas etapas sugeridas incluem: