пуре::вариантс – Конектор за
Приручник за управљање изворним кодом
Параметриц Тецхнологи ГмбХ
Верзија 6.0.7.685 за пуре::варијанте 6.0
Ауторско право © 2003-2024 Параметриц Тецхнологи ГмбХ
2024

Увод

пуре::вариантс Конектор за управљање изворним кодом (конектор) омогућава програмерима да управљају варијабилношћу изворног кода користећи пуре::вариантс. Управљање изворним кодом пуре::варијанти пружа флексибилну прилику за синхронизацију структура директоријума и изворног кода fileлако са моделима пуре::вариантс. На тај начин се управљање варијантама може применити изводљиво чак и на сложене софтверске пројекте. Штавише, везе између пуре::вариантс функција и изворног кода могу се лакше управљати помоћу програмера и веома су доступне путем управљања изворним кодом.
1.1. Софтверски захтеви
Пуре::вариантс конектор за управљање изворним кодом је проширење за пуре::вариантс и доступан је на свим подржаним платформама.
1.2. Инсталација
Молимо погледајте одељак пуре::вариантс Конектори у Пуре::вариантс Водичу за подешавање за детаљне информације о томе како да инсталирате конектор (мени Хелп -> Хелп Цонтентс, а затим пуре::вариантс Водич за подешавање -> пуре::вариантс Цоннецторс).
1.3. О овом приручнику
Од читаоца се очекује да има основна знања и искуства са пуре::варијантама. Молимо вас да погледате његов уводни материјал пре читања овог упутства. Приручник је доступан у онлајн помоћи, као иу ПДФ формату за штампање овде.

Коришћење конектора

2.1. Почевши од чисте::варијанте
У зависности од коришћеног метода инсталације или покрените пуре::вариантс-енаблед Ецлипсе или под Виндовсом изаберите пуре::вариантс ставку из менија програма.
Ако перспектива управљања варијантама већ није активирана, урадите то тако што ћете је изабрати из Опен Перспецтиве->Отхер… у менију Прозор.
2.2. Увезите стабло именика у породични модел
Пре увоза стабла директоријума у ​​породични модел, мора се креирати пројекат варијанти. Такође је сугестивно да се карактеристике већ дефинишу у моделу карактеристика. Молимо консултујте пуре::вариантс документацију за помоћ у вези са овим корацима.
Стварни увоз се покреће одабиром акције Увези... било у контекстуалном менију Пројекти view или са менијем Увоз... у File мени. Изаберите Вариант Моделс или Пројецтс из категорије Вариант Манагемент и притисните Нект. На следећој страници изаберите Увези породични модел из изворних фасцикли и поново притисните Нект.
Изаберите тип изворног кода за увоз
Појављује се чаробњак за увоз (погледајте слику 1, „Страница чаробњака за увоз да бисте изабрали тип изворног кода који може да се увезе“). Изаберите тип пројекта за увоз и притисните Даље. Сваки тип садржи унапред дефинисани скуп file типове за увоз у модел.
Слика 1. Страница чаробњака за увоз за одабир типа изворног кода који се може увестиИзаберите Извор и циљ
На следећој страници чаробњака (Слика 2, „Страница чаробњака за увоз за одабир извора и циља за увоз“) изворни директоријум и циљни модел морају бити специфицирани.
Притисните дугме Бровсе… да изаберете директоријум у коме постоји изворни код који треба да се увезе. Подразумевано је изабран тренутни радни простор јер би ово могло бити корисна тачка за почетак навигације.
Испод можете да наведете образац за укључивање и искључивање. Ови шаблони морају бити јава регуларни изрази. Свака улазна путања, у односу на изворну коренску фасциклу, проверава се овим шаблоном. Ако се образац укључивања подудара, фасцикла се увози, ако се образац за изузимање не подудара. Што значи да образац укључивања унапред бира фасцикле за увоз, образац искључивања ограничава овај предизбор.
Након одабира директорија изворног кода, циљни модел мора бити дефинисан. Зато изаберите варијантни пројекат или фасциклу у којој треба да се чува модел и унесите назив модела. Тхе file име се аутоматски проширује са екстензијом .ццфм ако није дато у овом дијалогу. Подразумевано ће бити постављено на исто име као и сам назив модела. Ово је препоручена поставка.
Након што су наведени корисни изворни фолдер и назив жељеног модела, дијалог се може завршити притиском на Заврши. Ако се притисне дугме Даље, отвара се следећа страница на којој се могу извршити додатна подешавања.
Слика 2. Страница чаробњака за увоз за одабир извора и циља за увозПромените подешавања увоза
На последњој страни чаробњака (Слика 3, „Страница чаробњака за увоз за дефинисање појединачне конфигурације”) постоје поставке које се могу урадити да би се прилагодило понашање увоза за увезени софтверски пројекат.
Страница дијалога приказује табелу у којој је file дефинисани су типови, који ће се узети у обзир у процесу увоза.
Сваки ред се састоји од четири поља.

• Поље Опис садржи кратак описни текст за идентификацију file тип.
• Тхе File поље шаблона назива се користи за избор fileс које треба увести када се подударају са вредношћу поља. Поље користи следећу синтаксу:

1. Најчешћи случај употребе може бити а file проширење. Уобичајена синтакса је .ЕКСТ, где је ЕКСТ жељени file проширење (нпр. .јава).
2. Друга уобичајена ситуација је посебна file, као макеfile. Стога је могуће тачно подударати file име. Да бисте то урадили, само унесите file име у поље (нпр. буилд.кмл).
3. У неким случајевима су жеље за мапирањем конкретније, дакле само fileс који се подударају са посебним шаблоном треба увести. Да би се испунио овај захтев, могуће је користити регуларне изразе у File поље обрасца имена.
   Описивање синтаксе регуларних израза би превазишло намеру ове помоћи. Молимо погледајте одељак регуларних израза у референтном поглављу у корисничком водичу за пуре::вариантс (нпр. .*).

• Поље типа мапирани елемент поставља мапирање између а file тип и тип елемента породице пуре::вариантс. Тип елемента породице је дескриптор за извор file да пружи додатне информације мапираном елементу у увезеном моделу. Типични избори су пс:цласс или пс:макеfile.
• Тхе Маппед file поље типа поставља пресликавање између а file тип и чисте::варијанте file тип. Тхе file укуцајте пуре::вариантс је дескриптор за извор file да пружи додатне информације мапираном елементу у увезеном моделу. Типични избори су импл за имплементације или деф за дефиницију files.

Слика 3. Страница чаробњака за увоз за дефинисање појединачне конфигурацијеНово file типови се могу додати коришћењем дугмета Додај мапирање. Сва поља су попуњена са недефинисаном вредношћу и мора их попунити корисник. Да бисте изменили вредност у пољу, само кликните на поље мишем. Вредност се може мењати и може се променити. Није могуће променити подразумевану вредност file обрасци назива табеле. Да би прилагођавање било флексибилно, могуће је поништити избор а file откуцајте поништавањем избора реда. Опозван избор file обрасци имена остају у конфигурацији, али их увозник неће користити. Кориснички дефинисано file типови се могу поново уклонити коришћењем дугмета Уклони мапирање.
Подразумевано друго files file образац имена је доступан у табели, али је поништен. Обично се не жели увести све fileс, али то се може лако променити избором одговарајућег реда.
Постоје три опште опције увоза за прилагођавање понашања увозника.

• Не увозите директоријуме без подударања fileс (нпр. ЦВС именици).
  Ако увозник пронађе директоријум у коме нема подударања file налази се у њему и где ниједан поддиректоријум нема подударање file, директоријум неће бити увезен. Ово је често корисно ако пројектима управљају системи за управљање верзијама као што је ЦВС. За ЦВС, сваки релевантни директоријум садржи ЦВС-директоријум када није релевантан fileс се чувају. Ако је ова опција изабрана и ЦВС-fileс се не подударају ни са једним file типа дефинисаног изнад, директоријум се неће увозити као компонента у породични модел.
