zestawy SDK urządzeń i usług Azure IoT

Ta dokumentacja zawiera listę Azure SDKs, których można użyć do tworzenia rozwiązań IoT, w tym zestawów SDK urządzeń, usług i zarządzania dla zestawów SDK IoT Hub i Device Provisioning Service (DPS), zestawów SDK w wersji zapoznawczej na potrzeby zarządzania certyfikatami oraz linków do interfejsów API płaszczyzny sterowania i płaszczyzny danych Azure Digital Twins.

Zestawy SDK urządzeń

Zestawy SDK urządzeń firmy Microsoft Azure IoT zawierają kod ułatwiający tworzenie aplikacji łączących się z usługami Azure IoT Hub i zarządzanych przez te usługi. Te zestawy SDK mogą działać na ogólnym urządzeniu obliczeniowym opartym na protokole MPU, takim jak komputer, tablet, smartfon lub Raspberry Pi. Zestawy SDK obsługują programowanie w języku C i w nowoczesnych językach zarządzanych, w tym w języku C#, Node.js, Python i Java.

Zestawy SDK są dostępne w wielu językach , co zapewnia elastyczność wyboru, która najlepiej odpowiada twojemu zespołowi i scenariuszowi.

Język Pakiet Źródło Quickstarts Próbki Reference
.NET NuGet GitHub Połączenie z IoT Hub Samples Referencja
Python pip GitHub Połączenie z IoT Hub Samples Referencja
Node.js npm  GitHub Połączenie z IoT Hub Samples Referencja
Java Maven GitHub Połączenie z IoT Hub Samples Referencja
C packages GitHub Połączenie z IoT Hub Samples Referencja

Zestaw SDK urządzenia Java zawiera przykłady dla systemu Android.

Zestaw SDK urządzenia C zawiera przykłady dla systemu iOS, które używają platformy CocoaPods.

Ostrzeżenie

Zestaw Azure IoT C SDK nie jest odpowiedni dla aplikacji osadzonych ze względu na zarządzanie pamięcią i model wątków. Aby uzyskać informacje o opcjach zestawu SDK urządzeń osadzonych, zobacz zestawy SDK urządzeń osadzonych.

Użyj zestawów SDK urządzeń, aby utworzyć kod do uruchamiania na urządzeniach IoT łączących się z usługą IoT Hub lub IoT Central.

Zestawy SDK urządzeń osadzonych

Te zestawy SDK zostały zaprojektowane i utworzone do uruchamiania na urządzeniach z ograniczonymi zasobami obliczeniowymi i pamięci i są implementowane przy użyciu języka C.

Zestawy SDK urządzeń osadzonych są dostępne dla wielu systemów operacyjnych, co zapewnia elastyczność wyboru, która najlepiej pasuje do danego scenariusza.

RTOS SDK Źródło Próbki Reference
Eclipse ThreadX oprogramowanie pośredniczące Azure RTOS GitHub Przewodniki Szybkiego Startu Referencja
FreeRTOS Oprogramowanie pośredniczące FreeRTOS GitHub Samples Referencja
Bez systemu operacyjnego Azure SDK dla osadzonego języka C GitHub Samples Referencja

Użyj zestawów SDK urządzeń osadzonych, aby opracować kod do uruchamiania na urządzeniach IoT łączących się z usługą IoT Hub lub IoT Central.

Aby dowiedzieć się więcej o tym, kiedy używać zestawów SDK dla urządzeń osadzonych, zobacz Scenariusze użycia zestawu SDK języka C i osadzonego SDK języka C.

Cykl życia i obsługa zestawu SDK urządzeń

W tej sekcji przedstawiono podsumowanie cyklu życia zestawu SDK urządzeń Azure IoT i zasad pomocy technicznej. Aby uzyskać więcej informacji, zobacz Azure SDK Cykl życia i zasady pomocy technicznej.

Cykl życia pakietu

Pakiety są wydawane w następujących kategoriach. Każda kategoria ma zdefiniowaną strukturę obsługi.

  1. Wersja beta — znana również jako wersja zapoznawcza lub Release Candidate. Dostępne do celów wczesnego dostępu i uzyskiwania opinii zwrotnych i nie jest zalecane do użycia w środowisku produkcyjnym. Obsługa wersji zapoznawczej jest ograniczona do GitHub problemów. Wersje zapoznawcze zwykle działają przez mniej niż sześć miesięcy, po czym są uznawane za przestarzałe albo wydawane jako aktywne.

  2. Aktywne — ogólnie dostępne i w pełni obsługiwane, otrzymuje nowe aktualizacje funkcji, a także poprawki błędów i zabezpieczeń. Użyj najnowszej wersji , ponieważ ta wersja otrzymuje poprawki i aktualizacje.

  3. Przestarzałe — zastąpione przez nowsze wydanie. Wycofanie odbywa się w tym samym czasie, kiedy aktywowana jest nowa wersja. Wycofane wersje obejmują najbardziej krytyczne poprawki błędów i zabezpieczeń przez kolejne 12 miesięcy.

Uzyskaj pomoc techniczną

Jeśli występują problemy podczas korzystania z zestawów SDK Azure IoT, poszukaj pomocy technicznej, korzystając z następujących opcji:

  • Raportowanie usterek — wszyscy klienci mogą zgłaszać błędy na stronie problemów dla repozytorium GitHub skojarzonego z odpowiednim zestawem SDK.

  • Microsoft zespół obsługi klienta — użytkownicy, którzy mają plan obsługi mogą zaangażować zespół pomocy technicznej Microsoft, tworząc bilet pomocy technicznej bezpośrednio z portalu Azure<>Azure/c2>.

Zestawy SDK usługi IoT Hub

Zestawy SDK usługi Azure IoT zawierają kod ułatwiający tworzenie aplikacji, które bezpośrednio wchodzą w interakcje z IoT Hub w celu zarządzania urządzeniami i zabezpieczeniami.

Platforma Pakiet Repozytorium kodu Próbki Reference
.NET NuGet GitHub Samples Referencja
Java Maven GitHub Samples Referencja
Node npm GitHub Samples Referencja
Python pip GitHub Samples Referencja

Aby dowiedzieć się więcej na temat korzystania z zestawów SDK usług do interakcji z urządzeniami za pośrednictwem centrum IoT, zobacz przewodnik dla deweloperów usługi IoT Plug and Play.

Zestawy SDK zarządzania IoT Hub

Zestawy SDK zarządzania IoT Hub ułatwiają tworzenie aplikacji zaplecza, które zarządzają centrami IoT w ramach subskrypcji Azure.

Platforma Pakiet Repozytorium kodu Reference
.NET NuGet GitHub Referencja
Java Maven GitHub Referencja
Node.js npm GitHub Referencja
Python pip GitHub Referencja

Alternatywami zestawów SDK zarządzania są Azure CLIPowerShell oraz interfejs API REST.

Zestawy SDK urządzeń DPS

Zestawy SDK urządzeń DPS dostarczają implementacje API, takie jak rejestrowanie, oraz inne, które urządzenia wywołują w celu aprowizacji za pośrednictwem usługi DPS. Zestawy SDK urządzeń mogą działać na ogólnych urządzeniach obliczeniowych opartych na protokole MPU, takich jak komputer, tablet, smartfon lub Raspberry Pi. Zestawy SDK obsługują programowanie w języku C i w nowoczesnych językach zarządzanych, w tym w języku C#, Node.js, Python i Java.

W poniższej tabeli wymieniono zestawy SDK urządzeń dostępne dla każdego obsługiwanego języka.

Platforma Pakiet Repozytorium kodu Próbki Szybki start Reference
.NET NuGet GitHub Samples Szybki start Referencja
C apt-get, MBED, Arduino IDE lub iOS GitHub Samples Szybki start Referencja
Java Maven GitHub Samples Szybki start Referencja
Node.js npm GitHub Samples Szybki start Referencja
Python pip GitHub Samples Szybki start Referencja

Ostrzeżenie

Zestaw C SDK wymieniony powyżej nie jest odpowiedni dla aplikacji osadzonych ze względu na zarządzanie pamięcią i model wątków. W przypadku urządzeń osadzonych zapoznaj się z SDK dla urządzeń osadzonych.

Pakiety SDK dla urządzeń osadzonych DPS

Te zestawy SDK zostały zaprojektowane i utworzone do uruchamiania na urządzeniach z ograniczonymi zasobami obliczeniowymi i pamięci i są implementowane przy użyciu języka C.

RTOS SDK Źródło Próbki Reference
Eclipse ThreadX oprogramowanie pośredniczące Azure RTOS GitHub Przewodniki Szybkiego Startu Referencja
FreeRTOS Oprogramowanie pośredniczące FreeRTOS GitHub Samples Referencja
Bez systemu operacyjnego Azure SDK dla osadzonego języka C GitHub Samples Referencja

Dowiedz się więcej o zestawach SDK dla urządzeń i urządzeń wbudowanych w zestawach SDK IoT.

Zestawy SDK usługi DPS

Zestawy SDK usługi DPS pomagają budować aplikacje serwerowe do zarządzania zapisami i danymi rejestracyjnymi w wystąpieniach usługi DPS.

Platforma Pakiet Repozytorium kodu Próbki Szybki start Reference
.NET NuGet GitHub Samples Szybki start Referencja
Java Maven GitHub Samples Szybki start Referencja
Node.js npm GitHub Samples Szybki start Referencja

Zestawy SDK zarządzania usługą DPS

Zestawy SDK zarządzania usługami DPS ułatwiają tworzenie aplikacji zaplecza, które zarządzają wystąpieniami usługi DPS i ich metadanymi w ramach subskrypcji Azure.

Platforma Pakiet Repozytorium kodu Reference
.NET NuGet GitHub Referencja
Java Maven GitHub Referencja
Node.js npm GitHub Referencja
Python pip GitHub Referencja

Zestawy SDK zarządzania certyfikatami (wersja zapoznawcza)

W przypadku zestawów SDK obsługujących zarządzanie certyfikatami X.509 opartymi na Microsoft w wersji zapoznawczej skorzystaj z poniższych instrukcji i przykładów. Aby korzystać z zestawów SDK zarządzania certyfikatami w wersji zapoznawczej, należy użyć Azure IoT Hub z połączonym wystąpieniem usługi DPS, a urządzenia muszą aprowizować za pośrednictwem usługi DPS.

Zestawy SDK urządzeń do zarządzania certyfikatami (wersja zapoznawcza)

W poniższej tabeli wymieniono zestawy SDK platformy, które obecnie obsługują zarządzanie certyfikatami X.509 opartymi Microsoft w wersji zapoznawczej.

Język Pakiet Źródło/gałąź Próbki
.NET NuGet Azure/azure-iot-sdk-csharp at feature/iot-csr-preview CertificateSigningRequestSample
Python pip Azure/azure-iot-sdk-python at feature/iot-csr-preview cert-mgmt samples
Node.js npm Niedostępne Niedostępne
Java Maven Azure/azure-iot-sdk-java at feature/csr certificate-signing-sample
C packages Azure/azure-iot-sdk-c at feature/dps-csr-preview iothub_ll_client_sample_certificate_signing_request

Zestawy SDK urządzeń osadzonych zarządzania certyfikatami (wersja zapoznawcza)

W poniższej tabeli wymieniono osadzone zestawy SDK, które obecnie obsługują zarządzanie certyfikatami X.509 opartymi na Microsoft w wersji zapoznawczej.

