نشر تطبيق الجوال (EAS Build)

تبني خدمة Expo Application Services (EAS) تطبيق React Native الخاص بك وتحوّله إلى ملف APK (لأندرويد) أو IPA (لآيفون) قابل للمشاركة.

الخطوة 1: تثبيت EAS CLI

npm install -g eas-cli

الخطوة 2: تسجيل الدخول إلى Expo

eas login
# أدخل اسم مستخدم Expo وكلمة المرور

الخطوة 3: ضبط EAS

أنشئ الملف mobile/eas.json:

{
  "cli": {
    "version": ">= 3.0.0"
  },
  "build": {
    "development": {
      "developmentClient": true,
      "distribution": "internal"
    },
    "preview": {
      "android": {
        "buildType": "apk"
      },
      "ios": {
        "simulator": true
      }
    },
    "production": {}
  },
  "submit": {
    "production": {}
  }
}

الخطوة 4: البناء لأندرويد (APK)

cd mobile
eas build --platform android --profile preview

تستغرق هذه العملية من 5 إلى 10 دقائق. ترفع EAS الكود إلى خوادم Expo، وتبنيه هناك، ثم تعطيك رابط تحميل.

الناتج ملف بامتداد .apk يمكنك: - مشاركته مع أي شخص (يثبّته على أندرويد) - تثبيته يدويًا على الأجهزة - رفعه إلى متجر Google Play

الخطوة 5: البناء لآيفون (IPA)

eas build --platform ios --profile preview

ملاحظة: يتطلب البناء لآيفون حساب Apple Developer (بقيمة 99 دولارًا سنويًا) وشهادة. وللاختبار، استخدم نسخة محاكي iOS (الخيار --profile preview يبني للمحاكي).

الخطوة 6: مشاركة التطبيق مع المختبِرين

بعد اكتمال البناء، تعطيك EAS رابطًا مثل:

https://expo.dev/accounts/yourname/projects/mobile/builds/abc123

شارك هذا الرابط — يستطيع المختبِرون تثبيت ملف APK مباشرة على أندرويد.

الخطوة 7: تحديث رابط API للإنتاج

قبل البناء للإنتاج، تأكد من أن الملف App.tsx يشير إلى الواجهة الخلفية المنشورة:

const API_BASE_URL = "https://YOUR_USERNAME-aiproject-backend.hf.space";

اختياري: النشر في متاجر التطبيقات

متجر Google Play

  1. أنشئ حساب Google Play Developer (بقيمة 25 دولارًا تُدفع مرة واحدة)
  2. في الملف eas.json، استخدم ملف التعريف production
  3. شغّل eas build --platform android --profile production
  4. انتقل إلى Google Play Console → أنشئ تطبيقًا جديدًا
  5. ارفع ملف .aab الناتج عن البناء
  6. املأ بيانات صفحة المتجر وسياسة الخصوصية وما إلى ذلك.
  7. أرسله للمراجعة

متجر تطبيقات Apple

  1. أنشئ حساب Apple Developer (بقيمة 99 دولارًا سنويًا)
  2. شغّل eas build --platform ios --profile production
  3. انتقل إلى App Store Connect → أنشئ تطبيقًا جديدًا
  4. ارفع ملف IPA باستخدام تطبيق Transporter
  5. املأ بيانات صفحة المتجر
  6. أرسله للمراجعة

بديل: تحديثات OTA

للتحديثات السريعة دون إعادة بناء، استخدم Expo Updates:

eas update --branch production --message "Fix typo in chat UI"

يصل التحديث إلى المستخدمين فورًا (دون مراجعة من متجر التطبيقات). لكن هذا يعمل مع تغييرات JavaScript فقط — أما تغييرات الكود الأصلي فتحتاج إلى بناء جديد.