pure::variants – رابط برای
راهنمای مدیریت کد منبع
Parametric Technology GmbH
نسخه 6.0.7.685 برای pure::variants 6.0
حق چاپ © 2003-2024 Parametric Technology GmbH
2024

مقدمه

pure::variants Connector for Source Code Management (Connector) توسعه دهندگان را قادر می سازد تا تنوع کد منبع را با استفاده از pure::variants مدیریت کنند. مدیریت کد منبع pure::variants فرصتی انعطاف پذیر برای همگام سازی ساختارهای دایرکتوری و کد منبع فراهم می کند. fileبا مدل های pure::variants به راحتی می توانید استفاده کنید. بنابراین، مدیریت انواع می‌تواند حتی برای پروژه‌های نرم‌افزاری پیچیده نیز کاربردی باشد. علاوه بر این، ارتباطات بین ویژگی‌های pure:: variants و کد منبع ممکن است آسان‌تر با سازنده مدیریت شوند و از طریق مدیریت کد منبع بسیار قابل دسترسی هستند.
1.1. نرم افزار مورد نیاز
Pure::variants Connector برای مدیریت کد منبع یک برنامه افزودنی برای pure::variants است و در همه پلتفرم های پشتیبانی شده در دسترس است.
1.2. نصب و راه اندازی
لطفاً با بخش pure::variants Connectors در راهنمای راه‌اندازی pure::variants برای اطلاعات دقیق درباره نحوه نصب کانکتور (منو Help -> Help Contents و سپس pure::variants Setup Guide -> Pure::variants Connectors) مشورت کنید.
1.3. درباره این راهنما
از خواننده انتظار می رود که دانش اولیه و تجربیات مربوط به pure::variants را داشته باشد. لطفاً قبل از خواندن این راهنما با مطالب مقدماتی آن مشورت کنید. این راهنما به صورت راهنمای آنلاین و همچنین در قالب PDF قابل چاپ در اینجا موجود است.

با استفاده از رابط

2.1. شروع خالص::variants
بسته به روش نصب مورد استفاده، یا Pure::variants-enabled Eclipse را شروع کنید یا در زیر ویندوز، مورد pure::variants را از منوی برنامه انتخاب کنید.
اگر دیدگاه مدیریت متغیر قبلاً فعال نشده است، با انتخاب آن از Open Perspective->Other… در منوی پنجره، این کار را انجام دهید.
2.2. وارد کردن درخت دایرکتوری به مدل خانواده
قبل از وارد کردن یک درخت دایرکتوری به یک مدل خانواده، یک پروژه انواع باید ایجاد شود. همچنین پیشنهاد می‌شود که ویژگی‌هایی از قبل در یک مدل ویژگی تعریف شده باشد. لطفاً برای راهنمایی در مورد این مراحل به مستندات pure::variants مراجعه کنید.
واردات واقعی با انتخاب عمل Import… در منوی زمینه پروژه ها آغاز می شود view یا با منوی Import… در File منو مدل‌های متغیر یا پروژه‌ها را از دسته مدیریت متغیر انتخاب کنید و Next را فشار دهید. در صفحه زیر Import a Family Model from Source folders را انتخاب کنید و دوباره Next را فشار دهید.
نوع کد منبع را برای وارد کردن انتخاب کنید
جادوگر واردات ظاهر می شود (شکل 1 را ببینید، "صفحه جادوگر واردات برای انتخاب نوع کد منبعی که ممکن است وارد شود"). یک نوع پروژه را برای وارد کردن انتخاب کنید و Next را فشار دهید. هر نوع شامل مجموعه ای از پیش تعریف شده است file انواع برای وارد کردن به مدل
شکل 1. صفحه جادوگر واردات برای انتخاب نوع کد منبعی که ممکن است وارد شودمنبع و هدف را انتخاب کنید
در صفحه بعدی جادوگر (شکل 2، "صفحه جادوگر واردات برای انتخاب منبع و هدف برای واردات") دایرکتوری منبع و مدل هدف باید مشخص شود.
دکمه Browse… را فشار دهید تا فهرستی را انتخاب کنید که کد منبع وجود دارد و باید وارد شود. به‌طور پیش‌فرض، فضای کاری فعلی انتخاب شده است، زیرا ممکن است نقطه مفیدی برای شروع پیمایش باشد.
در زیر می توانید الگوی شامل و حذف را مشخص کنید. این الگوها باید عبارات منظم جاوا باشند. هر مسیر ورودی، نسبت به پوشه ریشه منبع، با این الگو بررسی می شود. اگر الگوی شامل مطابقت داشته باشد، اگر الگوی حذف مطابقت نداشته باشد، یک پوشه وارد می شود. به این معنی که الگوی شامل از قبل پوشه‌ها را برای وارد کردن انتخاب می‌کند، الگوی حذف این پیش‌انتخاب را محدود می‌کند.
پس از انتخاب دایرکتوری کد منبع باید یک مدل هدف تعریف شود. بنابراین یک پروژه یا پوشه ای که مدل باید در آن ذخیره شود را انتخاب کنید و نام مدل را وارد کنید. این file نام به طور خودکار با پسوند ccfm. اگر در این گفتگو داده نشده است، گسترش می یابد. به طور پیش فرض به همان نام خود مدل تنظیم می شود. این تنظیم توصیه شده است.
پس از مشخص شدن یک پوشه منبع مناسب و نام مدل مورد نظر، گفتگو ممکن است با فشار دادن Finish به پایان برسد. اگر دکمه Next فشار داده شود، صفحه دیگری باز می شود که می توان تنظیمات اضافی را در آن انجام داد.
شکل 2. صفحه ویزارد واردات برای انتخاب منبع و هدف برای وارداتتنظیمات برگزیده واردات را تغییر دهید
در آخرین صفحه جادوگر (شکل 3، «صفحه جادوگر واردات برای تعریف یک پیکربندی فردی”) تنظیماتی وجود دارد که می توان برای سفارشی کردن رفتار واردات برای پروژه نرم افزاری وارداتی انجام داد.
صفحه گفتگو جدولی را نشان می دهد که در آن file انواع تعریف شده است که در فرآیند واردات در نظر گرفته می شود.
هر خط از چهار فیلد تشکیل شده است.

• فیلد توضیحات حاوی یک متن توصیفی کوتاه برای شناسایی است file نوع
• را File برای انتخاب از فیلد الگوی نام استفاده می شود fileهنگامی که با مقدار فیلدها مطابقت دارند وارد شوند. این فیلد از نحو زیر استفاده می کند:

1. رایج ترین مورد استفاده ممکن است الف باشد file پسوند. نحو معمولی EXT است که در آن EXT مورد نظر است file پسوند (به عنوان مثال .java).
2. یکی دیگر از موقعیت های رایج یک وضعیت خاص است file، مانند یک ساختfile. بنابراین، امکان تطبیق بر روی دقیق وجود دارد file نام برای انجام این کار، فقط وارد کنید file نام را در فیلد قرار دهید (به عنوان مثال build.xml).
3. در برخی موارد، خواسته های نقشه برداری خاص تر هستند، بنابراین فقط fileمواردی که با یک الگوی خاص مطابقت دارند باید وارد شوند. برای مطابقت با این نیاز، می توان از عبارات منظم در آن استفاده کرد File فیلد الگوی نام
   توصیف نحو عبارات منظم بیش از هدف این کمک خواهد بود. لطفاً به بخش عبارات منظم فصل مرجع در راهنمای کاربر pure::variants (به عنوان مثال .*) مراجعه کنید.

• فیلد نوع عنصر Mapped نگاشت بین a را تنظیم می کند file نوع و یک نوع عنصر خانواده خالص::variants. نوع عنصر خانواده یک توصیف کننده برای منبع است file برای ارائه اطلاعات بیشتر به عنصر نگاشت شده در مدل وارد شده. انتخاب های معمولی ps:class یا ps:make هستندfile.
• نقشه برداری شده file فیلد type نگاشت بین a را تنظیم می کند file نوع و خالص::Variants file نوع را file نوع pure::variants یک توصیف کننده برای منبع است file برای ارائه اطلاعات بیشتر به عنصر نگاشت شده در مدل وارد شده. انتخاب‌های معمولی برای پیاده‌سازی یا تعریف تعریف هستند files.

شکل 3. صفحه ویزارد واردات برای تعریف یک پیکربندی فردیجدید file انواع را می توان با استفاده از دکمه Add Mapping اضافه کرد. تمام فیلدها با مقدار تعریف نشده پر می شوند و باید توسط کاربر پر شوند. برای ویرایش یک مقدار در یک فیلد، فقط با ماوس روی فیلد کلیک کنید. مقدار قابل ویرایش می شود و قابل تغییر است. امکان تغییر پیش فرض وجود ندارد file الگوهای نام جدول برای منعطف ساختن یک سفارشی‌سازی، می‌توان a را از حالت انتخاب خارج کرد file با لغو انتخاب سطر تایپ کنید. لغو انتخاب شد file الگوهای نام در پیکربندی باقی می مانند اما توسط وارد کننده استفاده نمی شود. کاربر تعریف شده است file ممکن است با استفاده از دکمه Remove Mapping دوباره انواع را حذف کنید.
به طور پیش فرض یک Other files file الگوی نام در جدول موجود است اما انتخاب نشده است. معمولاً نمی‌خواهد همه را وارد کند files اما این را می توان به راحتی با انتخاب ردیف مربوطه تغییر داد.
سه گزینه واردات کلی برای سفارشی کردن رفتار واردکننده وجود دارد.

• دایرکتوری ها را بدون مطابقت وارد نکنید files (به عنوان مثال دایرکتوری های CVS).
  اگر واردکننده دایرکتوری پیدا کند که هیچ تطبیقی ​​ندارد file در آن قرار دارد و هیچ زیر شاخه ای تطبیق ندارد file، دایرکتوری وارد نخواهد شد. این اغلب مفید است، اگر پروژه ها توسط سیستم های مدیریت نسخه مانند CVS مدیریت شوند. برای CVS، هر دایرکتوری مربوطه حاوی یک دایرکتوری CVS است که در آن نامربوط است files ذخیره می شوند. اگر این گزینه انتخاب شده و CVS-fileبا هیچ کدام مطابقت ندارد file نوع تعریف شده در بالا، دایرکتوری به عنوان یک جزء به مدل Family وارد نمی شود.
• مرتب کردن fileاس ها و دایرکتوری ها
  این گزینه را برای مرتب سازی فعال کنید files و دایرکتوری ها هر کدام به ترتیب حروف الفبا.
• مدیریت مسیر واردات
  برای همگام سازی بیشتر، واردکننده باید مسیر اصلی همه عناصر وارد شده را در مدل ذخیره کند.
  در بسیاری از موارد، مدل‌های خانواده با سایر کاربران به اشتراک گذاشته می‌شوند. ساختار دایرکتوری ممکن است برای هر کاربر متفاوت باشد. برای پشتیبانی از اکثر سناریوهای استفاده رایج، واردکننده می‌تواند در حالت‌های مختلف کار کند:

مطلق	مسیر مطلق به عنصر وارد شده در مدل ذخیره می شود. برای همگام سازی بعدی و در طول تبدیل files باید دقیقاً در همان مکان در هنگام اولین واردات قرار گیرد.
نسبت به فضای کاری	مسیرها نسبت به پوشه فضای کاری ذخیره می شوند. برای همگام سازی files باید بخشی از فضای کاری Eclipse باشد. تبدیل باید از فضای کاری Eclipse به عنوان دایرکتوری ورودی استفاده کند.
نسبت به پروژه	مسیرها نسبت به پروژه ذخیره می شوند. برای همگام سازی files بخشی از پروژه داخل Eclipse هستند. تبدیل باید از پوشه پروژه به عنوان دایرکتوری ورودی استفاده کند.
نسبت به مسیر	مسیرها نسبت به مسیر داده شده ذخیره می شوند. برای همگام سازی files باید دقیقاً در همان مکان قرار گیرند. دایرکتوری ورودی تبدیل همان مسیر نسبی در حین واردات است.

