pure::variants – Csatlakozó a
Forráskód kezelési kézikönyv
Parametric Technology GmbH
6.0.7.685-ös verzió a pure::variants 6.0-hoz
Copyright © 2003-2024 Parametric Technology GmbH
2024

Bevezetés

A pure::variants Connector for Source Code Management (Connector) lehetővé teszi a fejlesztők számára, hogy a pure::variants segítségével kezeljék a forráskód változékonyságát. A pure::variants forráskódkezelése rugalmas lehetőséget biztosít a címtárstruktúrák és a forráskód szinkronizálására files egyszerűen a pure::variants modellekkel. Ezáltal a változatok kezelése még összetett szoftverprojekteknél is alkalmazható. Ezenkívül a pure::variants funkciók és a forráskód közötti kapcsolatok könnyebben kezelhetők a készítővel, és a Forráskód-kezelésen keresztül könnyen elérhetők.
1.1. Szoftverkövetelmények
A pure::variants Connector for Source Code Management a pure::variants kiterjesztése, és minden támogatott platformon elérhető.
1.2. Telepítés
Kérjük, olvassa el a pure::variants Csatlakozók szakaszt a pure::variants Telepítési útmutatóban a csatlakozó telepítésével kapcsolatos részletes információkért (menü Súgó -> Súgó Tartalom, majd pure::variants Telepítési útmutató -> pure::variants Csatlakozók).
1.3. Erről a kézikönyvről
Az olvasótól elvárják, hogy rendelkezzen alapvető ismeretekkel és tapasztalatokkal a tiszta::változatokról. Kérjük, olvassa el a bevezető anyagot, mielőtt elolvasná ezt a kézikönyvet. A kézikönyv online súgóban, valamint nyomtatható PDF formátumban itt érhető el.

Csatlakozó használata

2.1. Kezdve tiszta::variánsok
A használt telepítési módtól függően vagy indítsa el a pure::variants-enabled Eclipse-t, vagy Windows alatt válassza ki a pure::variants elemet a programmenüből.
Ha a Változatkezelés perspektíva még nincs aktiválva, válassza ki az Ablak menü Megnyitás Perspektíva->Egyéb… pontjából.
2.2. Címtárfa importálása családmodellbe
Mielőtt importálna egy címtárfát egy családmodellbe, létre kell hozni egy változatprojektet. Javasoljuk továbbá, hogy a jellemzők már definiálva legyenek egy jellemzőmodellben. Kérjük, olvassa el a pure::variants dokumentációt, ha segítségre van szüksége ezekkel a lépésekkel kapcsolatban.
A tényleges importálás a Projektek helyi menüjében az Importálás… művelet kiválasztásával indul view vagy az Import… menü segítségével File menü. Válassza a Változatmodellek vagy Projektek lehetőséget a Változatkezelés kategóriából, majd nyomja meg a Tovább gombot. A következő oldalon válassza a Családmodell importálása a forrásmappákból lehetőséget, majd nyomja meg újra a Tovább gombot.
Válassza ki az importálandó forráskód típusát
Megjelenik az importvarázsló (lásd 1. ábra, „Az importálás varázsló oldala az importálható forráskód típusának kiválasztásához”). Válassza ki az importálni kívánt projekttípust, és nyomja meg a Tovább gombot. Mindegyik típus egy előre meghatározott készletet tartalmaz file a modellbe importálandó típusokat.
1. ábra: Az importálás varázsló oldala az importálható forráskód típusának kiválasztásáhozVálassza a Forrás és a Cél lehetőséget
A varázsló következő oldalán (2. ábra, „Az importálási varázsló oldala az importálás forrásának és céljának kiválasztásához”) meg kell adni a forráskönyvtárat és a célmodellt.
Nyomja meg a Tallózás… gombot, hogy kiválassza azt a könyvtárat, ahol az importálandó forráskód található. Alapértelmezés szerint az aktuális munkaterület van kiválasztva, mert ez hasznos lehet a navigáció megkezdéséhez.
Az alábbiakban megadhatja a beillesztési és kizárási mintát. Ezeknek a mintáknak Java reguláris kifejezéseknek kell lenniük. A forrás gyökérmappához viszonyított minden bemeneti útvonalat ez a minta ellenőrzi. Ha a beillesztési minta egyezik, a rendszer importál egy mappát, ha a kizárási minta nem egyezik. Ez azt jelenti, hogy a belefoglaló minta előre kiválasztja az importálandó mappákat, a kizárási minta pedig korlátozza ezt az előválasztást.
A forráskód könyvtár kiválasztása után meg kell határozni egy célmodellt. Ezért válasszon ki egy projektváltozatot vagy egy mappát, ahol a modellt tárolni szeretné, és adja meg a modell nevét. A file A név automatikusan kibővül a .ccfm kiterjesztéssel, ha nincs megadva ebben a párbeszédablakban. Alapértelmezés szerint ugyanarra a névre lesz beállítva, mint maga a modellnév. Ez az ajánlott beállítás.
A célszerű forrásmappa és a kívánt modellnév megadása után a párbeszédablak a Befejezés gomb megnyomásával fejeződhet be. Ha megnyomja a Tovább gombot, egy további oldal jelenik meg, ahol további beállításokat lehet elvégezni.
2. ábra: Az importálási varázsló oldala az importálás forrásának és céljának kiválasztásáhozMódosítsa az importálási beállításokat
A varázsló utolsó oldalán (3. ábra: „Az importvarázsló oldala az egyéni konfiguráció meghatározásához”) vannak olyan beállítások, amelyekkel testreszabhatja az importált szoftverprojekt importálási viselkedését.
A párbeszédpanelen egy táblázat látható, ahol a file típusok vannak meghatározva, amelyeket az importálási folyamat figyelembe vesz.
Minden sor négy mezőből áll.

• A Leírás mező egy rövid leíró szöveget tartalmaz, amely azonosítja a file típus.
• A File névminta mezőt a kiválasztáshoz használjuk files importálandók, ha megegyeznek a mezők értékével. A mező a következő szintaxist használja:

1. A leggyakoribb felhasználási eset lehet a file kiterjesztés. A szokásos szintaxis az .EXT, ahol az EXT a kívánt file kiterjesztés (pl. .java).
2. Egy másik gyakori helyzet egy speciális file, mint egy gyártmányfile. Ezért lehetséges a pontos egyezés file név. Ehhez csak írja be a file nevet a mezőbe (pl. build.xml).
3. Egyes esetekben a leképezési vágyak konkrétabbak, tehát csak fileazokat, amelyek egy speciális mintához illeszkednek, importálni kell. Ennek a követelménynek a teljesítéséhez lehetőség van reguláris kifejezések használatára a File névminta mező.
   A reguláris kifejezések szintaxisának leírása meghaladná ennek a súgónak a célját. Kérjük, olvassa el a pure::variants felhasználói kézikönyv referencia fejezetének reguláris kifejezések szakaszát (pl. .*).

• A Leképezett elem típusa mező a közötti leképezést állítja be file típust és egy tiszta::variants család elemtípust. A családelem típusa a forrás leírója file hogy az importált modellben a leképezett elemhez további információkat adjon. A tipikus választások a ps:class vagy a ps:makefile.
• A térképezett file típus mező beállítja a leképezést a között file típus és egy tiszta::variáns file típus. A file írja be a pure::variants parancsot a forrás leírója file hogy az importált modellben a leképezett elemhez további információkat adjon. A tipikus kiválasztások az impl a megvalósításokhoz vagy a def a definíciókhoz files.

3. ábra. Az importvarázsló oldala az egyéni konfiguráció meghatározásáhozÚj file típusok hozzáadhatók a Leképezés hozzáadása gombbal. Minden mező az undefined értékkel van kitöltve, és a felhasználónak kell kitöltenie. Egy mezőben lévő érték szerkesztéséhez kattintson a mezőre az egérrel. Az érték szerkeszthetővé válik és módosítható. Az alapértelmezés megváltoztatása nem lehetséges file táblázat névmintái. A testreszabás rugalmassá tételéhez törölheti a kijelölést a file írja be a sor kijelölésének megszüntetésével. Kijelölés megszüntetve file A névminták a konfigurációban maradnak, de az importőr nem fogja használni őket. Felhasználó által meghatározott file típusok ismét eltávolíthatók a Leképezés eltávolítása gombbal.
Alapértelmezés szerint egy Más files file névminta elérhető a táblázatban, de nincs kijelölve. Általában nem kívánja az összeset importálni files de ez könnyen megváltoztatható a megfelelő sor kiválasztásával.
Három általános importálási lehetőség áll rendelkezésre az importőr viselkedésének testreszabásához.

• Ne importáljon könyvtárakat egyeztetés nélkül files (pl. CVS könyvtárak).
  Ha az importőr olyan könyvtárat talál, ahol nincs egyezés file benne van, és ahol nincs egyező alkönyvtár file, a könyvtár nem lesz importálva. Ez gyakran hasznos, ha a projekteket verziókezelő rendszerek, például CVS kezelik. A CVS esetében minden releváns könyvtár tartalmaz egy CVS-könyvtárat, ahol az irreleváns files tárolódnak. Ha ez az opció ki van választva, és a CVS-files nem egyezik egyikkel sem file A fent definiált típus esetén a könyvtár nem importálódik összetevőként a családmodellbe.
• Fajta files és könyvtárak.
  Engedélyezze ezt a lehetőséget a rendezéshez files és könyvtárak ábécé sorrendben.
• Importálási útvonal kezelése.
  A további szinkronizáláshoz az importőrnek el kell tárolnia az összes importált elem eredeti elérési útját a modellben.
  Sok esetben a családi modelleket megosztják más felhasználókkal. A címtárstruktúra felhasználónként eltérő lehet. A leggyakoribb használati forgatókönyvek támogatása érdekében az importőr különböző módokban dolgozhat:

Abszolút	Az importált elem abszolút elérési útja a modellben tárolódik. A későbbi szinkronizáláshoz és az átalakítás során a files pontosan ugyanoda kell elhelyezni, mint az első importáláskor.
A munkaterülethez viszonyítva	Az elérési utak a munkaterület mappájához képest kerülnek tárolásra. A szinkronizáláshoz a files az Eclipse munkaterület részének kell lennie. Az átalakításnak az Eclipse munkaterületet kell használnia bemeneti könyvtárként.
Projekthez viszonyítva	Az útvonalak a projekthez viszonyítva tárolódnak. A szinkronizáláshoz a fileEzek az Eclipse projekt részei. Az átalakításnak a projekt mappát kell használnia bemeneti könyvtárként.
Path-hoz viszonyítva	Az utak az adott útvonalhoz viszonyítva tárolódnak. A szinkronizáláshoz a files pontosan ugyanazon a helyen kell elhelyezni. Az átalakítás bemeneti könyvtára megegyezik a relatív elérési úttal az importálás során.

A párbeszédpanel összes beállítása állandóan tárolva van. A személyes testreszabásokat nem szabad minden alkalommal újra elvégezni, amikor az importálás fut. Ez megkönnyíti és gyorsítja az importálási munkafolyamatot.
2.3. Modellek frissítése a címtárfából
Nyomja meg a Szinkronizálás gombot az importált modell szinkronizálása a könyvtár elérési útjával. A projekt gyökérútvonalát a modell tárolja, így az ugyanabba a könyvtárba fog szinkronizálódni, mint korábban. A Szinkronizálás gomb engedélyezéséhez nyissa meg a modellt, és válasszon ki egy elemet. A Szinkronizálás gomb megnyomása után megnyílik egy Összehasonlítás szerkesztő, ahol az aktuális családmodell és az aktuális címtárstruktúra modellje ellentétes (lásd 4. ábra, „Modellfrissítés a címtárfából az összehasonlító szerkesztőben”).
4. ábra Modellfrissítés a Címtárfából az Összehasonlításszerkesztőben   Az összehasonlító szerkesztőt a pure::variants során használják a modellverziók összehasonlítására, de ebben az esetben a fizikai könyvtárszerkezet (a jobb alsó sarokban látható) összehasonlítására használják az aktuális pure::variants modellel (bal alsó sarokban). Minden változtatás külön elemként jelenik meg a szerkesztő felső részében, az érintett elemek sorrendjében.
Ha kiválaszt egy elemet a listából, mindkét modellben kiemeli a megfelelő változást. Az exampLe, egy hozzáadott elemet a jobb oldalon egy doboz jelöl, és a bal oldalon kapcsolódik a modellben megvalósítható helyzetéhez. A felső és alsó szerkesztőablak közötti összevonás eszköztár eszközöket biztosít egyetlen vagy akár az összes (nem ütköző) változtatás egészének másolásához a címtárfa modellből a jellemzőmodellbe.
Jegyzet
A szinkronizálás az utoljára használt importőr beállításokkal történik. Ez lehetővé teszi a modell frissítését az importálás közben elvégzett egyéb beállításokkal.

A Relation Indexer használata

A Forráskód-kezelés Csatlakozója javítja a kapcsolatokat View információkkal a pure::variants modellelemek és a forráskód közötti kapcsolatokról. A relációk hozzáadódnak a ps:condxml és ps:condtext elemek feltételeiben használt szolgáltatásokhoz.
ps:flag és ps:flag eseténfile elemek az előfeldolgozó állandók helye a C/C++ forrásban files láthatók. Ezen túlmenően az egyező előfeldolgozói konstansok helye megjelenik egy kiválasztott jellemzőnél a jellemző egyedi nevei és az előfeldolgozói állandók közötti leképezés segítségével.
3.1. A Relation Indexer hozzáadása egy projekthez
A relációs indexelő egy speciális projekttulajdonság oldalon aktiválható. Válassza ki a projektet, majd a helyi menüben válassza a Tulajdonságok elemet. A következő párbeszédpanelen válassza ki a Relation Indexer oldalt.
5. ábra: Projekttulajdonság oldal a Kapcsolatindexelőhöz

A relációs indexelő aktiválása a projekthez a Relációs indexelő engedélyezése opció (1) kiválasztásával történik. Az indexelő engedélyezése után van még néhány lehetőség a projektspecifikus viselkedés meghatározására. A pure::variants Conditions és C/C++ Preprocessor Constants indexelése külön aktiválható (2). A lista a file névminták (3) segítségével választhatjuk ki a files indexeléshez. Csak files amelyek megfelelnek az egyik mintának, beolvasásra kerülnek. Adja hozzá a „*” mintát az összes beolvasásához files egy projektről.
A projekt indexelőjének aktiválása után egy építő hozzáadódik a projekthez. Ez az építői vizsgálat megváltozott files az új kapcsolatokhoz a pure::variants modellelemekhez automatikusan.
3.2. Kapcsolatok a forráskóddal
Aktivált relációindexelővel a Relations View további bejegyzéseket tartalmaz. Ezek a bejegyzések a nevét mutatják file és a változatpont sorszáma. A szerszámcsúcs a megfelelő részt mutatja a file. A bejegyzésre duplán kattintva a file megnyílik egy szerkesztőben.
pure::variants Feltételek
A pure::variants feltétel használható az a szakasz szakaszainak beillesztésére vagy kizárására file funkcióválasztástól függően. A Condition Indexer megkeresi az ilyen szabályokat, és kivonja a hivatkozott jellemzőket. Ha a szerkesztőben ilyen funkciót választunk, a Relations View mindent megmutat files és sorok, ahol egy feltétel található a kiválasztott jellemzővel (lásd 6. ábra, „Feltétel ábrázolása a kapcsolatokban View”).
6. ábra Egy feltétel ábrázolása a kapcsolatokban ViewHa részletes magyarázatot szeretne kapni a feltételek meghatározásáról, olvassa el a pure::variants Felhasználói kézikönyv 9.5.7 fejezetének ps:condtext szakaszát (Referencia–>Előre meghatározott forráselem-típusok–>ps:condtext).
C/C++ előfeldolgozó állandók
A C/C++ Preprocessor Indexer szkennel files az előfeldolgozói szabályokban használt konstansokhoz (pl. #ifdef, #ifndef, …).
Ha egy ps:flag vagy ps:flagfile elem van kiválasztva a Relations View mutatja a definiált előfeldolgozó állandó használatát.
A kapcsolatok View a funkciókhoz kapcsolódó előfeldolgozó állandókat is megjeleníti leképezési minták segítségével. Ehhez a minták kibővülnek a kiválasztott jellemző adataival. Az eredményül kapott szimbólumok a megfelelő előfeldolgozói állandók keresésére szolgálnak. 7. ábra: „C/C++ előfeldolgozó konstans ábrázolása a kapcsolatokban View” mutatja egy example a mintával a hírnév{Név}. A minta a funkció egyedi nevével bővült a fameNative névre. Az indexelt kódban 76 hely található, ahol a preprocesszor állandó fameNative használatos.
Ezek a helyek a kapcsolatokban láthatók View. A minták a beállításokban definiálhatók (lásd 3.3. szakasz, "A beállítások").
7. ábra: C/C++ előfeldolgozó konstans ábrázolása a relációkban View

3.3. A Beállítások
Az indexelő alapértelmezett viselkedésének megváltoztatásához nyissa meg az Eclipse beállításait, és válassza ki a Relation Indexer oldalt a Változatkezelés kategóriában. Az oldalon két lista látható.
8. ábra: Relációindexelő beállításai oldalA felső lista az alapértelmezettet tartalmazza file minták az indexelőhöz (1). Ez a lista az újonnan engedélyezett projektek kezdeti mintabeállítása.
Az alsó lista tartalmazza a jellemzők és az előfeldolgozó állandók közötti leképezést (2). Ez a leképezés minden projekthez használatos. Az 1. táblázat, „Támogatott leképezési cserék” mutatja az összes lehetséges cserét.
1. táblázat: Támogatott leképezési cserék

Helyettesítő karakter	Leírás	Example: FeatureA
Név	a kiválasztott jellemző egyedi neve	FLAG_{Name} – FLAG_FeatureA
NÉV	a kiválasztott jellemző egyedi neve nagybetűvel	FLAG_{NAME} – FLAG_FEATUREA
név	a kisbetűs a kiválasztott jellemző egyedi neve	flag_{name} – flag_featurea

Dokumentumok / Források

pure-systems 2024 csatlakozó a forráskód-kezelő szoftverhez [pdf] Felhasználói kézikönyv 2024, 2024-es csatlakozó a forráskód-kezelő szoftverhez, csatlakozó a forráskód-kezelő szoftverhez, a forráskód-kezelő szoftverhez, a kezelőszoftver, a szoftver

Hivatkozások

• Felhasználói kézikönyv