File size: 5,594 Bytes
a79063d
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
# 📱 دليل بناء 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** إذا لزم الأمر

---

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