همه تنظیمات برگزیده این گفتگو به طور مداوم ذخیره می شوند. سفارشی سازی های شخصی نباید هر بار که واردات اجرا می شود دوباره انجام شود. این امر گردش کار واردات را آسان و سریع می کند.
2.3. به روز رسانی مدل ها از درخت دایرکتوری
دکمه همگام سازی را فشار دهید برای همگام سازی یک مدل وارد شده با مسیر دایرکتوری آن. مسیر اصلی پروژه در مدل ذخیره می شود، بنابراین با همان دایرکتوری قبلی همگام می شود. برای فعال کردن دکمه همگام سازی، مدل را باز کنید و هر عنصر را انتخاب کنید. پس از فشار دادن دکمه همگام سازی، یک ویرایشگر مقایسه باز می شود که در آن مدل خانواده فعلی و مدل ساختار دایرکتوری فعلی با هم مخالفند (شکل 4، "به روز رسانی مدل از درخت فهرست در ویرایشگر مقایسه" را ببینید).
شکل 4. به روز رسانی مدل از درخت فهرست در ویرایشگر مقایسه   ویرایشگر مقایسه در سراسر pure::variants برای مقایسه نسخه های مدل استفاده می شود، اما در این مورد برای مقایسه ساختار دایرکتوری فیزیکی (نمایش داده شده در سمت راست پایین) با مدل pure::variants فعلی (سمت چپ پایین) استفاده می شود. همه تغییرات به‌عنوان موارد جداگانه در قسمت بالای ویرایشگر، به ترتیب توسط عناصر آسیب‌دیده فهرست شده‌اند.
انتخاب یک مورد در این لیست، تغییرات مربوطه را در هر دو مدل برجسته می کند. در سابقampیک عنصر اضافه شده با یک جعبه در سمت راست مشخص شده و با موقعیت قابل اجرا در مدل در سمت چپ متصل می شود. نوار ابزار Merge بین پنجره های ویرایشگر بالا و پایین ابزارهایی را برای کپی کردن تک یا حتی همه (غیر متضاد) تغییرات به عنوان یک کل از مدل درخت دایرکتوری به مدل ویژگی فراهم می کند.
توجه داشته باشید
همگام سازی با آخرین تنظیمات واردکننده استفاده شده انجام می شود. این امکان به روز رسانی مدل را با تنظیمات دیگر در حین انجام واردات فراهم می کند.

با استفاده از Relation Indexer

رابط برای مدیریت کد منبع، روابط را افزایش می دهد View با اطلاعاتی در مورد ارتباط بین عناصر مدل pure::variants و کد منبع. روابط برای ویژگی هایی که در شرایط عناصر ps:condxml و ps:condtext استفاده می شوند، اضافه می شوند.
برای ps:flag و ps:flagfile مکان ثابت های پیش پردازنده را در منبع C/C++ تعیین می کند files نشان داده شده است. علاوه بر این، مکان های تطبیق ثابت های پیش پردازنده برای یک ویژگی انتخاب شده با استفاده از نگاشت بین نام های منحصر به فرد ویژگی و ثابت های پیش پردازنده نشان داده می شود.
3.1. افزودن شاخص رابطه به پروژه
نمایه ساز رابطه را می توان در صفحه خاصی از پروژه فعال کرد. پروژه را انتخاب کنید و مورد Properties را در منوی زمینه انتخاب کنید. در گفتگوی بعدی صفحه Relation Indexer را انتخاب کنید.
شکل 5. صفحه ویژگی پروژه برای شاخص رابطه

