هذا المستودع مخصص للتطوير النشط لـ Azure SDK لـ Java. بالنسبة لعملاء SDK، نوصي بزيارة مستندات المطورين العامة أو مستندات المطورين ذات الإصدار الخاص بنا.
للبدء في استخدام مكتبة خدمة معينة، راجع ملف README.md الموجود في مجلد مشروع المكتبة. يمكنك العثور على مكتبات الخدمة في الدليل /sdk
. للحصول على قائمة بجميع الخدمات التي ندعمها، قم بالوصول إلى قائمتنا الخاصة بجميع المكتبات الموجودة.
للحصول على البرامج التعليمية والعينات والبدايات السريعة والوثائق الأخرى، تفضل بزيارة Azure لمطوري Java.
تعتمد جميع المكتبات على Java 8، مع الاختبار والدعم الأمامي حتى أحدث إصدار دعم طويل المدى لـ Java (حاليًا Java 17).
يمكن أن تحتوي كل خدمة على مكتبات "العميل" و"الإدارة". تُستخدم مكتبات "العميل" لاستهلاك الخدمة، بينما تُستخدم مكتبات "الإدارة" لتكوين الخدمة وإدارتها.
تتبع مكتبات عملائنا إرشادات تصميم Azure SDK لـ Java، وتشارك عددًا من الميزات الأساسية مثل إعادة محاولة HTTP، والتسجيل، وبروتوكولات النقل، وبروتوكولات المصادقة، وما إلى ذلك، بحيث بمجرد أن تتعلم كيفية استخدام هذه الميزات في مكتبة عميل واحدة، ستعرف كيفية استخدامها في مكتبات العملاء الأخرى. يمكنك التعرف على هذه الميزات المشتركة هنا. يمكن التعرف بسهولة على هذه المكتبات من خلال أسماء المجلدات والحزمة ومساحات الأسماء التي تبدأ بـ azure-
، على سبيل المثال azure-keyvault
.
يمكنك العثور على أحدث قائمة بجميع الباقات الجديدة على صفحتنا . تتضمن هذه القائمة أحدث الإصدارات: الثابتة والتجريبية.
ملاحظة: إذا كنت بحاجة إلى التأكد من أن التعليمات البرمجية الخاصة بك جاهزة للإنتاج، فاستخدم إحدى المكتبات الثابتة غير التجريبية.
كما هو الحال مع مكتبات عملائنا، تتبع مكتبات الإدارة إرشادات تصميم Azure SDK لـ Java. توفر هذه المكتبات واجهة برمجة تطبيقات عالية المستوى وموجهة نحو الكائنات لإدارة موارد Azure، والتي تم تحسينها لسهولة الاستخدام والإيجاز والاتساق. يمكنك العثور على قائمة مكتبات الإدارة في هذه الصفحة .
للحصول على وثائق عامة حول كيفية استخدام المكتبات الجديدة لإدارة موارد Azure، يرجى زيارة هنا . لقد قمنا أيضًا بإعداد الكثير من نماذج التعليمات البرمجية بالإضافة إلى دليل الترحيل في حالة قيامك بالترقية من الإصدارات السابقة.
يمكن التعرف على مكتبات الإدارة من خلال مساحات الأسماء التي تبدأ بـ azure-resourcemanager
، على سبيل المثال azure-resourcemanager-compute
.
لاحظ أن أحدث المكتبات من Microsoft موجودة في معرف مجموعة com.azure
Maven، ولها نمط تسمية الحزمة الذي يبدأ بـ com.azure
. إذا كنت تستخدم المكتبات الموجودة في معرف مجموعة com.microsoft.azure
Maven، أو لديك هذا كبنية الحزمة، فيرجى التفكير في الترحيل إلى أحدث المكتبات. يمكنك العثور على جدول تعيين من هذه الإصدارات التاريخية إلى ما يعادلها هنا.
azure-java-sdk
. يحتوي الفرع الرئيسي على أحدث التعليمات البرمجية مع ميزات جديدة وإصلاحات للأخطاء. وهو لا يمثل أحدث إصدار ثابت من SDK.
لكل حزمة نطلقها، ستكون هناك علامة git فريدة تم إنشاؤها تحتوي على اسم الحزمة وإصدارها لتمييز التزام الكود الذي أنتج الحزمة. سيتم استخدام هذه العلامة للخدمة عبر فروع الإصلاح العاجل بالإضافة إلى تصحيح التعليمات البرمجية لإصدار تجريبي أو إصدار ثابت معين. تنسيق علامات الإصدار هو <package-name>_<package-version>
. لمزيد من المعلومات يرجى الاطلاع على استراتيجية التفرع لدينا.
للحصول على تفاصيل حول المساهمة في هذا المستودع، راجع دليل المساهمة.
يرحب هذا المشروع بالمساهمات والاقتراحات. تتطلب معظم المساهمات منك الموافقة على اتفاقية ترخيص المساهم (CLA) التي تعلن أن لديك الحق في منحنا حقوق استخدام مساهمتك، بل وتفعل ذلك بالفعل. للحصول على التفاصيل، قم بعرض CLA الخاص بشركة Microsoft.
عند إرسال طلب سحب، سيحدد روبوت CLA تلقائيًا ما إذا كنت بحاجة إلى تقديم CLA وتزيين العلاقات العامة بشكل مناسب (على سبيل المثال، التسمية، التعليق). ما عليك سوى اتباع التعليمات التي يقدمها لك الروبوت. سوف تحتاج إلى القيام بذلك مرة واحدة فقط عبر جميع المستودعات التي تستخدم CLA الخاص بنا.
اعتمد هذا المشروع قواعد السلوك الخاصة بشركة Microsoft مفتوحة المصدر. لمزيد من المعلومات، راجع الأسئلة الشائعة حول قواعد السلوك أو اتصل بـ [email protected] لطرح أي أسئلة أو تعليقات إضافية.
لقد ساعد العديد من الأشخاص في جميع أنحاء العالم في تحسين هذا المشروع. سوف ترغب في التحقق من:
يجب الإبلاغ عن مشكلات الأمان والأخطاء بشكل خاص، عبر البريد الإلكتروني، إلى مركز الاستجابة الأمنية لـ Microsoft (MSRC) [email protected]. يجب أن تتلقى الرد خلال 24 ساعة. إذا لم تقم بذلك لأي سبب من الأسباب، فيرجى المتابعة عبر البريد الإلكتروني للتأكد من أننا تلقينا رسالتك الأصلية. يمكن العثور على مزيد من المعلومات، بما في ذلك مفتاح MSRC PGP، في Security TechCenter.
تم ترخيص Azure SDK لـ Java بموجب ترخيص MIT.