pure::variants – З’єднувач для
Керівництво з керування вихідним кодом
Parametric Technology GmbH
Версія 6.0.7.685 для pure::variants 6.0
Авторське право © 2003-2024 Parametric Technology GmbH
2024

вступ

pure::variants Connector для керування вихідним кодом (Connector) дозволяє розробникам керувати змінністю вихідного коду за допомогою pure::variants. Керування вихідним кодом pure::variants надає гнучку можливість синхронізувати структуру каталогів і вихідний код fileлегко з моделями pure::variants. Таким чином, управління варіантами можна застосовувати навіть до складних програмних проектів. Крім того, зв’язками між функціями pure::variants і вихідним кодом можна керувати легше за допомогою конструктора, і вони легко доступні через Керування вихідним кодом.
1.1. Вимоги до програмного забезпечення
Конектор pure::variants для керування вихідним кодом є розширенням для pure::variants і доступний на всіх підтримуваних платформах.
1.2. Монтаж
Будь ласка, зверніться до розділу pure::variants Connectors у pure::variants Setup Guide, щоб отримати детальну інформацію про встановлення конектора (меню «Довідка» -> «Вміст довідки», а потім pure::variants Setup Guide -> pure::variants Connectors).
1.3. Про цей посібник
Очікується, що читач матиме базові знання та досвід роботи з pure::variants. Перш ніж читати цей посібник, ознайомтеся зі вступним матеріалом. Посібник доступний у вигляді онлайн-довідки, а також у форматі PDF для друку тут.

Використання конектора

2.1. Початок pure::variants
Залежно від використовуваного методу інсталяції або запустіть Eclipse з підтримкою pure::variants, або в Windows виберіть пункт pure::variants у меню програми.
Якщо перспективу «Керування варіантами» ще не активовано, зробіть це, вибравши її в меню «Відкрити перспективу»->Інше… у меню «Вікно».
2.2. Імпортуйте дерево каталогів у сімейну модель
Перш ніж імпортувати дерево каталогів у сімейну модель, необхідно створити проект варіантів. Також рекомендовано вже мати функції, визначені в моделі функцій. Щоб отримати довідку щодо цих кроків, зверніться до документації pure::variants.
Фактичний імпорт запускається вибором дії Імпортувати… або в контекстному меню Проектів view або за допомогою меню «Імпорт…» у File меню. Виберіть варіанти моделей або проектів у категорії «Керування варіантами» та натисніть «Далі». На наступній сторінці виберіть «Імпортувати модель сім’ї з вихідних папок» і знову натисніть «Далі».
Виберіть тип вихідного коду для імпорту
З’явиться майстер імпорту (див. Малюнок 1, «Сторінка майстра імпорту для вибору типу вихідного коду, який можна імпортувати»). Виберіть тип проекту для імпорту та натисніть «Далі». Кожен тип містить попередньо визначений набір file типи для імпорту в модель.
Малюнок 1. Сторінка майстра імпорту для вибору типу вихідного коду, який можна імпортуватиВиберіть Джерело та Ціль
На наступній сторінці майстра (Рисунок 2, «Сторінка майстра імпорту для вибору джерела та цілі для імпорту») необхідно вказати вихідний каталог і цільову модель.
Натисніть кнопку «Огляд…», щоб вибрати каталог, у якому міститься вихідний код, який потрібно імпортувати. За замовчуванням вибрано поточне робоче середовище, оскільки це може бути корисним пунктом для початку навігації.
Нижче ви можете вказати шаблон включення та виключення. Ці шаблони мають бути регулярними виразами Java. Кожен вхідний шлях, відносно вихідної кореневої папки, перевіряється цим шаблоном. Якщо шаблон включення збігається, папка імпортується, якщо шаблон виключення не збігається. Це означає, що шаблон включення попередньо вибирає папки для імпорту, шаблон виключення обмежує цей попередній вибір.
Після вибору каталогу вихідного коду необхідно визначити цільову модель. Тому виберіть варіант проекту або папку, де має зберігатися модель, і введіть назву моделі. The file ім’я автоматично розширюється за допомогою розширення .ccfm, якщо воно не вказано в цьому діалоговому вікні. За замовчуванням буде встановлено ту саму назву, що й сама назва моделі. Це рекомендований параметр.
Після вказівки потрібної вихідної папки та бажаної назви моделі діалог можна завершити, натиснувши Готово. Якщо натиснути кнопку Далі, відкриється наступна сторінка, де можна виконати додаткові налаштування.
Малюнок 2. Сторінка майстра імпорту для вибору джерела та цілі для імпортуЗмінити налаштування імпорту
На останній сторінці майстра (Рисунок 3, «Сторінка майстра імпорту для визначення окремої конфігурації”) існують параметри, за допомогою яких можна налаштувати поведінку імпорту для імпортованого проекту програмного забезпечення.
Сторінка діалогу показує таблицю, де file визначено типи, які враховуватимуться в процесі імпорту.
Кожен рядок складається з чотирьох полів.

