Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
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.
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.
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.
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ą planobsługi mogą zaangażować zespół pomocy technicznej Microsoft, tworząc bilet pomocy technicznej bezpośrednio z portaluAzure<>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.
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:
-
DigitalTwinModels— kategoria DigitalTwinModels zawiera interfejsy API do zarządzania models w wystąpieniu Azure Digital Twins. Działania związane z zarządzaniem obejmują przekazywanie, walidację, pobieranie i usuwanie modeli utworzonych w języku DTDL. -
DigitalTwins— kategoria DigitalTwins zawiera interfejsy API, które umożliwiają deweloperom tworzenie, modyfikowanie i usuwanie bliźniaczych reprezentacji digitalnych i ich relacji w wystąpieniu Azure Digital Twins. -
Query— Kategoria zapytań umożliwia deweloperom znajdowanie zestawów cyfrowych bliźniaków w grafie bliźniaczym w ramach relacji. -
Event Routes— Kategoria Trasy zdarzeń zawiera interfejsy API do kierowania danych za pośrednictwem systemu i do usług podrzędnych. -
Import Jobs— Interfejs API do importu zadań umożliwia zarządzanie długotrwałym, asynchronicznym procesem importowania modeli, reprezentacji bliźniaczych i relacji zbiorczo. -
Delete Jobs— API Delete Jobs umożliwia zarządzanie długotrwałą akcją asynchroniczną, aby usunąć wszystkie modele, bliźniaki i relacje w wystąpieniu.
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.
Następne kroki
Sugerowane następne kroki obejmują: