Azure IoT SDKs
تسرد الجداول التالية مجموعات SDK المختلفة التي يمكنك استخدامها لإنشاء حلول IoT.
عدد تطوير البرامج للجهاز
تحتوي عدد تطوير برامج أجهزة Azure IoT من Microsoft على تعليمات برمجية تسهل إنشاء تطبيقات تتصل بخدمات Azure IoT Hub وتُدار بواسطتها. يمكن تشغيل حزم SDK هذه على جهاز حوسبة عام قائم على MPU مثل الكمبيوتر الشخصي أو الجهاز اللوحي أو الهاتف الذكي أو Raspberry Pi. تدعم حزم SDK التطوير في لغة C واللغات الحديثة المدارة بما في ذلك C# وNode.JS وPython وJava.
تتوفر حزم SDK بلغات متعددة، ما يوفر المرونة لاختيار أفضل ما يناسب فريقك وسيناريوهاتك.
| اللغة | الحزمة | المصدر | قوالب التشغيل السريع | العينات | المرجع |
|---|---|---|---|---|---|
| NET. | NuGet | GitHub | الاتصال إلى IoT Hub | عينات | مرجع |
| Python | نقطة | GitHub | الاتصال إلى IoT Hub | عينات | مرجع |
| Node.js | npm | GitHub | الاتصال إلى IoT Hub | عينات | مرجع |
| Java | Maven | GitHub | الاتصال إلى IoT Hub | عينات | مرجع |
| C | الحزم | GitHub | الاتصال إلى IoT Hub | عينات | مرجع |
يتضمن جهاز Java SDK عينات لنظام التشغيل Android.
يتضمن جهاز C SDK عينات لنظام التشغيل iOS التي تستخدم CocoaPods.
تحذير
Azure IoT C SDK غير مناسب للتطبيقات المضمنة بسبب إدارة الذاكرة ونموذج الترابط. للحصول على خيارات SDK للجهاز المضمنة، راجع حزم SDK للجهاز المضمنة.
استخدم SDKs للجهاز لتطوير التعليمات البرمجية للتشغيل على أجهزة IoT التي تتصل بمركز IoT أو IoT Central.
لمعرفة المزيد حول كيفية استخدام SDKs للجهاز، راجع ما هو تطوير جهاز وتطبيق Azure IoT؟.
عدد تطوير البرامج للأجهزة المضمنة
تم تصميم حزم SDK هذه وإنشاؤها للتشغيل على الأجهزة ذات موارد الحوسبة والذاكرة المحدودة ويتم تنفيذها باستخدام لغة C.
تتوفر حزم SDK للجهاز المضمنة لأنظمة تشغيل متعددة توفر المرونة لاختيار أفضل ما يناسب السيناريو الخاص بك.
| RTOS | SDK | المصدر | العينات | المرجع |
|---|---|---|---|---|
| Eclipse ThreadX | البرمجيات الوسيطة في Azure RTOS | GitHub | قوالب التشغيل السريع | مرجع |
| FreeRTOS | برنامج FreeRTOS وسيط | GitHub | عينات | مرجع |
| كمبيوتر بلا نظام تشغيل | Azure SDK لـ C المضمنة | GitHub | عينات | مرجع |
استخدم حزم SDK للجهاز المضمنة لتطوير التعليمات البرمجية للتشغيل على أجهزة IoT التي تتصل بمركز IoT أو 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 عن طريق إنشاء تذكرة دعم مباشرة من مدخل Microsoft Azure.
حزم SDK لخدمة IoT Hub
تحتوي عدد تطوير برامج خدمات Azure IoT على تعليمة برمجية لتسهيل إنشاء التطبيقات التي تتفاعل مباشرة مع IoT Hub لإدارة الأجهزة والأمان.
| النظام الأساسي | الحزمة | مستودع التعليمة البرمجية | العينات | المرجع |
|---|---|---|---|---|
| .NET | NuGet | GitHub | عينات | مرجع |
| Java | Maven | GitHub | عينات | مرجع |
| العقدة | npm | GitHub | عينات | مرجع |
| Python | نقطة | GitHub | عينات | مرجع |
لمعرفة المزيد حول استخدام حزم SDK للخدمة للتفاعل مع الأجهزة من خلال مركز IoT، راجع دليل مطور خدمة IoT أجهزة التوصيل و التشغيل.
SDKs لإدارة مركز IoT
تساعدك SDKs لإدارة IoT Hub على إنشاء تطبيقات خلفية تدير مراكز IoT في اشتراك Azure الخاص بك.
| النظام الأساسي | الحزمة | مستودع التعليمات البرمجية | المرجع |
|---|---|---|---|
| .NET | NuGet | GitHub | مرجع |
| Java | Maven | GitHub | مرجع |
| Node.js | npm | GitHub | مرجع |
| Python | نقطة | GitHub | مرجع |
تتضمن بدائل SDKs للإدارة Azure CLI وPowerShell وREST API.
DPS device SDKs
توفر مجموعات SDK لجهاز DPS تطبيقات لواجهة برمجة تطبيقات التسجيل وغيرها من الأجهزة التي تستدعيها لتوفيرها من خلال DPS. يمكن تشغيل SDKs للجهاز على أجهزة الحوسبة العامة المستندة إلى MPU مثل جهاز كمبيوتر شخصي أو كمبيوتر لوحي أو هاتف ذكي أو Raspberry Pi. تدعم حزم SDK التطوير في لغة C واللغات الحديثة المدارة بما في ذلك C# وNode.JS وPython وJava.
| النظام الأساسي | الحزمة | مستودع التعليمات البرمجية | العينات | تشغيل سريع | المرجع |
|---|---|---|---|---|---|
| .NET | NuGet | GitHub | عينات | التشغيل السريع | مرجع |
| C | apt-get أو MBED أو Arduino IDE أو iOS | GitHub | عينات | التشغيل السريع | مرجع |
| Java | Maven | GitHub | عينات | التشغيل السريع | مرجع |
| Node.js | npm | GitHub | عينات | التشغيل السريع | مرجع |
| Python | نقطة | GitHub | عينات | التشغيل السريع | مرجع |
تحذير
إن C SDK المذكورة أعلاه ليست مناسبة للتطبيقات المضمنة بسبب إدارة الذاكرة ونموذج الترابط. لمعرفة الأجهزة المضمنة، راجع حزم SDK للجهاز المضمّن.
حزم SDK لجهاز DPS المضمنة
تم تصميم حزم SDK هذه وإنشاؤها للتشغيل على الأجهزة ذات موارد الحوسبة والذاكرة المحدودة ويتم تنفيذها باستخدام لغة C.
| RTOS | SDK | المصدر | العينات | المرجع |
|---|---|---|---|---|
| Eclipse ThreadX | البرمجيات الوسيطة في Azure RTOS | GitHub | قوالب التشغيل السريع | مرجع |
| FreeRTOS | برنامج FreeRTOS وسيط | GitHub | عينات | مرجع |
| كمبيوتر بلا نظام تشغيل | Azure SDK لـ C المضمنة | GitHub | عينات | مرجع |
تعرف على المزيد حول الجهاز و SDKs للجهاز المضمن في IoT SDKs.
حزم SDK لخدمة DPS
تساعدك حزم SDK لخدمة DPS على إنشاء تطبيقات خلفية لإدارة التسجيلات وسجلات التسجيل في مثيلات DPS.
| النظام الأساسي | الحزمة | مستودع التعليمات البرمجية | العينات | تشغيل سريع | المرجع |
|---|---|---|---|---|---|
| .NET | NuGet | GitHub | عينات | التشغيل السريع | مرجع |
| Java | Maven | GitHub | عينات | التشغيل السريع | مرجع |
| Node.js | npm | GitHub | عينات | التشغيل السريع | مرجع |
مجموعات SDK لإدارة DPS
تساعدك مجموعات SDK لإدارة DPS على إنشاء تطبيقات خلفية تدير مثيلات DPS وبيانات التعريف الخاصة بها في اشتراك Azure الخاص بك.
| النظام الأساسي | الحزمة | مستودع التعليمات البرمجية | المرجع |
|---|---|---|---|
| .NET | NuGet | GitHub | مرجع |
| Java | Maven | GitHub | مرجع |
| Node.js | npm | GitHub | مرجع |
| Python | نقطة | GitHub | مرجع |
واجهات برمجة التطبيقات لمستوى التحكم في Azure Digital Twins
واجهات برمجة التطبيقات لمستوى التحكم هي واجهات برمجة تطبيقات ARM المستخدمة لإدارة مثيل Azure Digital Twins ككل، بحيث تغطي عمليات مثل إنشاء المثيل بأكمله أو حذفه. ستستخدم أيضا واجهات برمجة التطبيقات هذه لإنشاء نقاط النهاية وحذفها.
لاستدعاء واجهات برمجة التطبيقات مباشرة، راجع أحدث مجلد Swagger في مستودع Swagger لمستوى التحكم. يتضمن هذا المجلد أيضا مجلدا من الأمثلة التي تعرض الاستخدام.
فيما يلي SDKs المتوفرة حاليا لواجهات برمجة تطبيقات وحدة التحكم Azure Digital Twins.
واجهات برمجة تطبيقات مستوى بيانات Azure Digital Twins
واجهات برمجة تطبيقات مستوى البيانات هي واجهات برمجة تطبيقات Azure Digital Twins المستخدمة لإدارة العناصر داخل مثيل Azure Digital Twins. وهي تشمل عمليات مثل إنشاء المسارات وتحميل النماذج وإنشاء العلاقات وإدارة التوائم، ويمكن تقسيمها على نطاق واسع إلى الفئات التالية:
DigitalTwinModels- تحتوي فئة DigitalTwinModels على واجهات برمجة التطبيقات لإدارة النماذج في مثيل Azure Digital Twins. تتضمن أنشطة الإدارة تحميل النماذج التي تم تأليفها في DTDL والتحقق من صحتها واستردادها وحذفها.DigitalTwins- تحتوي فئة DigitalTwins على واجهات برمجة التطبيقات التي تتيح للمطورين إنشاء التوائم الرقمية وعلاقاتهم وتعديلها وحذفها في مثيل Azure Digital Twins.Query- تتيح فئة الاستعلام للمطورين العثور على مجموعات من التوائم الرقمية في الرسم البياني المزدوج عبر العلاقات.Event Routes- تحتوي فئة مسارات الأحداث على واجهات برمجة التطبيقات لتوجيه البيانات، من خلال النظام وإلى خدمات انتقال البيانات من الخادم.Import Jobs- تتيح لك واجهة برمجة تطبيقات استيراد المهام إدارة إجراء طويل الأمد وغير متزامن لاستيراد النماذج والتوائم والعلاقات بشكل مجمع.Delete Jobs- تتيح لك واجهة برمجة تطبيقات حذف المهام إدارة إجراء طويل الأمد وغير متزامن لحذف جميع النماذج والتوائم والعلاقات في مثيل.
لاستدعاء واجهات برمجة التطبيقات مباشرة، راجع أحدث مجلد Swagger في مستودع Swagger لمستوى البيانات. يتضمن هذا المجلد أيضا مجلدا من الأمثلة التي تعرض الاستخدام. يمكنك أيضا عرض الوثائق المرجعية لواجهة برمجة التطبيقات لمستوى البيانات.
فيما يلي SDKs المتوفرة حاليا لواجهات برمجة تطبيقات مستوى بيانات Azure Digital Twins.
الخطوات التالية
تتضمن الخطوات التالية المقترحة ما يلي: