01
التهيئة
ثبّت Android Studio
نزّل Android Studio من الموقع الرسمي وثبّته بالإعدادات الافتراضية، ثم افتح SDK Manager وتأكد من وجود الأدوات الأساسية.
من SDK Tools ثبّت أيضًا Android SDK Command-line Tools.
الإصدار 01 · دليل عملي
من المشروع
إلى المتجر.
رحلة مرتبة لبناء تطبيق «إياد نمبر وان»، توقيعه، وتجهيزه للنشر على Google Play — بلا تخمينات ولا خطوات ضائعة.
✦ احفظ مفتاحك، ثم ابنِ بثقة.
مسار الإطلاقEYAD / 01
01
Android Studioتهيئة بيئة البناء
02
Signed Bundleإنشاء ملف AAB
03
Google Playالإرسال للمراجعة
جاهز
للإطلاق
للإطلاق
12مرحلة محسوبة
01ملف AAB
∞ثقة أكبر
هذا الدليل يحول ملف البناء إلى مسار قراءة سهل: نفّذ، اختبر، ثم انشر.
02
المشروع
افتح المشروع في Android Studio
فك ضغط المشروع، افتح المجلد في Android Studio، وانتظر اكتمال Gradle Sync وتنزيل الاعتماديات.
المجلد المطلوب
eyad_number_one_android.zipإذا طلب Android Studio تحديث Gradle أو Android Gradle Plugin، اقبل تحديثًا متوافقًا ثم أعد المزامنة.
03
الخلفية
شغّل واجهة REST API
شغّل واجهة FastAPI على جهاز الكمبيوتر الذي سيخدم التطبيق أثناء الاختبار.
Terminal
cd rest_api_example
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
export SECRET_KEY="ضع-مفتاحا-سريا-قويا"
uvicorn app.main:app --host 0.0.0.0 --port 8000اختبر الواجهة بفتح http://127.0.0.1:8000/docs
04
الاتصال
اضبط عنوان API في التطبيق
افتح ملف MainActivity.kt واختر العنوان المناسب للبيئة التي تختبر عليها.
MainActivity.kt
private const val API_BASE_URL = "http://10.0.2.2:8000"Android Emulatorاترك العنوان كما هو.
هاتف حقيقي
http://192.168.1.10:8000الإصدار المنشور
https://api.example.comقاعدة الإنتاج
لا تستخدم عنوانًا محليًا أو HTTP غير المشفر في الإصدار المنشور. استخدم HTTPS دائمًا.
لا تستخدم عنوانًا محليًا أو HTTP غير المشفر في الإصدار المنشور. استخدم HTTPS دائمًا.
05
الاختبار
اختبر التطبيق من البداية للنهاية
أنشئ Emulator من Device Manager أو أوصل هاتف Android مع تفعيل USB Debugging، ثم اضغط Run واختبر مسار المستخدم كاملًا.
✓ إنشاء حساب ✓ تسجيل الدخول ✓ إضافة مهمة ✓ إنهاء وحذف
إذا ظهر خطأ اتصال، تحقق من تشغيل FastAPI والعنوان والشبكة وصلاحية الوصول إلى الإنترنت.
06
الهوية
ثبّت بيانات الإصدار
قبل أول نشر، راجع معرف التطبيق وإصداره في ملف app/build.gradle.kts.
app/build.gradle.kts
applicationId = "com.eyad.numberone"
versionCode = 1
versionName = "1.0.0"لا تغيّر applicationId بعد أول نشر. عند كل تحديث ارفع
versionCode إلى رقم أعلى.07
التوقيع
أنشئ ملف Keystore
من Android Studio اختر Build > Generate Signed Bundle / APK، ثم اختر Android App Bundle واضغط Create new لإنشاء Keystore.
01 · مكان آمن02 · كلمة مرور03 · Alias04 · شهادة
تنبيه لا يمكن التراجع عنه بسهولة
لا ترفع ملف Keystore إلى GitHub ولا ترسله لأي شخص. فقدانه قد يمنعك من تحديث التطبيق مستقبلًا.
لا ترفع ملف Keystore إلى GitHub ولا ترسله لأي شخص. فقدانه قد يمنعك من تحديث التطبيق مستقبلًا.
08
النسخة
ابنِ ملف AAB
اختر Build Variant: release ثم اضغط Finish. ملف Google Play هو AAB وليس APK العادي.
app-release.aabapp/build/outputs/bundle/release/app-release.aab
✓09
المتجر
أنشئ تطبيقك في Google Play Console
سجّل الدخول بحساب المطوّر، اختر Create app، ثم أدخل بيانات «إياد نمبر وان» واللغة العربية ونوع التطبيق.
فتح Google Play Console ↗10
الإصدار
ارفع النسخة إلى Production
من Test and release > Production اختر Create new release، ارفع app-release.aab وأضف ملاحظات الإصدار.
«الإصدار الأول من إياد نمبر وان لإدارة المهام.»
11
واجهة المتجر
أكمل متطلبات المتجر
جهّز مواد العرض والبيانات التي قد يطلبها Google Play قبل الإرسال.
أيقونة 512×512Feature Graphic 1024×500لقطات شاشةوصف وسياسة خصوصيةأمان البياناتتصنيف المحتوى
12
خط النهاية
راجع ثم أرسل للنشر
أكمل كل العناصر التي تظهر كـ Incomplete، راجع الإصدار والمحتوى والبلدان المستهدفة، ثم أرسل الإصدار للمراجعة.
12خطوات واضحة.→إصدار جاهز.
قبل الضغط على النشر
قائمة التحقق
الأخيرة
ضع علامة على كل بند. عندما تصل إلى 100% تكون جاهزًا للمراجعة.
مراجعة الإصدار 010 / 9
أكمل القائمة لتفعيل ختم الجاهزية.