Spaces:
Running
Running
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** إذا لزم الأمر
---
**🚀 مبروك! تطبيقك جاهز للعالم!**
|