ANDROID_STUDIO_GUIDE.md

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

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

---

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

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

1. **افتح Android Studio**
2. **اختر "Open an Existing Project"** أو **"Open"**
3. **انتقل إلى مجلد المشروع:**
   ```
   E:\almada\android
   ```
4. **اختر مجلد `android`** (وليس المجلد الرئيسي)
5. **اضغط "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 دقائق)

1. **في شريط القوائم، اختر:**
   ```
   Build > Build Bundle(s) / APK(s) > Build APK(s)
   ```

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

3. **عند اكتمال البناء، ستظهر نافذة:**
   ```
   APK(s) generated successfully.
   
   [locate] [analyze]
   ```

4. **اضغط "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"**
```bash
# الحل:
1. اذهب إلى File > Settings
2. اختر Appearance & Behavior > System Settings > Android SDK
3. تأكد من تثبيت Android SDK
```

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

### **خطأ: "Build failed"**
```bash
# الحل:
1. اذهب إلى Build > Clean Project
2. ثم Build > Rebuild Project
```

---

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

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

2. **تشغيل التطبيق:**
   - اضغط **Run** (الزر الأخضر)
   - اختر المحاكي
   - انتظر تشغيل التطبيق

### **الطريقة 2: على الهاتف الحقيقي**
1. **تفعيل Developer Options:**
   - اذهب إلى **Settings > About Phone**
   - اضغط على **Build Number** 7 مرات
   - ارجع إلى Settings وادخل **Developer Options**
   - فعل **USB Debugging**

2. **توصيل الهاتف:**
   - وصل الهاتف بـ USB
   - اختر **File Transfer** في الهاتف
   - في Android Studio، اختر جهازك من القائمة
   - اضغط **Run**

### **الطريقة 3: تثبيت APK يدوياً**
1. **نسخ APK إلى الهاتف**
2. **في الهاتف:**
   - اذهب إلى **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** إذا لزم الأمر

---

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