pure::variants – Tengi fyrir
Heimildarkóðastjórnunarhandbók
Parametric Technology GmbH
Útgáfa 6.0.7.685 fyrir hrein::afbrigði 6.0
Höfundarréttur © 2003-2024 Parametric Technology GmbH
2024

Inngangur

pure::variants Tengi fyrir frumkóðastjórnun (tengi) gerir forriturum kleift að stjórna breytileika frumkóða með því að nota pure::afbrigði. Frumkóðastjórnun hreinna::afbrigða veitir sveigjanlegt tækifæri til að samstilla möppuuppbyggingu og frumkóða files auðveldlega með hreinu::variants módel. Þannig er hægt að beita afbrigðum stjórnun sem framkvæmanlegt er, jafnvel við flókin hugbúnaðarverkefni. Ennfremur er auðveldara að stjórna tengingum á milli hreinna::afbrigðaeiginleika og frumkóða með byggingaraðilanum og eru mjög aðgengilegar með frumkóðastjórnuninni.
1.1. Hugbúnaðarkröfur
Hið hreina::afbrigði Tengi fyrir frumkóðastjórnun er viðbót fyrir hreina::afbrigði og er fáanlegt á öllum studdum kerfum.
1.2. Uppsetning
Vinsamlegast skoðaðu hlutann pure::variants Tengi í pure::variants Uppsetningarhandbók fyrir nákvæmar upplýsingar um hvernig á að setja upp tengið (valmyndin Help -> Help Contents og síðan pure::variants Uppsetningarhandbók -> pure::variants Tengingar).
1.3. Um þessa handbók
Ætlast er til að lesandinn hafi grunnþekkingu á og reynslu af hreinum::afbrigðum. Vinsamlega ráðfærðu þig við kynningarefni hennar áður en þú lest þessa handbók. Handbókin er fáanleg í nethjálp sem og á prenthæfu PDF formi hér.

Að nota tengi

2.1. Byrjar hreint::afbrigði
Það fer eftir uppsetningaraðferðinni sem notuð er annaðhvort að byrja á pure::variants-enabled Eclipse eða undir Windows velja pure::variants hlutinn úr forritavalmyndinni.
Ef afbrigðisstjórnunarsjónarmiðið er ekki þegar virkt, gerðu það með því að velja það úr Opna sjónarhorn->Annað... í gluggavalmyndinni.
2.2. Flytja inn skráartré inn í fjölskyldulíkan
Áður en skráartré er flutt inn í fjölskyldulíkan þarf að búa til afbrigðisverkefni. Einnig er ráðlegt að hafa eiginleika skilgreinda í eiginleikalíkani nú þegar. Vinsamlegast skoðið pure::variants skjölin til að fá hjálp varðandi þessi skref.
Raunverulegur innflutningur er hafinn með því að velja Flytja inn... aðgerðina annaðhvort í samhengisvalmyndinni í Verkefnum view eða með Import… valmyndinni í File matseðill. Veldu Variant Models eða Projects úr flokki Variant Management og ýttu á Next. Á næstu síðu veldu Flytja inn fjölskyldulíkan úr upprunamöppum og ýttu aftur á Next.
Veldu gerð frumkóða til að flytja inn
Innflutningshjálpin birtist (sjá mynd 1, "Síða innflutningshjálpar til að velja tegund frumkóða sem hægt er að flytja inn"). Veldu verkefnisgerð til að flytja inn og ýttu á Next. Hver tegund inniheldur fyrirfram skilgreint sett af file tegundir til að flytja inn í líkanið.
Mynd 1. Síða í innflutningshjálpinni til að velja tegund frumkóða sem hægt er að flytja innVeldu Uppruni og miða
Á næstu töfrasíðu (Mynd 2, "Síða innflutningshjálpar til að velja uppruna og markmið fyrir innflutninginn") tilgreina þarf upprunaskrána og marklíkanið.
Ýttu á Browse… hnappinn til að velja möppuna þar sem frumkóði er til sem ætti að flytja inn. Sjálfgefið er að núverandi vinnusvæði er valið vegna þess að þetta gæti verið gagnlegur punktur til að hefja siglingar.
Hér að neðan geturðu tilgreint innihalda og útiloka mynstur. Þessi mynstur verða að vera Java reglulegar tjáningar. Hver inntaksslóð, miðað við upprunarótarmöppuna, er merkt með þessu mynstri. Ef innihalda mynstur passar er mappa flutt inn, ef útilokunarmynstrið passar ekki. Sem þýðir að innihaldsmynstrið velur fyrirfram möppurnar til að flytja inn, útilokunarmynstrið takmarkar þetta forval.
Eftir að frumkóðaskráin hefur verið valin verður að skilgreina marklíkan. Veldu því afbrigðisverkefni eða möppu þar sem líkanið á að geyma og sláðu inn heiti líkans. The file nafn er framlengt sjálfkrafa með .ccfm endingunni ef það er ekki gefið upp í þessum glugga. Sjálfgefið verður það stillt á sama nafn og líkanið sjálft. Þetta er ráðlögð stilling.
Eftir að viðeigandi upprunamöppu og viðkomandi líkanheiti hefur verið tilgreint gæti glugganum verið lokið með því að ýta á Finish. Ef ýtt er á Næsta hnappinn kemur upp önnur síða þar sem hægt er að gera frekari stillingar.
Mynd 2. Síða í innflutningshjálpinni til að velja uppruna og markmið fyrir innflutninginnBreyta innflutningsstillingum
Á síðustu töfrasíðunni (Mynd 3, „Síða innflutningshjálpar til að skilgreina einstaka uppsetningu”) það eru kjörstillingar sem hægt er að gera til að sérsníða innflutningshegðun fyrir innflutta hugbúnaðarverkefnið.
Gluggatíðan sýnir töflu þar sem file gerðir eru skilgreindar sem verða teknar til greina í innflutningsferlinu.
Hver lína samanstendur af fjórum sviðum.

• Lýsingarreiturinn inniheldur stuttan lýsandi texta til að auðkenna file gerð.
• The File nafn mynstur reitur er notaður til að velja files til að flytja inn þegar þau passa við gildi reitanna. Reiturinn notar eftirfarandi setningafræði:

1. Algengasta notkunartilvikið getur verið a file framlenging. Venjuleg setningafræði er .EXT, þar sem EXT er æskilegt file ending (td .java).
2. Annað algengt ástand er sérstakt file, eins og tegundfile. Þess vegna er hægt að passa nákvæmlega file nafn. Til að gera þetta skaltu bara slá inn file nafn inn í reitinn (td build.xml).
3. Í sumum tilfellum eru kortlagningarþráin nákvæmari, svo aðeins files sem passa við sérstakt mynstur ætti að flytja inn. Til að uppfylla þessa kröfu er hægt að nota reglulegar segðir í File nafn mynstur reit.
   Að lýsa setningafræði reglulegra tjáninga myndi fara fram úr ætlun þessarar hjálpar. Vinsamlegast hafðu samband við reglubundnar orðasambönd í tilvísunarkaflanum í hreinu::variants notendahandbókinni (td .*).

• Reiturinn Kortlagt þáttargerð setur vörpun á milli a file tegund og hrein::afbrigði fjölskylduþáttartegund. Fjölskylduþáttargerðin er lýsing fyrir upprunann file til að veita frekari upplýsingar um kortlagða þáttinn í innfluttu líkaninu. Dæmigert val er ps:class eða ps:makefile.
• The Kortlagt file type field setur vörpun á milli a file tegund og hrein::afbrigði file gerð. The file slá inn pure::variants er lýsing fyrir upprunann file til að veita frekari upplýsingar um kortlagða þáttinn í innfluttu líkaninu. Dæmigert val er impl fyrir útfærslur eða def fyrir skilgreiningu files.

Mynd 3. Síða innflutningshjálpar til að skilgreina einstaka uppsetninguNýtt file tegundum er hægt að bæta við með því að nota hnappinn Bæta við kortlagningu. Allir reiti eru fylltir út með gildinu óskilgreint og verður notandinn að fylla út. Til að breyta gildi í reit smellirðu bara inn í reitinn með músinni. Gildið verður breytanlegt og hægt að breyta því. Það er ekki hægt að breyta sjálfgefnu file nafnmynstur borðsins. Til að gera sérstillingu sveigjanlega er hægt að afvelja a file sláðu inn með því að afvelja línuna. Afvalið file nafnamynstur haldast í stillingunum en verða ekki notuð af innflytjanda. Notandi skilgreindur file gerðir má fjarlægja aftur með því að nota hnappinn Fjarlægja kortlagningu.
Sjálfgefið er Annað files file nafnamynstur er fáanlegt í töflunni en afvalið. Venjulega er ekki óskað að flytja allt inn files en þessu er auðvelt að breyta með því að velja samsvarandi röð.
Það eru þrír almennir innflutningsvalkostir til að sérsníða hegðun innflytjanda.

• Ekki flytja inn möppur án þess að passa saman files (td CVS möppur).
  Ef innflytjandi finnur möppu þar sem engin samsvörun file er í henni og þar sem engin undirskrá hefur samsvörun file, skráin verður ekki flutt inn. Þetta er oft gagnlegt ef verkefnum er stjórnað af útgáfustjórnunarkerfum eins og CVS. Fyrir CVS inniheldur hver viðeigandi möppu CVS-skrá þar sem það skiptir ekki máli files eru geymdar. Ef þessi valkostur er valinn og CVS-files passa ekki við neina file tegund sem er skilgreind hér að ofan, verður skráin ekki flutt inn sem hluti í fjölskyldulíkanið.
• Raða files og möppur.
  Virkjaðu þennan valkost til að flokka files og möppur hver í stafrófsröð.
• Flytja inn slóð meðhöndlun.
  Fyrir frekari samstillingu þarf innflytjandinn að geyma upprunalega slóð allra innfluttra þátta í líkaninu.
  Í mörgum tilfellum er fjölskyldulíkönum deilt með öðrum notendum. Uppbygging möppu getur verið mismunandi fyrir hvern notanda. Til að styðja við algengustu notkunarsviðsmyndir getur innflytjandinn unnið í mismunandi stillingum:

Algjört	Alger slóð að innfluttu þættinum verður geymd í líkaninu. Fyrir síðari samstillingu og meðan á umbreytingunni stendur files verða að setja á nákvæmlega sama stað og við fyrsta innflutning.
Miðað við Workspace	Slóðirnar eru geymdar miðað við vinnusvæðismöppuna. Fyrir samstillingu files verður að vera hluti af Eclipse vinnusvæðinu. Umbreytingin verður að nota Eclipse vinnusvæðið sem inntaksskrá.
Miðað við Project	Slóðirnar eru geymdar miðað við verkefnið. Fyrir samstillingu files eru hluti af verkefninu innan Eclipse. Umbreytingin verður að nota verkefnamöppuna sem inntaksskrá.
Miðað við Path	Slóðirnar eru geymdar miðað við tiltekna slóð. Fyrir samstillingu files verða að vera staðsett á nákvæmlega sama stað. Umbreytingarinntaksskráin er sú sama og hlutfallsleg slóð meðan á innflutningi stendur.

