إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
يسرد هذا المرجع Azure SDKs التي يمكنك استخدامها لإنشاء حلول IoT، بما في ذلك حزم SDK للجهاز والخدمة والإدارة IoT Hub وخدمة توفير الأجهزة (DPS)، ومعاينة SDKs لإدارة الشهادات، وارتباطات إلى مستوى التحكم Azure Digital Twins وواجهات برمجة تطبيقات مستوى البيانات.
عدد تطوير البرامج للجهاز
تحتوي مجموعات SDK لجهاز Microsoft Azure IoT على تعليمات برمجية تسهل إنشاء التطبيقات التي تتصل بخدمات Azure IoT Hub وتديرها. يمكن تشغيل حزم SDK هذه على جهاز حوسبة عام قائم على MPU مثل الكمبيوتر الشخصي أو الجهاز اللوحي أو الهاتف الذكي أو Raspberry Pi. تدعم SDKs التطوير بلغات C واللغات المدارة الحديثة بما في ذلك C# Node.jsPython Java.
تتوفر حزم SDK بلغات متعددة، ما يوفر المرونة لاختيار أفضل ما يناسب فريقك وسيناريوهاتك.
| اللغة | الحزمة | المصدر | Quickstarts | العينات | المرجع |
|---|---|---|---|---|---|
| .NET | NuGet | GitHub | الاتصال ب IoT Hub | عينات | Reference |
| Python | نقطه | GitHub | الاتصال ب IoT Hub | عينات | Reference |
| Node.js | npm | GitHub | الاتصال ب IoT Hub | عينات | Reference |
| Java | مخضرم | GitHub | الاتصال ب IoT Hub | عينات | Reference |
| C | packages | GitHub | الاتصال ب IoT Hub | عينات | Reference |
يتضمن جهاز Java SDK عينات لنظام التشغيل Android.
يتضمن SDK لجهاز C عينات لنظام التشغيل iOS التي تستخدم CocoaPods.
التحذير
Azure IoT C SDK غير مناسبة للتطبيقات المضمنة بسبب إدارة الذاكرة ونموذج الترابط. للحصول على خيارات SDK للجهاز المضمنة، راجع حزم SDK للجهاز المضمنة.
استخدم مجموعات SDK للجهاز لتطوير التعليمات البرمجية للتشغيل على أجهزة IoT التي تتصل IoT Hub أو IoT Central.
عدد تطوير البرامج للأجهزة المضمنة
تم تصميم حزم SDK هذه وإنشاؤها للتشغيل على الأجهزة ذات موارد الحوسبة والذاكرة المحدودة ويتم تنفيذها باستخدام لغة C.
تتوفر حزم SDK للجهاز المضمنة لأنظمة تشغيل متعددة توفر المرونة لاختيار أفضل ما يناسب السيناريو الخاص بك.
| RTOS | SDK | المصدر | العينات | المرجع |
|---|---|---|---|---|
| إكليبس ثريدإكس | برنامج وسيط Azure RTOS | GitHub | قوالب التشغيل السريع | Reference |
| FreeRTOS | برنامج FreeRTOS وسيط | GitHub | عينات | Reference |
| كمبيوتر بلا نظام تشغيل | Azure SDK ل Embedded C | GitHub | عينات | Reference |
استخدم حزم SDK للجهاز المضمنة لتطوير التعليمات البرمجية للتشغيل على أجهزة IoT التي تتصل IoT Hub أو IoT Central.
لمعرفة المزيد حول وقت استخدام حزم SDK للجهاز المضمنة، راجع سيناريوهات استخدام C SDK وC SDK المضمنة.
دورة حياة ودعم SDK للجهاز
يلخص هذا القسم دورة حياة Azure IoT Device SDK ونهج الدعم. لمزيد من المعلومات، راجع Azure SDK نهج دورة الحياة والدعم.
دورة حياة الحزمة
يتم إصدار الحزم في الفئات التالية. تحتوي كل فئة على بنية دعم محددة.
Beta - يعرف أيضا باسم Preview أو Release Candidate. متوفر لأغراض الوصول المبكر والملاحظات ولا يوصى باستخدامه في الإنتاج. يقتصر دعم إصدار المعاينة على مشكلات GitHub. عادة ما تكون إصدارات المعاينة حية لمدة أقل من ستة أشهر، وبعد ذلك يتم إهمالها أو إصدارها كنشطة.
نشط - متوفر بشكل عام ومدعم بالكامل، يتلقى تحديثات ميزات جديدة، بالإضافة إلى إصلاحات الأخطاء والأمان. استخدم أحدث إصدار لأن هذا الإصدار يتلقى الإصلاحات والتحديثات.
مهمل - يحل محله إصدار أحدث. يحدث الإهمال في نفس الوقت الذي يصبح فيه الإصدار الجديد نشطا. تعالج الإصدارات المهملة إصلاحات الأخطاء وإصلاحات الأمان الأكثر أهمية لمدة 12 شهرا أخرى.
الحصول على الدعم
إذا واجهت مشكلات أثناء استخدام Azure IoT SDKs، فاطلب الدعم من خلال الخيارات التالية:
الإبلاغ عن الأخطاء - يمكن لجميع العملاء الإبلاغ عن الأخطاء في صفحة المشكلات لمستودع GitHub المرتبط ب SDK ذات الصلة.
Microsoft فريق دعم العملاء - يمكن للمستخدمين الذين لديهم خطة دعم إشراك فريق دعم العملاء Microsoft عن طريق إنشاء تذكرة دعم مباشرة من مدخل Azure.
IoT Hub حزم SDK للخدمة
تحتوي حزم SDK لخدمة Azure IoT على تعليمات برمجية لتسهيل إنشاء التطبيقات التي تتفاعل مباشرة مع IoT Hub لإدارة الأجهزة والأمان.
| المنصة | الحزمة | مستودع التعليمات البرمجية | العينات | المرجع |
|---|---|---|---|---|
| .NET | NuGet | GitHub | عينات | Reference |
| Java | مخضرم | GitHub | عينات | Reference |
| العقدة | npm | GitHub | عينات | Reference |
| Python | نقطه | GitHub | عينات | Reference |
لمعرفة المزيد حول استخدام حزم SDK للخدمة للتفاعل مع الأجهزة من خلال مركز IoT، راجع دليل مطور الخدمة IoT Plug and Play.
IoT Hub إدارة SDKs
تساعدك مجموعات SDK لإدارة IoT Hub على إنشاء تطبيقات خلفية تدير مراكز IoT في اشتراكك في Azure.
| المنصة | الحزمة | مستودع التعليمات البرمجية | المرجع |
|---|---|---|---|
| .NET | NuGet | GitHub | Reference |
| Java | مخضرم | GitHub | Reference |
| Node.js | npm | GitHub | Reference |
| Python | نقطه | GitHub | Reference |
تتضمن بدائل SDKs للإدارة Azure CLI، PowerShell، وواجهة برمجة تطبيقات REST.
مجموعات تطوير تطبيقات أجهزة DPS
توفر مجموعات SDK لجهاز DPS تطبيقات لواجهة برمجة تطبيقات التسجيل وغيرها من الأجهزة التي تستدعيها لتوفيرها من خلال DPS. يمكن تشغيل SDKs للجهاز على أجهزة الحوسبة العامة المستندة إلى MPU مثل جهاز كمبيوتر شخصي أو كمبيوتر لوحي أو هاتف ذكي أو Raspberry Pi. تدعم SDKs التطوير بلغات C واللغات المدارة الحديثة بما في ذلك C# Node.jsPython Java.
الجدول التالي يسرد مجموعات تطوير التطبيقات للأجهزة المتاحة لكل لغة مدعومة.
| المنصة | الحزمة | مستودع التعليمات البرمجية | العينات | تشغيل سريع | المرجع |
|---|---|---|---|---|---|
| .NET | NuGet | GitHub | عينات | Quickstart | Reference |
| C | apt-get أو MBED أو Arduino IDE أو iOS | GitHub | عينات | Quickstart | Reference |
| Java | مخضرم | GitHub | عينات | Quickstart | Reference |
| Node.js | npm | GitHub | عينات | Quickstart | Reference |
| Python | نقطه | GitHub | عينات | Quickstart | Reference |
التحذير
إن C SDK المذكورة أعلاه ليست مناسبة للتطبيقات المضمنة بسبب إدارة الذاكرة ونموذج الترابط. لمعرفة الأجهزة المضمنة، راجع حزم SDK للجهاز المضمّن.
حزم SDK لجهاز DPS المضمنة
تم تصميم حزم SDK هذه وإنشاؤها للتشغيل على الأجهزة ذات موارد الحوسبة والذاكرة المحدودة ويتم تنفيذها باستخدام لغة C.
| RTOS | SDK | المصدر | العينات | المرجع |
|---|---|---|---|---|
| إكليبس ثريدإكس | برنامج وسيط Azure RTOS | GitHub | قوالب التشغيل السريع | Reference |
| FreeRTOS | برنامج FreeRTOS وسيط | GitHub | عينات | Reference |
| كمبيوتر بلا نظام تشغيل | Azure SDK ل Embedded C | GitHub | عينات | Reference |
تعرف على المزيد حول الجهاز و SDKs للجهاز المضمن في IoT SDKs.
حزم SDK لخدمة DPS
تساعدك حزم SDK لخدمة DPS على إنشاء تطبيقات خلفية لإدارة التسجيلات وسجلات التسجيل في مثيلات DPS.
| المنصة | الحزمة | مستودع التعليمات البرمجية | العينات | تشغيل سريع | المرجع |
|---|---|---|---|---|---|
| .NET | NuGet | GitHub | عينات | Quickstart | Reference |
| Java | مخضرم | GitHub | عينات | Quickstart | Reference |
| Node.js | npm | GitHub | عينات | Quickstart | Reference |
مجموعات SDK لإدارة DPS
تساعدك مجموعات SDK لإدارة DPS على إنشاء تطبيقات خلفية تدير مثيلات DPS وبيانات التعريف الخاصة بها في اشتراكك في Azure.
| المنصة | الحزمة | مستودع التعليمات البرمجية | المرجع |
|---|---|---|---|
| .NET | NuGet | GitHub | Reference |
| Java | مخضرم | GitHub | Reference |
| Node.js | npm | GitHub | Reference |
| Python | نقطه | GitHub | Reference |
SDKs لإدارة الشهادات (معاينة)
بالنسبة إلى SDKs التي تدعم إدارة شهادات X.509 المدعومة Microsoft في المعاينة، استخدم الإرشادات والعينات التالية. لاستخدام SDKs لإدارة الشهادات في المعاينة، يجب استخدام Azure IoT Hub مع مثيل DPS مرتبط، ويجب توفير الأجهزة من خلال DPS.
SDKs لجهاز إدارة الشهادات (معاينة)
يسرد الجدول التالي SDKs للنظام الأساسي الذي يدعم حاليا إدارة شهادات X.509 المدعومة Microsoft في المعاينة.
| اللغة | الحزمة | المصدر/الفرع | العينات |
|---|---|---|---|
| .NET | NuGet | Azure/azure-iot-sdk-csharp في feature/iot-csr-preview | CertificateSigningRequestSample |
| Python | نقطه | Azure/azure-iot-sdk-python في feature/iot-csr-preview | عينات cert-mgmt |
| Node.js | npm | غير متوفر | غير متوفر |
| Java | مخضرم | 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 في المعاينة.
| RTOS | SDK | المصدر | العينات |
|---|---|---|---|
| FreeRTOS | برنامج FreeRTOS وسيط | Azure/azure-iot-middleware-freertos في feature/dps-csr-preview | غير متوفر |
| كمبيوتر بلا نظام تشغيل | Azure SDK ل Embedded C | Azure/azure-sdk-for-c في feature/dps-csr-preview | paho_iot_hub_csr_sample.c |
واجهات برمجة التطبيقات لمستوى التحكم Azure Digital Twins
واجهات برمجة التطبيقات لمستوى التحكم هي ARM واجهات برمجة التطبيقات المستخدمة لإدارة مثيل Azure Digital Twins ككل، بحيث تغطي عمليات مثل إنشاء المثيل بأكمله أو حذفه. ستستخدم أيضا واجهات برمجة التطبيقات هذه لإنشاء نقاط النهاية وحذفها.
لاستدعاء واجهات برمجة التطبيقات مباشرة، راجع أحدث مجلد Swagger في control plane Swagger repo. يتضمن هذا المجلد أيضا مجلدا من الأمثلة التي تعرض الاستخدام.
فيما يلي SDKs المتوفرة حاليا لواجهات برمجة تطبيقات وحدة التحكم Azure Digital Twins.
واجهات برمجة تطبيقات مستوى البيانات Azure Digital Twins
واجهات برمجة تطبيقات مستوى البيانات هي واجهات برمجة التطبيقات Azure Digital Twins المستخدمة لإدارة العناصر داخل مثيل Azure Digital Twins. وهي تشمل عمليات مثل إنشاء المسارات وتحميل النماذج وإنشاء العلاقات وإدارة التوائم، ويمكن تقسيمها على نطاق واسع إلى الفئات التالية:
-
DigitalTwinModels- تحتوي الفئة DigitalTwinModels على واجهات برمجة التطبيقات لإدارة models في مثيل Azure Digital Twins. تتضمن أنشطة الإدارة تحميل النماذج التي تم تأليفها في DTDL والتحقق من صحتها واستردادها وحذفها. -
DigitalTwins- تحتوي الفئة DigitalTwins على واجهات برمجة التطبيقات التي تتيح للمطورين إنشاء digital twins وعلاقاتهم وتعديلها وحذفها في مثيل Azure Digital Twins. -
Query- تتيح فئة الاستعلام للمطورين العثور على مجموعات من التوائم الرقمية في الرسم البياني المزدوج عبر العلاقات. -
Event Routes- تحتوي فئة مسارات الأحداث على واجهات برمجة التطبيقات لتوجيه البيانات، من خلال النظام وإلى خدمات انتقال البيانات من الخادم. -
Import Jobs- تتيح لك واجهة برمجة تطبيقات استيراد المهام إدارة إجراء طويل الأمد وغير متزامن لاستيراد النماذج والتوائم والعلاقات بشكل مجمع. -
Delete Jobs- تتيح لك واجهة برمجة تطبيقات حذف المهام إدارة إجراء طويل الأمد وغير متزامن لحذف جميع النماذج والتوائم والعلاقات في مثيل.
لاستدعاء واجهات برمجة التطبيقات مباشرة، راجع أحدث مجلد Swagger في data plane Swagger repo. يتضمن هذا المجلد أيضا مجلدا من الأمثلة التي تعرض الاستخدام. يمكنك أيضا عرض الوثائق المرجعية لواجهة برمجة التطبيقات لمستوى البيانات.
فيما يلي SDKs المتوفرة حاليا لواجهات برمجة تطبيقات مستوى البيانات Azure Digital Twins.
| لغة SDK | ارتباط الحزمة | الوثائق المرجعية | شفرة المصدر |
|---|---|---|---|
| .NET (C#) | Azure. DigitalTwins.Core على NuGet | Reference لمكتبة عميل Azure IoT Digital Twins .NET | مكتبة عميل Azure IoT Digital Twins .NET على GitHub |
| 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 |
الخطوات التالية
تتضمن الخطوات التالية المقترحة ما يلي: