كيف تُصدر إصدارات برمجية تجتاز مراجعة السوق

في سوق يراجع فيه أشخاص الإصدارات قبل أن يتمكن المشترون من تنزيلها، يعني رفض الإصدار ضياع أيام. ومعظم حالات الرفض لا تتعلق بسوء الشيفرة، بل بتفاصيل كان يمكن تفاديها: أرشيف غير مرتب، أو سجل تغييرات مفقود، أو أرقام إصدارات غير متطابقة، أو توافق لم يُختبر قط. يوضح هذا الدليل كيف تجهّز إصداراً يجتاز المراجعة من أول مرة.

كُتب الدليل للمؤلفين على DevMarket، حيث يفحص شخص كل إصدار قبل أن يصبح متاحاً، لكن العادات نفسها تفيد على أي منصة.

ما الذي تفحصه المراجعة

مراجعة الإصدار فحص للجودة والسلامة، وليست ضماناً لبرمجياتك. ينظر المراجعون في:

• ما إذا كان الأرشيف سليماً وآمناً لفك ضغطه؛
• ما إذا كانت معلومات الإصدار وسجل التغييرات والتوافق موجودة ومتسقة؛
• ما إذا كان الإصدار يطابق الوصف في صفحة المنتج؛
• ما إذا كان فيه أي شيء غير آمن أو مضلّل.

معرفة هذا تخبرك بما عليك تحضيره.

جهّز الأرشيف بشكل نظيف

إصدارك ملف zip واحد. اجعله مرتباً:

1. ضمّن ما يحتاجه المشترون فقط: الشيفرة والتوثيق والترخيص. واترك خارجه مجلدات البناء، ومجلدات الاعتماديات التي يمكن تثبيتها، وملفات التخزين المؤقت، وملفات المحررات، والملاحظات الشخصية.
2. استخدم بنية مجلدات معقولة يكون اسم المنتج في أعلاها.
3. لا تستخدم مسارات غير معتادة. تُرفض المسارات التي تتسلق خارج المجلد (باستخدام ..)، والمسارات المطلقة، والروابط إلى ملفات خارج الأرشيف، والملفات ذات الأسماء الغريبة، لأنه يمكن استغلالها لمهاجمة جهاز المشتري.
4. حافظ على حجم معقول. الأرشيف الكبير جداً لمنتج صغير يثير تساؤلات.
5. افتح ملف zip بنفسك على جهاز نظيف وتأكد من أنه يُفك دون أخطاء.

استخدم أرقام إصدارات واضحة

اختر نظام ترقيم والتزم به. الأرقام المنقّطة مثل 1.2.0 سهلة القراءة. وفي وحدات Odoo يضيف كثير من المؤلفين رقم سلسلة Odoo في البداية، كما في 19.0.1.2.0. ارفع الرقم مع كل إصدار، ولا ترفع أبداً أرشيفين مختلفين تحت رقم الإصدار نفسه. وإذا اضطررت إلى استبدال ملف مرفوع رُفض، فأصلحه وارفعه مجدداً تحت الرقم نفسه: رفض الإصدار لا يمنعك من المحاولة مرة أخرى.

اكتب سجل تغييرات مفيداً

يقرأ سجل التغييرات المشترون الذين يقررون هل يحدّثون، والمراجعون الذين يفحصون الإصدار. اكتب ما تغيّر بكلمات بسيطة:

• أُضيف: الميزات الجديدة.
• تغيّر: سلوك يعمل الآن بطريقة مختلفة.
• أُصلح: الأخطاء، مع ذكر ما كان العَرَض.
• الأمان: أي شيء يعالج مشكلة أمنية. وسمه بوصفه إصدار أمان.

عبارة «إصلاح أخطاء وتحسينات» لا تخبر أحداً بشيء. حتى سطر محدد واحد لكل تغيير أفضل منها.

حدّد نسخ المنصة التي تدعمها

اختر نسخ المنصة التي يعمل معها هذا الإصدار، وكن جاداً فيما تقوله. إذا قلت إنه يعمل مع Odoo 17.0 و18.0 و19.0 فينبغي أن تكون قد اختبرت الثلاث جميعاً. وإذا اختبرت نسخة واحدة فقط، فاذكر نسخة واحدة. يعتمد المشترون على هذه القائمة، والادعاء الخاطئ يؤدي إلى طلبات دعم وتقييمات سيئة واسترداد للمبالغ.

اختبر قبل أن ترسل

أنشئ بيئة جديدة، وثبّت إصدارك كما سيفعل المشتري، وجرّب الميزات الرئيسية. ثبّته على كل نسخة مدعومة من المنصة. تأكد من أن الترقية من الإصدار السابق تعمل، وأن إلغاء التثبيت أو التعطيل يترك النظام سليماً. احتفظ بسكربت اختبار قصير ليخضع كل إصدار للفحوص نفسها.

تأكد أن الوصف ما زال مطابقاً

إذا أضاف الإصدار ميزات أو أزالها، فحدّث وصف المنتج ولقطات الشاشة أيضاً. يقارن المراجعون ما تعد به بما تسلّمه. وصف الصفحة لميزات لا يحتويها الأرشيف سبب شائع لطلب إجراء تعديل.

كن صريحاً بشأن ما تفعله برمجياتك

اذكر إن كانت البرمجية تتصل بخدمات خارجية، أو ترسل بيانات إلى أي جهة، أو تحمّل شيفرة من مكان آخر، ووضّح ماذا ولماذا. التتبع الخفي أو جمع البيانات الخفي غير مسموح، ويهدم الثقة إذا اكتُشف. الإفصاح الصادق بسيط ويحميك.

قائمة تحقق قبل الإرسال

إذا أُعيد إصدارك إليك

اقرأ ملاحظة المراجع بعناية، وأصلح النقاط التي تذكرها، وارفع الإصدار مرة أخرى. اعتبر كل ملاحظة فحص جودة مجانياً. وإذا لم تكن متأكداً مما تعنيه ملاحظة، فاسأل.

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

بعد أن تصبح إصداراتك في حالة جيدة، تأكد أن الصفحة التي تقدمها كذلك: اقرأ كيف تكتب صفحة منتج تبيع، وفكّر في كيف تسعّر برمجياتك وتحدد ترخيصها. وللبيع على DevMarket، ابدأ من صفحة البيع.