SDK Azure IoT

Tabel berikut mencantumkan berbagai SDK yang dapat Anda gunakan untuk membangun solusi IoT.

SDK Perangkat

SDK perangkat Microsoft Azure IoT berisi kode yang memfasilitasi pembangunan aplikasi yang tersambung dan dikelola oleh layanan Azure IoT Hub. SDK ini dapat berjalan pada perangkat komputasi yang berbasis MPU umum seperti PC, tablet, smartphone, atau Raspberry Pi. SDK mendukung pengembangan bahasa C dan bahasa modern terkelola termasuk dalam C#, Node.JS, Python, dan Java.

SDK yang tersedia dalam berbagai bahasa memberikan fleksibilitas yang dapat Anda pilih berdasarkan pada tim dan skenario Anda.

Bahasa Paket Sumber Mulai cepat Sampel Referensi
.NET NuGet GitHub Menyambungkan ke Azure IoT Hub Sampel Referensi
Python pip GitHub Menyambungkan ke Azure IoT Hub Sampel Referensi
Node.js npm  GitHub Menyambungkan ke Azure IoT Hub Sampel Referensi
Java Maven GitHub Menyambungkan ke Azure IoT Hub Sampel Referensi
C paket GitHub Menyambungkan ke Azure IoT Hub Sampel Referensi

SDK perangkat Java menyertakan sampel untuk Android.

SDK perangkat C menyertakan sampel untuk iOS yang menggunakan CocoaPods.

Peringatan

Azure IoT C SDK tidak cocok untuk aplikasi yang disematkan karena manajemen memori dan model utasnya. Untuk opsi SDK perangkat yang disematkan, lihat SDK perangkat yang disematkan.

Gunakan SDK perangkat untuk mengembangkan kode agar berjalan pada perangkat IoT yang tersambung ke IoT Hub atau IoT Central.

Untuk mempelajari selengkapnya tentang cara menggunakan SDK perangkat, lihat Apa itu perangkat Azure IoT dan pengembangan aplikasi?.

SDK perangkat tersematkan

SDK ini telah dirancang dan dibuat untuk berjalan pada perangkat dengan sumber daya komputasi dan memori yang terbatas dan diimplementasikan dengan menggunakan bahasa C.

SDK perangkat yang disematkan tersedia untuk beberapa sistem operasi yang memberikan fleksibilitas untuk memilih yang paling sesuai dengan skenario Anda.

RTOS SDK Sumber Sampel Referensi
Eclipse ThreadX Middleware Azure RTOS GitHub Mulai Cepat Referensi
FreeRTOS Middleware FreeRTOS GitHub Sampel Referensi
Bare Metal SDK Azure untuk Embedded C GitHub Sampel Referensi

Gunakan SDK perangkat yang disematkan untuk mengembangkan kode agar berjalan pada perangkat IoT yang tersambung ke IoT Hub atau IoT Central.

Untuk mempelajari selengkapnya tentang kapan menggunakan SDK perangkat yang disematkan, lihat skenario penggunaan C SDK dan Embedded C SDK.

Siklus hidup dan dukungan SDK Perangkat

Bagian ini merangkum siklus hidup dan kebijakan dukungan Azure IoT Device SDK. Untuk informasi selengkapnya, lihat Siklus Hidup dan kebijakan dukungan Azure SDK.

Siklus hidup paket

Paket dirilis dalam kategori berikut. Setiap kategori memiliki struktur dukungan yang ditentukan.

  1. Beta - Juga dikenal sebagai Pratinjau atau Kandidat Rilis. Tersedia untuk tujuan akses awal dan umpan balik dan tidak disarankan untuk digunakan dalam produksi. Dukungan versi pratinjau terbatas pada masalah GitHub. Rilis pratinjau biasanya ditayangkan selama kurang dari enam bulan, setelah itu rilis tidak digunakan lagi atau dirilis sebagai aktif.

  2. Aktif - Umumnya tersedia dan didukung penuh, menerima pembaruan fitur baru, serta perbaikan bug dan keamanan. Sebaiknya pelanggan menggunakan versi terbaru karena versi tersebut menerima perbaikan dan pembaruan.

  3. Tidak digunakan lagi - Digantikan oleh rilis yang lebih baru. Penghentian terjadi pada saat yang sama rilis baru menjadi aktif. Rilis yang tidak digunakan lagi membahas perbaikan bug paling penting dan perbaikan keamanan selama 12 bulan lagi.

Dapatkan dukungan

Jika Anda mengalami masalah saat menggunakan Azure IoT SDK, ada beberapa cara untuk mencari dukungan:

  • Melaporkan bug - Semua pelanggan dapat melaporkan bug di halaman masalah untuk repositori GitHub yang terkait dengan SDK yang relevan.

  • Tim Dukungan Pelanggan Microsoft - Pengguna yang memiliki paket dukungan dapat melibatkan tim Dukungan Pelanggan Microsoft dengan membuat tiket dukungan langsung dari portal Azure.

SDK layanan IoT Hub

SDK layanan Azure IoT Hub berisi kode untuk memfasilitasi pembangunan aplikasi yang berinteraksi langsung dengan IoT Hub untuk mengelola perangkat dan keamanan.

Platform Paket Repositori kode Sampel Referensi
.NET NuGet GitHub Sampel Referensi
Java Maven GitHub Sampel Referensi
Simpul npm GitHub Sampel Referensi
Python pip GitHub Sampel Referensi

Untuk mempelajari selengkapnya tentang menggunakan SDK layanan untuk berinteraksi dengan perangkat melalui hub IoT, lihat panduan pengembang layanan IoT Plug and Play.

SDK manajemen IoT Hub

SDK manajemen IoT Hub membantu Anda membangun aplikasi backend yang mengelola hub IoT di langganan Azure Anda.

Platform Paket Repositori kode Referensi
.NET NuGet GitHub Referensi
Java Maven GitHub Referensi
Node.js npm GitHub Referensi
Python pip GitHub Referensi

Alternatif untuk SDK manajemen termasuk Azure CLI, PowerShell, dan REST API.

SDK perangkat DPS

SDK perangkat DPS menyediakan implementasi Register API dan lainnya yang dipanggil perangkat untuk provisi melalui DPS. SDK perangkat dapat berjalan pada perangkat komputasi berbasis MPU umum seperti PC, tablet, smartphone, atau Raspberry Pi. SDK mendukung pengembangan bahasa C dan bahasa modern terkelola termasuk dalam C#, Node.JS, Python, dan Java.

Platform Paket Repositori kode Sampel Mulai Cepat Referensi
.NET NuGet GitHub Sampel Mulai Cepat Referensi
C apt-get, MBED, Arduino IDE atau iOS GitHub Sampel Mulai Cepat Referensi
Java Maven GitHub Sampel Mulai Cepat Referensi
Node.js npm GitHub Sampel Mulai Cepat Referensi
Python pip GitHub Sampel Mulai Cepat Referensi

Peringatan

SDK C yang tercantum di atas tidak cocok dengan aplikasi tersematkan karena manajemen memori dan model pengalurannya (threading). Untuk perangkat tersematkan, lihat SDK perangkat terisematkan.

SDK perangkat yang disematkan DPS

SDK ini telah dirancang dan dibuat untuk berjalan pada perangkat dengan sumber daya komputasi dan memori yang terbatas dan diimplementasikan dengan menggunakan bahasa C.

RTOS SDK Sumber Sampel Referensi
Eclipse ThreadX Middleware Azure RTOS GitHub Mulai Cepat Referensi
FreeRTOS Middleware FreeRTOS GitHub Sampel Referensi
Bare Metal SDK Azure untuk Embedded C GitHub Sampel Referensi

Pelajari selengkapnya tentang perangkat dan SDK perangkat yang disematkan di SDK IoT.

SDK layanan DPS

SDK layanan DPS membantu Anda membangun aplikasi backend untuk mengelola pendaftaran dan rekaman pendaftaran dalam instans DPS.

Platform Paket Repositori kode Sampel Mulai Cepat Referensi
.NET NuGet GitHub Sampel Mulai Cepat Referensi
Java Maven GitHub Sampel Mulai Cepat Referensi
Node.js npm GitHub Sampel Mulai Cepat Referensi

SDK manajemen DPS

SDK manajemen DPS membantu Anda membangun aplikasi backend yang mengelola instans DPS dan metadatanya di langganan Azure Anda.

Platform Paket Repositori kode Referensi
.NET NuGet GitHub Referensi
Java Maven GitHub Referensi
Node.js npm GitHub Referensi
Python pip GitHub Referensi

API sarana kontrol Azure Digital Twins

API saran kontrol adalah API ARM yang digunakan untuk mengelola instans Azure Digital Twins Anda secara keseluruhan, sehingga mereka mencakup operasi seperti membuat atau menghapus seluruh instans Anda. Anda juga akan menggunakan API ini untuk membuat dan menghapus titik akhir.

Untuk memanggil API secara langsung, referensikan folder Swagger terbaru di repositori Swagger sarana kontrol. Folder ini juga menyertakan folder contoh yang menampilkan penggunaan.

Berikut adalah SDK yang saat ini tersedia untuk API sarana kontrol Azure Digital Twins.

Bahasa SDK Tautan paket Dokumentasi rujukan Kode sumber
.NET (C#) Azure.ResourceManager.DigitalTwins di NuGet Referensi untuk Azure DigitalTwins SDK untuk .NET Pustaka klien manajemen Microsoft Azure Digital Twins untuk .NET di GitHub
Java azure-resourcemanager-digitaltwins di Maven Referensi untuk Manajemen Sumber Daya - Digital Twins Pustaka klien Azure Resource Manager AzureDigitalTwins untuk Java di GitHub
JavaScript Pustaka klien AzureDigitalTwinsManagement untuk JavaScript di npm Pustaka klien AzureDigitalTwinsManagement untuk JavaScript di GitHub
Python azure-mgmt-digitaltwins di PyPI Microsoft Azure SDK untuk Python di GitHub
Go azure-sdk-for-go/services/digitaltwins/mgmt Azure SDK untuk Go di GitHub

API sarana data Azure Digital Twins

API sarana data adalah API Azure Digital Twins yang digunakan untuk mengelola elemen dalam instans Azure Digital Twins Anda. API ini meliputi operasi seperti membuat rute, mengunggah model, menciptakan hubungan, dan mengelola kembaran, dan dapat dibagi secara luas menjadi kategori berikut:

  • DigitalTwinModels - Kategori DigitalTwinModels berisi API untuk mengelola model dalam instans Azure Digital Twins. Kegiatan pengelolaan meliputi pengunggahan, validasi, pengambilan, dan penghapusan model yang ditulis dalam DTDL.
  • DigitalTwins - Kategori DigitalTwins berisi API yang memungkinkan pengembang membuat, memodifikasi, dan menghapus kembar digital dan hubungannya dalam instans Azure Digital Twins.
  • Query - Kategori Kueri memungkinkan pengembang menemukan set kembar digital dalam grafik kembar di seluruh hubungan.
  • Event Routes - Kategori Rute Peristiwa berisi API untuk merutekan data, melalui sistem dan ke layanan hilir.
  • Import Jobs - API Impor Pekerjaan memungkinkan Anda mengelola tindakan asinkron yang berjalan lama untuk mengimpor model, kembar , dan hubungan secara massal.
  • Delete Jobs - Delete Jobs API memungkinkan Anda mengelola tindakan asinkron yang berjalan lama untuk menghapus semua model, kembar , dan hubungan dalam instans.

Untuk memanggil API secara langsung, referensikan folder Swagger terbaru di repositori Swagger bidang data. Folder ini juga menyertakan folder contoh yang menampilkan penggunaan. Anda juga dapat melihat dokumentasi referensi API sarana data.

Berikut adalah SDK yang saat ini tersedia untuk API sarana data Azure Digital Twins.

Bahasa SDK Tautan paket Dokumentasi rujukan Kode sumber
.NET (C#) Azure.DigitalTwins.Core di NuGet Referensi untuk pustaka klien Azure IoT Digital Twins untuk .NET Pustaka klien Azure IoT Digital Twins untuk .NET di GitHub
Java com.azure:azure-digitaltwins-core di Maven Referensi untuk Azure Digital Twins SDK untuk Java Pustaka klien Azure IoT Digital Twins untuk Java di GitHub
JavaScript Pustaka klien Azure Digital Twins Core untuk JavaScript di npm Reference for @azure/digital-twins-core Pustaka klien Azure Digital Twins Core untuk JavaScript di GitHub
Python Pustaka klien Azure Digital Twins Core untuk Python di PyPI Referensi untuk azure-digitaltwins-core Pustaka klien Azure Digital Twins Core untuk Python di GitHub

Langkah berikutnya

Langkah berikutnya yang disarankan meliputi: