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 dão 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.
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.
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.
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 |
| Nó | 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 dão 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.
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.
Próximas etapas
As próximas etapas sugeridas incluem: