pure::variants – موصل لـ
دليل إدارة الكود المصدر
شركة بارامترية للتكنولوجيا المحدودة
الإصدار 6.0.7.685 للنسخة النقية::المتغيرات 6.0
حقوق الطبع والنشر © 2003-2024 Parametric Technology GmbH
2024

مقدمة

يتيح موصل pure::variants لإدارة الكود المصدر (الموصل) للمطورين إدارة تباين الكود المصدر باستخدام pure::variants. توفر إدارة الكود المصدر لـ pure::variants فرصة مرنة لمزامنة هياكل الدليل والكود المصدر fileيمكن إدارة المتغيرات بسهولة باستخدام نماذج pure::variants. وبالتالي يمكن تطبيق إدارة المتغيرات عمليًا حتى على مشاريع البرمجيات المعقدة. علاوة على ذلك، يمكن إدارة الاتصالات بين ميزات pure::variants وكود المصدر بسهولة باستخدام المنشئ ويمكن الوصول إليها بسهولة عبر إدارة كود المصدر.
1.1. متطلبات البرنامج
يعد موصل pure::variants لإدارة الكود المصدر امتدادًا لـ pure::variants ومتاح على جميع الأنظمة الأساسية المدعومة.
1.2. التثبيت
يرجى الرجوع إلى القسم النقي :: المتغيرات الموصلات في دليل الإعداد النقي: المتغيرات للحصول على معلومات مفصلة حول كيفية تثبيت الموصل (تعليمات القائمة -> محتويات التعليمات ثم دليل إعداد المتغيرات الخالصة -> الموصلات النقية :: المتغيرات).
1.3. حول هذا الدليل
من المتوقع أن يكون لدى القارئ معرفة أساسية وخبرة في التعامل مع pure::variants. يُرجى الرجوع إلى المواد التمهيدية قبل قراءة هذا الدليل. يتوفر الدليل في شكل تعليمات عبر الإنترنت وكذلك بتنسيق PDF قابل للطباعة هنا.

باستخدام الموصل

2.1. بدء تشغيل pure::variants
اعتمادًا على طريقة التثبيت المستخدمة، قم إما ببدء تشغيل pure::variants-enabled Eclipse أو ضمن نظام التشغيل Windows، حدد عنصر pure::variants من قائمة البرنامج.
إذا لم يتم تنشيط منظور إدارة المتغيرات بالفعل، فقم بذلك عن طريق تحديده من "فتح المنظور-> آخر..." في قائمة "النافذة".
2.2. استيراد شجرة الدليل إلى نموذج العائلة
قبل استيراد شجرة دليل إلى نموذج عائلي، يجب إنشاء مشروع متغيرات. كما أنه من المستحسن أن يكون لديك ميزات محددة في نموذج الميزات بالفعل. يرجى الرجوع إلى وثائق pure::variants للحصول على المساعدة حول هذه الخطوات.
يتم بدء عملية الاستيراد الفعلية عن طريق تحديد إجراء الاستيراد... إما في قائمة السياق الخاصة بالمشاريع view أو مع قائمة الاستيراد... في File القائمة. حدد نماذج المتغيرات أو المشاريع من فئة إدارة المتغيرات واضغط على التالي. في الصفحة التالية، حدد استيراد نموذج عائلي من مجلدات المصدر واضغط على التالي مرة أخرى.
اختر نوع الكود المصدر الذي تريد استيراده
يظهر معالج الاستيراد (انظر الشكل 1، "صفحة معالج الاستيراد لتحديد نوع الكود المصدر الذي يمكن استيراده"). حدد نوع المشروع الذي تريد استيراده واضغط على التالي. يحتوي كل نوع على مجموعة محددة مسبقًا من file أنواع لاستيرادها إلى النموذج.
الشكل 1. صفحة معالج الاستيراد لتحديد نوع الكود المصدر الذي يمكن استيرادهحدد المصدر والهدف
في صفحة المعالج التالية (الشكل 2، "صفحة معالج الاستيراد لتحديد المصدر والهدف للاستيراد") يجب تحديد دليل المصدر والنموذج المستهدف.
اضغط على زر "استعراض..." لتحديد الدليل الذي يوجد به الكود المصدر الذي يجب استيراده. بشكل افتراضي، يتم تحديد مساحة العمل الحالية لأنها قد تكون نقطة مفيدة لبدء التنقل.
فيما يلي، يمكنك تحديد نمط التضمين والاستبعاد. يجب أن تكون هذه الأنماط عبارة عن تعبيرات Java عادية. يتم فحص كل مسار إدخال، نسبة إلى مجلد الجذر المصدر، بهذه الأنماط. إذا تطابق نمط التضمين، فسيتم استيراد مجلد، وإذا لم يتطابق نمط الاستبعاد. بمعنى أن نمط التضمين يحدد مسبقًا المجلدات المراد استيرادها، فإن نمط الاستبعاد يقيد هذا التحديد المسبق.
بعد تحديد دليل الكود المصدر، يجب تحديد نموذج مستهدف. لذا، حدد مشروعًا مختلفًا أو مجلدًا حيث يجب تخزين النموذج وأدخل اسم النموذج. file يتم تمديد الاسم تلقائيًا بامتداد .ccfm إذا لم يتم تقديمه في مربع الحوار هذا. بشكل افتراضي، سيتم تعيينه على نفس اسم اسم النموذج نفسه. هذا هو الإعداد الموصى به.
بعد تحديد مجلد المصدر المناسب واسم النموذج المطلوب، يمكن إنهاء الحوار بالضغط على زر "إنهاء". إذا تم الضغط على زر "التالي"، فستظهر صفحة أخرى حيث يمكن إجراء إعدادات إضافية.
الشكل 2. صفحة معالج الاستيراد لتحديد المصدر والهدف للاستيرادتغيير تفضيلات الاستيراد
في صفحة المعالج الأخيرة (الشكل 3، "صفحة معالج الاستيراد لتحديد تكوين فردي") هناك تفضيلات يمكن القيام بها لتخصيص سلوك الاستيراد لمشروع البرنامج المستورد.
تُظهر صفحة الحوار جدولاً حيث file تم تعريف الأنواع التي سيتم أخذها في الاعتبار أثناء عملية الاستيراد.
يتكون كل سطر من أربعة حقول.

• يحتوي حقل الوصف على نص وصفي قصير لتحديد file يكتب.
• ال File يتم استخدام حقل نمط الاسم للاختيار fileيجب استيراد العناصر عندما تتطابق مع قيمة الحقول. يستخدم الحقل بناء الجملة التالي:

1. قد تكون حالة الاستخدام الأكثر شيوعًا هي file الامتداد. الصيغة المعتادة هي .EXT، حيث EXT هو الامتداد المطلوب. file الامتداد (على سبيل المثال .java).
2. هناك حالة شائعة أخرى وهي حالة خاصة file، مثل صنعfileلذلك، فمن الممكن أن يتم المطابقة على وجه الدقة file الاسم. للقيام بذلك، فقط أدخل file الاسم في الحقل (على سبيل المثال build.xml).
3. في بعض الحالات تكون رغبات رسم الخرائط أكثر تحديدًا، لذا فقط fileيجب استيراد العناصر التي تتوافق مع نمط خاص. لتلبية هذا المتطلب، من الممكن استخدام التعبيرات العادية في File حقل نمط الاسم.
   إن وصف بناء جملة التعبيرات العادية يتجاوز الغرض من هذه المساعدة. يرجى الرجوع إلى قسم التعبيرات العادية في فصل المراجع في دليل مستخدم pure::variants (على سبيل المثال .*).

• يحدد حقل نوع العنصر المحدد التعيين بين file نوع ونوع عنصر عائلة pure::variants. نوع عنصر العائلة هو وصف للمصدر file لتوفير مزيد من المعلومات للعنصر المرسوم في النموذج المستورد. الاختيارات النموذجية هي ps:class أو ps:makefile.
• الخريطة file يحدد حقل النوع التعيين بين file النوع و pure::variants file النوع. file النوع في pure::variants هو وصف للمصدر file لتوفير مزيد من المعلومات للعنصر المرسوم في النموذج المستورد. الاختيارات النموذجية هي impl للتنفيذات أو def للتعريف files.

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

• لا تستورد الدلائل دون المطابقة files (على سبيل المثال دلائل CVS).
  إذا وجد المستورد دليلاً لا يحتوي على أي بيانات مطابقة file يوجد فيه ولا يوجد دليل فرعي مطابق له fileلن يتم استيراد الدليل. غالبًا ما يكون هذا مفيدًا، إذا كانت المشاريع تُدار بواسطة أنظمة إدارة الإصدارات مثل CVS. بالنسبة إلى CVS، يحتوي كل دليل ذي صلة على دليل CVS حيث لا توجد ملفات ذات صلة. fileيتم تخزين s. إذا تم تحديد هذا الخيار وتم حفظ CVS-fileلا تتطابق مع أي file إذا كان النوع المحدد أعلاه، فلن يتم استيراد الدليل كمكون في النموذج العائلي.
• نوع fileق والأدلة.
  قم بتمكين هذا الخيار للفرز files والدلائل كل حسب الترتيب الأبجدي.
• معالجة مسار الاستيراد.
  لمزيد من المزامنة، يحتاج المستورد إلى تخزين المسار الأصلي لجميع العناصر المستوردة في النموذج.
  في كثير من الحالات، تتم مشاركة نماذج العائلة مع مستخدمين آخرين. قد يختلف هيكل الدليل لكل مستخدم. لدعم سيناريوهات الاستخدام الأكثر شيوعًا، يمكن للمستورد العمل في أوضاع مختلفة:

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

يتم تخزين كافة تفضيلات مربع الحوار هذا بشكل دائم. لا يجب إعادة إجراء التخصيصات الشخصية في كل مرة يتم فيها تشغيل عملية الاستيراد. وهذا يجعل سير عمل الاستيراد سهلاً وسريعًا.
2.3. تحديث النماذج من شجرة الدليل
اضغط على زر المزامنة لمزامنة نموذج مستورد مع مسار الدليل الخاص به. يتم تخزين المسار الجذري للمشروع في النموذج حتى تتم مزامنته مع نفس الدليل كما كان من قبل. لتمكين زر المزامنة، افتح النموذج وحدد أي عنصر. بعد الضغط على زر المزامنة، يتم فتح محرر المقارنة حيث يتم معارضة نموذج العائلة الحالي ونموذج بنية الدليل الحالية (انظر الشكل 4، "تحديث النموذج من شجرة الدليل في محرر المقارنة").
الشكل 4. تحديث النموذج من شجرة الدليل في محرر المقارنة   يتم استخدام محرر المقارنة في جميع أنحاء pure::variants لمقارنة إصدارات النموذج ولكن في هذه الحالة يتم استخدامه لمقارنة بنية الدليل المادية (المعروضة في الجانب الأيمن السفلي) مع نموذج pure::variants الحالي (الجانب الأيسر السفلي). يتم سرد جميع التغييرات كعناصر منفصلة في الجزء العلوي من المحرر، مرتبة حسب العناصر المتأثرة.
يؤدي تحديد عنصر في هذه القائمة إلى تسليط الضوء على التغيير في كلا الطرازين. في المثال السابقampعلى سبيل المثال، يتم تمييز العنصر المضاف بمربع على الجانب الأيمن ويتم ربطه بموضعه المناسب في النموذج على الجانب الأيسر. يوفر شريط أدوات الدمج بين نوافذ المحرر العلوية والسفلية أدوات لنسخ التغييرات الفردية أو حتى جميع التغييرات (غير المتضاربة) ككل من نموذج شجرة الدليل إلى نموذج الميزة.
ملحوظة
يتم إجراء المزامنة باستخدام آخر إعدادات المستورد المستخدمة. يتيح هذا إمكانية تحديث النموذج بإعدادات أخرى تم إجراؤها أثناء إجراء الاستيراد.

استخدام فهرس العلاقة

يعمل موصل إدارة الكود المصدر على تعزيز العلاقات View مع معلومات حول الاتصالات بين عناصر نموذج pure::variants وكود المصدر. تتم إضافة العلاقات للميزات المستخدمة في شروط عناصر ps:condxml وps:condtext.
بالنسبة إلى ps:flag وps:flagfile العناصر التي تحدد موقع ثوابت المعالج المسبق في مصدر C/C++ fileيتم عرض s. بالإضافة إلى ذلك، يتم عرض مواقع ثوابت المعالج المسبق المطابقة لخاصية محددة باستخدام التعيين بين أسماء الميزات الفريدة وثوابت المعالج المسبق.
3.1. إضافة فهرس العلاقة إلى مشروع
يمكن تنشيط فهرس العلاقات في صفحة خصائص المشروع الخاصة. حدد المشروع واختر عنصر الخصائص في قائمة السياق. في مربع الحوار التالي، حدد صفحة فهرس العلاقات.
الشكل 5. صفحة خصائص المشروع لفهرس العلاقة

يتم تنشيط فهرس العلاقة للمشروع من خلال تحديد خيار تمكين فهرس العلاقة (1). بعد تمكين الفهرس، توجد بعض الخيارات الأخرى لتحديد السلوك الخاص بالمشروع. يمكن تنشيط فهرسة شروط pure::variants وثوابت المعالج المسبق C/C++ بشكل منفصل (2). القائمة التي تحتوي على file يتم استخدام أنماط الأسماء (3) لتحديد files للفهرسة فقط fileيتم مسح العناصر التي تطابق أحد الأنماط. أضف "*" كنمط لمسح جميع العناصر. fileجزء من المشروع.
بعد تنشيط الفهرس لمشروع ما، تتم إضافة منشئ للمشروع. يقوم هذا المنشئ بفحص التغييرات files للعلاقات الجديدة مع عناصر النموذج pure::variants تلقائيًا.
3.2. العلاقات مع الكود المصدر
مع مؤشر العلاقة المنشط، العلاقات View يحتوي على إدخالات إضافية. تعرض هذه الإدخالات اسم file ورقم خط النقطة المتغيرة. يُظهر تلميح الأداة القسم المناسب من file. من خلال النقر المزدوج على الإدخال file سيتم فتحه في المحرر.
شروط pure::variants
يمكن استخدام شرط pure::variants لتضمين أو استبعاد أقسام من file اعتمادًا على اختيار ميزة. يبحث فهرس الحالة عن مثل هذه القواعد ويستخرج الميزات المشار إليها. إذا تم تحديد مثل هذه الميزة في المحرر، يتم عرض العلاقات View سوف تظهر كل شيء files والخطوط التي يوجد بها الشرط مع الميزة المحددة (انظر الشكل 6، "تمثيل الشرط في العلاقات"). View").
الشكل 6. تمثيل الشرط في العلاقات Viewللحصول على شرح مفصل حول كيفية تحديد الشروط، راجع القسم ps:condtext من الفصل 9.5.7 من دليل مستخدم pure::variants (المرجع–> أنواع عناصر المصدر المحددة مسبقًا–> ps:condtext).
ثوابت المعالج المسبق C/C++
يقوم فهرس المعالج المسبق C/C++ بفحص files للثوابت المستخدمة في قواعد المعالج المسبق (على سبيل المثال #ifdef، #ifndef، ...).
إذا كان ps:flag أو ps:flagfile تم تحديد العنصر العلاقات View يظهر استخدام ثابت المعالج المسبق المحدد.
العلاقات View كما يعرض ثوابت المعالج المسبق المتصلة بالميزات باستخدام أنماط التعيين. ولهذا الغرض، يتم توسيع الأنماط باستخدام بيانات الميزة المحددة. تُستخدم الرموز الناتجة للبحث عن ثوابت المعالج المسبق المطابقة. الشكل 7، "تمثيل ثابت معالج مسبق C/C++ في العلاقات View"يظهر السابق"ample مع النمط fame{Name}. يتم توسيع النمط بالاسم الفريد للميزة إلى fameNative. يوجد في الكود المفهرس 76 موقعًا حيث يتم استخدام ثابت المعالج المسبق fameNative.
تظهر هذه المواقع في العلاقات Viewيمكن تعريف الأنماط في التفضيلات (انظر القسم 3.3، "التفضيلات").
الشكل 7. تمثيل ثابت المعالج المسبق C/C++ في العلاقات View

3.3. التفضيلات
لتغيير السلوك الافتراضي للمفهرس، افتح تفضيلات Eclipse وحدد صفحة فهرس العلاقات في فئة إدارة المتغيرات. تعرض الصفحة قائمتين.
الشكل 8. صفحة تفضيلات فهرس العلاقةتحتوي القائمة العلوية على الإعدادات الافتراضية file أنماط الفهرس (1). هذه القائمة هي إعداد النمط الأولي للمشروعات التي تم تمكينها حديثًا.
تحتوي القائمة السفلية على التعيين بين الميزات وثوابت المعالج المسبق (2). يتم استخدام هذا التعيين لجميع المشاريع. يوضح الجدول 1، "استبدالات التعيين المدعومة" جميع الاستبدالات الممكنة.
الجدول 1. بدائل التعيين المدعومة

بطاقة بديلة	وصف	Example: ميزة أ
اسم	الاسم الفريد للميزة المحددة	FLAG_{الاسم} – FLAG_FeatureA
اسم	الاسم الفريد للميزة المحددة بأحرف كبيرة	FLAG_{NAME} – FLAG_FEATUREA
اسم	الاسم الفريد للميزة المحددة بأحرف صغيرة	flag_{name} – flag_featurea

المستندات / الموارد

موصل pure-systems 2024 لبرامج إدارة التعليمات البرمجية المصدرية [بي دي اف] دليل المستخدم 2024، 2024 موصل لبرامج إدارة التعليمات البرمجية المصدرية، موصل لبرامج إدارة التعليمات البرمجية المصدرية، برامج إدارة التعليمات البرمجية المصدرية، برامج الإدارة، البرامج

مراجع

• دليل المستخدم