استخدم Maven Central Repository Search من سطر الأوامر الخاص بك!
استخدم mcs
للبحث بسرعة عن إحداثيات التبعية في Maven Central، دون الحاجة إلى التبديل إلى متصفحك.
تدعم هذه الأداة أوضاع البحث التالية:
بحث البدل
mcs search plexus-utils
سيعطيك هذا جميع القطع الأثرية الموجودة في Maven Central والتي تحمل اسم "plexus-utils". يكون الإخراج في شكل جدولي، يوضح الإحداثيات الدقيقة لكل قطعة أثرية واللحظة التي تم فيها نشر أحدث إصدار لها.
تنسيق البحث
mcs search org.codehaus.plexus:plexus-utils
mcs search org.codehaus.plexus:plexus-utils:3.4.1
إذا كانت هناك عدة نتائج، فسوف تحصل على نفس نتائج الجدول كما هو مذكور أعلاه. ولكن إذا كانت هناك نتيجة واحدة فقط، فسيمنحك هذا بشكل افتراضي مقتطف pom.xml للعنصر الذي بحثت عنه. جاهز للنسخ واللصق في IDE المفضل لديك!
إذا كنت تريد مقتطفًا بتنسيق مختلف، فاستخدم -f <type>
أو --format=<type>
. الأنواع المدعومة هي: maven
، gradle
، gradle-short
، gradle-kotlin
، sbt
، ivy
، grape
، leiningen
، buildr
، jbang
، gav
.
البحث عن اسم الفئة
mcs class-search CommandLine
mcs class-search -f picocli.CommandLine
سيعطيك هذا جميع القطع الأثرية الموجودة في Maven Central والتي تحتوي على فئة معينة. إذا قمت بتعيين العلامة -f
، فسيتم اعتبار مصطلح البحث اسم فئة "مصنف بالكامل"، وبالتالي يتضمن اسم الحزمة.
-l <number>
، والذي يتيح لك تحديد عدد النتائج التي تريد رؤيتها على الأكثر .-s
(أو --show-vulnerabilities
). سيؤدي ذلك إلى قيام MCS بإظهار ملخص للثغرات الأمنية المبلغ عنها مقابل كل نتيجة. إذا كانت هناك نتيجة بحث واحدة فقط، فستعرض أرقام CVE المبلغ عنها مقابل تلك النتيجة. لاحظ أن هذه الميزة ستصل قريبًا إلى حدود واجهة برمجة التطبيقات (API) لمؤشر Sonatype OSS. راجع وثائقهم للحصول على تفاصيل حول كيفية تأثير ذلك على استخدامك. يمكنك تحديد بيانات الاعتماد الخاصة بك باستخدام خصائص النظام ossindex.username
و ossindex.password
. راجع قسم "تكوين MCS" لمعرفة كيفية القيام بذلك بالطريقة الأكثر ملاءمة. يمكنك تثبيت mcs باستخدام مدير الحزم الذي تختاره:
مدير الحزم | منصة | تثبيت | ملاحظات |
---|---|---|---|
البيرة المنزلية | ؟ ؟ | brew install mthmulders/tap/mcs | |
فرقعة | ؟ | snap install maven-central-search | |
SDKMAN! | ؟ ؟ | sdk install mcs | |
شوكولاتة | ؟ | choco install mcs | |
مغرفة | ؟ | scoop install mthmulders/mcs |
في بعض المواقف، مثل عندما تعمل خلف جدار حماية يعترض TLS (الشركة)، قد يفشل MCS مع
فشل بناء مسار PKIX: sun.security.provider.certpath.SunCertPathBuilderException: غير قادر على العثور على مسار شهادة صالح للهدف المطلوب
في كلام الشخص العادي: لا يحتوي مخزن الثقة الافتراضي المدمج (مجموعة شهادات X.509 الموثوقة) على أي شيء يسمح بالثقة في الشهادة (الشهادات) المقدمة من الخادم. يستخدم Maven Central شهادة يمكن الوثوق بها، ولكن السبب هنا هو جدار الحماية (الشركة) الذي يعترض TLS والذي يقدم شهادة داخلية.
الحل هو إنشاء مخزن ثقة يحتوي على الشهادة "الأعلى" في سلسلة الشهادات، على سبيل المثال شهادة المرجع المصدق (الداخلي). يمكنك استخدام أداة مثل Portecle لإنشاء مثل هذا المتجر الموثوق. بعد ذلك، قم بتوجيه MCS إلى مخزن الثقة هذا بهذه الطريقة
mcs -Djavax.net.ssl.trustStore=/path/to/keystore search something
إذا كنت تعمل خلف وكيل، فسوف تحترم MCS متغيرات البيئة HTTP_PROXY
و HTTPS_PROXY
.
يتم تمرير بعض تكوينات MCS عبر خصائص النظام. يمكنك القيام بذلك في كل مرة تقوم فيها باستدعاء MCS عن طريق إضافة -Dxxx=yyy
. ولجعل الأمر أكثر ملاءمة، يمكنك إنشاء ملف تكوين سيتم قراءته تلقائيًا بواسطة MCS وتفسيره على أنه إعدادات التكوين.
للقيام بذلك، قم بإنشاء دليل .mcs في دليل المستخدم الخاص بك (عادةً C:Users<your-user-name> على ?، أو /home/ على ? أو /Users/ على ?). داخل هذا المجلد، قم بإنشاء ملف mcs.config واكتب السطر التالي فيه:
javax.net.ssl.trustStore=/path/to/keystore
ossindex.username=xxx
ossindex.password=yyy
بهذه الطريقة، ليس عليك أن تتذكر تمرير -D
.
ربما تكون أسهل طريقة للحصول على بيئة تطوير عمل هي استخدام Gitpod:
سيقوم بتكوين مساحة عمل في متصفحك وإظهار أن كل شيء يعمل كما هو متوقع عن طريق تشغيل mvn verify
. لا يؤثر هذا الإعداد على جهاز الكمبيوتر الخاص بك - بمجرد إغلاق علامة تبويب المتصفح، فإنه يختفي.
تحقق من المشكلات إذا كنت تبحث عن شيء للعمل عليه. إذا كانت لديك فكرة جديدة، فلا تتردد في طرحها باستخدام المناقشات.
لم يكن MCS ممكنًا لولا مساهمات الأشخاص الرائعين حول العالم. القائمة الكاملة موجودة في CONTRIBUTORS.md.