# تعليمات بناء تطبيق محفظتي الموحدة

## متطلبات النظام

### الأدوات المطلوبة:
- **Node.js** (الإصدار 18 أو أحدث)
- **npm** أو **yarn**
- **Ionic CLI** (الإصدار 7 أو أحدث)
- **Angular CLI** (الإصدار 17 أو أحدث)
- **Capacitor CLI** (الإصدار 5 أو أحدث)

### للأندرويد:
- **Android Studio** (أحدث إصدار)
- **Android SDK** (API Level 24 أو أحدث)
- **Java JDK** (الإصدار 11 أو أحدث)

### لـ iOS:
- **Xcode** (أحدث إصدار)
- **iOS SDK** (iOS 13 أو أحدث)
- **macOS** (مطلوب لبناء تطبيقات iOS)

## خطوات التثبيت

### 1. تثبيت الأدوات العامة
```bash
# تثبيت Node.js من https://nodejs.org

# تثبيت Ionic CLI
npm install -g @ionic/cli

# تثبيت Angular CLI
npm install -g @angular/cli

# تثبيت Capacitor CLI
npm install -g @capacitor/cli
```

### 2. إعداد المشروع
```bash
# الانتقال إلى مجلد المشروع
cd almada

# تثبيت التبعيات
npm install

# أو باستخدام yarn
yarn install
```

### 3. إعداد Capacitor
```bash
# تهيئة Capacitor
npx cap init "محفظتي الموحدة" "com.almada.unifiedwallet"

# إضافة منصات
npx cap add android
npx cap add ios
```

## بناء التطبيق

### 1. بناء تطبيق الويب
```bash
# بناء للتطوير
ionic build

# بناء للإنتاج
ionic build --prod
```

### 2. بناء تطبيق الأندرويد

#### أ. إعداد Android Studio
```bash
# نسخ الملفات إلى مجلد الأندرويد
npx cap copy android

# مزامنة المشروع
npx cap sync android

# فتح في Android Studio
npx cap open android
```

#### ب. بناء APK من سطر الأوامر
```bash
# بناء APK للتطوير
cd android
./gradlew assembleDebug

# بناء APK للإنتاج
./gradlew assembleRelease

# بناء AAB للنشر في Google Play
./gradlew bundleRelease
```

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

### 3. بناء تطبيق iOS

#### أ. إعداد Xcode
```bash
# نسخ الملفات إلى مجلد iOS
npx cap copy ios

# مزامنة المشروع
npx cap sync ios

# فتح في Xcode
npx cap open ios
```

#### ب. بناء IPA من Xcode
1. افتح Xcode
2. اختر جهاز أو محاكي
3. اختر **Product > Archive**
4. بعد اكتمال الأرشفة، اختر **Distribute App**
5. اتبع التعليمات لإنشاء ملف IPA

## تشغيل التطبيق للتطوير

### 1. تشغيل في المتصفح
```bash
# تشغيل خادم التطوير
ionic serve

# تشغيل مع إعادة التحميل التلقائي
ionic serve --lab
```

### 2. تشغيل على الأندرويد
```bash
# تشغيل على جهاز أو محاكي
ionic cap run android

# تشغيل مع إعادة التحميل المباشر
ionic cap run android --livereload --external
```

### 3. تشغيل على iOS
```bash
# تشغيل على جهاز أو محاكي
ionic cap run ios

# تشغيل مع إعادة التحميل المباشر
ionic cap run ios --livereload --external
```

## إعدادات الإنتاج

### 1. تحديث المتغيرات
قم بتحديث ملف `src/environments/environment.prod.ts`:
```typescript
export const environment = {
  production: true,
  apiUrl: 'https://api.almada.com',
  // ... باقي الإعدادات
};
```

### 2. إعداد الأيقونات والشاشات
```bash
# إنشاء الأيقونات والشاشات تلقائياً
npm install -g cordova-res
cordova-res android --skip-config --copy
cordova-res ios --skip-config --copy
```

### 3. توقيع التطبيق للأندرويد
```bash
# إنشاء مفتاح التوقيع
keytool -genkey -v -keystore my-release-key.keystore -alias alias_name -keyalg RSA -keysize 2048 -validity 10000

# إضافة إعدادات التوقيع في android/app/build.gradle
```

### 4. إعداد التوقيع لـ iOS
1. افتح Xcode
2. اذهب إلى **Signing & Capabilities**
3. اختر **Team** و **Bundle Identifier**
4. تأكد من إعداد **Provisioning Profile**

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

### 1. اختبار الوحدة
```bash
# تشغيل اختبارات الوحدة
npm test

# تشغيل مع المراقبة
npm test -- --watch
```

### 2. اختبار النهاية إلى النهاية
```bash
# تشغيل اختبارات e2e
npm run e2e
```

### 3. اختبار على الأجهزة
```bash
# تثبيت على جهاز أندرويد
adb install android/app/build/outputs/apk/debug/app-debug.apk

# عرض سجلات الأندرويد
adb logcat
```

## نشر التطبيق

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

### 2. Apple App Store
1. إنشاء حساب مطور في App Store Connect
2. رفع التطبيق عبر Xcode أو Application Loader
3. ملء معلومات التطبيق
4. إرسال للمراجعة

## استكشاف الأخطاء

### مشاكل شائعة:

#### 1. خطأ في بناء الأندرويد
```bash
# تنظيف المشروع
cd android
./gradlew clean

# إعادة بناء
./gradlew build
```

#### 2. مشاكل Capacitor
```bash
# إعادة مزامنة
npx cap sync

# تحديث Capacitor
npm update @capacitor/core @capacitor/cli
```

#### 3. مشاكل الأذونات
تأكد من إضافة الأذونات المطلوبة في:
- `android/app/src/main/AndroidManifest.xml` للأندرويد
- `ios/App/App/Info.plist` لـ iOS

## الدعم والمساعدة

للحصول على المساعدة:
1. راجع [وثائق Ionic](https://ionicframework.com/docs)
2. راجع [وثائق Capacitor](https://capacitorjs.com/docs)
3. تواصل مع فريق التطوير

---

**ملاحظة**: تأكد من تحديث جميع التبعيات بانتظام للحصول على أحدث الميزات وإصلاحات الأمان.