Skip to content

Latest commit

 

History

History
215 lines (163 loc) · 6 KB

RELEASE_FILES.md

File metadata and controls

215 lines (163 loc) · 6 KB

📦 ملفات النشر - NFC Manager

تاريخ الإنشاء: 17 أكتوبر 2025 - 05:30
الإصدار: 1.0.0 (Build 1)
الحالة: ✅ جاهز للنشر

📍 مواقع الملفات

1. APK للاختبار وFirebase

المسار: app/build/outputs/apk/release/app-release.apk
الحجم: 24 MB
التوقيع: ✅ موقّع (SHA256withRSA)
الاستخدام: الاختبار، Firebase App Distribution، التوزيع المباشر

المسار الكامل:

/Users/sunmarke/Desktop/nfcManager/android/app/build/outputs/apk/release/app-release.apk

2. AAB للنشر على Google Play

المسار: app/build/outputs/bundle/release/app-release.aab
الحجم: 20 MB
التوقيع: ✅ موقّع (SHA256withRSA)
الاستخدام: النشر على Google Play Store (مطلوب)

المسار الكامل:

/Users/sunmarke/Desktop/nfcManager/android/app/build/outputs/bundle/release/app-release.aab

🔐 معلومات التوقيع

Keystore: app/nfcmanager-release.keystore
Alias: nfcmanager-key
Algorithm: SHA256withRSA
Key Size: 2048-bit
Certificate: CN=NFC Manager, OU=Development, O=DXB Mark, L=Dubai, ST=Dubai, C=AE

⚠️ مهم: احتفظ بملف الـ keystore في مكان آمن! ستحتاجه لجميع التحديثات المستقبلية.

🚀 خيارات النشر

Option 1: Google Play Store (موصى به)

الملف المطلوب: app-release.aab

الخطوات:

  1. انتقل إلى Google Play Console
  2. أنشئ تطبيق جديد
  3. املأ Store Listing (راجع GOOGLE_PLAY_RELEASE.md)
  4. ارفع ملف AAB
  5. أرسل للمراجعة

المميزات:

  • ✅ توزيع تلقائي لملايين المستخدمين
  • ✅ تحديثات تلقائية
  • ✅ إحصائيات مفصلة
  • ✅ حجم تنزيل أصغر (Google Play يحسّن الحجم)

Option 2: Firebase App Distribution

الملف المطلوب: app-release.apk

الخطوات:

  1. انتقل إلى Firebase Console
  2. أنشئ مشروع جديد أو استخدم موجود
  3. اذهب إلى App Distribution
  4. ارفع ملف APK
  5. أضف المختبرين (emails)
  6. أرسل دعوات

الاستخدام:

  • 🧪 اختبار بيتا قبل النشر العام
  • 👥 توزيع على فريق محدد
  • 📊 جمع feedback من المختبرين

الأمر لرفع APK (Firebase CLI):

firebase appdistribution:distribute app/build/outputs/apk/release/app-release.apk \
  --app YOUR_APP_ID \
  --release-notes "النسخة 1.0.0 - الإصدار الأول" \
  --testers "email1@example.com,email2@example.com"

Option 3: التوزيع المباشر

الملف المطلوب: app-release.apk

طرق التوزيع:

  1. رابط مباشر: ارفع على خادم ووزع الرابط
  2. Email: أرسل الملف مباشرة
  3. USB/ADB: نقل مباشر للأجهزة

⚠️ تحذير: المستخدمون يحتاجون تفعيل "Install from Unknown Sources"

📋 Checklist قبل النشر

Google Play Store

  • بناء AAB ✅
  • توقيع AAB ✅
  • اختبار APK على أجهزة متعددة
  • تحضير Screenshots (2-8 صور)
  • كتابة Store Listing
  • إنشاء Privacy Policy ✅
  • إنشاء حساب Google Play Console
  • رفع AAB
  • تعبئة Data Safety
  • تعبئة Content Rating
  • إرسال للمراجعة

Firebase App Distribution

  • بناء APK ✅
  • توقيع APK ✅
  • إنشاء مشروع Firebase
  • تفعيل App Distribution
  • إضافة المختبرين
  • رفع APK
  • إرسال دعوات

📊 مقارنة الملفات

الميزة APK AAB
الحجم 24 MB 20 MB
Google Play ❌ غير مقبول ✅ مطلوب
Firebase ✅ مدعوم ✅ مدعوم
التوزيع المباشر ✅ سهل ❌ يحتاج تحويل
التحديثات يدوي تلقائي (Play Store)
التحسين ثابت ديناميكي حسب الجهاز

🔄 التحديثات المستقبلية

عند إصدار تحديث جديد:

  1. زيادة Version Code و Version Name في app/build.gradle:

    versionCode 2
versionName "1.0.1"

  2. بناء ملفات جديدة:

    ./gradlew clean
./gradlew bundleRelease  # للـ AAB
./gradlew assembleRelease  # للـ APK

  3. استخدام نفس الـ keystore (مهم جداً!)

  4. رفع على Google Play كتحديث

📞 الدعم الفني

لمشاكل النشر:

لمشاكل التطبيق:

📝 ملاحظات مهمة

✅ تم إنجازه:

  • بناء APK موقّع (24 MB)
  • بناء AAB موقّع (20 MB)
  • إنشاء Keystore آمن
  • توثيق شامل للنشر
  • Privacy Policy محدث
  • تنظيم ملفات المشروع

🔜 الخطوات التالية:

  1. تحضير Screenshots للتطبيق
  2. إنشاء حساب Google Play Console ($25)
  3. رفع AAB وتعبئة المعلومات
  4. اختبار APK على Firebase (اختياري)
  5. النشر! 🎉

🎯 روابط سريعة

  • دليل Google Play: GOOGLE_PLAY_RELEASE.md
  • Privacy Policy: PRIVACY_POLICY.md
  • Security Review: SECURITY_REVIEW.md
  • Progress Tracker: PROGRESS_TRACKER.md
  • README: README.md

آخر تحديث: 17 أكتوبر 2025 - 05:30
الحالة: ✅ جاهز للنشر على جميع المنصات