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, каб атрымаць падрабязную інфармацыю аб тым, як усталяваць злучальнік (меню Help -> Help Contents, а затым pure::variants Setup Guide -> pure::variants Connectors).
1.3. Пра гэта кіраўніцтва
Чакаецца, што чытач будзе мець базавыя веды і досвед працы з pure::variants. Калі ласка, азнаёмцеся з уводным матэрыялам перад чытаннем гэтага кіраўніцтва. Кіраўніцтва даступна ў онлайн-даведцы, а таксама ў фармаце PDF для друку тут.

Выкарыстанне Connector

2.1. Пачатак pure::variants
У залежнасці ад выкарыстоўванага метаду ўсталявання альбо запусціце Eclipse з падтрымкай pure::variants, альбо ў Windows выберыце пункт pure::variants у меню праграмы.
Калі ракурс кіравання варыянтамі яшчэ не актываваны, зрабіце гэта, выбраўшы яго ў меню «Адкрыць ракурс»->Іншае… у меню «Акно».
2.2. Імпартаваць дрэва каталогаў у сямейную мадэль
Перш чым імпартаваць дрэва каталогаў у сямейную мадэль, трэба стварыць праект варыянтаў. Таксама пажадана ўжо мець функцыі, вызначаныя ў мадэлі функцый. Калі ласка, звярніцеся да дакументацыі pure::variants, каб атрымаць даведку аб гэтых кроках.
Фактычны імпарт запускаецца выбарам дзеяння Імпартаваць… у кантэкстным меню Праектаў view або з дапамогай меню «Імпарт…» у File меню. Выберыце Варыянтныя мадэлі або Праекты з катэгорыі Кіраванне варыянтамі і націсніце Далей. На наступнай старонцы абярыце "Імпартаваць мадэль сям'і з зыходных тэчак" і зноў націсніце "Далей".
Выберыце тып зыходнага кода для імпарту
З'явіцца майстар імпарту (гл. малюнак 1, «Старонка майстра імпарту для выбару тыпу зыходнага кода, які можна імпартаваць»). Выберыце тып праекта для імпарту і націсніце "Далей". Кожны тып змяшчае загадзя вызначаны набор file тыпы для імпарту ў мадэль.
Малюнак 1. Старонка майстра імпарту для выбару тыпу зыходнага кода, які можна імпартавацьВыберыце Крыніца і мэта
На наступнай старонцы майстра (Малюнак 2, «Старонка майстра імпарту для выбару крыніцы і мэты для імпарту») павінны быць указаны зыходны каталог і мэтавая мадэль.
Націсніце кнопку «Агляд…», каб выбраць каталог, дзе знаходзіцца зыходны код, які трэба імпартаваць. Па змаўчанні выбіраецца бягучая працоўная вобласць, таму што гэта можа быць карысным пунктам для пачатку навігацыі.
Ніжэй вы можаце задаць шаблон уключэння і выключэння. Гэтыя шаблоны павінны быць рэгулярнымі выразамі Java. Кожны ўваходны шлях адносна зыходнай каранёвай папкі правяраецца гэтым шаблонам. Калі шаблон уключэння супадае, папка імпартуецца, калі шаблон выключэння не супадае. Гэта азначае, што шаблон уключэння папярэдне выбірае тэчкі для імпарту, шаблон выключэння абмяжоўвае гэты папярэдні выбар.
Пасля выбару каталога зыходнага кода неабходна вызначыць мэтавую мадэль. Таму выберыце варыянт праекта або тэчку, у якой будзе захоўвацца мадэль, і ўвядзіце назву мадэлі. The file імя аўтаматычна пашыраецца з пашырэннем .ccfm, калі яно не пададзена ў гэтым дыялогавым акне. Па змаўчанні яна будзе мець тое ж імя, што і назва самой мадэлі. Гэта рэкамендаваны параметр.
After an expedient source folder and the desired model name are specified, the dialog might be finished by pressing Finish. Калі націскаецца кнопка, надыходзіць далейшая старонка, дзе можна зрабіць дадатковыя налады.
Малюнак 2. Старонка майстра імпарту для выбару крыніцы і мэты для імпартуЗмяніць параметры імпарту
На апошняй старонцы майстра (Малюнак 3, «Старонка майстра імпарту для вызначэння індывідуальнай канфігурацыі») ёсць перавагі, якія можна зрабіць, каб наладзіць паводзіны імпарту для імпартаванага праекта праграмнага забеспячэння.
Дыялогавая старонка паказвае табліцу, дзе file вызначаны тыпы, якія будуць улічвацца ў працэсе імпарту.
Кожны радок складаецца з чатырох палёў.

• Поле "Апісанне" змяшчае кароткі апісальны тэкст для ідэнтыфікацыі file тыпу.
• The File поле шаблону імя выкарыстоўваецца для выбару fileімпартуюцца, калі яны супадаюць са значэннем палёў. У полі выкарыстоўваецца наступны сінтаксіс:

