Discord.Net
v3.16.0
يمكن العثور على الوثائق على https://docs.discordnet.dev/index.html
Discord.Net هو مشروع مفتوح المصدر مرخص من معهد ماساتشوستس للتكنولوجيا (MIT) وقد تم تطويره بالكامل بواسطة متطوعين. إذا كنت ترغب في دعم جهودنا ماليًا، يرجى مراعاة ما يلي:
إصداراتنا المستقرة متاحة من NuGet من خلال الحزمة الوصفية Discord.Net:
يمكن أيضًا تثبيت المكونات الفردية من NuGet:
خطافات الويب
خدمات الأوامر النصية والتفاعل.
تغطية كاملة لواجهة برمجة التطبيقات (API).
جوهر API. تنفذ فقط الكيانات والوظائف المجردة.
Nightlies هي إصدارات من Discord.NET لا تزال في مرحلة تجريبية ولم يتم إصدارها.
وهي متوفرة من خلال مصدرين مختلفين:
ملحوظة
تتطلب حزم GitHub المصادقة. يمكنك العثور على مزيد من المعلومات هنا.
لا يدعم .NET Core 1.1 WebSockets على نظام التشغيل Win7 والإصدارات الأقدم. تم إصلاح هذه المشكلة منذ إصدار .NET Core 2.1. يوصى باستهداف .NET Core 2.1 أو أعلى لمشروعك إذا كنت ترغب في تشغيل الروبوت الخاص بك على الأنظمة الأساسية القديمة؛ وبدلاً من ذلك، يمكنك اختيار تثبيت الحزمة Discord.Net.Providers.WS4Net.
يدعم Discord فقط TLS1.2+ على جميع مواقعهم الإلكترونية بما في ذلك واجهة برمجة التطبيقات (API) منذ 19/07/2022. لا يدعم .NET Framework هذا البروتوكول بشكل افتراضي. إذا كنت تعتمد على .NET Framework، فمن المقترح ترقية مشروعك إلى net6-windows . يدعم إطار العمل هذا معظم ميزات Windows فقط التي يقدمها fx، ويحل أخطاء بدء التشغيل الناتجة عن عدم تطابق بروتوكول TLS.
تلتزم هذه المكتبة عمومًا بالإصدار الدلالي. يتم نشر الحزم بتنسيق إصدار MAJOR.MINOR.PATCH .
تشير زيادة مكون PATCH دائمًا إلى أنه تم إجراء تغيير داخلي فقط، وهو إصلاح للأخطاء بشكل عام. لن تؤثر هذه التغييرات على واجهة برمجة التطبيقات العامة بأي شكل من الأشكال، ويضمن دائمًا أن تكون متوافقة مع قاعدة التعليمات البرمجية الخاصة بك، وأي تبعيات مجمعة مسبقًا لقاعدة التعليمات البرمجية الخاصة بك.
تشير زيادة المكون MINOR إلى إجراء بعض الإضافات إلى المكتبة، وهذه الإضافة غير متوافقة مع الإصدارات السابقة. ومع ذلك، لا يضمن Discord.Net التوافق مع الإضافات البسيطة. بمعنى آخر، نحن نسمح بمجموعة محدودة من التغييرات العاجلة عند حدوث تغيير بسيط في الإصدار.
نظرًا لطبيعة Discord API، سنحتاج في كثير من الأحيان إلى إضافة خاصية إلى كيان لدعم أحدث تغييرات واجهة برمجة التطبيقات. يوفر Discord.Net واجهات كوسيلة لاستهلاك الكيانات؛ وعلى هذا النحو، يعد إدخال حقل جديد إلى كيان ما بمثابة تغيير جذري من الناحية الفنية. تشير نتوءات الإصدار الرئيسي بشكل عام إلى بعض التغييرات الرئيسية في المكتبة، وعلى هذا النحو نحن مترددون في رفع الإصدار الرئيسي لكل إضافة بسيطة إلى المكتبة. للتوصل إلى حل وسط، قررنا أنه يجب التعامل مع الواجهات على أنها قابلة للاستهلاك فقط ، ويجب ألا تقوم تطبيقاتك عادةً بتنفيذ واجهات.
بالنسبة للتطبيقات التي يتم فيها تنفيذ الواجهات، كما هو الحال في نماذج الاختبار، فإننا نعتذر عن هذا التعارض مع SemVer.
على الرغم من أننا لن نقوم مطلقًا بكسر واجهة برمجة التطبيقات (خارج تغييرات الواجهة) في الإصدارات البسيطة، سنحتاج أحيانًا إلى كسر واجهة برمجة التطبيقات (ABI)، عن طريق إدخال معلمات إلى طريقة لمطابقة التغييرات في المنبع مع Discord. على هذا النحو، قد تتطلب منك زيادة طفيفة في الإصدار إعادة ترجمة التعليمات البرمجية الخاصة بك، وقد تحتاج أيضًا التبعيات، مثل الوظائف الإضافية، إلى إعادة ترجمة وإعادة نشرها على الإصدار الأحدث. عند إجراء تغيير كسر ثنائي، سيتم ملاحظة التغيير في ملاحظات الإصدار.
تشير زيادة المكون الرئيسي إلى إجراء تغييرات جذرية على المكتبة؛ يجب على المستهلكين التحقق من ملاحظات الإصدار لتحديد التغييرات التي يجب إجراؤها.
فرع الإصدار بعد الرائد. عند الإصدار، سيتم دفع التصحيحات إلى هذه الفروع. سيتم وضع علامة على إصدارات NuGet الجديدة في هذه الفروع.
فرع التطوير متاح على MyGet. هذا الفرع هو ما تستهدفه طلبات السحب.
الفروع التي تستهدف التطوير وإضافة ميزات جديدة. لا تتردد في استكشاف هذه الفروع وإبداء الرأي عند الضرورة.
يستهدف عادةً المطورين. تُستخدم هذه الفروع لتحديث الوثائق إما بميزات جديدة أو بإعادة صياغة الميزات الموجودة.