RTOS SDK Źródło Próbki
FreeRTOS Oprogramowanie pośredniczące FreeRTOS Azure/azure-iot-middleware-freertos at feature/dps-csr-preview Niedostępne
Bez systemu operacyjnego Azure SDK dla osadzonego języka C Azure/azure-sdk-for-c at feature/dps-csr-preview paho_iot_hub_csr_sample.c

interfejsy API płaszczyzny sterowania Azure Digital Twins

Interfejsy API płaszczyzny sterowania są ARM interfejsy API używane do zarządzania wystąpieniem Azure Digital Twins jako całości, więc obejmują operacje takie jak tworzenie lub usuwanie całego wystąpienia. Te interfejsy API będą również używane do tworzenia i usuwania punktów końcowych.

Aby wywołać interfejsy API bezpośrednio, należy odwołać się do najnowszego folderu struktury Swagger w repozytorium swagger płaszczyzny control. Ten folder zawiera również folder przykładów pokazujący użycie.

Poniżej przedstawiono zestawy SDK dostępne obecnie dla interfejsów API płaszczyzny sterowania Azure Digital Twins.

Język zestawu SDK Link do pakietu Dokumentacja referencyjna Kod źródłowy
.NET (C#) Azure. ResourceManager.DigitalTwins w witrynie NuGet Dokumentacja zestawu AZURE DigitalTwins SDK dla platformy .NET Mcrosoft Azure Digital Twins management client library for .NET on GitHub
Java azure-resourcemanager-digitaltwins w narzędziu Maven Dokumentacja dotycząca zarządzania zasobami — digital twins Azure Resource Manager biblioteka klienta azureDigitalTwins dla Java w GitHub
JavaScript Biblioteka klienta AzureDigitalTwinsManagement dla JavaScript na npm AzureDigitalTwinsManagement client library for JavaScript on GitHub
Python azure-mgmt-digitaltwins na PyPI Zestaw Microsoft Azure SDK dla języka Python w witrynie GitHub
Go azure-sdk-for-go/services/digitaltwins/mgmt Azure SDK dla Go na GitHub

interfejsy API płaszczyzny danych Azure Digital Twins

Interfejsy API płaszczyzny danych to interfejsy API Azure Digital Twins używane do zarządzania elementami w ramach wystąpienia Azure Digital Twins. Obejmują one operacje, takie jak tworzenie tras, przekazywanie modeli, tworzenie relacji i zarządzanie reprezentacjami bliźniaczymi, które można ogólnie podzielić na następujące kategorie:

Aby wywołać interfejsy API bezpośrednio, odwołaj się do najnowszego folderu struktury Swagger w repozytorium swagger płaszczyzny data. Ten folder zawiera również folder przykładów pokazujący użycie. Możesz również wyświetlić dokumentację referencyjną interfejsu API płaszczyzny danych.

Poniżej przedstawiono zestawy SDK dostępne obecnie dla interfejsów API płaszczyzny danych Azure Digital Twins.

Język zestawu SDK Link do pakietu Dokumentacja referencyjna Kod źródłowy
.NET (C#) Azure. DigitalTwins.Core w witrynie NuGet Dokumentacja biblioteki klienckiej Azure IoT Digital Twins dla platformy .NET Azure IoT biblioteka klienta usługi Digital Twins dla .NET GitHub
Java com.azure:azure-digitaltwins-core w narzędziu Maven Dokumentacja zestawu SDK usługi Azure Digital Twins dla języka Java Azure IoT biblioteka klienta usługi Digital Twins dla Java w GitHub
JavaScript Biblioteka klienta Azure Digital Twins Core dla języka JavaScript na npm Reference for @azure/digital-twins-core Biblioteka klienta azure Digital Twins Core dla języka JavaScript w witrynie GitHub
Python Biblioteka klienta Azure Digital Twins Core dla Pythona na PyPI Odwołanie do azure-digitaltwins-core Biblioteka klienta azure Digital Twins Core dla języka Python w witrynie GitHub

Następne kroki

Sugerowane następne kroki obejmują: