pure::varianty – Konektor pre
Manuál správy zdrojového kódu
Parametric Technology GmbH
Verzia 6.0.7.685 pre čisté::varianty 6.0
Copyright © 2003-2024 Parametric Technology GmbH
2024

Úvod

pure::variants Connector pre správu zdrojového kódu (Connector) umožňuje vývojárom spravovať variabilitu zdrojového kódu pomocou pure::variants. Správa zdrojového kódu pure::variants poskytuje flexibilnú možnosť synchronizácie adresárových štruktúr a zdrojového kódu files modelmi pure::variants. Manažment variantov sa tak dá prakticky aplikovať aj na komplexné softvérové ​​projekty. Okrem toho prepojenia medzi funkciami pure::variants a zdrojovým kódom možno jednoduchšie spravovať pomocou tvorcu a sú vysoko dostupné prostredníctvom správy zdrojového kódu.
1.1. Softvérové ​​požiadavky
Pure::variants Connector pre správu zdrojového kódu je rozšírenie pre pure::variants a je dostupné na všetkých podporovaných platformách.
1.2. Inštalácia
Podrobné informácie o inštalácii konektora nájdete v časti pure::variants Konektory v Sprievodcovi nastavením pure::variants (ponuka Pomocník -> Obsah pomocníka a potom Sprievodca nastavením pure::variants -> Konektory pure::variants).
1.3. O tomto návode
Od čitateľa sa očakáva, že bude mať základné znalosti a skúsenosti s čistými::variantami. Pred prečítaním tohto návodu si prečítajte jeho úvodný materiál. Príručka je dostupná v online pomocníkovi, ako aj vo formáte PDF na tlač tu.

Pomocou konektora

2.1. Počnúc čisto::varianty
V závislosti od použitej metódy inštalácie buď spustite Eclipse s podporou pure::variants alebo v systéme Windows vyberte položku pure::variants z ponuky programu.
Ak perspektíva Manažment variantov ešte nie je aktivovaná, urobte tak tak, že ju vyberiete z ponuky Open Perspective->Iné... v menu Window.
2.2. Importujte adresárový strom do modelu rodiny
Pred importovaním stromu adresárov do modelu rodiny je potrebné vytvoriť projekt variantov. Odporúča sa tiež mať funkcie definované už v modeli funkcií. Pomoc o týchto krokoch nájdete v dokumentácii pure::variants.
Samotný import sa spustí výberom akcie Import… buď v kontextovom menu Projekty view alebo pomocou ponuky Import… v File menu. Vyberte Modely variantov alebo Projekty z kategórie Správa variantov a stlačte Ďalej. Na nasledujúcej stránke vyberte Importovať model rodiny zo zdrojových priečinkov a znova stlačte Ďalej.
Vyberte typ zdrojového kódu, ktorý chcete importovať
Zobrazí sa sprievodca importom (pozri Obrázok 1, „Stránka sprievodcu importom na výber typu zdrojového kódu, ktorý možno importovať“). Vyberte typ projektu, ktorý chcete importovať, a stlačte Ďalej. Každý typ obsahuje preddefinovanú sadu file typy na importovanie do modelu.
Obrázok 1. Stránka sprievodcu importom na výber typu zdrojového kódu, ktorý možno importovaťVyberte Zdroj a Cieľ
Na ďalšej stránke sprievodcu (Obrázok 2, „Stránka sprievodcu importom na výber zdroja a cieľa importu“) musí byť špecifikovaný zdrojový adresár a cieľový model.
Stlačením tlačidla Prehľadávať… vyberte adresár, v ktorom existuje zdrojový kód, ktorý sa má importovať. V predvolenom nastavení je vybratý aktuálny pracovný priestor, pretože to môže byť užitočný bod na spustenie navigácie.
Nižšie môžete určiť vzor zahrnúť a vylúčiť. Tieto vzory musia byť regulárne výrazy java. Každá vstupná cesta vzhľadom na zdrojový koreňový priečinok sa kontroluje pomocou týchto vzorov. Ak sa vzor zahrnutia zhoduje, importuje sa priečinok, ak sa vzor vylúčenia nezhoduje. Znamená to, že vzor zahrnutia vopred nevyberá priečinky na importovanie, vzor vylúčenia tento predvýber obmedzuje.
Po výbere adresára zdrojového kódu je potrebné definovať cieľový model. Vyberte preto variantný projekt alebo priečinok, kde má byť model uložený a zadajte názov modelu. The file názov sa automaticky rozšíri o príponu .ccfm, ak nie je uvedená v tomto dialógovom okne. V predvolenom nastavení bude mať rovnaký názov ako samotný názov modelu. Toto je odporúčané nastavenie.
Po zadaní vhodného zdrojového priečinka a požadovaného názvu modelu možno dialóg ukončiť stlačením tlačidla Dokončiť. Ak stlačíte tlačidlo Ďalej, zobrazí sa ďalšia stránka, na ktorej je možné vykonať ďalšie nastavenia.
Obrázok 2. Stránka sprievodcu importom na výber zdroja a cieľa importuZmeňte predvoľby importu
Na poslednej strane sprievodcu (Obrázok 3, „Stránka sprievodcu importom na definovanie individuálnej konfigurácie”) existujú preferencie, ktoré možno vykonať na prispôsobenie správania importu pre importovaný softvérový projekt.
Dialógová stránka zobrazuje tabuľku, v ktorej je file sú definované typy, ktoré sa budú brať do úvahy pri importe.
Každý riadok pozostáva zo štyroch polí.

• Pole Popis obsahuje krátky popisný text na identifikáciu file typu.
• The File pole vzoru názvu sa používa na výber files, ktoré sa majú importovať, keď sa zhodujú s hodnotou polí. Pole používa nasledujúcu syntax:

1. Najčastejším prípadom použitia môže byť a file rozšírenie. Zvyčajná syntax je .EXT, kde EXT je požadované file rozšírenie (napr. .java).
2. Ďalšia bežná situácia je špeciálna file, ako značkafile. Preto je možné zhodovať sa presne file meno. Ak to chcete urobiť, stačí zadať file názov do poľa (napr. build.xml).
3. V niektorých prípadoch sú želania mapovania špecifickejšie, takže len filetie, ktoré zodpovedajú špeciálnemu vzoru, by sa mali importovať. Na splnenie tejto požiadavky je možné použiť regulárne výrazy v File pole vzoru názvu.
   Opis syntaxe regulárnych výrazov by prekročil zámer tejto pomoci. Pozrite si časť o regulárnych výrazoch v referenčnej kapitole v užívateľskej príručke pure::variants (napr. .*).

• Pole Mapovaný typ prvku nastavuje mapovanie medzi a file typ a typ prvku rodiny čistý::varianty. Typ prvku rodiny je deskriptorom zdroja file na poskytnutie ďalších informácií mapovanému prvku v importovanom modeli. Typické výbery sú ps:class alebo ps:makefile.
• Mapované file pole typu nastavuje mapovanie medzi a file typ a čisté::varianty file typu. The file type in pure::variants je deskriptor pre zdroj file na poskytnutie ďalších informácií mapovanému prvku v importovanom modeli. Typické výbery sú impl pre implementácie alebo def pre definíciu files.

Obrázok 3. Stránka sprievodcu importom na definovanie individuálnej konfigurácieNové file typy je možné pridať pomocou tlačidla Pridať mapovanie. Všetky polia sú vyplnené s hodnotou undefined a musí ich vyplniť užívateľ. Ak chcete upraviť hodnotu v poli, stačí do poľa kliknúť myšou. Hodnota sa stane upraviteľnou a možno ju zmeniť. Predvolené nastavenie nie je možné zmeniť file pomenovať vzory tabuľky. Aby bolo prispôsobenie flexibilné, je možné zrušiť výber a file napíšte zrušením výberu riadka. Výber bol zrušený file vzory názvov zostanú v konfigurácii, ale importér ich nepoužije. Definované používateľom file typy možno znova odstrániť pomocou tlačidla Odstrániť mapovanie.
Štandardne Iné files file vzor názvu je dostupný v tabuľke, ale nie je vybratý. Zvyčajne sa nechce importovať všetko files, ale to sa dá jednoducho zmeniť výberom príslušného riadku.
Existujú tri všeobecné možnosti importu na prispôsobenie správania importéra.

• Neimportujte adresáre bez zhody files (napr. adresáre CVS).
  Ak importér nájde adresár, v ktorom sa nezhoduje file je v ňom a kde žiadny podadresár nemá zhodu file, adresár sa neimportuje. Toto je často užitočné, ak sú projekty riadené systémami správy verzií, ako je CVS. V prípade CVS každý relevantný adresár obsahuje adresár CVS tam, kde to nie je relevantné files sú uložené. Ak je vybratá táto možnosť a CVS-files sa nezhodujú so žiadnym file typu definovaného vyššie, adresár sa neimportuje ako komponent do modelu rodiny.
• Triediť files a adresáre.
  Ak chcete triediť, povoľte túto možnosť files a adresáre každý v abecednom poradí.
• Spracovanie cesty importu.
  Pre ďalšiu synchronizáciu musí importér uložiť pôvodnú cestu všetkých importovaných prvkov do modelu.
  V mnohých prípadoch sú rodinné modely zdieľané s inými používateľmi. Adresárová štruktúra môže byť pre každého používateľa iná. Na podporu najbežnejších scenárov používania môže importér pracovať v rôznych režimoch:

Absolútna	Absolútna cesta k importovanému prvku sa uloží do modelu. Pre neskoršiu synchronizáciu a počas transformácie files musia byť umiestnené presne na rovnakom mieste ako pri prvom importe.
Relatívne k pracovnému priestoru	Cesty sú uložené relatívne k priečinku pracovného priestoru. Pre synchronizáciu files musí byť súčasťou pracovného priestoru Eclipse. Transformácia musí použiť pracovný priestor Eclipse ako vstupný adresár.
Relatívne k projektu	Cesty sú uložené relatívne k projektu. Pre synchronizáciu files sú súčasťou projektu v Eclipse. Transformácia musí použiť priečinok projektu ako vstupný adresár.
Vo vzťahu k Path	Cesty sú uložené relatívne k danej ceste. Pre synchronizáciu files musia byť umiestnené presne na rovnakom mieste. Vstupný adresár transformácie je rovnaký ako relatívna cesta počas importu.

Všetky predvoľby tohto dialógového okna sú trvalo uložené. Osobné prispôsobenia sa nesmú opakovať pri každom spustení importu. Vďaka tomu je pracovný postup importu jednoduchý a rýchly.
2.3. Aktualizácia modelov z adresárového stromu
Stlačte tlačidlo Synchronizovať na synchronizáciu importovaného modelu s jeho adresárovou cestou. Koreňová cesta projektu je uložená v modeli, takže sa bude synchronizovať s rovnakým adresárom ako predtým. Ak chcete aktivovať tlačidlo Synchronizovať, otvorte model a vyberte ľubovoľný prvok. Po stlačení tlačidla Synchronizovať sa otvorí editor porovnania, v ktorom je aktuálny model rodiny a model aktuálnej adresárovej štruktúry v protiklade (pozri obrázok 4, „Aktualizácia modelu zo stromu adresárov v editore porovnania“).
Obrázok 4. Aktualizácia modelu z Directory Tree v Compare Editore   Editor porovnania sa používa vo všetkých čistých::variantoch na porovnanie verzií modelu, ale v tomto prípade sa používa na porovnanie fyzickej adresárovej štruktúry (zobrazenej v pravej dolnej časti) s aktuálnym modelom pure::variants (ľavá dolná strana). Všetky zmeny sú uvedené ako samostatné položky v hornej časti editora, zoradené podľa dotknutých prvkov.
Výberom položky v tomto zozname sa zvýrazní príslušná zmena v oboch modeloch. V example, pridaný prvok je označený rámčekom na pravej strane a spojený s jeho realizovateľnou pozíciou v modeli na ľavej strane. Panel nástrojov Zlúčiť medzi hornými a dolnými oknami editora poskytuje nástroje na kopírovanie jednotlivých alebo dokonca všetkých (nekonfliktných) zmien ako celku z modelu stromového adresára do modelu funkcií.
Poznámka
Synchronizácia sa vykonáva s naposledy použitými nastaveniami importéra. To umožňuje aktualizovať model s ďalšími nastaveniami, ktoré boli vykonané počas importu.

Použitie Relation Indexer

Konektor pre správu zdrojového kódu zlepšuje vzťahy View s informáciami o prepojeniach medzi prvkami modelu pure::variants a zdrojovým kódom. Vzťahy sú pridané pre funkcie, ktoré sa používajú v podmienkach prvkov ps:condxml a ps:condtext.
Pre ps:flag a ps:flagfile prvky umiestnenie konštánt preprocesora v zdroji C/C++ filesú zobrazené s. Okrem toho sa pre vybranú vlastnosť zobrazujú umiestnenia zhodných konštánt preprocesora pomocou mapovania medzi jedinečnými názvami funkcií a konštantami preprocesora.
3.1. Pridanie indexovača vzťahov do projektu
Indexer vzťahov je možné aktivovať na špeciálnej stránke vlastností projektu. Vyberte projekt a v kontextovej ponuke vyberte položku Vlastnosti. V nasledujúcom dialógovom okne vyberte stránku Relation Indexer.
Obrázok 5. Stránka vlastností projektu pre indexovač vzťahov

Indexer vzťahov sa pre projekt aktivuje výberom možnosti Povoliť indexovanie vzťahov (1). Po povolení indexátora existuje niekoľko ďalších možností na definovanie správania špecifického pre projekt. Indexovanie čistých::variantových podmienok a C/C++ predprocesorových konštánt možno aktivovať samostatne (2). Zoznam s file vzory mien (3) sa používajú na výber files na indexovanie. Iba filenaskenujú sa tie, ktoré sa zhodujú s jedným zo vzorov. Pridajte „*“ ako vzor na skenovanie všetkých files projektu.
Po aktivácii indexátora pre projekt sa do projektu pridá tvorca. Skenovanie tohto nástroja Builder sa zmenilo files pre nové vzťahy k prvkom modelu pure::variants automaticky.
3.2. Vzťahy k zdrojovému kódu
S aktivovaným indexátorom vzťahov Relations View obsahuje ďalšie položky. Tieto položky zobrazujú názov file a číslo riadku bodu variantu. Tip nástroja zobrazuje príslušnú časť file. Dvojitým kliknutím na položku file sa otvorí v editore.
čisté::varianty Podmienky
Podmienku pure::variants možno použiť na zahrnutie alebo vylúčenie sekcií a file v závislosti od výberu funkcie. Condition Indexer vyhľadá takéto pravidlá a extrahuje odkazované funkcie. Ak je takáto funkcia vybratá v editore, Vzťahy View ukáže všetko files a čiary, kde sa nachádza podmienka s vybratým prvkom (pozri obrázok 6, „Zobrazenie podmienky vo vzťahoch View“).
Obrázok 6. Reprezentácia podmienky vo vzťahoch ViewAk chcete získať podrobné vysvetlenie, ako definovať podmienky, pozrite si časť ps:condtext v kapitole 9.5.7 používateľskej príručky pure::variants (Odkaz–>Preddefinované typy zdrojových prvkov–>ps:condtext).
Konštanty predprocesora C/C++
C/C++ Preprocessor Indexer skenuje files pre konštanty používané v pravidlách preprocesora (napr. #ifdef, #ifndef, ...).
Ak ps:flag alebo ps:flagfile je vybraný prvok Vzťahy View ukazuje využitie definovanej konštanty preprocesora.
Vzťahy View tiež zobrazuje konštanty preprocesora spojené s funkciami pomocou vzorov mapovania. Na tento účel sa vzory rozšíria o údaje vybraného prvku. Výsledné symboly sa používajú na vyhľadávanie zodpovedajúcich konštánt preprocesora. Obrázok 7, “Reprezentácia konštanty C/C++ preprocesora vo vzťahoch View“ ukazuje example so vzorom sláva{Name}. Vzor je rozšírený o jedinečný názov objektu na fameNative. V indexovanom kóde je 76 miest, kde sa používa konštanta fameNative preprocesora.
Tieto miesta sú zobrazené vo vzťahoch View. Vzory je možné definovať v preferenciách (pozri časť 3.3 – „Predvoľby“).
Obrázok 7. Reprezentácia konštanty preprocesora C/C++ vo vzťahoch View

3.3. Predvoľby
Ak chcete zmeniť predvolené správanie indexátora, otvorte predvoľby Eclipse a vyberte stránku Indexovanie vzťahov v kategórii Správa variantov. Stránka zobrazuje dva zoznamy.
Obrázok 8. Stránka Predvoľby indexovania vzťahovHorný zoznam obsahuje predvolenú hodnotu file vzory pre indexer (1). Tento zoznam je počiatočným nastavením vzoru pre novo povolené projekty.
Spodný zoznam obsahuje mapovanie medzi funkciami a konštantami preprocesora (2). Toto mapovanie sa používa pre všetky projekty. Tabuľka 1 „Podporované náhrady mapovania“ zobrazuje všetky možné náhrady.
Tabuľka 1. Podporované náhrady mapovania

Zástupný znak	Popis	Example: FeatureA
Meno	jedinečný názov vybranej funkcie	FLAG_{Name} – FLAG_FeatureA
NAME	veľkými písmenami Jedinečný názov vybranej funkcie	FLAG_{NAME} – FLAG_FEATUREA
meno	malé písmená Jedinečný názov vybranej funkcie	flag_{name} – flag_featurea

Dokumenty / zdroje

pure-systems 2024 Connector pre softvér na správu zdrojového kódu [pdfPoužívateľská príručka 2024, 2024 konektor pre softvér na správu zdrojového kódu, konektor na softvér na správu zdrojového kódu, softvér na správu zdrojového kódu, softvér na správu, softvér

Referencie

• Používateľská príručka