APK_BUILD_GUIDE.md

# دليل بناء APK - محفظتي الموحدة

## 🎯 **الوضع الحالي**

✅ **تم إنجازه:**
- ✅ إعداد مشروع Capacitor كامل
- ✅ تثبيت Java JDK 11
- ✅ إضافة منصة الأندرويد
- ✅ نسخ ملفات التطبيق إلى مجلد www
- ✅ إضافة الأذونات المطلوبة
- ✅ إعداد ملفات التكوين

❌ **المطلوب لإكمال البناء:**
- ❌ تثبيت Android SDK
- ❌ إعداد متغيرات البيئة
- ❌ بناء APK

---

## 📋 **خطوات إكمال بناء APK**

### **الطريقة 1: استخدام Android Studio (الأسهل)**

#### 1. تحميل وتثبيت Android Studio:
```
https://developer.android.com/studio
```

#### 2. فتح المشروع:
```bash
cd E:\almada\android
# ثم فتح المجلد في Android Studio
```

#### 3. بناء APK:
- في Android Studio: **Build > Build Bundle(s) / APK(s) > Build APK(s)**
- انتظار اكتمال البناء
- ستجد APK في: `android/app/build/outputs/apk/debug/`

---

### **الطريقة 2: سطر الأوامر (متقدم)**

#### 1. تثبيت Android SDK:
```bash
# تحميل Command Line Tools من:
# https://developer.android.com/studio#command-tools

# استخراج إلى مجلد مثل:
# C:\Android\cmdline-tools\latest\
```

#### 2. إعداد متغيرات البيئة:
```bash
# إضافة إلى متغيرات البيئة:
ANDROID_HOME=C:\Android
ANDROID_SDK_ROOT=C:\Android
PATH=%PATH%;%ANDROID_HOME%\cmdline-tools\latest\bin
PATH=%PATH%;%ANDROID_HOME%\platform-tools
```

#### 3. تثبيت SDK Components:
```bash
sdkmanager "platform-tools" "platforms;android-33" "build-tools;33.0.0"
```

#### 4. بناء APK:
```bash
cd E:\almada\android
.\gradlew assembleDebug
```

---

### **الطريقة 3: استخدام Ionic CLI (الأبسط)**

#### 1. تثبيت Android Studio أولاً (للحصول على SDK)

#### 2. استخدام Ionic:
```bash
cd E:\almada
ionic cap build android
```

---

## 📱 **ملفات APK المتوقعة**

بعد البناء الناجح ستجد:

### **APK للتطوير:**
```
android/app/build/outputs/apk/debug/app-debug.apk
```

### **APK للإنتاج:**
```
android/app/build/outputs/apk/release/app-release.apk
```

---

## 🔧 **إعدادات إضافية للتطبيق**

### **الأذونات المضافة:**
```xml
<!-- الأذونات الأساسية -->
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.VIBRATE" />

<!-- أذونات SMS (للمستقبل) -->
<uses-permission android:name="android.permission.READ_SMS" />
<uses-permission android:name="android.permission.RECEIVE_SMS" />

<!-- أذونات البصمة -->
<uses-permission android:name="android.permission.USE_FINGERPRINT" />
<uses-permission android:name="android.permission.USE_BIOMETRIC" />
```

### **معلومات التطبيق:**
- **اسم التطبيق:** محفظتي الموحدة
- **Package ID:** com.almada.unifiedwallet
- **الإصدار:** 1.0.0

---

## 🚀 **اختبار التطبيق**

### **تثبيت APK على الهاتف:**
```bash
# تفعيل Developer Options و USB Debugging
# ثم:
adb install app-debug.apk
```

### **أو نسخ APK إلى الهاتف وتثبيته يدوياً**

---

## 📊 **الميزات المتاحة في التطبيق**

### **الصفحة الرئيسية:**
- تسجيل دخول برقم هاتف + PIN
- عرض المحافظ الـ6 (جوالي، ONE Cash، إلخ)
- عرض الأرصدة الموحدة

### **الميزات المتقدمة:**
- واجهة عربية كاملة (RTL)
- تصميم متجاوب
- رسوم متحركة سلسة
- دعم الوضع الليلي

### **الأمان:**
- تشفير البيانات محلياً
- حماية PIN
- جلسات آمنة

---

## 🎯 **الخطوات التالية بعد البناء**

### **للاختبار:**
1. تثبيت APK على الهاتف
2. اختبار تسجيل الدخول (777123456 / 1234)
3. اختبار جميع الميزات
4. التأكد من الأداء

### **للتطوير:**
1. إضافة ميزات قراءة SMS
2. تطوير نظام الإشعارات
3. إضافة المزيد من المحافظ
4. تحسين الأمان

### **للنشر:**
1. إنشاء حساب Google Play Developer
2. إعداد التوقيع للإنتاج
3. رفع التطبيق للمراجعة
4. التسويق والترويج

---

## 💡 **نصائح مهمة**

### **للبناء الناجح:**
- تأكد من تثبيت Java JDK 11+ ✅
- تأكد من تثبيت Android SDK
- تأكد من إعداد متغيرات البيئة
- استخدم Android Studio للسهولة

### **للاختبار:**
- اختبر على أجهزة مختلفة
- اختبر جميع الميزات
- تأكد من الأداء والاستقرار

### **للأمان:**
- لا تشارك ملفات التوقيع
- استخدم ProGuard للحماية
- اختبر الأمان بعناية

---

**🎉 مبروك! تطبيقك جاهز للبناء والاختبار!**

للمساعدة في أي خطوة، راجع الوثائق أو تواصل مع فريق التطوير.