Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
В этой ссылке перечислены Azure SDKs, которые можно использовать для создания решений Интернета вещей, включая пакеты SDK для устройств, служб и управления для IoT Hub и службы подготовки устройств (DPS), предварительной версии пакетов SDK для управления сертификатами, а также ссылки на Azure Digital Twins плоскости управления и API плоскости данных.
Пакеты SDK для устройств
Пакеты SDK для устройств Microsoft Azure IoT содержат код, упрощающий создание приложений, которые подключаются к службам Azure IoT Hub и управляются ими. Эти пакеты SDK могут работать на обычном вычислительном устройстве на основе MPU, например ПК, планшете, смартфоне или Raspberry Pi. Пакеты SDK поддерживают разработку на C и на современных управляемых языках, включая C#, Node.js, Python и Java.
Пакеты SDK доступны на нескольких языках, что позволяет выбрать наиболее подходящий вариант для ваших команды и сценария.
| Язык | Package | Исходный материал | Quickstarts | Образцы | Справочные материалы |
|---|---|---|---|---|---|
| .NET | NuGet | GitHub | Подключиться к IoT-хабу | Samples | Справочные материалы |
| Python | pip | GitHub | Подключиться к IoT-хабу | Samples | Справочные материалы |
| Node.js | npm | GitHub | Подключиться к IoT-хабу | Samples | Справочные материалы |
| Java | Maven | GitHub | Подключиться к IoT-хабу | Samples | Справочные материалы |
| C | packages | GitHub | Подключиться к IoT-хабу | Samples | Справочные материалы |
Пакет SDK для устройств Java включает samples для Android.
Пакет SDK для устройств C включает samples для iOS, использующих CocoaPods.
Предупреждение
Пакет SDK Azure IoT C не подходит для внедренных приложений из-за ее модели управления памятью и потоковой работы. Для параметров пакета SDK встроенных устройств см. пакеты SDK встроенных устройств.
Используйте пакеты SDK для устройств для разработки кода для запуска на устройствах Интернета вещей, которые подключаются к IoT Hub или IoT Central.
Пакеты SDK для встраиваемых устройств
Эти пакеты SDK разработаны и созданы для работы на устройствах с ограниченными объемом вычислительных ресурсов и ресурсов памяти. Они реализуются с помощью языка C.
Пакеты SDK для внедренных устройств доступны для нескольких операционных систем , которые обеспечивают гибкость, чтобы выбрать наиболее подходящий сценарий.
| ОСРВ (Операционная система реального времени) | SDK | Исходный материал | Образцы | Справочные материалы |
|---|---|---|---|---|
| Eclipse ThreadX | ПО промежуточного слоя Azure RTOS | GitHub | Краткие руководства | Справочные материалы |
| FreeRTOS | Промежуточное ПО FreeRTOS | GitHub | Samples | Справочные материалы |
| Голое железо | Azure SDK для Embedded C | GitHub | Samples | Справочные материалы |
Используйте пакеты SDK для внедренных устройств для разработки кода для запуска на устройствах Интернета вещей, которые подключаются к IoT Hub или IoT Central.
Узнать больше о том, когда использовать пакеты SDK для встраиваемых устройств, можно в разделе сценарии использования C SDK и Embedded C SDK.
Жизненный цикл и поддержка пакета SDK для устройств
В этом разделе приведены сведения о жизненном цикле пакета SDK для устройств Azure IoT и политике поддержки. Дополнительные сведения см. в статье Azure SDK Жизненный цикл и политика поддержки.
Жизненный цикл пакета
Пакеты выпускаются в следующих категориях. Каждая категория имеет определенную структуру поддержки.
Бета-версия — также называется предварительным просмотром или кандидатом на выпуск. Доступно для ранних целей доступа и обратной связи и не рекомендуется использовать в рабочей среде. Поддержка предварительной версии ограничена GitHub проблемами. Предварительные версии обычно живут менее шести месяцев, после чего они либо устарели, либо выпущены как активные.
Активная — общедоступная и полностью поддерживаемая версия, которая получает новые обновления функций, а также исправления ошибок и безопасности. Используйте последнюю версию , так как эта версия получает исправления и обновления.
Устаревший — заменен более недавним выпуском. Устаревание происходит одновременно с тем, как новый выпуск становится активным. Устаревшие выпуски содержат самые критические устранения ошибок и исправления безопасности в течение дополнительных 12 месяцев.
Получите поддержку
Если при использовании пакетов SDK Azure IoT возникают проблемы, обратитесь в службу поддержки с помощью следующих вариантов:
Reporting bugs . Все клиенты могут сообщать об ошибках на странице проблем для репозитория GitHub, связанного с соответствующим пакетом SDK.
Microsoft службу поддержки клиентов — пользователи, у которых есть планsupport могут обратиться в службу поддержки Microsoft, создав запрос в службу поддержки непосредственно на< порталеAzure/c2>.
пакеты SDK службы IoT Hub
Пакеты SDK службы Azure IoT содержат код для упрощения создания приложений, взаимодействующих непосредственно с IoT Hub для управления устройствами и безопасностью.
| Platform | Package | Репозиторий кода | Образцы | Справочные материалы |
|---|---|---|---|---|
| .NET | NuGet | GitHub | Samples | Справочные материалы |
| Java | Maven | GitHub | Samples | Справочные материалы |
| Узел | npm | GitHub | Samples | Справочные материалы |
| Python | pip | GitHub | Samples | Справочные материалы |
Дополнительные сведения об использовании пакетов SDK службы для взаимодействия с устройствами через Центр Интернета вещей см. в руководстве разработчика службы IoT Plug and Play.
пакеты SDK для управления IoT Hub
Пакеты SDK для управления IoT Hub помогают создавать серверные приложения, управляющие центрами Интернета вещей в подписке Azure.
| Platform | Package | Репозиторий кода | Справочные материалы |
|---|---|---|---|
| .NET | NuGet | GitHub | Справочные материалы |
| Java | Maven | GitHub | Справочные материалы |
| Node.js | npm | GitHub | Справочные материалы |
| Python | pip | GitHub | Справочные материалы |
Альтернативные пакеты SDK для управления включают Azure CLI, PowerShell и REST API.
Пакеты SDK для устройств DPS
Пакеты SDK для устройств DPS предоставляют реализации API регистрации и других API, которые устройства вызывают для обеспечения через DPS. Пакеты SDK для устройств могут работать на общих вычислительных устройствах на основе MPU, таких как компьютер, планшет, смартфон или Raspberry Pi. Пакеты SDK поддерживают разработку на C и на современных управляемых языках, включая C#, Node.js, Python и Java.
В следующей таблице перечислены пакеты SDK для устройств, доступные для каждого поддерживаемого языка.
| Platform | Package | Репозиторий кода | Образцы | Быстрый старт | Справочные материалы |
|---|---|---|---|---|---|
| .NET | NuGet | GitHub | Samples | Быстрый старт | Справочные материалы |
| C | apt-get, MBED, IDE Arduino или iOS | GitHub | Samples | Быстрый старт | Справочные материалы |
| Java | Maven | GitHub | Samples | Быстрый старт | Справочные материалы |
| Node.js | npm | GitHub | Samples | Быстрый старт | Справочные материалы |
| Python | pip | GitHub | Samples | Быстрый старт | Справочные материалы |
Предупреждение
Указанный выше пакет SDK для Cне подходит для встраиваемых приложений из-за способа управления памятью и потоковой модели. Дополнительные сведения о встраиваемых устройствах см. в разделе о пакетах SDK для встраиваемых устройств.
SDK для встроенных устройств DPS
Эти пакеты SDK разработаны и созданы для работы на устройствах с ограниченными объемом вычислительных ресурсов и ресурсов памяти. Они реализуются с помощью языка C.
| ОСРВ (Операционная система реального времени) | SDK | Исходный материал | Образцы | Справочные материалы |
|---|---|---|---|---|
| Eclipse ThreadX | ПО промежуточного слоя Azure RTOS | GitHub | Краткие руководства | Справочные материалы |
| FreeRTOS | Промежуточное ПО FreeRTOS | GitHub | Samples | Справочные материалы |
| Голое железо | Azure SDK для Embedded C | GitHub | Samples | Справочные материалы |
Узнайте больше об SDK для устройств и встраиваемых устройств в разделе SDK для Интернета вещей.
Пакеты SDK для службы DPS
Пакеты SDK службы DPS помогают создавать серверные приложения для управления учётными и регистрационными записями в экземплярах DPS.
| Platform | Package | Репозиторий кода | Образцы | Быстрый старт | Справочные материалы |
|---|---|---|---|---|---|
| .NET | NuGet | GitHub | Samples | Быстрый старт | Справочные материалы |
| Java | Maven | GitHub | Samples | Быстрый старт | Справочные материалы |
| Node.js | npm | GitHub | Samples | Быстрый старт | Справочные материалы |
Пакеты SDK для управления DPS
Пакеты SDK для управления DPS помогают создавать внутренние приложения, которые управляют экземплярами DPS и их метаданными в подписке Azure.
| Platform | Package | Репозиторий кода | Справочные материалы |
|---|---|---|---|
| .NET | NuGet | GitHub | Справочные материалы |
| Java | Maven | GitHub | Справочные материалы |
| Node.js | npm | GitHub | Справочные материалы |
| Python | pip | GitHub | Справочные материалы |
Пакеты SDK для управления сертификатами (предварительная версия)
Для пакетов SDK, поддерживающих управление сертификатами X.509 Microsoft в предварительной версии, используйте следующие инструкции и примеры. Чтобы использовать пакеты SDK для управления сертификатами в предварительной версии, необходимо использовать Azure IoT Hub с связанным экземпляром DPS, а устройства должны подготавливать через DPS.
Пакеты SDK для устройств управления сертификатами (предварительная версия)
В следующей таблице перечислены пакеты SDK платформы, которые в настоящее время поддерживают управление сертификатами X.509 с поддержкой Microsoft в предварительной версии.
| Язык | Package | Source/Branch | Образцы |
|---|---|---|---|
| .NET | NuGet | Azure/azure-iot-sdk-csharp at feature/iot-csr-preview | CertificateSigningRequestSample |
| Python | pip | Azure/azure-iot-sdk-python на сайте feature/iot-csr-preview | cert-mgmt samples |
| Node.js | npm | Недоступно | Недоступно |
| Java | Maven | Azure/azure-iot-sdk-java на языке feature/csr | certificate-signing-sample |
| C | packages | Azure/azure-iot-sdk-c в feature/dps-csr-preview | iothub_ll_client_sample_certificate_signing_request |
Пакеты SDK для внедренных устройств управления сертификатами (предварительная версия)
В следующей таблице перечислены внедренные пакеты SDK, которые в настоящее время поддерживают управление сертификатами X.509 с поддержкой Microsoft в предварительной версии.
| ОСРВ (Операционная система реального времени) | SDK | Исходный материал | Образцы |
|---|---|---|---|
| FreeRTOS | Промежуточное ПО FreeRTOS | Azure/azure-iot-middleware-freertos at feature/dps-csr-preview | Недоступно |
| Голое железо | Azure SDK для Embedded C | Azure/azure-sdk-for-c at feature/dps-csr-preview | paho_iot_hub_csr_sample.c |
API уровня управления Azure Digital Twins
API уровня управления ARM, используемые для управления экземпляром Azure Digital Twins в целом, поэтому они охватывают такие операции, как создание или удаление всего экземпляра. Вы также будете использовать эти API для создания и удаления конечных точек.
Чтобы вызвать API напрямую, обратитесь к последней папке Swagger в репозитории control plane Swagger. В эту папку также входит папка примеров, в которых показано использование.
Ниже приведены пакеты SDK, доступные в настоящее время для API уровня управления Azure Digital Twins.
API плоскости данных Azure Digital Twins
API плоскости данных — это API Azure Digital Twins, используемые для управления элементами в экземпляре Azure Digital Twins. К ним относятся такие операции, как создание маршрутов, отправка моделей, создание связей и управление двойниками. Их можно разделить на следующие категории:
-
DigitalTwinModels— категория DigitalTwinModels содержит API для управления models в экземпляре Azure Digital Twins. К действиям управления относятся передача, проверка, извлечение и удаление моделей, созданных в DTDL. -
DigitalTwins— категория DigitalTwins содержит API, которые позволяют разработчикам создавать, изменять и удалять digital twins и их связи в экземпляре Azure Digital Twins. -
Query— Категория "Запрос" позволяет разработчикам находить наборы цифровых двойников в графе двойников по связям. -
Event Routes— Категория "Маршруты событий" содержит API-интерфейсы для маршрутизации данных через систему и подчиненные службы. -
Import Jobs— API импорта заданий позволяет управлять длительным асинхронным действием для импорта моделей, двойников и связей в массовом режиме. -
Delete Jobs— API по удалению заданий позволяет управлять длительным асинхронным процессом, направленным на удаление всех моделей, двойников и связей в экземпляре.
Чтобы вызвать API напрямую, обратитесь к последней папке Swagger в репозитории data plane Swagger. В эту папку также входит папка примеров, в которых показано использование. Вы также можете просмотреть справочную документацию по API плоской модели данных.
Ниже приведены пакеты SDK, доступные в настоящее время для API Azure Digital Twins плоскости данных.
| Язык пакета SDK | Ссылка на пакет | Справочная документация | Исходный код |
|---|---|---|---|
| .NET (C#) | Azure. DigitalTwins.Core в NuGet | Reference для клиентской библиотеки Azure IoT Digital Twins для .NET | клиентская библиотека |
| Java | com.azure:azure-digitaltwins-core в Maven | Reference для пакета SDK Azure Digital Twins для Java | Azure IoT клиентская библиотека Digital Twins для Java в GitHub |
| JavaScript | клиентская библиотека Azure Azure Digital Twins Core для JavaScript на npm | Reference for @azure/digital-twins-core | Azure Azure Digital Twins клиентская библиотека Core для JavaScript на GitHub |
| Python | клиентская библиотека Azure Azure Digital Twins Core для Python в PyPI | Справочник по azure-digitaltwins-core | клиентская библиотека Azure Azure Digital Twins Core для Python в GitHub |
Дальнейшие действия
Ниже приведены следующие шаги.