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

# تثبيت تطبيق الأندرويد

> كيفية تحميل، إعداد وتثبيت تطبيق الأندرويد الأصلي (APK) لبوابة طالب معهد إيصال.

بالإضافة إلى نسخة تطبيق الويب (PWA)، يوفر معهد إيصال تطبيق أندرويد أصلي (ملف `.apk`) تم تطويره باستخدام Capacitor. يحتوي هذا التطبيق على تحسينات أداء أصلية وتكامل متقدم مع نظام التنبيهات المباشرة لنظام أندرويد.

## تفاصيل التطبيق

* **اسم الحزمة (Package Name):** `dz.essal.institute`
* **اسم التطبيق (App Name):** Essal Mobile (إيصال موبايل)
* **المتطلبات الأساسية:** نظام تشغيل أندرويد 8.0 (Oreo) أو أحدث.

***

## خطوات التثبيت (ملف APK)

بما أن التطبيق يتم توزيعه مباشرة من خلال قسم تكنولوجيا المعلومات بالمعهد، يجب عليك إجراء تثبيت يدوي لملف APK:

### الخطوة 1: تحميل ملف APK

1. قم بتسجيل الدخول إلى [بوابة الطالب](https://app.essal.institute) من متصفح هاتفك المحمول.
2. انتقل إلى قسم **الإعداد التقني والتحميلات (Technical Setup & Downloads)**.
3. اضغط على زر **تحميل تطبيق إيصال للأندرويد (APK)** لتحميل أحدث نسخة.

### الخطوة 2: تفعيل تثبيت التطبيقات من مصادر غير معروفة

لحماية جهازك، يتم تعطيل تثبيت التطبيقات من خارج متجر Google Play افتراضياً. يجب تفعيل هذا الخيار مؤقتاً لمتصفحك أو لمدير الملفات:

1. افتح ملف APK الذي قمت بتحميله.
2. إذا ظهرت لك رسالة تنبيه تقول *"لدواعي أمنية، لا يُسمح لهاتفك بتثبيت تطبيقات غير معروفة من هذا المصدر"*، اضغط على **الإعدادات (Settings)**.
3. قم بتفعيل خيار **السماح من هذا المصدر (Allow from this source)**.
4. اضغط على زر العودة.

### الخطوة 3: تثبيت التطبيق

1. اضغط على **تثبيت (Install)** في نافذة التثبيت.
2. انتظر حتى تكتمل عملية التثبيت.
3. بمجرد التثبيت، اضغط على **فتح (Open)** لتشغيل تطبيق إيصال موبايل.

***

## تفعيل التنبيهات الإشعارات

لتلقي تحديثات الجداول الدراسية، مواعيد الامتحانات، وتنبيهات الحضور في الوقت الفعلي:

1. عند تشغيل التطبيق للمرة الأولى، سيطلب منك الإذن: *"هل تريد السماح لتطبيق Essal Mobile بإرسال إشعارات إليك؟"*.
2. اضغط على **سماح (Allow)**.
3. إذا قمت برفض الإذن بالخطأ، انتقل إلى **إعدادات هاتفك ← التطبيقات ← Essal Mobile ← الإشعارات** وتأكد من تفعيل خيار **عرض الإشعارات (Show Notifications)**.

***

## الإعداد التقني (خاص بمسؤولي النظام)

إذا كنت مسؤول نظام تقوم بإعداد تحديث للتطبيق:

* يتطلب النشر على متجر Google Play رفع حزمة تطبيق أندرويد موقعة (`.aab`) والموجودة في المسار `android/app/release/app-release.aab`.
* يجب تسجيل معرف التطبيق `dz.essal.institute` في مشروع Firebase وتضمين بيانات الاعتماد `FIREBASE_SERVICE_ACCOUNT` على خادم الويب لتتمكن البوابة من إرسال التنبيهات بنجاح عبر Firebase Cloud Messaging (FCM).