حل التبعية عبر البرنامج المساعد Shade لـ NoClassDefFoundError

في أول تجربة مع Maven، يمكن أن تنشأ تناقضات بين Eclipse واستخدام سطر الأوامر بسبب إدارة التبعية. على الرغم من نجاح إنشاء مشروع Maven وإضافة التبعيات داخل Eclipse، إلا أن تنفيذ المشروع عبر سطر الأوامر قد يؤدي إلى خطأ NoClassDefFoundError.

افتراضيًا، يقوم Maven بتجميع التبعيات بشكل منفصل ولا يقوم بتضمينها في ملف JAR المترجم. يؤدي هذا الإغفال إلى فشل Java VM عند محاولة تحديد موقع فئات المكتبة أثناء التنفيذ.

بدلاً من إضافة المكتبات يدويًا إلى مسار الفصل، يوفر البرنامج الإضافي maven-shade-plugin حلاً أكثر كفاءة. يقوم بإنشاء "uber-JAR" الذي يجمع بين فئات التطبيق ورمز المكتبة المطلوب.

لتنفيذ ذلك، أضف تكوين البرنامج المساعد التالي إلى POM الخاص بك:

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-shade-plugin</artifactId>
    <version>3.5.2</version>
    <executions>
        <execution>
            <phase>package</phase>
            <goals>
                <goal>shade</goal>
            </goals>
        </execution>
    </executions>
</plugin>

بعد إضافة هذا التكوين، أعد تشغيل الأوامر التالية:

$ mvn package
$ java -cp target/bil138_4-0.0.1-SNAPSHOT.jar tr.edu.hacettepe.cs.b21127113.bil138_4.App

للحصول على خيارات التكوين المتقدمة، مثل تحديد ملفات JAR المضمنة أو ملف JAR قابل للتنفيذ، راجع قسم "الأمثلة" على موقع الويب maven-shade-plugin.