📱 دليل بناء APK باستخدام Android Studio

🎯 الهدف: تحويل المشروع إلى ملف APK قابل للتثبيت

📋 الخطوات المفصلة:

الخطوة 1: فتح المشروع ⏱️ (2-3 دقائق)

افتح Android Studio
اختر "Open an Existing Project" أو "Open"
انتقل إلى مجلد المشروع:
```
E:\almada\android
```
اختر مجلد android (وليس المجلد الرئيسي)
اضغط "OK"

الخطوة 2: انتظار المزامنة ⏱️ (5-10 دقائق)

عند فتح المشروع لأول مرة، سيقوم Android Studio بـ:

📥 تحميل Gradle (إذا لم يكن مثبت)
📦 تحميل التبعيات (Dependencies)
🔄 مزامنة المشروع (Sync)

انتظر حتى تكتمل العملية! ستظهر رسالة في الأسفل:

✅ Gradle sync finished

الخطوة 3: حل المشاكل المحتملة ⏱️ (2-5 دقائق)

إذا ظهرت أي رسائل خطأ:

مشكلة SDK:

SDK location not found

الحل:

اذهب إلى File > Project Structure
اختر SDK Location
تأكد من مسار Android SDK

مشكلة Gradle:

Gradle version not supported

الحل:

اضغط على "Update Gradle" في الرسالة
أو اذهب إلى File > Project Structure > Project

الخطوة 4: بناء APK ⏱️ (3-5 دقائق)

في شريط القوائم، اختر:

Build > Build Bundle(s) / APK(s) > Build APK(s)

انتظر اكتمال البناء - ستظهر رسالة في الأسفل:
```
⏳ Building APK...
✅ APK(s) generated successfully
```
عند اكتمال البناء، ستظهر نافذة:
```
APK(s) generated successfully.

[locate] [analyze]
```
اضغط "locate" للذهاب إلى مجلد APK

الخطوة 5: العثور على ملف APK ⏱️ (1 دقيقة)

ملف APK سيكون في:

E:\almada\android\app\build\outputs\apk\debug\app-debug.apk

معلومات الملف:

الاسم: app-debug.apk
الحجم: ~15-20 MB
النوع: Debug APK (للاختبار)

🔧 استكشاف الأخطاء:

خطأ: "SDK not found"

# الحل:
1. اذهب إلى File > Settings
2. اختر Appearance & Behavior > System Settings > Android SDK
3. تأكد من تثبيت Android SDK

خطأ: "Gradle sync failed"

# الحل:
1. اضغط "Try Again"
2. أو اذهب إلى File > Sync Project with Gradle Files

خطأ: "Build failed"

# الحل:
1. اذهب إلى Build > Clean Project
2. ثم Build > Rebuild Project

📱 اختبار التطبيق:

الطريقة 1: على الكمبيوتر (محاكي)

إنشاء محاكي:
- اذهب إلى Tools > AVD Manager
- اضغط "Create Virtual Device"
- اختر جهاز (مثل Pixel 4)
- اختر نظام Android (API 30+)
تشغيل التطبيق:
- اضغط Run (الزر الأخضر)
- اختر المحاكي
- انتظر تشغيل التطبيق

الطريقة 2: على الهاتف الحقيقي

تفعيل Developer Options:
- اذهب إلى Settings > About Phone
- اضغط على Build Number 7 مرات
- ارجع إلى Settings وادخل Developer Options
- فعل USB Debugging
توصيل الهاتف:
- وصل الهاتف بـ USB
- اختر File Transfer في الهاتف
- في Android Studio، اختر جهازك من القائمة
- اضغط Run

الطريقة 3: تثبيت APK يدوياً

نسخ APK إلى الهاتف
في الهاتف:
- اذهب إلى Settings > Security
- فعل "Install from Unknown Sources"
- افتح ملف APK واضغط Install

🎯 بيانات التجربة:

بعد تثبيت التطبيق، استخدم:

رقم الهاتف: 777123456
رمز PIN: 1234

📊 معلومات التطبيق:

المعلومة	القيمة
اسم التطبيق	محفظتي الموحدة
Package Name	com.almada.unifiedwallet
الإصدار	1.0.0
حجم APK	~15-20 MB
الحد الأدنى	Android 7.0 (API 24)

🎉 النجاح!

عند اكتمال جميع الخطوات، ستحصل على:

✅ ملف APK جاهز للتثبيت
✅ تطبيق يعمل على الأندرويد
✅ واجهة عربية كاملة
✅ جميع الميزات متاحة

💡 نصائح مهمة:

للبناء الناجح:

تأكد من اتصال الإنترنت أثناء أول مزامنة
لا تغلق Android Studio أثناء التحميل
انتظر اكتمال جميع العمليات

للاختبار:

اختبر على أجهزة مختلفة إن أمكن
تأكد من جميع الميزات تعمل
اختبر تسجيل الدخول والتنقل

للمشاكل:

راجع Build Output في الأسفل
استخدم "Clean Project" عند المشاكل
أعد تشغيل Android Studio إذا لزم الأمر

🚀 مبروك! تطبيقك جاهز للعالم!