دورة الحياة والمراحل

ينظّم Maven بناء مشروع في دورة حياة (lifecycle): سلسلة مرتَّبة من المراحل. عندما تطلب مرحلة، ينفّذ Maven كل المراحل السابقة بالترتيب.

هذا أهم مبدأ يُحفَظ :

طلب مرحلة ينفّذ تلقائياً كل ما يسبقها. إذن mvn package يطلق أيضاً validate و compile و test.

لدى Maven في الواقع ثلاث دورات حياة :

# تنفيذ مرحلة = تنفيذ الكل حتى تبلغها
mvn package      # يطلق validate -> compile -> test -> package

تمرين مصغّر — أي مراحل تُنفَّذ عندما تشغّل mvn package؟ اسردها بالترتيب.

تضم دورة الحياة default مراحل كثيرة؛ هذه الأكثر استخداماً يومياً :

mvn validate    # تحققات أساسية
mvn compile     # + التجميع
mvn test        # + الاختبارات الوحدية
mvn package     # + إنشاء الأثر
mvn verify      # + اختبارات التكامل
mvn install     # + نسخ إلى ~/.m2
mvn deploy      # + نشر بعيد

كلما تقدّمنا في القائمة، زاد ما يفعله Maven. mvn install «السكين السويسري» للتطوير المحلي: يبني الكل ويجعل الأثر متاحاً لمشاريعك الأخرى على الجهاز نفسه.

تحوّل المرحلة compile شفرة Java (src/main/java) إلى bytecode (.class) في target/classes. يتولى ذلك إضافة Compiler، باستخدام javac في JDK.

يُحدَّد إصدار Java بالخصائص التي رأيناها في الدرس 02 :

<properties>
    <maven.compiler.source>17</maven.compiler.source>
    <maven.compiler.target>17</maven.compiler.target>
</properties>

# تجميع الشفرة الرئيسية
mvn compile

# تجميع شفرة الاختبار أيضاً
mvn test-compile

تمرين مصغّر — في أي مجلد يُودَع الـ bytecode .class للشفرة الرئيسية بعد mvn compile؟

النتيجة في target/ :

target/
└── classes/
    └── com/exemple/App.class   <-- bytecode مجمَّع

إذا فشل التجميع (BUILD FAILURE)، يتوقف Maven فوراً: لا تُنفَّذ المراحل التالية (test، package). نصحّح دائماً أخطاء التجميع أولاً.

تشغّل المرحلة test الاختبارات الوحدية في src/test/java. تطلقها إضافة Surefire، عادة مع إطار JUnit.

اختبار JUnit نموذجي :

import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.assertEquals;

class CalculTest {
    @Test
    void additionDeDeuxNombres() {
        assertEquals(4, 2 + 2);
    }
}

# تشغيل كل الاختبارات
mvn test

# تشغيل صنف اختبار واحد
mvn test -Dtest=CalculTest

# البناء مع تخطي الاختبارات (يُتجنَّب إلا لحالات محددة)
mvn package -DskipTests

تمرين مصغّر — اكتب أمر Maven الذي يغلف المشروع دون تشغيل الاختبارات.

mvn package -DskipTests

إذا فشل اختبار واحد، يفشل البناء كله (BUILD FAILURE) ولا يُنتَج package. هذا مقصود: لا نسلّم أثراً لا تنجح اختباراته. تخطي الاختبارات بـ -DskipTests يجب أن يبقى استثناء.

تجمع المرحلة package الشفرة المجمَّعة في أثر قابل للتسليم، يُودَع في target/. يعتمد نوع الأثر على الوسم <packaging> في pom.xml.

<!-- اختيار نوع الأثر -->
<packaging>jar</packaging>

# إنتاج الأثر
mvn package

# تحديد النتيجة
ls target/

النتيجة :

target/
├── classes/
├── mon-app-1.0.0-SNAPSHOT.jar   <-- الأثر القابل للتسليم
└── ...

يتبع اسم الأثر النمط artifactId-version.packaging. مثال: mon-app-1.0.0-SNAPSHOT.jar. هذا الملف الذي توزّعه أو تنشره.