• Сортирај fileс и именике.
  Омогућите ову опцију за сортирање fileс и именике сваки по абецедном реду.
• Руковање путањом увоза.
  За даљу синхронизацију увозник треба да сачува оригиналну путању свих увезених елемената у модел.
  У многим случајевима породични модели се деле са другим корисницима. Структура директоријума може бити различита за сваког корисника. Да би подржао најчешће сценарије коришћења, увозник може да ради у различитим режимима:

Апсолутно	Апсолутна путања до увезеног елемента биће сачувана у моделу. За каснију синхронизацију и током трансформације fileморају бити постављени на потпуно истој локацији као приликом првог увоза.
У односу на радни простор	Путања се чувају у односу на фасциклу радног простора. За синхронизацију fileс мора бити део радног простора Ецлипсе. Трансформација мора да користи радни простор Ецлипсе као улазни директоријум.
У односу на пројекат	Путања се чувају у односу на пројекат. За синхронизацију fileсу део пројекта унутар Ецлипсе-а. Трансформација мора да користи фасциклу пројекта као улазни директоријум.
У односу на пут	Путања се чувају у односу на дату путању. За синхронизацију fileморају бити постављени на потпуно истој локацији. Улазни директоријум трансформације је исти као релативна путања током увоза.

Сва подешавања овог дијалога се стално чувају. Лична прилагођавања се не смеју понављати сваки пут када се увоз покрене. Ово чини ток рада увоза лаким и брзим.
2.3. Ажурирање модела из стабла директоријума
Притисните дугме Синхронизуј да бисте синхронизовали увезени модел са његовом путањом директоријума. Основна путања пројекта је ускладиштена у моделу тако да ће се синхронизовати са истим директоријумом као и раније. Да бисте омогућили дугме Синхронизуј, отворите модел и изаберите било који елемент. Након притиска на дугме Синхронизуј отвара се уређивач за упоређивање где се супротстављају тренутни модел породице и модел тренутне структуре директоријума (погледајте слику 4, „Ажурирање модела из стабла директоријума у ​​уређивачу за упоређивање“).
Слика 4. Ажурирање модела из стабла директоријума у ​​уређивачу поређења   Уређивач за поређење се користи у пуре::вариантс за упоређивање верзија модела, али се у овом случају користи за упоређивање физичке структуре директоријума (приказано у доњем десном углу) са тренутним пуре::вариантс моделом (доња лева страна). Све промене су наведене као засебне ставке у горњем делу уређивача, поређане према захваћеним елементима.
Одабиром ставке на овој листи истиче се одговарајућа промена у оба модела. У бивampЛе, додани елемент је означен кутијом на десној страни и повезан са својом изводљивом позицијом у моделу на левој страни. Трака са алаткама за спајање између горњег и доњег прозора уређивача пружа алатке за копирање појединачних или чак свих (неконфликтних) промена као целине из модела стабла директоријума у ​​модел карактеристика.
Напомена
Синхронизација се врши са последњим коришћеним подешавањима увозника. Ово омогућава ажурирање модела са другим подешавањима која су направљена током увоза.

Коришћење индекса релација

Конектор за управљање изворним кодом побољшава односе View са информацијама о везама између елемената модела пуре::вариантс и изворног кода. Релације се додају за карактеристике које се користе у условима елемената пс:цондкмл и пс:цондтект.
За пс:флаг и пс:флагfile елементи локације претпроцесорских константи у Ц/Ц++ извору fileприказани су с. Поред тога, локације одговарајућих константи претпроцесора су приказане за изабрану карактеристику коришћењем мапирања између јединствених имена обележја и константи претпроцесора.
3.1. Додавање индекса релација пројекту
Индексер релација се може активирати на посебној страници својстава пројекта. Изаберите пројекат и изаберите ставку Својства у контекстуалном менију. У предстојећем дијалогу изаберите страницу Индекс релација.
Слика 5. Страница својстава пројекта за индекс релација

Индекс релација се активира за пројекат избором опције Енабле Релатион Индекер (1). Након што омогућите индексер, постоје још неке опције за дефинисање понашања специфичног за пројекат. Индексирање пуре::вариантс услова и Ц/Ц++ константи препроцесора може се активирати одвојено (2). Листа са file обрасци имена (3) се користи за избор fileс за индексирање. Само fileскенирају се ови који одговарају једном од шаблона. Додајте „*“ као образац да бисте све скенирали fileс пројекта.
Након активирања индексера за пројекат, пројекту се додаје буилдер. Скенирања овог градитеља су промењена fileс за нове релације према елементима модела пуре::вариантс аутоматски.
3.2. Односи према изворном коду
Са активираним индексатором релација Релације View садржи додатне уносе. Ови уноси показују име file и линијски број варијантне тачке. Савет алата показује одговарајући одељак file. Двоструким кликом на унос file биће отворен у уреднику.
пуре::вариантс Услови
Услов пуре::вариантс се може користити за укључивање или искључивање делова а file у зависности од избора карактеристика. Индекс услова скенира таква правила и издваја референтне карактеристике. Ако је таква карактеристика изабрана у уређивачу, Релатионс View показаће све fileс и линије где се налази услов са изабраним обележјем (погледајте слику 6, „Представљање услова у релацијама View”).
Слика 6. Представљање услова у релацијама ViewДа бисте добили детаљно објашњење како да дефинишете услове, погледајте одељак пс:цондтект поглавља 9.5.7 Пуре::вариантс Корисничког водича (Референце–>Унапред дефинисани типови изворних елемената–>пс:цондтект).
Константе препроцесора Ц/Ц++
Индекс Ц/Ц++ препроцесора скенира fileс за константе које се користе у правилима препроцесора (нпр. #ифдеф, #ифндеф, …).
Ако је пс:флаг или пс:флагfile елемент је изабран Релације View приказује употребу дефинисане константе претпроцесора.
Тхе Релатионс View такође приказује константе претпроцесора повезане са карактеристикама коришћењем образаца мапирања. За ово се обрасци проширују подацима о изабраној особини. Добијени симболи се користе за тражење одговарајућих константи претпроцесора. Слика 7, „Представљање Ц/Ц++ константе претпроцесора у релацијама View” показује бившиampле са узорком слава {Име}. Образац је проширен јединственим именом функције на фамеНативе. У индексираном коду постоји 76 локација на којима се користи константа препроцесора фамеНативе.
Ове локације су приказане у Релацијама View. Обрасци се могу дефинисати у преференцама (погледајте одељак 3.3, „Преференце“).
Слика 7. Представљање Ц/Ц++ константе претпроцесора у релацијама View

3.3. Тхе Преференцес
Да бисте променили подразумевано понашање индексера, отворите Ецлипсе преференце и изаберите страницу Релатион Индекер у категорији Управљање варијантама. Страница приказује две листе.
Слика 8. Страница за подешавање индекса релацијаГорња листа садржи подразумевано file обрасци за индексер (1). Ова листа је почетна поставка шаблона за новоомогућене пројекте.
Доња листа садржи мапирање између карактеристика и константи претпроцесора (2). Ово мапирање се користи за све пројекте. Табела 1, „Подржане замене мапирања“ приказује све могуће замене.
Табела 1. Подржане замене мапирања

Вилдцард	Опис	Exampле: ФеатуреА
Име	јединствени назив изабране карактеристике	ФЛАГ_{Назив} – ФЛАГ_ФеатуреА
НАМЕ	велика слова Јединствени назив изабране карактеристике	ФЛАГ_{НАМЕ} – ФЛАГ_ФЕАТУРЕА
име	мала слова Јединствени назив изабране карактеристике	флаг_{наме} – ознака_феатуреа

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

пуре-системс 2024 конектор за софтвер за управљање изворним кодом [пдф] Упутство за употребу 2024, 2024 конектор за софтвер за управљање изворним кодом, конектор за софтвер за управљање изворним кодом, софтвер за управљање изворним кодом, софтвер за управљање, софтвер

Референце

• Упутство за употребу