من أين جاءت هذه الطريقة
من أغسطس 2024 إلى أغسطس 2025 عملت Software Development Engineer in Test، أي مهندس برمجيات متخصصًا في الاختبار وأتمتته، لدى TAKADOM AL-IRAQ (TTech) بنظام العمل الحر. كنت مسؤولًا عن اختبار تطبيقات الجوال والويب والـ APIs في منتجات خدمات عامة، وبنيت أتمتة الاختبارات بـ Kotlin وSelenium لمشروع نفطكم (Naftcom)، مع تغطية للـ API واختبارات regression (إعادة اختبار ما كان يعمل بعد كل تغيير) حول مسار المواطن ومسار المحطة فيه. وهذا الكود في مستودع خاص، لذا لن أتناوله بالتفصيل هنا.
وأنا أبني تطبيقات الجوال أيضًا. ففي Apps Square أنا مسؤول عن تطبيقات الجوال لعدة منتجات، من إنشاء المشروع والـ architecture حتى الاختبار والتسليم. وفي Inside Tech بنيت تطبيق العميل وتطبيق التاجر في بسمار بـ Kotlin Multiplatform، وكنت مهندس الجوال الوحيد فيهما، ولكلٍّ منهما صفحة عامة على App Store وGoogle Play. وتجد تفاصيل مشاريعي في صفحة المشاريع.
وعادة الاختبار ترافقني. فحين أقرأ وصف أي ميزة اليوم، يظل سؤالي الأول: ماذا يحدث إذا فشلت؟
اختبر النسخة التي ستُنشر فعلًا
نسخة الـ debug، أي نسخة التطوير التي يعمل عليها المبرمج، لا تثبت الكثير عن الإصدار الفعلي. والقائمة صريحة هنا: أختبر نسخة الـ release الموقّعة بإعدادات الإنتاج، لأن تقليص الكود (code shrinking) وإعدادات الـ release قد يعطّلان أشياء لا تظهر أبدًا في نسخة الـ debug.
وبجانب هذا البند بنود أخرى، لأنها تفشل بالطريقة الصامتة نفسها:
- رقم الإصدار ورقم الـ build. كل رفع إلى المتجر يحتاج رقم build أعلى من السابق (
versionCodeعلى Android، ورقم الـ build على iOS)، ويجب أن يطابق الإصدار الظاهر للمستخدمين ملاحظات الإصدار. - مفاتيح التوقيع. استخدم Play App Signing حتى يمكن إعادة تعيين الـ upload key إذا فُقد. واحتفظ بنسخة احتياطية من المفاتيح وكلمات المرور خارج المستودع.
- ملفات الـ symbols للأعطال. ارفع ملف الـ mapping الخاص بـ R8/ProGuard وملفات dSYM لـ iOS إلى أداة تقارير الأعطال؛ فهذه الملفات هي التي تحوّل تقرير العطل إلى كود مقروء. ومن دونها تبقى الـ stack traces القادمة من الإنتاج غير مفهومة، ويصبح أول عطل حقيقي لعبة تخمين.
- لا بقايا من الـ debug. راجع في إعدادات الـ release عناوين الخادم (base URLs)، والـ feature flags، وأي logs مفصّلة تطبع بيانات شخصية، وقوائم الاختبار المخفية.
الأجهزة ومسار التحديث
تطلب القائمة أجهزة حقيقية من الطرفين: على الأقل أقدم إصدار نظام تشغيل تدعمه وأحدث إصدار، وشاشة صغيرة وأخرى كبيرة.
واختبار التحديث هو آخر اختبار أقبل أن أتخطاه. ثبّت النسخة الموجودة على المتجر اليوم، وأنشئ بعض البيانات، ثم حدّث. يجب أن تبقى الجلسات والإعدادات المحفوظة والبيانات المحلية كما هي. فقد يكون التثبيت الجديد مثاليًا، بينما يفقد من يستخدم التطبيق منذ عام جلسته.
مسارات الفشل أولًا
هنا تظهر خلفية الـ QA أكثر من أي مكان آخر. بند الشبكة في القائمة يقول: اختبر الاتصال البطيء والمقطوع والمتقطّع، وتأكد أن حالات التحميل وإعادة المحاولة والأخطاء تعمل، وأن إرسال الـ request نفسه مرة ثانية لا يُنشئ أبدًا طلبًا مكررًا أو دفعة مكررة.
والجزء الأخير هو الأهم. فإعادة المحاولة التي تعمل هي نصف الميزة فقط، والنصف الآخر أن تكون آمنة: من ضغط زر الدفع مرتين لأن الشبكة ضعيفة، ينبغي ألا يُخصم منه المبلغ مرتين.
وهذا مثال صغير من تطبيق Flutter عملت عليه، هو Fueler. كانت الشاشة الرئيسية تحمّل بيانات الحساب والمحفظة والمنتجات بالتوازي، وتحدد موقع المستخدم أيضًا لإيجاد المحطات القريبة. وكان الكود الأصلي ينتظر كل ذلك قبل عرض الصفحة، فإذا تأخر تحديد الموقع اختفى رصيد المحفظة خلف حالة التحميل، مع أن المحفظة لا تحتاج إلى الإحداثيات أصلًا.
والاختبار الذي يحمي الإصلاح يفعل ما يفعله أي مختبِر: يؤخّر عمدًا شيئًا واحدًا تعتمد عليه الشاشة.
// مبسّط من ملف الاختبار في المشروع.
locationResolver.delay = const Duration(seconds: 3); // تحديد موقع يبدأ من الصفر فعلًا
final loading = cubit.load();
await Future<void>.delayed(const Duration(milliseconds: 400));
// الشاشة قابلة للاستخدام قبل أن يصل تحديد الموقع:
expect(cubit.state.status, HomeStatus.loaded);
expect(cubit.state.profile, _profile);
expect(cubit.state.products, _products);
// ...والأقسام التي تحتاج إلى الإحداثيات تقول ذلك بصدق:
expect(cubit.state.locationAccess, LocationAccess.unknown);
expect(cubit.state.stations, isEmpty);وفي المجموعة نفسها اختبار ثانٍ يتحقق من أن تحديد الموقع السريع (warm fix) يُصدر حالة واحدة بالضبط مع كل تحديث للشاشة، حتى لا يعود قسم المحطات فجأة إلى «جارٍ تحديد الموقع». لم أقِس التوقيت على الأجهزة ولا أي أثر على معدلات التحويل، فالفكرة هنا في شكل الاختبار: أبطئ شيئًا واحدًا، ثم تحقق مما يُسمح لبقية الشاشة بفعله.
الأذونات واللغة التي تقرأ بها
الكاميرا والموقع والإشعارات، لكلٍّ منها اختبار للحالة التي تُنسى: أن يضغط المستخدم «عدم السماح» (Don't Allow). يجب أن يظل التطبيق يعمل، وأن يوضّح لماذا يحتاج إلى الإذن.
وتتعامل القائمة مع العربية كإعداد اختبار، لا كمهمة ترجمة: واجهات معكوسة، ونص عربي وإنجليزي متداخل، وحجم خط النظام في أقصى درجاته. فأخطاء الاتجاه من اليمين إلى اليسار (RTL) يسهل أن تفوتك إذا كنت تقرأ الواجهة بلغة واحدة فقط، وهذا بند يهمّ كل تطبيق يخاطب مستخدمين عربًا.
الـ API جزء من الإصدار
إصدار تطبيق الجوال نصفه إصدار للـ backend، والنصف الذي يُنسى هو التطبيق القديم. فالمستخدمون يحدّثون ببطء، ولذلك تطلب القائمة أن يظل الـ API يخدم النسخة المثبّتة لديهم: تبقى الـ endpoints القديمة وشكل الردود تعمل، أو تُطلق آلية التحديث الإجباري أولًا.
وفحص أدنى إصدار مدعوم يتيح لك إيقاف نسخة معطوبة دون انتظار أن يحدّث الجميع. وعلى جانب البيانات: جرّب الـ migrations (تعديلات بنية قاعدة البيانات) على نسخة من بيانات الإنتاج أولًا، وخذ نسخة احتياطية قبل الإصدار.
وأنقل العادة نفسها إلى أدواتي. فـ PostSync Pro أداة Compose Desktop مفتوحة المصدر بنيتها، ترسل طلبات REST، وتشغّل assertions محدودة النطاق (bounded assertions)، وتتحقق من الردود مقابل مواصفة OpenAPI. وهي منشورة كنسخة Beta، والشاشات التي ما زالت تستخدم بيانات محاكاة معلَّمة بأنها معاينات (previews).
إعادة اختبار ما يؤلم أكثر
لا أحاول إعادة اختبار كل شيء. تقول القائمة: أجرِ اختبار regression على أهم المسارات، وهي التسجيل، وتسجيل الدخول، والدفع أو الحجز، وكل ما قد يدفع مستخدمًا إلى الاتصال بالدعم. وللإشعارات والـ deep links (روابط تفتح شاشة محددة داخل التطبيق) فحص خاص: يجب أن تفتح الشاشة الصحيحة والتطبيق مغلق، وهو في الخلفية، والمستخدم غير مسجّل الدخول.
قواعد المتاجر حالات اختبار أيضًا
ينشر المتجران قواعد تُقرأ كأنها متطلبات، فتتحول إلى بنود فحص. وإذا كنت تستعد لرفع تطبيق على App Store أو نشر تطبيق على Google Play، فهذه بعض بنود القائمة:
- App Store: ابنِ التطبيق بالـ SDK المطلوب (iOS 26 SDK أو أحدث، منذ 28 أبريل 2026)؛ واجعل بيانات App Privacy مطابقة لما يجمعه التطبيق والـ SDKs التي يستخدمها؛ وامنح فريق المراجعة في Apple (App Review) حسابًا تجريبيًا يعمل، وأبقِ الـ backend يعمل طوال فترة المراجعة؛ ووفّر حذف الحساب من داخل التطبيق؛ وإذا قدّمت تسجيل دخول عبر طرف ثالث، فقدّم خيارًا مكافئًا مثل Sign in with Apple؛ وأجب عن سؤال التشفير في
Info.plist. - Google Play: اجعل نموذج Data safety مطابقًا للتطبيق؛ والتزم بشرط الـ target API؛ وقدّم للمراجعة بيانات دخول تبقى صالحة (قابلة لإعادة الاستخدام، دون رمز لمرة واحدة، وغير منتهية الصلاحية)؛ وإذا كان حساب المطوّر شخصيًا وجديدًا، فأجرِ الـ closed test (اختبار مغلق مع مجموعة من المختبِرين) قبل التقديم على الإنتاج (production).
التواريخ والحدود تتغير، لذلك تربط القائمة كل قاعدة بصفحتها الرسمية، وتسجّل تاريخ آخر مراجعة لها. راجعها من جديد قبل أن تعتمد على أي منها.
ومراجعة المتجر بوابة منفصلة لها قواعدها. فهي لا تخبرني إن كان الدفع سيصمد أمام اتصال متقطّع، ولذلك لا تحل أبدًا محل اختباري أنا.
أدلة مكتوبة، لا ذاكرة
بعد أي إصدار أريد أن أجيب: ما الذي اختُبر، وعلى ماذا، وماذا حدث. ويكفي لذلك سجل قصير. هذا قالب توضيحي، وليس ملفًا من مشروع بعينه:
release: 2.4.0 (build 118)
artifact: signed release build, production config
devices: [oldest supported OS, newest OS, small screen, large screen]
upgrade_from_live: passed, session and local data kept
network: slow / offline / flaky checked, repeated request created no duplicate
permissions: camera, location, notifications denied once each
arabic_rtl_large_text: checked
regression: sign-in, checkout, support-call flows
backend: old endpoints still served, min-version check in place
symbols: mapping file and dSYMs uploaded
rollout: staged, halt criteria agreed
owner_first_72h: namedوالكتابة نفسها تغيّر السلوك: البند المتروك يصبح ظاهرًا، ولا تعود عبارة «ظننت أننا فحصنا ذلك» إجابة.
يوم النشر وما بعده
لا ينتهي الإصدار حين يصبح الـ build متاحًا للمستخدمين. فالقسم الأخير من القائمة يطلب:
- ملاحظات إصدار مكتوبة للمستخدمين، بكل لغات المتجر، تقول ما الذي تغيّر وهل عليهم فعل أي شيء؛
- شخصًا يتابع أول 72 ساعة، مع مسؤول عن تقارير الأعطال وتقييمات المستخدمين على المتجر ورسائل الدعم؛
- خطة لإصدار به خلل، لأن التحديث المثبّت يبقى لدى المستخدمين حتى تنشر إصلاحًا: جهّز مسارًا للـ hotfix (الإصلاح العاجل) ومفاتيح تحكم من جهة الخادم؛
- التحقق من تحليلات الإصدار في الإنتاج: تُرسل الأحداث مرة واحدة، وبالقيم الصحيحة، وتحترم اختيار المستخدم بشأن جمع بياناته (consent).
وعلى Google Play تطلب القائمة أيضًا staged rollout، أي نشرًا تدريجيًا: انشر لنسبة صغيرة من المستخدمين أولًا، وأوقف النشر إذا ارتفع معدل الأعطال أو الـ ANR (توقف التطبيق عن الاستجابة). وهذا للتحديثات، لا للنشر الأول.
ما سأفعله بشكل مختلف
- تحويل مزيد من البنود إلى فحوص آلية. بعض البنود، مثل مسار التحديث واختبار تكرار الـ request، تتكرر بما يكفي حتى لا يُترك تذكّرها لشخص.
- ربط كل بند بمسؤول وبدليل. علامة الصح تقول إن أحدًا نظر، لكنها لا تقول ماذا رأى.
- التعامل مع القائمة كنقطة بداية. فهي مكتوبة لتطبيقات الجوال التي لها backend. بعض المشاريع ستتخطى بنودًا، والمشروع الذي فيه مدفوعات سيحتاج إلى أكثر منها.
- إبقاء قواعد المتاجر محدّثة. فهي تتغير، وتاريخ «آخر مراجعة» لا يكون صادقًا إلا إذا حدّثه أحد.
- الدقة في وصف القائمة. هي قائمتي العامة، وليست سجلًا بأن كل بند نُفّذ في كل إصدار.
وإذا كان لديك تطبيق جوال متوقف قبل النشر، فيمكنك أن تبدأ بـ قائمة المراجعة كاملة، أو أن تخبرني عنه من صفحة ابدأ مشروعك.
محمد الجوهري (Mohamed Elgohary)، مهندس برمجيات، القاهرة. mohamedelgohary.dev