1. Найбольш распаўсюджаным варыянтам выкарыстання можа быць a file пашырэнне. Звычайны сінтаксіс - .EXT, дзе EXT - патрэбны file пашырэнне (напрыклад, .java).
2. Яшчэ адна распаўсюджаная сітуацыя - асаблівая file, як зрабіцьfile. Такім чынам, можна супадаць па дакладным file імя. Для гэтага проста ўвядзіце file імя ў поле (напрыклад, build.xml).
3. У некаторых выпадках жаданні адлюстравання больш канкрэтныя, таму толькі fileякія адпавядаюць спецыяльнаму шаблону, трэба імпартаваць. Каб адпавядаць гэтаму патрабаванню, можна выкарыстоўваць рэгулярныя выразы ў File поле шаблону імя.
   Апісанне сінтаксісу рэгулярных выразаў будзе перавышаць намер гэтай дапамогі. Калі ласка, азнаёмцеся з раздзелам рэгулярных выразаў даведачнай главы ў кіраўніцтве карыстальніка pure::variants (напрыклад, .*).

• Поле Mapped element type задае супастаўленне паміж 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 тыпы могуць быць дададзены з дапамогай кнопкі Add Mapping. Усе палі запаўняюцца значэннем undefined і павінны быць запоўнены карыстальнікам. Каб змяніць значэнне ў полі, проста пстрыкніце поле мышкай. Значэнне становіцца даступным для рэдагавання і можа быць зменена. Немагчыма змяніць па змаўчанні file назва шаблонаў табл. Каб зрабіць настройку гнуткай, можна зняць выбар з a file увядзіце, адмяніўшы выбар радка. Вылучэнне знята file шаблоны імёнаў застаюцца ў канфігурацыі, але не будуць выкарыстоўвацца імпарцёрам. Вызначана карыстальнікам file тыпы можна зноў выдаліць з дапамогай кнопкі "Выдаліць адлюстраванне".
Па змаўчанні іншы files file узор імя даступны ў табліцы, але выбар зняты. Як правіла, не хочацца імпартаваць усё files, але гэта можна лёгка змяніць, выбраўшы адпаведны радок.
Ёсць тры агульныя варыянты імпарту, каб наладзіць паводзіны імпарцёра.

• Не імпартуйце каталогі без супастаўлення files (напрыклад, каталогі CVS).
  Калі імпарцёр знаходзіць каталог, у якім няма супадзенняў file знаходзіцца ў ім і дзе ні ў адным падкаталогу няма супадзенняў file, каталог не будзе імпартаваны. Гэта часта карысна, калі праекты кіруюцца сістэмамі кіравання версіямі, такімі як CVS. Для CVS кожны рэлевантны каталог утрымлівае CVS-каталог, дзе гэта не мае значэння files захоўваюцца. Калі абраны гэты параметр і CVS-files не супадаюць ні з адным file тыпу, вызначанага вышэй, каталог не будзе імпартаваны як кампанент у сямейную мадэль.
• Сартаваць files і каталогі.
  Уключыце гэты параметр для сартавання files і каталогі кожны ў алфавітным парадку.
• Апрацоўка шляху імпарту.
  Для далейшай сінхранізацыі імпарцёр павінен захаваць зыходны шлях усіх імпартаваных элементаў у мадэль.
  У многіх выпадках сямейныя мадэлі абагульваюцца з іншымі карыстальнікамі. Структура каталога можа адрознівацца для кожнага карыстальніка. Для падтрымкі найбольш распаўсюджаных сцэнарыяў імпарцёр можа працаваць у розных рэжымах:

Абсалютны	Абсалютны шлях да імпартаванага элемента будзе захаваны ў мадэлі. Для наступнай сінхранізацыі і падчас трансфармацыі files павінны быць размешчаны сапраўды ў тым жа месцы, што і падчас першага імпарту.
Адносна Workspace	Шляхі захоўваюцца адносна папкі працоўнай вобласці. Для сінхранізацыі files павінен быць часткай працоўнай прасторы Eclipse. Пераўтварэнне павінна выкарыстоўваць працоўную вобласць Eclipse у якасці ўваходнага каталога.
Адносна праекта	Шляхі захоўваюцца адносна праекта. Для сінхранізацыі fileз'яўляюцца часткай праекта ўнутры Eclipse. Пераўтварэнне павінна выкарыстоўваць папку праекта ў якасці ўваходнага каталога.
Адносна шляху	Шляхі захоўваюцца адносна дадзенага шляху. Для сінхранізацыі files павінны быць размешчаны ў дакладна такім жа месцы. Уваходны каталог трансфармацыі такі ж, як і адносны шлях падчас імпарту.

Усе налады гэтага дыялогу захоўваюцца пастаянна. Асабістыя налады не павінны перарабляцца пры кожным імпартаванні. Гэта робіць працоўны працэс імпарту лёгкім і хуткім.
2.3. Абнаўленне мадэляў з дрэва каталогаў
Націсніце кнопку Сінхранізаваць каб сінхранізаваць імпартаваную мадэль з яе шляхам да каталога. Каранёвы шлях праекта захоўваецца ў мадэлі, таму ён будзе сінхранізавацца з тым жа каталогам, што і раней. Каб уключыць кнопку «Сінхранізаваць», адкрыйце мадэль і абярыце любы элемент. Пасля націску кнопкі «Сінхранізаваць» адкрываецца рэдактар ​​параўнання, дзе бягучая сямейная мадэль і мадэль бягучай структуры каталога супрацьпастаўляюцца (гл. малюнак 4, «Абнаўленне мадэлі з дрэва каталогаў у рэдактары параўнання»).
Малюнак 4. Абнаўленне мадэлі з дрэва каталогаў у рэдактары параўнання   Рэдактар ​​параўнання выкарыстоўваецца ва ўсім pure::variants для параўнання версій мадэлі, але ў дадзеным выпадку ён выкарыстоўваецца для параўнання фізічнай структуры каталога (паказана ў правым ніжнім баку) з бягучай мадэллю pure::variants (ніжні левы бок). Усе змены пералічаны як асобныя элементы ў верхняй частцы рэдактара, упарадкаваныя па закранутых элементах.
Выбар элемента ў гэтым спісе вылучае адпаведныя змены ў абедзвюх мадэлях. У эксample, дададзены элемент пазначаны полем з правага боку і звязаны з яго магчымым становішчам у мадэлі з левага боку. Панэль інструментаў «Аб'яднанне» паміж верхнім і ніжнім вокнамі рэдактара дае інструменты для капіравання асобных або нават усіх (неканфліктных) змяненняў у цэлым з мадэлі дрэва каталогаў у мадэль функцый.
Заўвага
Сінхранізацыя выконваецца з апошнімі выкарыстанымі наладамі імпарцёра. Гэта дае магчымасць абнавіць мадэль іншымі наладамі, зробленымі падчас імпарту.

Выкарыстанне індэксатара адносін

Злучальнік для кіравання зыходным кодам паляпшае адносіны View з інфармацыяй пра сувязі паміж элементамі мадэлі pure::variants і зыходным кодам. Адносіны дадаюцца для функцый, якія выкарыстоўваюцца ва ўмовах элементаў ps:condxml і ps:condtext.
Для ps:flag і ps:flagfile элементы размяшчэнне канстант прэпрацэсара ў зыходным коды C/C++ files паказаны. Акрамя таго, месцазнаходжанне адпаведных канстант прэпрацэсара паказваецца для выбранай функцыі з дапамогай супастаўлення паміж унікальнымі назвамі функцый і канстантамі прэпрацэсара.
3.1. Даданне індэксатара адносін да праекта
Індэксатар адносін можа быць актываваны на спецыяльнай старонцы ўласцівасцей праекта. Выберыце праект і ў кантэкстным меню абярыце пункт «Уласцівасці». У наступным дыялогавым акне выберыце старонку Relation Indexer.
Малюнак 5. Старонка ўласцівасцей праекта для індэксатара адносін

Індэксатар адносін актывуецца для праекта, выбраўшы опцыю Enable Relation Indexer (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. Старонка пераваг індэксатара адносінВерхні спіс змяшчае па змаўчанні file выкрайкі для паказальніка (1). Гэты спіс з'яўляецца першапачатковай наладай мадэлі для нядаўна ўключаных праектаў.
Ніжні спіс змяшчае адлюстраванне паміж функцыямі і канстантамі прэпрацэсара (2). Гэта адлюстраванне выкарыстоўваецца для ўсіх праектаў. Табліца 1 «Падтрымоўваныя замены адлюстравання» паказвае ўсе магчымыя замены.
Табліца 1. Падтрымліваюцца замены адлюстравання

Падстаноўны знак	Апісанне	Example: Характарыстыка A
Імя	Унікальнае імя абранага аб'екта	FLAG_{Назва} – FLAG_FeatureA
ІМЯ	верхні рэгістр Унікальнае імя абранага аб'екта	FLAG_{NAME} – FLAG_FEATUREA
імя	ніжні рэгістр Унікальнае імя абранага аб'екта	flag_{name} – flag_featurea

Дакументы / Рэсурсы

pure-systems 2024 Connector для праграмнага забеспячэння для кіравання зыходным кодам [pdfКіраўніцтва карыстальніка 2024, 2024 раз'ём для праграмнага забеспячэння для кіравання зыходным кодам, раз'ём для праграмнага забеспячэння для кіравання зыходным кодам, праграмнае забеспячэнне для кіравання зыходным кодам, праграмнае забеспячэнне для кіравання, праграмнае забеспячэнне

Спасылкі

• Кіраўніцтва карыстальніка