بعد package، تكمل ثلاث عمليات دورة الحياة.

التوليفة clean install من الأكثر شيوعاً: تضمن بناءً نظيفاً تماماً.

# البدء من الصفر والبناء حتى التثبيت المحلي
mvn clean install

# البناء والنشر على المستودع البعيد للفريق
mvn clean deploy

mvn clean install المنعكس عندما «لم يعد يعمل بلا سبب»: يحذف clean ملفات مجمَّعة قديمة محتملة في target/.

تمرين مصغّر — اكتب الأمر الذي يبدأ من target/ نظيف ثم يثبّت الأثر في المستودع المحلي ~/.m2.

mvn clean install

السؤال 1: ماذا يحدث عندما تشغّل mvn package؟

a) تُنفَّذ مرحلة package وحدها

b) ينفّذ Maven أيضاً كل المراحل السابقة (validate، compile، test)

c) ينشر Maven الأثر على مستودع بعيد

d) يحذف Maven المجلد target/

السؤال 2: أي إضافة Maven تشغّل الاختبارات الوحدية؟

a) Compiler

b) Surefire

c) Shade

d) Jar

السؤال 3: ماذا تفعل المرحلة install؟

a) تثبّت Maven على الجهاز

b) تنسخ الأثر إلى المستودع المحلي ~/.m2

c) تنشر على Maven Central

d) تحذف target/

السؤال 4: أي وسم يحدد إن كان المشروع ينتج .jar أو .war؟

a) <scope>

b) <version>

c) <packaging>

d) <artifactId>

السؤال 5: ماذا يحدث أثناء mvn package إذا فشل اختبار وحدي؟

a) يُنتَج الأثر رغم ذلك

b) يفشل البناء (BUILD FAILURE) ولا يُنتَج الأثر

c) يتجاهل Maven الاختبار

d) ينتقل Maven مباشرة إلى deploy

المطلوب

على مشروع Maven، اجتز دورة الحياة خطوة بخطوة: نظّف، جمّع، اختبر، غلّف، ثم ثبّت محلياً. راقب في كل خطوة ما ينتجه Maven في target/.

التصحيح — سلسلة الأوامر المتوقعة

# 1. البدء من الصفر: يحذف target/
mvn clean

# 2. التجميع: ينتج target/classes
mvn compile
ls target/classes        # bytecode .class موجود

# 3. الاختبار: Surefire يشغّل اختبارات JUnit
mvn test

# 4. التغليف: ينتج .jar في target/
mvn package
ls target/*.jar          # mon-app-1.0.0-SNAPSHOT.jar

# 5. التثبيت في المستودع المحلي ~/.m2
mvn install

# الصيغة المختصرة الأكثر شيوعاً:
mvn clean install

النتيجة المتوقعة :

[INFO] --- compiler:compile --- (target/classes créé)
[INFO] --- surefire:test --- Tests run: 1, Failures: 0, Errors: 0
[INFO] --- jar:jar --- Building jar: target/mon-app-1.0.0-SNAPSHOT.jar
[INFO] --- install:install --- Installing ... to ~/.m2/repository/...
[INFO] BUILD SUCCESS

لاحظ ترتيب أسطر [INFO]: compile ثم test ثم jar ثم install. هذا الدليل الظاهر على أن Maven يسلسل المراحل تلقائياً بترتيب دورة الحياة.

النقاط التي يجب تذكّرها

1. دورة الحياة سلسلة مرتَّبة من المراحل؛ طلب مرحلة ينفّذ كل ما يسبقها.
2. مراحل أساسية: validate → compile → test → package → verify → install → deploy.
3. compile (إضافة Compiler) تنتج الـ bytecode في target/classes.
4. test (إضافة Surefire + JUnit) تشغّل الاختبارات؛ الفشل يوقف البناء.
5. package تنشئ .jar/.war؛ install تنسخه إلى ~/.m2؛ clean يفرغ target/.

ما يلي

تتقن الآن Maven: البنية، و pom.xml، والتبعيات، ودورة الحياة. الوحدة 04 تتناول التحوية بـ Docker، حيث ستغلف هذه الآثار Maven في صور قابلة للنقل.