🎯 مقدمة

بعد ما تخلص تطبيقك بـ Flutter وتتأكد إنه شغال تمام، بييجي أصعب سؤال بيواجه أي مطور:

"إزاي أطلع التطبيق ده من الكمبيوتر بتاعي وأوصله للمستخدمين؟"

في المقالة دي هشرحلك الرحلة الكاملة من لحظة ما تكون شغال على الكود، لحد ما التطبيق يظهر على Google Play Store — بشكل عملي ومنظم.

📁 المرحلة 1: توقيع التطبيق (Signing)

ليه لازم أوقّع التطبيق؟

التوقيع الرقمي هو اللي بيثبت إن التطبيق ده بتاعك، وإن أي تحديث جاي لازم يكون بنفس التوقيع. لو ضاع منك الـ Keystore، مش هتقدر تحدّث تطبيقك تاني على Google Play.

1️⃣ إنشاء ملف Keystore

افتح CMD (مش PowerShell) واكتب:

cd C:\Users\ataha\AndroidStudioProjects\poundos_offline\android
keytool -genkey -v -keystore poundos-release-key.jks -keyalg RSA -keysize 2048 -validity 10000 -alias poundos

هيسألك على:

• Keystore password: اكتب باسورد قوي واحفظه
• الاسم، القسم، الشركة، المدينة، المحافظة
• Country code: EG لمصر

2️⃣ إنشاء ملف key.properties

في مسار android/key.properties:

storePassword=الباسورد_بتاعك
keyPassword=الباسورد_بتاعك
keyAlias=poundos
storeFile=poundos-release-key.jks

مهم جداً: ضيف الملف ده في .gitignore:

android/key.properties
android/*.jks

3️⃣ تعديل android/app/build.gradle

قبل بلوك android { ضيف:

def keystoreProperties = new Properties()
def keystorePropertiesFile = rootProject.file('key.properties')
if (keystorePropertiesFile.exists()) {
    keystoreProperties.load(new FileInputStream(keystorePropertiesFile))
}

داخل بلوك android { ضيف:

signingConfigs {
    release {
        keyAlias = keystoreProperties['keyAlias']
        keyPassword = keystoreProperties['keyPassword']
        storeFile = keystoreProperties['storeFile'] ? file(keystoreProperties['storeFile']) : null
        storePassword = keystoreProperties['storePassword']
    }
}

buildTypes {
    release {
        signingConfig = signingConfigs.release
        minifyEnabled = true
        shrinkResources = true
    }
}

4️⃣ تحديث pubspec.yaml

version: 1.0.0+5

• 1.0.0 = versionName (اللي يظهر للمستخدم)
• +5 = versionCode (رقم داخلي لازم يزيد مع كل رفعة)

📦 المرحلة 2: بناء APK

للتجربة والتوزيع المباشر:

flutter clean
flutter pub get
flutter build apk --release

هتلاقي الملف في:

build/app/outputs/flutter-apk/app-release.apk

لتقسيم APK حسب المعالج (أصغر حجماً):

flutter build apk --release --split-per-abi

هيطلعلك 3 ملفات:

• app-armeabi-v7a-release.apk (الأجهزة القديمة)
• app-arm64-v8a-release.apk (الأجهزة الحديثة) ← الأهم
• app-x86_64-release.apk (للمحاكيات)

📦 المرحلة 3: بناء App Bundle (AAB)

flutter build appbundle --release

الملف في:

build/app/outputs/bundle/release/app-release.aab

🚀 المرحلة 4: الرفع على Google Play

1️⃣ إنشاء حساب مطوّر

• الرابط: play.google.com/console
• الرسوم: 25$ لمرة واحدة (مدى الحياة)
• المطلوب: حساب Google + بطاقة ائتمان + هوية

2️⃣ إنشاء تطبيق جديد

• App name: اسم التطبيق
• Default language: العربية
• Free or paid: Free

3️⃣ ملء معلومات التطبيق

App Content (لازم تكمله كله):

• سياسة الخصوصية
• هل فيه إعلانات؟
• Content rating
• الفئة المستهدفة
• Data safety

Store Listing:

• وصف قصير (80 حرف)
• وصف كامل (4000 حرف)
• أيقونة 512×512
• Feature graphic 1024×500
• 2-8 صور من التطبيق

4️⃣ رفع الـ AAB

Production → Create new release → Upload AAB → Save → Review → Start rollout

5️⃣ المراجعة

Google بتراجع التطبيق في 1-7 أيام. لو اتقبل → يظهر على المتجر. 🎉

📋 جدول المقاسات المطلوبة لصور المتجر

⚠️ نصائح مهمة

📋 ملخص الأوامر السريعة

# قبل كل بناء
flutter clean
flutter pub get

# بناء APK
flutter build apk --release

# بناء APK مقسّم
flutter build apk --release --split-per-abi

# بناء AAB للمتجر
flutter build appbundle --release

🏁 خاتمة

رفع تطبيق على Google Play مش معقد زي ما بيبان — هو بس خطوات مرتبة لازم تمشي عليها بالترتيب. أهم حاجة:

ولو التزمت بالخطوات دي، تطبيقك هيبقى على المتجر في أقل من أسبوع.