Allar kjörstillingar þessa glugga eru geymdar stöðugt. Ekki má endurgera persónulegu sérstillingarnar í hvert sinn sem innflutningur er í gangi. Þetta gerir innflutningsvinnuflæðið auðvelt og hratt.
2.3. Uppfærsla módel frá möpputré
Ýttu á samstillingarhnappinn til að samstilla innflutt líkan við skráarslóð þess. Rótslóð verkefnisins er geymd í líkaninu svo það mun samstillast við sömu möppu og áður. Til að virkja Samstillingarhnappinn skaltu opna líkanið og velja hvaða þátt sem er. Eftir að hafa ýtt á Samstillingarhnappinn opnast Compare Editor þar sem núverandi fjölskyldulíkan og líkanið af núverandi möppuuppbyggingu er á móti (sjá mynd 4, "Model update from Directory Tree in Compare Editor").
Mynd 4. Líkanuppfærsla frá Directory Tree í Compare Editor   Samanburðaritillinn er notaður í gegnum hreinar::afbrigði til að bera saman líkanaútgáfur en í þessu tilfelli er hann notaður til að bera saman líkamlega möppuuppbyggingu (sýnd neðst hægra megin) við núverandi hreina::afbrigði líkan (neðri vinstra megin). Allar breytingar eru skráðar sem aðskildir hlutir í efri hluta ritlins, raðað eftir þeim þáttum sem verða fyrir áhrifum.
Að velja hlut á þessum lista undirstrikar viðkomandi breytingu á báðum gerðum. Í fyrrvample, viðbætt þáttur er merktur með kassa hægra megin og tengdur við mögulega staðsetningu hans í líkaninu vinstra megin. Sameina tækjastikan á milli efri og neðri ritstjórnarglugga býður upp á verkfæri til að afrita stakar eða jafnvel allar (óandstæðar) breytingar í heild frá möpputréslíkaninu yfir í eiginleikalíkanið.
Athugið
Samstillingin er gerð með síðustu notuðu innflutningsstillingunum. Þetta gerir það mögulegt að uppfæra líkanið með öðrum stillingum eins og þær voru gerðar á meðan innflutningurinn fór fram.

Notaðu Relation Indexer

Tengi fyrir frumkóðastjórnun eykur tengslin View með upplýsingum um tengingar milli hreinna::variants líkanþátta og frumkóða. Tengslum er bætt við fyrir eiginleika sem eru notaðir í skilyrðum ps:condxml og ps:condtext þáttanna.
Fyrir ps:flag og ps:flagfile þættir staðsetning forvinnslufasta í C/C++ uppruna files eru sýndar. Að auki eru staðsetningar samsvarandi forvinnslufasta sýndar fyrir valinn eiginleika með því að nota vörpun á milli einstaka heita eiginleika og forvinnslufasta.
3.1. Að bæta tengslavísitölunni við verkefni
Hægt er að virkja tengslavísitöluna á sérstakri verkeignasíðu. Veldu verkefnið og veldu hlutinn Eiginleikar í samhengisvalmyndinni. Í komandi valmynd skaltu velja síðuna Tengslskráning.
Mynd 5. Verkeignasíða fyrir tengslavísitöluna

Venslavísirinn er virkjaður fyrir verkefnið með því að velja Virkja tengslavísitölu valkostinn (1). Eftir að hafa virkjað vísitöluna eru nokkrir fleiri möguleikar til að skilgreina verkefnissértæka hegðun. Hægt er að virkja flokkun hreinna::variants Skilyrði og C/C++ forvinnslufasta sérstaklega (2). Listinn með file nafnmynstur (3) er notað til að velja files fyrir verðtryggingu. Aðeins files sem passa við eitt af mynstrum eru skannaðar. Bættu við "*" sem mynstur til að skanna allt files af verkefni.
Eftir að hafa virkjað vísitölu fyrir verkefni er byggingaraðili bætt við verkefnið. Þessi smiður skannar breytt files fyrir ný tengsl við hreina::afbrigði líkanþátta sjálfkrafa.
3.2. Tengslin við frumkóðann
Með virkjaðri tengslavísitölu eru tengslin View inniheldur viðbótarfærslur. Þessar færslur sýna nafnið á file og línunúmer afbrigðispunktsins. Verkfæraábendingin sýnir viðeigandi hluta af file. Með því að tvísmella á færsluna á file verður opnað í ritstjóra.
pure::variants Skilyrði
Hið hreina::variants skilyrði er hægt að nota til að taka með eða útiloka hluta af a file fer eftir eiginleikum vali. Skilyrðisvísirinn leitar að slíkum reglum og dregur út eiginleikana sem vísað er til. Ef slíkur eiginleiki er valinn í ritlinum eru Tengsl View mun sýna allt files og línur þar sem ástand með valinn eiginleika er staðsettur (sjá mynd 6, „Framsetning ástands í samskiptum View”).
Mynd 6. Framsetning ástands í samskiptum ViewTil að fá nákvæma útskýringu á því hvernig á að skilgreina skilyrði, skoðaðu kaflann ps:condtext í kafla 9.5.7 í hreinu::variants notendahandbókinni (Reference–>Predefined Source Element Types–>ps:condtext).
C/C++ forvinnslufastar
C/C++ Preprocessor Indexer skannar files fyrir fasta sem notaðir eru í forvinnslureglum (td #ifdef, #ifndef, …).
Ef ps:flag eða ps:flagfile þáttur er valinn Tengsl View sýnir notkun á skilgreindum forvinnslufasta.
Samböndin View sýnir einnig forvinnslufasta tengda eiginleikum með því að nota kortlagningarmynstur. Fyrir þetta eru mynstrin stækkuð með gögnum um valinn eiginleika. Táknin sem myndast eru notuð til að leita að samsvarandi forvinnsluföstum. Mynd 7, „Framsetning á C/C++ forvinnslufasta í samböndunum View“ sýnir fyrrverandiample með mynstur frægð {Name}. Mynstrið er stækkað með einstöku nafni eiginleikans í fameNative. Í verðtryggða kóðanum eru 76 staðir þar sem forvinnslufastinn frægur er notaður.
Þessar staðsetningar eru sýndar í samskiptum View. Hægt er að skilgreina mynstrin í stillingum (sjá kafla 3.3, „Kjörin“).
Mynd 7. Framsetning á C/C++ forvinnslufasta í samböndunum View

3.3. Kjörstillingarnar
Til að breyta sjálfgefna hegðun vísitölunnar opnaðu Eclipse-stillingarnar og veldu síðuna Tengslvísitölu í flokknum Afbrigðisstjórnun. Á síðunni eru tveir listar.
Mynd 8. Síða um kjörstillingar tengslavísitöluEfri listinn inniheldur sjálfgefið file mynstur fyrir vísitöluna (1). Þessi listi er upphafsmynsturstilling fyrir nýlega virkjuð verkefni.
Neðri listinn inniheldur kortlagningu á milli eiginleika og forvinnslufasta (2). Þessi kortlagning er notuð fyrir öll verkefni. Tafla 1, „Styddar kortlagningarskipti“ sýnir allar mögulegar skipti.
Tafla 1. Stuðar kortlagningarskipti

Wildcard	Lýsing	Example: EiginleikiA
Nafn	einstakt heiti valins eiginleika	FLAG_{Name} – FLAG_EiginleikiA
NAFN	hástöfum Einstakt heiti valins eiginleika	FLAG_{NAME} – FLAG_FEATUREA
nafn	lágstafir Einstakt heiti valins eiginleika	flag_{name} – flag_featurea

Skjöl / auðlindir

pure-systems 2024 tengi fyrir frumkóðastjórnunarhugbúnað [pdfNotendahandbók 2024, 2024 tengi fyrir frumkóðastjórnunarhugbúnað, tengi fyrir frumkóðastjórnunarhugbúnað, frumkóðastjórnunarhugbúnað, stjórnunarhugbúnað, hugbúnaður

Heimildir

• Notendahandbók