.Net Svn Versioning

تضمين SVN Revision في إصدار تجميعة .NET الخاصة بك

في عالم تطوير البرمجيات، تعتبر إدارة الإصدارات أمرًا بالغ الأهمية. بالنسبة لأولئك الذين يستخدمون Subversion (SVN) كنظام للتحكم في الإصدار، يمكن أن يؤدي تضمين رقم مراجعة مستودع SVN في سلسلة إصدار تجميعة .NET إلى تعزيز القدرة على تتبع الأخطاء وسهولة التصحيح. إذا كنت تتساءل، “هل هناك طريقة للقيام بذلك بدون أدوات خارجية مثل CC.NET؟”, فالجواب هو نعم بالتأكيد.

المشكلة: إصدار دون أدوات إضافية

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

Major.Minor.SVNRev

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

الحل: استخدام SubWCRev

إحدى الطرق الفعالة لتضمين رقم مراجعة SVN في إصدار تجميعة .NET الخاصة بك هي من خلال SubWCRev، وهي أداة مضمنة مع TortoiseSVN. SubWCRev تقوم بقراءة الكلمات الرئيسية لـ SVN من ملفاتك وتستبدلها بمعلومات المراجعة المناسبة أثناء عملية البناء.

دليل خطوة بخطوة لتنفيذ SubWCRev

  1. قم بتنزيل وتكوين TortoiseSVN:

    • ابدأ بتنزيل TortoiseSVN إذا لم تقم بذلك بالفعل.
    • قم بتثبيته على جهازك للوصول إلى أداة SubWCRev المرفقة.

  2. إعداد ملف AssemblyInfo.cs الخاص بك:

    • افتح ملف AssemblyInfo.cs الخاص بك؛ يحتوي هذا الملف عادةً على معلومات إصدار تجميعتك.
    • أضف عناصر نائب حيث سيتم استبدال أرقام الإصدار بواسطة SubWCRev.

    مثال:

    [assembly: AssemblyVersion("1.0.0.0")]
[assembly: AssemblyFileVersion("1.0.0.0")]
[assembly: AssemblyInformationalVersion("1.0.0.0")]

  3. إنشاء ملف قالب:

    • أنشئ ملف نصي جديد (مثل VersionInfo.txt) وهيكله لتعريف كيفية ملء معلومات الإصدار.
    • استخدم عناصر نائب لرقم المراجعة.

    مثال لـ VersionInfo.txt:

    [assembly: AssemblyVersion("${VersionNumber}.0")]
[assembly: AssemblyFileVersion("${VersionNumber}.0")]
[assembly: AssemblyInformationalVersion("${VersionNumber}.${Revision}")]

  4. تشغيل SubWCRev:

    • استخدم أمر SubWCRev لاستبدال عناصر نائب في ملف VersionInfo.txt بأرقام الإصدار الفعلية من مستودع SVN الخاص بك.
    • يمكن عادةً القيام بذلك عبر سطر الأوامر أو تضمينه في نصوص البناء الخاصة بك.

  5. بناء مشروعك:

    • عند بناء مشروعك، سيقوم SubWCRev بإنشاء ملف AssemblyInfo.cs جديد مع النسخة التي تم ملؤها برقم مراجعة SVN الخاص بك.

الخلاصة

من خلال دمج SubWCRev في سير العمل الخاص بمشروع .NET الخاص بك، يمكنك بسهولة ضمان أن سلسلة إصدار تجميعتك تتضمن رقم مراجعة SVN، كل ذلك دون الحاجة للاعتماد على برامج خارجية مثل CC.NET. لا تجعل هذه الطريقة إصدارك أكثر إعلامية فحسب، بل تبقيه بسيطًا وسهل الإدارة.

الآن بعد أن عرفت كيفية تضمين SVN revision number في إصدار تجميعة .NET الخاص بك، جرب ذلك في مشروعك القادم، وستقدر الوضوح الذي يجلبه.