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.
| Linguagem | 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.
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.
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.
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 |
| Nó | 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.
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.
Próximos passos
As próximas etapas sugeridas incluem: