pure::variants – Konektor pro
Manuál pro správu zdrojového kódu
Parametric Technology GmbH
Verze 6.0.7.685 pro čisté::varianty 6.0
Copyright © 2003-2024 Parametric Technology GmbH
2024

Zavedení

pure::variants Connector pro správu zdrojového kódu (Connector) umožňuje vývojářům spravovat variabilitu zdrojového kódu pomocí pure::variants. Správa zdrojového kódu pure::variants poskytuje flexibilní příležitost k synchronizaci adresářových struktur a zdrojového kódu files modely pure::variants. Díky tomu lze správu variant prakticky aplikovat i na komplexní softwarové projekty. Navíc spojení mezi funkcemi pure::variants a zdrojovým kódem lze snáze spravovat pomocí tvůrce a jsou vysoce přístupná prostřednictvím správy zdrojového kódu.
1.1. Softwarové požadavky
Pure::variants Connector pro správu zdrojového kódu je rozšíření pro pure::variants a je dostupné na všech podporovaných platformách.
1.2. Instalace
Podrobné informace o instalaci konektoru naleznete v části Konektory pure::variants v Průvodci nastavením pure::variants (menu Nápověda -> Obsah nápovědy a poté Průvodce nastavením pure::variants -> Konektory pure::variants).
1.3. O tomto návodu
Od čtenáře se očekává, že bude mít základní znalosti a zkušenosti s čistými::variantami. Před přečtením této příručky si prosím přečtěte její úvodní materiál. Manuál je k dispozici v online nápovědě a také ve formátu PDF pro tisk zde.

Pomocí konektoru

2.1. Počínaje čistě::varianty
V závislosti na použité metodě instalace buď spusťte pure::variants-enabled Eclipse, nebo pod Windows vyberte položku pure::variants z programové nabídky.
Pokud perspektiva Variant Management ještě není aktivována, udělejte to tak, že ji vyberete z nabídky Otevřít perspektivu->Jiné… v nabídce Okno.
2.2. Importujte adresářový strom do modelu rodiny
Před importem stromu adresářů do modelu rodiny je třeba vytvořit projekt variant. Také je vhodné mít prvky definované již v modelu prvků. Nápovědu ohledně těchto kroků naleznete v dokumentaci pure::variants.
Vlastní import se spustí výběrem akce Import… buď v kontextovém menu Projekty view nebo pomocí nabídky Import… v File menu. Vyberte Modely variant nebo Projekty z kategorie Správa variant a stiskněte Další. Na následující stránce vyberte Importovat model rodiny ze zdrojových složek a znovu stiskněte Další.
Vyberte typ zdrojového kódu, který chcete importovat
Zobrazí se průvodce importem (viz Obrázek 1, „Stránka průvodce importem pro výběr typu zdrojového kódu, který lze importovat“). Vyberte typ projektu, který chcete importovat, a stiskněte Další. Každý typ obsahuje předdefinovanou sadu file typy k importu do modelu.
Obrázek 1. Stránka průvodce importem pro výběr typu zdrojového kódu, který lze importovatVyberte Zdroj a Cíl
Na další stránce průvodce (Obrázek 2, „Stránka průvodce importem pro výběr zdroje a cíle importu“) musí být specifikován zdrojový adresář a cílový model.
Stisknutím tlačítka Procházet… vyberte adresář, ve kterém existuje zdrojový kód, který má být importován. Ve výchozím nastavení je vybrán aktuální pracovní prostor, protože to může být užitečný bod pro zahájení navigace.
Níže můžete zadat vzor pro zahrnutí a vyloučení. Tyto vzory musí být regulární výrazy Java. Každá vstupní cesta vzhledem ke zdrojové kořenové složce je kontrolována pomocí těchto vzorů. Pokud se vzor zahrnutí shoduje, složka se importuje, pokud se vzor vyloučení neshoduje. To znamená, že vzor pro začlenění předem vybírá složky k importu, vzor vyloučení tento předvýběr omezuje.
Po výběru adresáře zdrojového kódu je nutné definovat cílový model. Vyberte proto variantní projekt nebo složku, kam má být model uložen, a zadejte název modelu. The file název se automaticky rozšíří o příponu .ccfm, pokud není v tomto dialogu uvedena. Ve výchozím nastavení bude nastaven na stejný název jako samotný název modelu. Toto je doporučené nastavení.
Po zadání vhodné zdrojové složky a požadovaného názvu modelu lze dialog ukončit stisknutím tlačítka Dokončit. Pokud stisknete tlačítko Další, zobrazí se další stránka, kde lze provést další nastavení.
Obrázek 2. Stránka průvodce importem pro výběr zdroje a cíle importuZměnit předvolby importu
Na poslední stránce průvodce (Obrázek 3, „Stránka průvodce importem pro definování individuální konfigurace“) existují předvolby, kterými lze přizpůsobit chování importu pro importovaný softwarový projekt.
Dialogová stránka zobrazuje tabulku, kde je file jsou definovány typy, které budou brány v úvahu při importu.
Každý řádek se skládá ze čtyř polí.

• Pole Popis obsahuje krátký popisný text k identifikaci file typ.
• The File pole vzor jména se používá k výběru files, které se mají importovat, když se shodují s hodnotou polí. Pole používá následující syntaxi:

1. Nejčastějším případem použití může být a file rozšíření. Obvyklá syntaxe je .EXT, kde EXT je požadovaný file rozšíření (např. .java).
2. Další běžná situace je speciální file, jako značkafile. Proto je možné přesně sladit file jméno. Chcete-li to provést, stačí zadat file jméno do pole (např. build.xml).
3. V některých případech jsou přání mapování konkrétnější, takže pouze files, které odpovídají speciálnímu vzoru, by měly být importovány. Pro splnění tohoto požadavku je možné použít regulární výrazy v File pole vzoru jména.
   Popis syntaxe regulárních výrazů by překročil záměr této nápovědy. Prostudujte si prosím sekci regulárních výrazů v referenční kapitole v čisté::variants uživatelské příručce (např. .*).

• Pole Mapovaný typ prvku nastavuje mapování mezi a file typ a typ prvku rodiny pure::variants. Typ prvku rodiny je deskriptorem zdroje file k poskytnutí dalších informací mapovanému prvku v importovaném modelu. Typické volby jsou ps:class nebo ps:makefile.
• Mapované file pole typu nastavuje mapování mezi a file typ a čisté::varianty file typ. The file type in pure::variants je deskriptor pro zdroj file k poskytnutí dalších informací mapovanému prvku v importovaném modelu. Typické výběry jsou impl pro implementace nebo def pro definici files.

Obrázek 3. Stránka průvodce importem pro definování individuální konfiguraceNový file typy lze přidat pomocí tlačítka Přidat mapování. Všechna pole jsou vyplněna hodnotou undefined a musí být vyplněna uživatelem. Chcete-li upravit hodnotu v poli, stačí do pole kliknout myší. Hodnotu lze upravit a lze ji změnit. Výchozí nastavení není možné změnit file jmenné vzory tabulky. Aby bylo přizpůsobení flexibilní, je možné zrušit výběr a file zadejte zrušením výběru řádku. Výběr zrušen file vzory jmen zůstanou v konfiguraci, ale nebudou použity importérem. Definováno uživatelem file typy lze znovu odstranit pomocí tlačítka Odebrat mapování.
Ve výchozím nastavení Jiné files file vzor názvu je v tabulce k dispozici, ale není vybrán. Obvykle se nechce importovat všechny files, ale to lze snadno změnit výběrem příslušného řádku.
Existují tři obecné možnosti importu pro přizpůsobení chování importéru.

• Neimportujte adresáře bez shody files (např. adresáře CVS).
  Pokud importér najde adresář, ve kterém není žádná shoda file je v něm a kde žádný podadresář nemá odpovídající file, adresář nebude importován. To je často užitečné, pokud jsou projekty spravovány systémy správy verzí, jako je CVS. V případě CVS každý relevantní adresář obsahuje adresář CVS, pokud to není relevantní files jsou uloženy. Pokud je vybrána tato možnost a CVS-files neodpovídají žádnému file typu definovaného výše, nebude adresář importován jako komponenta do modelu rodiny.
• Seřadit files a adresáře.
  Chcete-li třídit, povolte tuto možnost files a adresáře každý v abecedním pořadí.
• Zpracování cesty importu.
  Pro další synchronizaci potřebuje importér uložit původní cestu všech importovaných prvků do modelu.
  V mnoha případech jsou rodinné modely sdíleny s ostatními uživateli. Struktura adresáře se může pro každého uživatele lišit. Pro podporu nejběžnějších scénářů použití může importér pracovat v různých režimech:

Absolutní	Absolutní cesta k importovanému prvku bude uložena do modelu. Pro pozdější synchronizaci a během transformace files musí být umístěny na přesně stejné místo jako při prvním importu.
Relativní k pracovnímu prostoru	Cesty jsou uloženy relativně ke složce pracovního prostoru. Pro synchronizaci files musí být součástí pracovního prostoru Eclipse. Transformace musí jako vstupní adresář použít pracovní prostor Eclipse.
Relativní k projektu	Cesty jsou uloženy relativně k projektu. Pro synchronizaci files jsou součástí projektu uvnitř Eclipse. Transformace musí jako vstupní adresář použít složku projektu.
Relativní k Path	Cesty jsou uloženy relativně k dané cestě. Pro synchronizaci files musí být umístěny na přesně stejném místě. Vstupní adresář transformace je stejný jako relativní cesta během importu.

Všechny předvolby tohoto dialogu jsou trvale uloženy. Osobní přizpůsobení se nesmí opakovat při každém spuštění importu. Díky tomu je pracovní postup importu snadný a rychlý.
2.3. Aktualizace modelů z adresářového stromu
Stiskněte tlačítko Synchronizovat k synchronizaci importovaného modelu s jeho cestou k adresáři. Kořenová cesta projektu je uložena v modelu, takže se bude synchronizovat do stejného adresáře jako předtím. Chcete-li aktivovat tlačítko Synchronizovat, otevřete model a vyberte libovolný prvek. Po stisknutí tlačítka Synchronizovat se otevře Editor porovnání, kde je aktuální model rodiny a model aktuální adresářové struktury v protikladu (viz Obrázek 4, „Aktualizace modelu ze stromu adresářů v Editoru porovnání“).
Obrázek 4. Aktualizace modelu ze stromu adresářů v Editoru porovnání   Porovnávací editor se používá ve všech pure::variants k porovnání verzí modelu, ale v tomto případě se používá k porovnání fyzické adresářové struktury (zobrazené v pravé dolní části) s aktuálním modelem pure::variants (levá dolní strana). Všechny změny jsou uvedeny jako samostatné položky v horní části editoru, seřazené podle dotčených prvků.
Výběrem položky v tomto seznamu zvýrazníte příslušnou změnu u obou modelů. V example, přidaný prvek je označen rámečkem na pravé straně a spojen s jeho proveditelnou pozicí v modelu na levé straně. Panel nástrojů Sloučit mezi horními a dolními okny editoru poskytuje nástroje pro kopírování jednotlivých nebo dokonce všech (nekonfliktních) změn jako celku z modelu adresářového stromu do modelu funkcí.
Poznámka
Synchronizace se provádí s naposledy použitým nastavením importéru. To umožňuje aktualizovat model s dalšími nastaveními, která byla provedena během importu.

Použití Relation Indexer

Konektor pro správu zdrojového kódu zlepšuje vztahy View s informacemi o spojeních mezi prvky modelu pure::variants a zdrojovým kódem. Vztahy jsou přidány pro funkce, které se používají v podmínkách prvků ps:condxml a ps:condtext.
Pro ps:flag a ps:flagfile prvky umístění konstant preprocesoru ve zdroji C/C++ filejsou zobrazeny s. Kromě toho jsou pro vybraný prvek zobrazena umístění odpovídajících konstant preprocesoru pomocí mapování mezi jedinečnými názvy prvků a konstantami preprocesoru.
3.1. Přidání Relation Indexer do projektu
Indexátor vztahů lze aktivovat na speciální stránce vlastností projektu. Vyberte projekt a v kontextovém menu zvolte položku Vlastnosti. V nadcházejícím dialogu vyberte stránku Relation Indexer.
Obrázek 5. Stránka vlastností projektu pro Relation Indexer

Indexátor vztahů se pro projekt aktivuje výběrem možnosti Povolit indexování vztahů (1). Po povolení indexátoru existují další možnosti, jak definovat chování specifické pro projekt. Indexování čistých::variantových podmínek a konstant preprocesoru C/C++ lze aktivovat samostatně (2). Seznam s file vzory jmen (3) se používají k výběru files pro indexování. Pouze files, které odpovídají jednomu ze vzorů, jsou naskenovány. Přidejte „*“ jako vzor pro skenování všech files projektu.
Po aktivaci indexeru pro projekt je do projektu přidán tvůrce. Skenování tohoto stavitele se změnilo files pro nové vztahy k prvkům modelu pure::variants automaticky.
3.2. Vztahy ke zdrojovému kódu
S aktivovaným indexátorem vztahů Relations View obsahuje další položky. Tyto položky zobrazují název file a číslo řádku bodu varianty. Tip nástroje zobrazuje příslušnou část file. Dvojitým kliknutím na položku file se otevře v editoru.
pure::varianty Podmínky
Podmínku pure::variants lze použít k zahrnutí nebo vyloučení částí a file v závislosti na výběru funkce. Condition Indexer vyhledá taková pravidla a extrahuje odkazované funkce. Pokud je taková funkce vybrána v editoru, Relations View ukáže vše files a řádky, kde se nachází podmínka s vybraným prvkem (viz Obrázek 6, „Zobrazení podmínky ve vztazích View“).
Obrázek 6. Reprezentace podmínky ve vztazích ViewPodrobné vysvětlení, jak definovat podmínky, naleznete v části ps:condtext v kapitole 9.5.7 uživatelské příručky pure::variants (Reference–>Předdefinované typy zdrojových prvků–>ps:condtext).
Konstanty preprocesoru C/C++
C/C++ Preprocessor Indexer skenuje files pro konstanty používané v pravidlech preprocesoru (např. #ifdef, #ifndef, …).
Pokud ps:flag nebo ps:flagfile je vybrán prvek Relations View ukazuje použití definované konstanty preprocesoru.
Vztahy View také zobrazuje konstanty preprocesoru spojené s funkcemi pomocí vzorů mapování. Za tímto účelem jsou vzory rozšířeny o data vybraného prvku. Výsledné symboly se používají k hledání odpovídajících konstant preprocesoru. Obrázek 7, „Reprezentace konstanty preprocesoru C/C++ ve vztazích View“ ukazuje example se vzorem sláva{Jméno}. Vzor je rozšířen o jedinečný název objektu na fameNative. V indexovaném kódu je 76 míst, kde se používá konstanta fameNative preprocesoru.
Tato umístění jsou uvedena ve vztazích View. Vzory lze definovat v předvolbách (viz 3.3 – „Předvolby“).
Obrázek 7. Reprezentace konstanty preprocesoru C/C++ ve vazbách View

3.3. Předvolby
Chcete-li změnit výchozí chování indexátoru, otevřete předvolby Eclipse a vyberte stránku Relation Indexer v kategorii Variant Management. Stránka zobrazuje dva seznamy.
Obrázek 8. Stránka Předvolby indexování vztahůHorní seznam obsahuje výchozí file vzory pro indexátor (1). Tento seznam je výchozím nastavením vzoru pro nově povolené projekty.
Spodní seznam obsahuje mapování mezi vlastnostmi a konstantami preprocesoru (2). Toto mapování se používá pro všechny projekty. Tabulka 1 „Podporované náhrady mapování“ uvádí všechny možné náhrady.
Tabulka 1. Podporované náhrady mapování

Zástupný znak	Popis	Example: Funkce A
Jméno	jedinečný název vybraného prvku	FLAG_{Name} – FLAG_FeatureA
JMÉNO	velká písmena Jedinečný název vybraného prvku	FLAG_{NAME} – FLAG_FEATUREA
jméno	malá písmena Jedinečný název vybraného prvku	flag_{name} – flag_featurea

Dokumenty / zdroje

pure-systems 2024 Connector pro software pro správu zdrojového kódu [pdfUživatelská příručka 2024, 2024 konektor pro software pro správu zdrojového kódu, konektor pro software pro správu zdrojového kódu, software pro správu zdrojového kódu, software pro správu, software

Reference

• Uživatelská příručka