> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerix.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# التحكم بالإصدارات

> اقترح تحديث التطبيق أو اجعله إلزامياً، وضع تطبيقك في وضع الصيانة، وأوصل التغيير إلى الأجهزة دون نشر إصدار جديد.

## ما الذي تقدّمه

تتيح لك وحدة التحكم بالإصدارات أن تغيّر ما يراه المستخدمون حين يفتحون تطبيقك،
من لوحة التحكم، دون نشر نسخة جديدة. وهي تغطي ثلاث حالات:

* **صدر تحديث جديد.** أخبر مستخدمي الإصدارات القديمة بأن إصداراً جديداً متاح،
  أو أوصِ به، أو اجعله شرطاً لمتابعة استخدام التطبيق.
* **إصدار معطوب.** احظر إصداراً بعينه أو أكثر، كنسخة تتعطل عند التشغيل أو
  تسرّب بيانات، ووجّه مستخدميه إلى المتجر.
* **الخدمة متوقفة.** ضع التطبيق كله، أو جزءاً من جمهورك، في وضع الصيانة مع
  رسالة تغطي الشاشة بالكامل حتى ترفعها.

تتحقق حزمة Lerix الموجودة أصلاً في تطبيقك من إعدادات المشروع عند تشغيل التطبيق
وعند عودته إلى الواجهة. وتعرض شاشات جاهزة بالعربية والإنجليزية، أو تسلّم الحالة
إلى واجهتك الخاصة.

## تنبيهات التحديث

لكل منصة قاعدة تحديث تحدد الإصدارات الحالية. يقارن كل جهاز إصداره بها، فيقع في
واحدة من أربع حالات:

| الحالة | ما يراه المستخدم | هل يستطيع متابعة استخدام التطبيق؟ |
| - | - | - |
| **لا شيء** | لا شيء | نعم |
| **اختياري** (`available`) | مطالبة فيها **تحديث** و**لاحقاً**، و**تخطي هذا الإصدار** إن كان مسموحاً | نعم |
| **مُوصى به** (`recommended`) | المطالبة نفسها، دون **تخطي هذا الإصدار** | نعم |
| **إلزامي** (`required`) | شاشة كاملة تمنع الاستخدام، فيها زر **تحديث** | لا |

تسمّي لوحة التحكم القاعدة التي تمنع المستخدمين **تحديثاً إجبارياً**.

تلتزم المطالبات غير الإلزامية (الاختيارية والمُوصى بها) بمدة التذكير، ولا تظهر أكثر من
مرة في الجلسة الواحدة. ويمكن أن تحمل المطالبة موعداً نهائياً يصبح بعده
إلزامياً. راجع [قواعد التحديث](https://docs.lerix.dev/ar/modules/release-control/update-rules.md).

## وضع الصيانة

يغطي وضع الصيانة التطبيق بشاشة لا يمكن تجاوزها: عنوانك ورسالتك، ووقت العودة
المتوقع إن أردت، وزر **حاول مرة أخرى**. ابدأه فوراً أو حدّد له موعداً، واقصره
على منصات أو إصدارات أو دول معينة، واستثنِ فريقك عبر قائمة استثناء. وتنتهي كل
نافذة صيانة من تلقاء نفسها، بعد 7 أيام كحد أقصى من بدايتها. راجع
[وضع الصيانة](https://docs.lerix.dev/ar/modules/release-control/maintenance-mode.md).

## أي شاشة تظهر أولاً

إذا انطبقت أكثر من حالة، تعرض الحزمة شاشة واحدة، بهذا الترتيب:

1. **الصيانة**
2. **التحديث الإلزامي**
3. **التحديث المُوصى به أو الاختياري**

لا تظهر المطالبة غير الإلزامية أبداً فوق شاشة الصيانة أو التحديث الإلزامي، ولا قبل
أن يرسم تطبيقك شاشته الأولى.

## المنصات

| الحزمة | شاشات جاهزة | الدليل |
| - | - | - |
| Flutter (iOS وأندرويد وmacOS وWindows والويب) | نعم | [Flutter](https://docs.lerix.dev/ar/frameworks/flutter/release-control.md) |
| Swift (iOS وiPadOS وmacOS) | نعم | [Swift](https://docs.lerix.dev/ar/frameworks/ios/release-control.md) |
| Kotlin (أندرويد) | نعم، مع دعم اختياري لتحديثات Google Play داخل التطبيق | [Kotlin](https://docs.lerix.dev/ar/frameworks/android/release-control.md) |
| React وNext.js وAngular والويب (JS) | نعم | [React](https://docs.lerix.dev/ar/frameworks/react/release-control.md)، [Next.js](https://docs.lerix.dev/ar/frameworks/nextjs/release-control.md)، [Angular](https://docs.lerix.dev/ar/frameworks/angular/release-control.md)، [الويب](https://docs.lerix.dev/ar/frameworks/web/release-control.md) |

لا تعرض حزم الخادم وEdge أي شاشات، لذا لا ينطبق عليها التحكم بالإصدارات.

## سرعة وصول التغيير

* تتحقق التطبيقات عند التشغيل، ثم عند عودتها إلى الواجهة إذا مضى على آخر تحقق
  أكثر من 5 دقائق.
* عند أي تغيير يمنع المستخدمين أو يرفع المنع عنهم (الصيانة، أو تحديث إجباري، أو
  **رفع الكل**)، يرسل Lerix أيضاً إشعاراً صامتاً إلى كل جهاز لديه رمز إشعارات من
  Lerix، فتتحدث تطبيقات الجوال وسطح المكتب العاملة في الخلفية كذلك.
* خلال 30 دقيقة بعد أي تغيير، وطوال سريان نافذة صيانة، تتحقق التطبيقات المفتوحة
  كل دقيقة. وتعتمد صفحات الويب والتطبيقات التي لا تستخدم إشعارات Lerix على هذا
  التحقق.

وتعرض لوحة التحكم عدد الأجهزة النشطة التي استلمت آخر تغيير. راجع
[وصول التغييرات والعمل دون اتصال](https://docs.lerix.dev/ar/modules/release-control/delivery-offline.md).

## مفتاح إيقاف لحزمة Lerix نفسها

القناة نفسها تحميك منّا أيضاً. إذا أساء أحد إصدارات حزمة Lerix التصرف في
تطبيقك يوماً ما، يستطيع فريق Lerix إيقاف عمل تلك الحزمة عن بُعد، للإصدارات
المتأثرة فقط، دون أن تنشر أنت تحديثاً لتطبيقك.

* **ما الذي يتوقف**: حركة Lerix الخاصة ومعالجاتها، مثل تقارير الأخطاء
  والتحليلات وتتبّع الطلبات والملاحظات والاستبيانات وتسجيل رموز الإشعارات. قد
  يشمل الإيقاف وحدة واحدة أو جميعها.
* **ما الذي يستمر**: تطبيقك، واتصالاته الخاصة بالشبكة، وفحص إعدادات Lerix،
  ليمكن رفع الإيقاف لاحقاً.
* **مصير البيانات المنتظرة**: تبقى على الجهاز وتُرسل بعد رفع الإيقاف.
* **مدته**: لكل إيقاف وقت انتهاء يُرفع عنده تلقائياً، حتى على جهاز غير متصل.

هذه شبكة أمان نأمل ألا نحتاج إليها أبداً، ولا يتطلب وجودها أي إعداد منك.

## من يستطيع التعديل

يستطيع أي عضو في المشروع فتح **التحكم بالإصدارات** والاطلاع على القواعد ونوافذ
الصيانة والسجل. أما التعديل فيتطلب صلاحية **إدارة تحديثات التطبيق**، وهي متاحة
لدوري **المالك** و**المسؤول**. راجع
[الأحداث والـ Webhooks والصلاحيات](https://docs.lerix.dev/ar/modules/release-control/events-webhooks.md).

> [!NOTE]
>
> يعمل التحكم بالإصدارات داخل تطبيقك، لذا قد تتجاهله نسخة معدَّلة أو قديمة جداً.
> استخدمه وسيلةً للوصول إلى مستخدميك، واستمر في فرض كل ما يمس الأمان على خادمك
> أيضاً.

> **[قواعد التحديث](https://docs.lerix.dev/ar/modules/release-control/update-rules.md)**
>
> أحدث إصدار وأدنى إصدار، والإصدارات المحظورة، والمواعيد النهائية، وروابط المتاجر.

> **[وضع الصيانة](https://docs.lerix.dev/ar/modules/release-control/maintenance-mode.md)**
>
> حدّد الموعد والنطاق، وجرّبه على أجهزتك، ثم فعّله للجميع.

> **[وصول التغييرات والعمل دون اتصال](https://docs.lerix.dev/ar/modules/release-control/delivery-offline.md)**
>
> متى تتحقق التطبيقات، وماذا تفعل دون شبكة.

> **[واجهة مخصصة](https://docs.lerix.dev/ar/modules/release-control/custom-ui.md)**
>
> ارسم شاشاتك الخاصة من الحالة نفسها.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.