ملاحظة: إذا كنت تبحث عن Swagger Core 1.5.X وOpenAPI 2.0، فيرجى الرجوع إلى الفرع 1.5.
ملاحظة: منذ الإصدار 2.1.7، يدعم Swagger Core أيضًا مساحة الاسم Jakarta. توجد مجموعة متوازية من القطع الأثرية مع اللاحقة -jakarta
، مما يوفر نفس الوظيفة التي توفرها القطع الأثرية غير اللاحقة (على سبيل المثال: javax
). يرجى الاطلاع على ويكي لمزيد من التفاصيل.
ملاحظة: نظرًا لأن الإصدار 2.2.0، يدعم Swagger Core OpenAPI 3.1؛ انظر هذه الصفحة للحصول على التفاصيل
Swagger Core هو تطبيق Java لمواصفات OpenAPI. الإصدار الحالي يدعم JAX-RS2 (مساحات الأسماء javax
و jakarta
).
راجع الدليل الخاص ببدء استخدام Swagger Core للبدء في إضافة Swagger إلى واجهة برمجة التطبيقات (API) الخاصة بك.
يحتوي موقع github wiki على وثائق وعينات ومساهمات وما إلى ذلك. ابدأ من هناك.
خضعت مواصفات OpenAPI للعديد من المراجعات منذ الإنشاء الأولي في عام 2010. يتمتع مشروع Swagger Core بالتوافقات التالية مع مواصفات OpenAPI:
النسخة الأساسية سواغر | تاريخ الافراج عنه | توافق مواصفات OpenAPI | ملحوظات | حالة |
---|---|---|---|---|
2.2.26 ( المستقر الحالي ) | 2024-11-18 | 3.x | العلامة v2.2.26 | المدعومة |
2.2.25 | 2024-10-02 | 3.x | العلامة v2.2.25 | المدعومة |
2.2.24 | 2024-09-23 | 3.x | العلامة v2.2.24 | المدعومة |
2.2.23 | 2024-08-28 | 3.x | العلامة v2.2.23 | المدعومة |
2.2.22 | 15-05-2024 | 3.x | العلامة v2.2.22 | المدعومة |
2.2.21 | 2024-03-20 | 3.x | العلامة v2.2.21 | المدعومة |
2.2.20 | 2023-12-19 | 3.x | العلامة v2.2.20 | المدعومة |
2.2.19 | 2023-11-10 | 3.x | العلامة v2.2.19 | المدعومة |
2.2.18 | 2023-10-25 | 3.x | العلامة v2.2.18 | المدعومة |
2.2.17 | 2023-10-12 | 3.x | العلامة v2.2.17 | المدعومة |
2.2.16 | 18-09-2023 | 3.x | العلامة v2.2.16 | المدعومة |
2.2.15 | 2023-07-08 | 3.x | العلامة v2.2.15 | المدعومة |
2.2.14 | 2023-06-26 | 3.x | العلامة v2.2.14 | المدعومة |
2.2.13 | 2023-06-24 | 3.x | العلامة v2.2.13 | المدعومة |
2.2.12 | 2023-06-13 | 3.x | العلامة v2.2.12 | المدعومة |
2.2.11 | 2023-06-01 | 3.x | العلامة v2.2.11 | المدعومة |
2.2.10 | 15-05-2023 | 3.x | العلامة v2.2.10 | المدعومة |
2.2.9 | 2023-03-20 | 3.x | العلامة v2.2.9 | المدعومة |
2.2.8 | 2023-01-06 | 3.x | العلامة v2.2.8 | المدعومة |
2.2.7 | 2022-11-15 | 3.0 | العلامة v2.2.7 | المدعومة |
2.2.6 | 2022-11-02 | 3.0 | العلامة v2.2.6 | المدعومة |
2.2.5 | 2022-11-02 | 3.0 | العلامة v2.2.5 | المدعومة |
2.2.4 | 2022-10-16 | 3.0 | العلامة v2.2.4 | المدعومة |
2.2.3 | 2022-09-27 | 3.0 | العلامة v2.2.3 | المدعومة |
2.2.2 | 2022-07-20 | 3.0 | العلامة v2.2.2 | المدعومة |
2.2.1 | 15-06-2022 | 3.0 | العلامة v2.2.1 | المدعومة |
2.2.0 | 2022-04-04 | 3.0 | العلامة v2.2.0 | المدعومة |
2.1.13 | 2022-02-07 | 3.0 | العلامة v2.1.13 | المدعومة |
2.1.12 | 2021-12-23 | 3.0 | العلامة v2.1.12 | المدعومة |
2.1.11 | 2021-09-29 | 3.0 | العلامة v2.1.11 | المدعومة |
2.1.10 | 2021-06-28 | 3.0 | العلامة v2.1.10 | المدعومة |
2.1.9 | 2021-04-20 | 3.0 | العلامة v2.1.9 | المدعومة |
2.1.8 | 2021-04-18 | 3.0 | العلامة v2.1.8 | المدعومة |
2.1.7 | 2021-02-18 | 3.0 | العلامة v2.1.7 | المدعومة |
2.1.6 | 2020-12-04 | 3.0 | العلامة v2.1.6 | المدعومة |
2.1.5 | 2020-10-01 | 3.0 | العلامة v2.1.5 | المدعومة |
2.1.4 | 2020-07-24 | 3.0 | العلامة v2.1.4 | المدعومة |
2.1.3 | 2020-06-27 | 3.0 | العلامة v2.1.3 | المدعومة |
2.1.2 | 2020-04-01 | 3.0 | العلامة v2.1.2 | المدعومة |
2.1.1 | 2020-01-02 | 3.0 | العلامة v2.1.1 | المدعومة |
2.1.0 | 2019-11-16 | 3.0 | العلامة v2.1.0 | المدعومة |
2.0.10 | 2019-10-11 | 3.0 | العلامة v2.0.10 | المدعومة |
2.0.9 | 2019-08-22 | 3.0 | العلامة v2.0.9 | المدعومة |
2.0.8 | 2019-04-24 | 3.0 | العلامة v2.0.8 | المدعومة |
2.0.7 | 2019-02-18 | 3.0 | العلامة v2.0.7 | المدعومة |
2.0.6 | 2018-11-27 | 3.0 | العلامة v2.0.6 | المدعومة |
2.0.5 | 2018-09-19 | 3.0 | العلامة v2.0.5 | المدعومة |
2.0.4 | 2018-09-05 | 3.0 | العلامة v2.0.4 | المدعومة |
2.0.3 | 2018-08-09 | 3.0 | العلامة v2.0.3 | المدعومة |
1.6.14 ( المستقر الحالي ) | 2024-03-19 | 2.0 | العلامة v1.6.14 | المدعومة |
1.6.13 | 2024-01-26 | 2.0 | العلامة v1.6.13 | المدعومة |
1.6.12 | 2023-10-14 | 2.0 | العلامة v1.6.12 | المدعومة |
1.6.11 | 15-05-2023 | 2.0 | العلامة v1.6.11 | المدعومة |
1.6.10 | 2023-03-21 | 2.0 | العلامة v1.6.10 | المدعومة |
1.6.9 | 2022-11-15 | 2.0 | العلامة v1.6.9 | المدعومة |
1.6.8 | 2022-10-16 | 2.0 | العلامة v1.6.8 | المدعومة |
1.6.7 | 2022-09-27 | 2.0 | العلامة v1.6.7 | المدعومة |
1.6.6 | 2022-04-04 | 2.0 | العلامة v1.6.6 | المدعومة |
1.6.5 | 2022-02-07 | 2.0 | العلامة v1.6.5 | المدعومة |
1.6.4 | 2021-12-23 | 2.0 | العلامة v1.6.4 | المدعومة |
1.6.3 | 2021-09-29 | 2.0 | العلامة v1.6.3 | المدعومة |
1.6.2 | 2020-07-01 | 2.0 | العلامة v1.6.2 | المدعومة |
1.6.1 | 2020-04-01 | 2.0 | العلامة v1.6.1 | المدعومة |
1.6.0 | 2019-11-16 | 2.0 | العلامة v1.6.0 | المدعومة |
1.5.24 | 2019-10-11 | 2.0 | العلامة v1.5.24 | المدعومة |
1.5.23 | 2019-08-22 | 2.0 | العلامة v1.5.23 | المدعومة |
1.5.22 | 2019-02-18 | 2.0 | العلامة v1.5.22 | المدعومة |
1.5.21 | 2018-08-09 | 2.0 | العلامة v1.5.21 | المدعومة |
1.5.20 | 2018-05-23 | 2.0 | العلامة v1.5.20 | المدعومة |
2.0.2 | 2018-05-23 | 3.0 | العلامة v2.0.2 | المدعومة |
2.0.1 | 2018-04-16 | 3.0 | العلامة v2.0.1 | المدعومة |
1.5.19 | 2018-04-16 | 2.0 | العلامة v1.5.19 | المدعومة |
2.0.0 | 2018-03-20 | 3.0 | العلامة v2.0.0 | المدعومة |
2.0.0-rc4 | 2018-01-22 | 3.0 | العلامة v2.0.0-rc4 | المدعومة |
2.0.0-rc3 | 2017-11-21 | 3.0 | العلامة v2.0.0-rc3 | المدعومة |
2.0.0-rc2 | 2017-09-29 | 3.0 | العلامة v2.0.0-rc2 | المدعومة |
2.0.0-rc1 | 2017-08-17 | 3.0 | العلامة v2.0.0-rc1 | المدعومة |
1.5.18 | 2018-01-22 | 2.0 | العلامة v1.5.18 | المدعومة |
1.5.17 | 2017-11-21 | 2.0 | العلامة v1.5.17 | المدعومة |
1.5.16 | 15-07-2017 | 2.0 | العلامة v1.5.16 | المدعومة |
1.3.12 | 2014-12-23 | 1.2 | العلامة v1.3.12 | المدعومة |
1.2.4 | 19/06/2013 | 1.1 | علامة swagger-project_2.10.0-1.2.4 | مهمل |
1.0.0 | 2011-10-16 | 1.0 | العلامة v1.0 | مهمل |
إذا كنت مهتمًا بتاريخ التغيير في Swagger وإطار عمل Swagger Core، فراجع هنا.
أنت بحاجة إلى تثبيت ما يلي وتوافره في $PATH الخاص بك:
# first time building locally
mvn -N
البنيات اللاحقة:
mvn install
سيؤدي هذا إلى بناء الوحدات.
بالطبع إذا كنت لا ترغب في البناء محليًا، يمكنك الحصول على القطع الأثرية من maven Central:
https://repo1.maven.org/maven2/io/swagger/core/
تم نقل العينات إلى مستودع جديد وتحتوي على عمليات تكامل وتكوينات متنوعة.
يرجى الكشف عن أي مشكلات أو نقاط ضعف متعلقة بالأمان عن طريق إرسال بريد إلكتروني إلى [email protected]، بدلاً من استخدام أداة تعقب المشكلات العامة.