كيف تعمل الوسوم (Tags) والإصدارات (Releases) في Git؟

Question

Accepted Answer

تُحدد **الوسوم** نقاطًا محددة في السجل كنقاط مهمة — عادةً **الإصدارات** (الإصدارات مثل v1.0.0). على عكس الفروع، الوسوم هي مؤشرات ثابتة لا تتحرك، وتُستخدم لتسمية والإشارة إلى إصدارات الإصدار. إنها مركزية في إدارة الإصدارات والإصدار.

## إنشاء الوسوم

```bash
# annotated tag (recommended for releases — has metadata: tagger, date, message)
git tag -a v1.0.0 -m "Release version 1.0.0"

# lightweight tag (just a pointer, no metadata)
git tag v1.0.0

# tag a specific past commit
git tag -a v1.0.0 <commit> -m "..."
```

**الوسوم المعلقة** (موصى بها للإصدارات) تخزن البيانات الوصفية (المُنشئ، التاريخ، الرسالة)؛ **الوسوم الخفيفة** هي مجرد اسم يشير إلى التزام.

## العمل مع الوسوم

```bash
git tag                        # list tags
git show v1.0.0                # show a tag and its commit
git checkout v1.0.0            # check out the code at a tag (detached HEAD)

# tags are NOT pushed by default — push them explicitly:
git push origin v1.0.0         # push a specific tag
git push origin --tags         # push all tags
```

مهم: **الوسوم لا تُرسل تلقائيًا** باستخدام `git push` — يجب أن تدفعها بشكل صريح.

## الوسوم مقابل الفروع

```text
BRANCH → a MOVABLE pointer that advances as you commit (ongoing development)
TAG    → a FIXED pointer to a specific commit (a permanent label — doesn't move)
→ Use tags to permanently mark releases/milestones; branches for ongoing work.
```

## إصدارات الدلالات والإصدارات

```text
SEMANTIC VERSIONING (SemVer): MAJOR.MINOR.PATCH (e.g. v2.3.1)
  MAJOR → breaking changes | MINOR → new features (compatible) | PATCH → bug fixes
→ Tags label these versions. Platforms (GitHub) build "Releases" from tags
  (with release notes, built artifacts) for distribution.
```

## لماذا يُهم ذلك

فهم الوسوم والإصدارات مفيد لـ **إدارة الإصدارات والإصدار**، لذا فهو معرفة عملية مفيدة للعمل مع البرامج المُصدرة. **الوسوم** تحدد نقاطًا مهمة في السجل — عادةً **إصدارات الإصدار** (مثل v1.0.0) — مما يوفر مراجع ثابتة ودائمة لالتزامات محددة، وهو ضروري لتتبع والإشارة إلى الكود الذي يشكل كل إصدار.

فهم التمييز بين **الوسوم المعلقة** (موصى بها للإصدارات، تخزين البيانات الوصفية مثل المُنشئ والتاريخ والرسالة) والوسوم الخفيفة هو معرفة عملية لوسم الإصدار الصحيح.

معرفة كيفية إنشاء وإدراج والتحقق من الوسوم، والأهم من ذلك أن **الوسوم لا تُرسل تلقائيًا** (مما يتطلب `git push origin --tags` الصريح أو دفع وسوم محددة — خطأ شائع حيث ينسى الناس إرسال الوسوم التي أنشأوها)، ضروري لإدارة وسوم الإصدار بشكل صحيح.

فهم **الوسوم مقابل الفروع** (الوسم هو مؤشر ثابت لالتزام محدد — تسمية دائمة لا تتحرك — بينما الفرع هو مؤشر متحرك يتقدم مع التطوير) يوضح أدوارهم المختلفة: الوسوم لتحديد الإصدارات والمعالم بشكل دائم، الفروع للعمل المستمر.

فهم الاتصال بـ **الإصدارات الدلالية** (اتفاقيات MAJOR.MINOR.PATCH للتواصل حول طبيعة التغييرات) وكيفية بناء المنصات **الإصدارات** من الوسوم (مع ملاحظات الإصدار والقطع الأثرية للتوزيع) يعكس كيفية توافق الوسوم مع إدارة الإصدار الفعلية.

نظرًا لأن إصدار وإصدار البرامج هو احتياج شائع والوسوم هي آلية Git لتحديد والإشارة إلى إصدارات الإصدار (المركزية في إدارة الإصدار والمدمجة مع ميزات الإصدار الخاصة بالمنصات)، فإن فهم الوسوم والإصدارات — الوسوم المعلقة مقابل الوسوم الخفيفة، وإرسالها، والوسوم مقابل الفروع، ودورها في الإصدارات/الإصدارات — معرفة Git عملية وذات صلة قيمة لإدارة البرامج المُصدرة، وهو جانب مفيد من التطوير المهني المرتبط بـ اتفاقيات الإصدارات وعمليات الإصدار.