puhas::variandid – Ühendus jaoks
Lähtekoodi haldusjuhend
Parametric Technology GmbH
Versioon 6.0.7.685 puhta::variants 6.0 jaoks
Autoriõigus © 2003-2024 Parametric Technology GmbH
2024

Sissejuhatus

pure::variants Lähtekoodi haldamise konnektor (Connector) võimaldab arendajatel hallata lähtekoodi varieeruvust, kasutades puhast::varianti. Pure::variantide lähtekoodihaldus annab paindliku võimaluse kataloogistruktuuride ja lähtekoodi sünkroonimiseks files lihtsalt puhaste::variantide mudelitega. Seeläbi saab variantide haldust rakendada ka keerukate tarkvaraprojektide puhul. Lisaks saab koostaja abil lihtsamini hallata ühendusi puhaste::variantide funktsioonide ja lähtekoodi vahel ning need on lähtekoodihalduse kaudu hõlpsasti juurdepääsetavad.
1.1. Nõuded tarkvarale
Pure::variants Connector lähtekoodi haldamiseks on puhaste::variantide laiendus ja see on saadaval kõigil toetatud platvormidel.
1.2. Paigaldamine
Lisateabe saamiseks konnektori paigaldamise kohta lugege jaotist pure::variants Pure::variantsi seadistusjuhendi ühendused (menüü Abi -> Abi sisu ja seejärel puhas::variantsi seadistusjuhend -> pure::variants Connectors).
1.3. Teave selle juhendi kohta
Lugejalt oodatakse põhiteadmisi ja kogemusi puhaste::variantide kohta. Enne selle juhendi lugemist tutvuge selle sissejuhatava materjaliga. Kasutusjuhend on saadaval nii võrguabis kui ka prinditavas PDF-vormingus siit.

Connectori kasutamine

2.1. Alustades puhtalt::variandid
Olenevalt kasutatavast installimeetodist käivitage kas puhas::variants-enabled Eclipse või valige Windowsis programmimenüüst üksus pure::variants.
Kui variantide haldamise perspektiiv pole veel aktiveeritud, vali see menüüs Aken valikust Ava vaatenurk->Muu….
2.2. Importige kataloogipuu peremudelisse
Enne kataloogipuu importimist peremudelisse tuleb luua variantide projekt. Samuti on soovitatav, et funktsioonid oleksid juba funktsioonimudelis määratletud. Nende sammude kohta abi saamiseks vaadake puhast::variantsi dokumentatsiooni.
Tegelik importimine algab, valides kas Projektide kontekstimenüüst toimingu Import… view või menüüs Import… File menüü. Valige kategooriast Variantide haldamine Variantide mudelid või Projektid ja vajutage Edasi. Järgmisel lehel valige Impordi lähtekaustadest peremudel ja vajutage uuesti nuppu Edasi.
Valige imporditava lähtekoodi tüüp
Ilmub impordiviisard (vt joonis 1, „Impordiviisardi leht imporditava lähtekoodi tüübi valimiseks”). Valige imporditav projekti tüüp ja vajutage nuppu Edasi. Iga tüüp sisaldab eelmääratletud komplekti file mudelisse importimiseks.
Joonis 1. Impordiviisardi leht, et valida imporditava lähtekoodi tüüpValige Allikas ja sihtmärk
Järgmisel viisardi lehel (Joonis 2, "Impordiviisardi leht impordi allika ja sihtmärgi valimiseks") tuleb määrata lähtekataloog ja sihtmudel.
Vajutage nuppu Sirvi…, et valida kataloog, kus on imporditav lähtekood. Vaikimisi on valitud praegune tööala, kuna see võib olla kasulik punkt navigeerimise alustamiseks.
Allpool saate määrata kaasamise ja välistamise mustri. Need mustrid peavad olema Java regulaaravaldised. Nende mustritega kontrollitakse iga sisendtee lähtejuurkausta suhtes. Kui kaasamise muster kattub, imporditakse kaust, kui välistamismuster ei ühti. See tähendab, et kaasamismuster valib imporditavad kaustad eelnevalt, välistamismuster aga piirab seda eelvalikut.
Pärast lähtekoodi kataloogi valimist tuleb määratleda sihtmudel. Seetõttu valige variandiprojekt või kaust, kuhu mudel salvestada, ja sisestage mudeli nimi. The file nime pikendatakse automaatselt laiendiga .ccfm, kui seda pole antud dialoogis. Vaikimisi määratakse see samale nimele kui mudeli nimi. See on soovitatav seadistus.
Pärast otstarbeka lähtekausta ja soovitud mudeli nime määramist võib dialoogi lõpetada, vajutades Finish. Kui vajutada nuppu Edasi, ilmub järgmine leht, kus saab teha täiendavaid seadistusi.
Joonis 2. Impordiviisardi leht impordi allika ja sihtmärgi valimiseksMuuda impordi eelistusi
Viisardi viimasel lehel (Joonis 3, „Impordiviisardi leht individuaalse konfiguratsiooni määratlemiseks”) on eelistusi, mida saab teha imporditava tarkvaraprojekti impordikäitumise kohandamiseks.
Dialoogilehel kuvatakse tabel, kus file tüübid on määratletud, mida impordiprotsess arvestab.
Iga rida koosneb neljast väljast.

• Väli Kirjeldus sisaldab lühikest kirjeldavat teksti, et tuvastada file tüüp.
• The File valimiseks kasutatakse nimemustri välja files imporditakse, kui need vastavad väljade väärtusele. Väljal kasutatakse järgmist süntaksit:

1. Kõige tavalisem kasutusjuht võib olla a file pikendamine. Tavaline süntaks on .EXT, kus soovitud on EXT file laiendus (nt .java).
2. Teine levinud olukord on eriline file, nagu markfile. Seetõttu on võimalik täpselt sobitada file nimi. Selleks sisestage lihtsalt file nimi väljale (nt build.xml).
3. Mõnel juhul on kaardistamise soovid konkreetsemad, nii et ainult files, mis vastavad erimustrile, tuleks importida. Selle nõude täitmiseks on võimalik kasutada regulaaravaldisi File nimemustri väli.
   Regulaaravaldiste süntaksi kirjeldamine ületaks selle abi eesmärgi. Palun tutvuge puhta::variantsi kasutusjuhendi (nt .*) viitepeatüki regulaaravaldiste jaotisega.

• Väli Mapped element type määrab vastenduse a vahel file tüüp ja puhas::variants perekonna elemenditüüp. Pereelemendi tüüp on allika kirjeldus file imporditud mudeli vastendatud elemendi kohta lisateabe andmiseks. Tüüpilised valikud on ps:class või ps:makefile.
• Kaardistatud file tüüpi väli määrab vastenduse a vahel file tüüp ja puhas::variandid file tüüp. The file tippige pure::variants on allika deskriptor file imporditud mudeli vastendatud elemendi kohta lisateabe andmiseks. Tüüpilised valikud on impl rakenduste jaoks või def definitsioonide jaoks files.

Joonis 3. Impordiviisardi leht individuaalse konfiguratsiooni määratlemiseksUus file tüüpe saab lisada, kasutades nuppu Lisa vastendus. Kõik väljad on täidetud väärtusega undefined ja kasutaja peab need täitma. Väljal oleva väärtuse muutmiseks klõpsake lihtsalt väljal hiirega. Väärtus muutub redigeeritavaks ja seda saab muuta. Vaikimisi pole võimalik muuta file tabeli nimemustrid. Kohandamise paindlikuks muutmiseks on võimalik tühistada a file tippige, tühistades rea valiku. Valimine on tühistatud file nimemustrid jäävad konfiguratsiooni, kuid importija neid ei kasuta. Kasutaja määratletud file tüübid saab uuesti eemaldada, kasutades nuppu Eemalda vastendus.
Vaikimisi Muu files file nimemuster on tabelis saadaval, kuid valimata. Tavaliselt ei taheta kõiki importida files, kuid seda saab hõlpsasti muuta, valides vastava rea.
Importija käitumise kohandamiseks on kolm üldist impordivalikut.

• Ärge importige katalooge ilma sobitamiseta files (nt CVS kataloogid).
  Kui importija leiab kataloogi, kus ei ühti file on selles ja kus ühelgi alamkataloogil pole vastet file, kataloogi ei impordita. See on sageli kasulik, kui projekte haldavad versioonihaldussüsteemid nagu CVS. CVS-i jaoks sisaldab iga asjakohane kataloog CVS-kataloogi, kui see ei ole asjakohane files on salvestatud. Kui see valik on valitud ja CVS-files ei vasta ühelegi file ülal määratletud tüüpi, ei impordita kataloogi komponendina peremudelisse.
• Sorteeri files ja kataloogid.
  Sordimiseks lubage see suvand files ja kataloogid tähestikulises järjekorras.
• Imporditee käsitlemine.
  Edasiseks sünkroonimiseks peab importija salvestama mudelisse kõigi imporditud elementide algse tee.
  Paljudel juhtudel jagatakse peremudeleid teiste kasutajatega. Kataloogi struktuur võib iga kasutaja jaoks olla erinev. Kõige tavalisemate kasutusstsenaariumide toetamiseks võib importija töötada erinevates režiimides.

Absoluutne	Imporditud elemendi absoluutne tee salvestatakse mudelisse. Hilisemaks sünkroonimiseks ja teisenduse ajal files tuleb paigutada täpselt samasse kohta, kus esimesel importimisel.
Tööruumiga võrreldes	Teed salvestatakse tööruumi kausta suhtes. Sünkroonimiseks files peab olema osa Eclipse'i tööruumist. Teisendus peab kasutama sisendkataloogina Eclipse'i tööruumi.
Projektiga võrreldes	Teed salvestatakse projekti suhtes. Sünkroonimiseks fileNeed on osa Eclipse'i projektist. Teisendus peab kasutama sisendkataloogina projekti kausta.
Pathi suhtes	Teed salvestatakse antud tee suhtes. Sünkroonimiseks files tuleb asetada täpselt samasse kohta. Teisenduse sisendkataloog on sama, mis suhteline tee importimise ajal.

Kõik selle dialoogi eelistused salvestatakse püsivalt. Isiklikke kohandusi ei tohi iga kord importimise ajal uuesti teha. See muudab impordi töövoo lihtsaks ja kiireks.
2.3. Mudelite värskendamine kataloogipuust
Vajutage nuppu Sünkrooni imporditud mudeli sünkroonimiseks selle kataloogiteega. Projekti juurtee on salvestatud mudelisse, nii et see sünkroonitakse samasse kataloogi nagu varem. Nupu Sünkrooni lubamiseks avage mudel ja valige suvaline element. Pärast sünkroonimisnupu vajutamist avaneb võrdlusredaktor, kus praegune peremudel ja praeguse kataloogistruktuuri mudel on vastandlikud (vt joonis 4, „Mudeli värskendus kataloogipuust võrdlusredaktoris”).
Joonis 4. Mudeli värskendus võrdlusredaktoris kataloogipuust   Võrdlusredaktorit kasutatakse kogu pure::variantsi mudeli versioonide võrdlemiseks, kuid sel juhul kasutatakse seda füüsilise kataloogi struktuuri (kuvatakse alumises paremas servas) võrdlemiseks praeguse pure::variantsi mudeliga (all vasakul). Kõik muudatused on loetletud redaktori ülemises osas eraldi üksustena, mis on järjestatud mõjutatud elementide järgi.
Selles loendis üksuse valimine tõstab esile mõlema mudeli vastava muudatuse. Eksisample, on lisatud element märgitud paremal pool asuva kastiga ja ühendatud selle teostatava asukohaga mudelis vasakul küljel. Ülemise ja alumise redaktori akna ühendamise tööriistariba pakub tööriistu üksikute või isegi kõigi (mittekonfliktsete) muudatuste kui terviku kopeerimiseks kataloogipuu mudelist funktsioonimudelisse.
Märkus
Sünkroonimine toimub viimati kasutatud importija seadistustega. See võimaldab värskendada mudelit muude importimise ajal tehtud seadistustega.

Suhteindekseri kasutamine

Lähtekoodi haldamise konnektor täiustab suhteid View teabega pure::variantsi mudeli elementide ja lähtekoodi vaheliste ühenduste kohta. Seosed lisatakse funktsioonidele, mida kasutatakse elementide ps:condxml ja ps:condtext tingimustes.
ps:lipp ja ps:lipp jaoksfile elemendid eelprotsessori konstantide asukoht C/C++ allikas files on näidatud. Lisaks kuvatakse valitud funktsiooni jaoks sobivate eeltöötluskonstantide asukohad, kasutades funktsiooni kordumatute nimede ja eeltöötluskonstantide vahelist vastendamist.
3.1. Suhteindekseri lisamine projektile
Seoste indekseerija saab aktiveerida spetsiaalsel projekti atribuudi lehel. Valige projekt ja valige kontekstimenüüst üksus Atribuudid. Valige eelseisvas dialoogis leht Relation Indexer.
Joonis 5. Suhteindekseri projekti atribuutide leht

Relatsiooniindekseerija aktiveeritakse projekti jaoks, valides suvandi Luba relatsiooniindekser (1). Pärast indekseerija lubamist on projektipõhise käitumise määratlemiseks veel mõned võimalused. Pure::variantide tingimuste ja C/C++ eelprotsessori konstantide indekseerimist saab eraldi aktiveerida (2). Nimekiri koos file nimemustreid (3) kasutatakse valimiseks files indekseerimiseks. Ainult files, mis vastavad ühele mustritest, skannitakse. Kõigi skannimiseks lisage mustrina "*". files projektist.
Pärast projekti indekseerija aktiveerimist lisatakse projektile ehitaja. See ehitaja skannib muudetud files uute suhete jaoks puhaste::variantide mudelielementidega automaatselt.
3.2. Seosed lähtekoodiga
Aktiveeritud seoste indekseerijaga suhted View sisaldab täiendavaid kirjeid. Need kirjed näitavad üksuse nime file ja variandi punkti rea number. Tööriista näpunäide näitab vastavat jaotist file. Topeltklõpsates kirjel file avatakse toimetajaks.
puhas::variandid Tingimused
Tingimust Pure::variants saab kasutada a sektsioonide kaasamiseks või välistamiseks file olenevalt funktsiooni valikust. Seisundi indekseerija otsib selliseid reegleid ja eraldab viidatud funktsioonid. Kui selline funktsioon on redaktoris valitud, kuvatakse Relations View näitab kõike files ja read, kus asub valitud tunnusega tingimus (vt joonis 6, „Tingimuse esitus suhetes View”).
Joonis 6. Tingimuse esitus suhetes ViewÜksikasjaliku selgituse saamiseks tingimuste määratlemise kohta lugege puhta::variantsi kasutusjuhendi peatüki 9.5.7 jaotist ps:condtext (Viide–>Eelmääratletud lähteelementide tüübid–>ps:condtext).
C/C++ eelprotsessori konstandid
C/C++ eelprotsessori indekseerija skannib files eeltöötlusreeglites kasutatavate konstantide jaoks (nt #ifdef, #ifndef, …).
Kui ps:lipp või ps:lippfile element on valitud suhted View näitab määratletud eeltöötluskonstandi kasutamist.
Suhted View kuvab ka eelprotsessori konstandid, mis on kaardistusmustrite abil funktsioonidega ühendatud. Selleks laiendatakse mustreid valitud funktsiooni andmetega. Saadud sümboleid kasutatakse sobivate eeltöötluskonstantide otsimiseks. Joonis 7, „C/C++ eelprotsessori konstandi esitus suhetes View” näitab endineample mustriga kuulsus{Nimi}. Mustrit laiendatakse funktsiooni ainulaadse nimega fameNative. Indekseeritud koodis on 76 asukohta, kus kasutatakse eelprotsessori konstanti fameNative.
Need asukohad on näidatud suhetes View. Mustrid saab määratleda eelistustes (vt jaotis 3.3, "Eelistused").
Joonis 7. C/C++ eelprotsessori konstandi esitus suhetes View

3.3. Eelistused
Indekseri vaikekäitumise muutmiseks avage Eclipse'i eelistused ja valige kategoorias Variant Management leht Relation Indexer. Lehel on kaks loendit.
Joonis 8. Relatsiooniindekseri eelistuste lehtÜlemine loend sisaldab vaikeväärtust file indekseerija mustrid (1). See loend on äsja lubatud projektide esialgne mustriseade.
Alumine loend sisaldab funktsioonide ja eelprotsessori konstantide vahelist vastendamist (2). Seda kaardistamist kasutatakse kõigi projektide jaoks. Tabel 1 „Toetatud kaardistamise asendused” näitab kõiki võimalikke asendusi.
Tabel 1. Toetatud kaardistamise asendused

Metamärk	Kirjeldus	Example: FunktsioonA
Nimi	valitud funktsiooni kordumatu nimi	FLAG_{Nimi} – FLAG_FeatureA
NIMI	valitud funktsiooni unikaalne nimi suurtähtedega	FLAG_{NAME} – FLAG_FEATUREA
nimi	väiketähtedega valitud funktsiooni kordumatu nimi	lipp_{nimi} – lipu_funktsioon

Dokumendid / Ressursid

pure-systems 2024 pistik lähtekoodihaldustarkvara jaoks [pdfKasutusjuhend 2024, 2024 lähtekoodi haldustarkvara konnektor, lähtekoodi haldustarkvara pistik, lähtekoodi haldustarkvara, haldustarkvara, tarkvara

Viited

• Kasutusjuhend