• Поле Опис містить короткий описовий текст для визначення file типу.
• The File поле шаблону імені використовується для вибору files для імпорту, коли вони збігаються зі значенням полів. Поле використовує такий синтаксис:

1. Найпоширенішим випадком використання може бути a file розширення. Звичайним синтаксисом є .EXT, де EXT є бажаним file розширення (наприклад, .java).
2. Інша поширена ситуація - особлива file, як зробитиfile. Тому можна зіставити по точній file назва. Для цього просто введіть file назву в поле (наприклад, build.xml).
3. У деяких випадках бажання відображення є більш конкретними, тому тільки fileякі відповідають спеціальному шаблону, слід імпортувати. Щоб відповідати цій вимозі, можна використовувати регулярні вирази в File поле шаблону імені.
   Опис синтаксису регулярних виразів виходить за рамки цієї довідки. Будь ласка, зверніться до розділу регулярних виразів довідкового розділу в посібнику користувача pure::variants (наприклад, .*).

• Поле «Тип відображеного елемента» встановлює відображення між a file тип і тип елемента сімейства pure::variants. Тип елемента родини є дескриптором для джерела file щоб надати додаткову інформацію зіставленому елементу в імпортованій моделі. Типовим вибором є ps:class або ps:makefile.
• Відображено file поле типу встановлює відображення між a file тип і чистий::варіанти file типу. The file type in pure::variants є дескриптором для джерела file щоб надати додаткову інформацію зіставленому елементу в імпортованій моделі. Типовим вибором є impl для реалізації або def для визначення files.

Рисунок 3. Сторінка майстра імпорту для визначення індивідуальної конфігураціїновий file типи можна додати за допомогою кнопки «Додати відображення». Усі поля заповнюються значенням undefined і повинні бути заповнені користувачем. Щоб змінити значення в полі, просто клацніть поле мишею. Значення стає доступним для редагування та може бути змінено. Неможливо змінити значення за замовчуванням file назва зразків таблиці. Щоб зробити налаштування гнучкими, можна скасувати вибір a file введіть, скасувавши вибір рядка. Знято вибір file Шаблони імен залишаються в конфігурації, але не використовуватимуться імпортером. Визначено користувачем file типи можна знову видалити за допомогою кнопки Видалити відображення.
За замовчуванням Інше files file Шаблон назви доступний у таблиці, але не вибрано. Зазвичай імпортувати не всі files але це можна легко змінити, вибравши відповідний рядок.
Існує три загальні параметри імпорту для налаштування поведінки імпортера.

• Не імпортуйте каталоги без відповідності files (наприклад, каталоги CVS).
  Якщо імпортер знаходить каталог, де немає збігів file знаходиться в ньому і де жоден підкаталог не має відповідності file, каталог не буде імпортовано. Це часто корисно, якщо проектами керують системи керування версіями, такі як CVS. Для CVS кожен релевантний каталог містить CVS-каталог, де він не має значення files зберігаються. Якщо вибрано цей параметр і CVS-files не збігаються з жодним file тип, визначений вище, каталог не буде імпортовано як компонент до сімейної моделі.
• Сортувати files та каталоги.
  Увімкніть цю опцію для сортування files і каталоги в алфавітному порядку.
• Обробка шляху імпорту.
  Для подальшої синхронізації імпортеру необхідно зберегти вихідний шлях усіх імпортованих елементів у модель.
  У багатьох випадках сімейні моделі надаються іншим користувачам. Структура каталогу може відрізнятися для кожного користувача. Для підтримки більшості типових сценаріїв використання імпортер може працювати в різних режимах:

Абсолютний	Абсолютний шлях до імпортованого елемента буде збережено в моделі. Для подальшої синхронізації та під час трансформації fileслід розмістити в тому самому місці, що й під час першого імпорту.
Відносно робочої області	Шляхи зберігаються відносно папки робочої області. Для синхронізації files має бути частиною робочого простору Eclipse. Перетворення має використовувати робочий простір Eclipse як вхідний каталог.
Відносно проекту	Шляхи зберігаються відносно проекту. Для синхронізації files є частиною проекту всередині Eclipse. Перетворення має використовувати папку проекту як вхідний каталог.
Відносно шляху	Шляхи зберігаються відносно заданого шляху. Для синхронізації fileповинні бути розміщені точно в одному місці. Вхідний каталог трансформації збігається з відносним шляхом під час імпорту.

Усі параметри цього діалогового вікна зберігаються постійно. Персональні налаштування не можна переробляти щоразу під час імпорту. Це робить процес імпорту простим і швидким.
2.3. Оновлення моделей з дерева каталогів
Натисніть кнопку Синхронізувати для синхронізації імпортованої моделі з її шляхом до каталогу. Кореневий шлях проекту зберігається в моделі, тому він синхронізуватиметься з тим же каталогом, що й раніше. Щоб активувати кнопку «Синхронізувати», відкрийте модель і виберіть будь-який елемент. Після натискання кнопки «Синхронізувати» відкривається редактор порівняння, де поточна модель сімейства та модель поточної структури каталогу протиставляються (див. Малюнок 4, «Оновлення моделі з дерева каталогів у редакторі порівняння»).
Рисунок 4. Оновлення моделі з дерева каталогів у редакторі порівняння   Редактор порівняння використовується в pure::variants для порівняння версій моделі, але в цьому випадку використовується для порівняння фізичної структури каталогу (відображеної в нижньому правому куті) з поточною моделлю pure::variants (нижній лівий бік). Усі зміни перераховуються як окремі елементи у верхній частині редактора, упорядковані за елементами, яких це стосується.
Вибір елемента в цьому списку висвітлює відповідну зміну в обох моделях. У вихamplе, доданий елемент позначено рамкою з правого боку та пов’язано з його можливим положенням у моделі з лівого боку. Панель інструментів «Об’єднати» між верхнім і нижнім вікнами редактора надає інструменти для копіювання окремих або навіть усіх (неконфліктних) змін у цілому з моделі дерева каталогів до моделі функцій.
Примітка
Синхронізація виконується з останніми використаними параметрами імпортера. Це дає змогу оновити модель за допомогою інших параметрів, зроблених під час виконання імпорту.

Використання Relation Indexer

З’єднувач для керування вихідним кодом покращує відносини View з інформацією про зв’язки між елементами моделі pure::variants і вихідним кодом. Додано зв’язки для функцій, які використовуються в умовах елементів ps:condxml і ps:condtext.
Для ps:flag і ps:flagfile елементи розташування констант препроцесора в джерелі C/C++ files показано. Крім того, розташування відповідних констант препроцесора показано для вибраної функції за допомогою зіставлення між унікальними назвами функцій і константами препроцесора.
3.1. Додавання індексатора відношень до проекту
Індексатор відношень можна активувати на спеціальній сторінці властивостей проекту. Виберіть проект і виберіть у контекстному меню пункт Властивості. У наступному діалоговому вікні виберіть сторінку Relation Indexer.
Рисунок 5. Сторінка властивостей проекту для індексатора відношень

Індексатор зв’язків активується для проекту шляхом вибору параметра «Увімкнути індексатор зв’язків» (1). Після ввімкнення індексатора є ще кілька параметрів для визначення конкретної поведінки проекту. Індексацію умов pure::variants і констант препроцесора C/C++ можна активувати окремо (2). Список с file Шаблони імен (3) використовуються для вибору files для індексації. Тільки fileякі відповідають одному з шаблонів, скануються. Додайте «*» як шаблон, щоб сканувати все files проекту.
Після активації індексатора для проекту до проекту додається конструктор. Сканування цього конструктора змінено files для нових відносин до елементів моделі pure::variants автоматично.
3.2. Відношення до вихідного коду
З активованим індексатором відношень Relations View містить додаткові записи. Ці записи показують назву file і номер рядка варіантної точки. Підказка показує відповідний розділ file. Двічі клацнувши запис the file буде відкрито в редакторі.
pure::variants Умови
Умову pure::variants можна використовувати для включення або виключення розділів a file залежно від вибору функції. Індексатор умов сканує такі правила та витягує посилання на функції. Якщо таку функцію вибрано в редакторі 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 з шаблоном fame{Name}. Шаблон розширено унікальною назвою функції до fameNative. В індексованому коді є 76 місць, де використовується константа препроцесора fameNative.
Ці місця відображаються у зв’язках View. Шаблони можна визначити в налаштуваннях (див. Розділ 3.3, «Параметри»).
Рисунок 7. Представлення константи препроцесора C/C++ у зв’язках View

3.3. Налаштування
Щоб змінити типову поведінку індексатора, відкрийте параметри Eclipse і виберіть сторінку Relation Indexer у категорії Variant Management. На сторінці показано два списки.
Малюнок 8. Сторінка параметрів Relation IndexerВерхній список містить значення за замовчуванням file шаблони для покажчика (1). Цей список є початковим параметром шаблону для нещодавно активованих проектів.
Нижній список містить відображення між функціями та константами препроцесора (2). Це відображення використовується для всіх проектів. Таблиця 1 «Підтримувані заміни зіставлення» показує всі можливі заміни.
Таблиця 1. Підтримувані заміни відображення

Wildcard	опис	Example: FeatureA
Ім'я	Унікальна назва вибраного об’єкта	FLAG_{Назва} – FLAG_FeatureA
ІМ'Я	у верхньому регістрі Унікальна назва вибраного об’єкта	FLAG_{NAME} – FLAG_FEATUREA
назва	нижній регістр Унікальна назва вибраного об’єкта	flag_{name} – flag_featurea

Документи / Ресурси

pure-systems 2024 Connector для програмного забезпечення для керування вихідним кодом [pdfПосібник користувача 2024, 2024 Connector для програмного забезпечення для керування вихідним кодом, Connector для програмного забезпечення для керування вихідним кодом, програмного забезпечення для керування вихідним кодом, програмного забезпечення для керування, програмного забезпечення

Список літератури

• Посібник користувача