نمایه ساز رابطه با انتخاب گزینه Enable Relation Indexer (1) برای پروژه فعال می شود. پس از فعال کردن نمایه ساز، گزینه های بیشتری برای تعریف رفتار خاص پروژه وجود دارد. نمایه سازی pure::variants Conditions و C/C++ Constants Preprocessor را می توان به طور جداگانه فعال کرد (2). لیست با file الگوهای نام (3) برای انتخاب استفاده می شود files برای نمایه سازی فقط fileاسکن هایی که با یکی از الگوها مطابقت دارند اسکن می شوند. برای اسکن همه، "*" را به عنوان الگو اضافه کنید fileاز یک پروژه
پس از فعال سازی نمایه ساز برای یک پروژه، سازنده به پروژه اضافه می شود. این اسکن سازنده تغییر کرد files برای روابط جدید با عناصر خالص::variants مدل به طور خودکار.
3.2. روابط با کد منبع
با شاخص رابطه فعال شده، Relations View شامل ورودی های اضافی است. این ورودی ها نام آن را نشان می دهد file و شماره خط نقطه متغیر. نوک ابزار بخش مناسبی را نشان می دهد file. با دوبار کلیک کردن روی ورودی file در یک ویرایشگر باز خواهد شد.
pure::variants شرایط
شرط pure::variants می تواند برای گنجاندن یا حذف بخش هایی از a استفاده شود file بسته به انتخاب ویژگی Indexer Condition چنین قوانینی را اسکن می کند و ویژگی های ارجاع شده را استخراج می کند. اگر چنین ویژگی در ویرایشگر انتخاب شده باشد، Relations 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 عنصر Relations انتخاب شده است View استفاده از ثابت پیش پردازنده تعریف شده را نشان می دهد.
روابط View همچنین ثابت های پیش پردازنده متصل به ویژگی ها را با استفاده از الگوهای نگاشت نشان می دهد. برای این کار الگوها با داده های ویژگی انتخاب شده گسترش می یابند. نمادهای به دست آمده برای جستجوی ثابت های پیش پردازنده منطبق استفاده می شوند. شکل 7، «نمایش یک ثابت پیش پردازنده C/C++ در روابط View” یک سابق را نشان می دهدample با الگوی شهرت{Name}. این الگو با نام منحصر به فرد ویژگی به fameNative گسترش یافته است. در کد ایندکس شده 76 مکان وجود دارد که در آنها از fameNative ثابت پیش پردازنده استفاده شده است.
این مکان ها در روابط نشان داده شده است View. الگوها را می توان در اولویت ها تعریف کرد (به بخش 3.3، "اولویت ها" مراجعه کنید).
شکل 7. نمایش یک ثابت پیش پردازنده C/C++ در روابط View

3.3. تنظیمات
برای تغییر رفتار پیش‌فرض نمایه‌ساز، تنظیمات Eclipse را باز کنید و صفحه Relation Indexer را در دسته مدیریت متغیر انتخاب کنید. صفحه دو لیست را نشان می دهد.
شکل 8. صفحه اولویت شاخص رابطهلیست بالا حاوی پیش فرض است file الگوهای شاخص (1). این لیست تنظیمات اولیه الگوی پروژه های تازه فعال شده است.
لیست پایین شامل نگاشت بین ویژگی ها و ثابت های پیش پردازنده است (2). این نقشه برداری برای همه پروژه ها استفاده می شود. جدول 1، «جایگزین‌های نقشه‌برداری پشتیبانی شده» همه جایگزین‌های ممکن را نشان می‌دهد.
جدول 1. جایگزین های نقشه برداری پشتیبانی شده

عام	توضیحات	Example: ویژگی A
نام	نام منحصر به فرد ویژگی انتخاب شده	FLAG_{Name} – FLAG_FeatureA
NAME	حروف بزرگ نام منحصر به فرد ویژگی انتخاب شده	FLAG_{NAME} – FLAG_FEATUREA
نام	حروف کوچک نام منحصر به فرد ویژگی انتخاب شده	flag_{name} – flag_featurea

اسناد / منابع

pure-systems 2024 Connector برای نرم افزار مدیریت کد منبع [pdf] دفترچه راهنمای کاربر 2024، 2024 رابط برای نرم افزار مدیریت کد منبع، رابط برای نرم افزار مدیریت کد منبع، نرم افزار مدیریت کد منبع، نرم افزار مدیریت، نرم افزار

مراجع

• راهنمای کاربر