pure::variants – Liitin
Lähdekoodin hallintaopas
Parametric Technology GmbH
Versio 6.0.7.685 puhtaalle::variantsille 6.0
Tekijänoikeus © 2003-2024 Parametric Technology GmbH
2024

Johdanto

pure::variants Connector for Source Code Management (Connector) antaa kehittäjille mahdollisuuden hallita lähdekoodin vaihtelua käyttämällä pure::variantsia. Pure::varianttien lähdekoodin hallinta tarjoaa joustavan mahdollisuuden synkronoida hakemistorakenteita ja lähdekoodia files helposti puhtailla::variants-malleilla. Näin vaihtoehtojen hallintaa voidaan soveltaa käytännöllisesti jopa monimutkaisiin ohjelmistoprojekteihin. Lisäksi puhtaan::varianttien ominaisuuksien ja lähdekoodin välisiä yhteyksiä voidaan hallita helpommin rakentajan avulla, ja ne ovat helposti saatavilla lähdekoodinhallinnan kautta.
1.1. Ohjelmistovaatimukset
Pure::variants Connector for Source Code Management on laajennus pure::varianteille ja on saatavilla kaikilla tuetuilla alustoilla.
1.2. Asennus
Katso pure::variantsin liittimet pure::variants-asennusoppaan kohdasta lisätietoja liittimen asentamisesta (valikko Ohje -> Ohjeen sisältö ja sitten pure::variants Asennusopas -> pure::variants Liittimet).
1.3. Tietoja tästä käyttöoppaasta
Lukijalta odotetaan perustietoa ja kokemuksia puhtaista::varianteista. Tutustu sen johdantomateriaaliin ennen tämän oppaan lukemista. Käsikirja on saatavilla online-ohjeessa sekä tulostettavassa PDF-muodossa täältä.

Liittimen käyttäminen

2.1. Alkaen puhtaasti::variantit
Käytetystä asennustavasta riippuen joko käynnistä pure::variants-yhteensopiva Eclipse tai valitse Windowsissa ohjelmavalikosta kohta pure::variants.
Jos Variant Management -näkökulmaa ei ole vielä aktivoitu, tee se valitsemalla se Ikkuna-valikon kohdasta Open Perspective->Other….
2.2. Tuo hakemistopuu perhemalliin
Ennen kuin tuot hakemistopuun perhemalliin, on luotava varianttiprojekti. On myös suositeltavaa, että ominaisuudet on jo määritetty ominaisuusmallissa. Katso näiden vaiheiden ohjeita puhtaasta::variants-dokumentaatiosta.
Varsinainen tuonti aloitetaan valitsemalla Tuo… -toiminto joko Projektien pikavalikosta view tai Import…-valikosta File valikosta. Valitse Varianttimallit tai Projektit kategoriasta Varianttien hallinta ja paina Seuraava. Valitse seuraavalla sivulla Tuo perhemalli lähdekansioista ja paina Seuraava.
Valitse tuotavan lähdekoodin tyyppi
Ohjattu tuontitoiminto tulee näkyviin (katso kuva 1, "Ohjatun tuontitoiminnon sivu, jolla valitaan tuotavan lähdekoodin tyyppi"). Valitse tuotava projektityyppi ja paina Seuraava. Jokainen tyyppi sisältää ennalta määritetyn joukon file malliin tuotavat tyypit.
Kuva 1. Ohjatun tuontitoiminnon sivu, jolla voit valita tuotavan lähdekoodin tyypinValitse lähde ja kohde
Seuraavalla ohjatun toiminnon sivulla (Kuva 2, "Ohjatun tuontitoiminnon sivu tuonnin lähteen ja kohteen valitsemiseksi") lähdehakemisto ja kohdemalli on määritettävä.
Paina Selaa…-painiketta valitaksesi hakemiston, jossa on tuotava lähdekoodi. Oletuksena nykyinen työtila on valittuna, koska tämä saattaa olla hyödyllinen kohta navigoinnin aloittamisessa.
Alla voit määrittää sisällytä- ja poissulkemismallin. Näiden mallien on oltava säännöllisiä Java-lausekkeita. Jokainen syöttöpolku suhteessa lähteen juurikansioon tarkistetaan näillä kuvioilla. Jos sisällyttämismalli täsmää, kansio tuodaan, jos poissulkemismalli ei täsmää. Tämä tarkoittaa, että sisällyttäminen valitsee tuotavat kansiot etukäteen, mutta poissulkemiskuvio rajoittaa tätä esivalintaa.
Lähdekoodihakemiston valinnan jälkeen on määritettävä kohdemalli. Valitse siksi varianttiprojekti tai kansio, johon malli tulee tallentaa, ja anna mallin nimi. The file nimi laajenee automaattisesti .ccfm-tunnisteella, jos sitä ei ole annettu tässä valintaikkunassa. Oletuksena sille asetetaan sama nimi kuin itse mallin nimi. Tämä on suositeltu asetus.
Kun tarkoituksenmukainen lähdekansio ja haluttu mallinimi on määritetty, valintaikkuna voidaan lopettaa painamalla Valmis. Jos Seuraava-painiketta painetaan, avautuu uusi sivu, jolla voidaan tehdä lisäasetuksia.
Kuva 2. Ohjatun tuontitoiminnon sivu, josta voit valita tuonnin lähteen ja kohteenMuuta tuontiasetuksia
Viimeisellä ohjatun toiminnon sivulla (Kuva 3, "Ohjatun tuontitoiminnon sivu yksittäisen kokoonpanon määrittämistä varten) on asetuksia, joilla voidaan mukauttaa tuodun ohjelmistoprojektin tuontikäyttäytymistä.
Dialogisivulla näkyy taulukko, jossa file tyypit määritellään, jotka otetaan huomioon tuontiprosessissa.
Jokainen rivi koostuu neljästä kentästä.

• Kuvaus-kenttä sisältää lyhyen kuvailevan tekstin tunnistaaksesi file tyyppi.
• The File nimimallikenttää käytetään valitsemiseen files tuodaan, kun ne vastaavat kenttien arvoa. Kentässä käytetään seuraavaa syntaksia:

1. Yleisin käyttötapa voi olla a file laajennus. Tavallinen syntaksi on .EXT, jossa EXT on haluttu file laajennus (esim. .java).
2. Toinen yleinen tilanne on erityinen file, kuin merkkifile. Siksi on mahdollista täsmätä täsmällisesti file nimi. Voit tehdä tämän kirjoittamalla file nimi kenttään (esim. build.xml).
3. Joissakin tapauksissa kartoitustoiveet ovat tarkempia, joten vain files, jotka vastaavat erityistä kuviota, tulee tuoda. Tämän vaatimuksen täyttämiseksi on mahdollista käyttää säännöllisiä lausekkeita File nimikuviokenttä.
   Säännöllisten lausekkeiden syntaksin kuvaaminen ylittäisi tämän ohjeen tarkoituksen. Tutustu puhtaan::variantsin käyttöoppaan viiteluvun säännöllisiin lausekkeisiin (esim. .*).

• Yhdistetty elementtityyppi -kenttä määrittää yhdistämisen välillä a file tyyppi ja puhdas::variants-perheelementtityyppi. Perheelementtityyppi on lähteen kuvaaja file antaa lisätietoja tuodun mallin kartoitetulle elementille. Tyypillisiä valintoja ovat ps:class tai ps:makefile.
• Kartoitettu file tyyppi -kenttä määrittää kartoituksen välillä a file tyyppi ja puhdas::variantit file tyyppi. The file kirjoita pure::variants on lähteen kuvaaja file antaa lisätietoja tuodun mallin kartoitetulle elementille. Tyypilliset valinnat ovat impl toteutuksille tai def määrittelylle files.

Kuva 3. Ohjatun tuontitoiminnon sivu yksittäisen kokoonpanon määrittämiseksiUusi file tyyppejä voidaan lisätä käyttämällä Lisää kartoitus -painiketta. Kaikki kentät on täytetty arvolla undefined ja käyttäjän tulee täyttää ne. Jos haluat muokata kentän arvoa, napsauta kenttää hiirellä. Arvosta tulee muokattavissa ja sitä voidaan muuttaa. Oletusasetusta ei ole mahdollista muuttaa file taulukon nimimallit. Jos haluat tehdä mukauttamisesta joustavaa, on mahdollista poistaa valinta a file kirjoita poistamalla rivin valinta. Poistettu file nimimallit pysyvät asetuksissa, mutta tuoja ei käytä niitä. Käyttäjän määrittelemä file tyypit voidaan poistaa uudelleen käyttämällä Poista kartoitus -painiketta.
Oletuksena Muu files file nimimalli on saatavilla taulukossa, mutta sitä ei ole valittu. Yleensä kaikkia ei haluta tuoda files, mutta tätä voidaan helposti muuttaa valitsemalla vastaava rivi.
Tuojan toiminnan mukauttamiseen on kolme yleistä tuontivaihtoehtoa.

• Älä tuo hakemistoja ilman täsmäämistä files (esim. CVS-hakemistot).
  Jos maahantuoja löytää hakemiston, josta ei löydy hakua file on siinä ja jossa millään alihakemistolla ei ole vastaavaa file, hakemistoa ei tuoda. Tämä on usein hyödyllistä, jos projekteja hallinnoidaan versionhallintajärjestelmillä, kuten CVS. CVS:lle jokainen relevantti hakemisto sisältää CVS-hakemiston, jos sillä ei ole merkitystä files tallennetaan. Jos tämä vaihtoehto valitaan ja CVS-files eivät täsmää mihinkään file edellä määriteltyä tyyppiä, hakemistoa ei tuoda osana perhemalliin.
• Järjestellä files ja hakemistot.
  Ota tämä vaihtoehto käyttöön lajitellaksesi files ja hakemistot kukin aakkosjärjestyksessä.
• Tuontipolun käsittely.
  Lisäsynkronointia varten tuojan on tallennettava malliin kaikkien tuotujen elementtien alkuperäinen polku.
  Monissa tapauksissa perhemallit jaetaan muiden käyttäjien kanssa. Hakemistorakenne voi olla erilainen kullekin käyttäjälle. Yleisimpien käyttöskenaarioiden tukemiseksi maahantuoja voi toimia eri tiloissa:

Ehdoton	Tuodun elementin absoluuttinen polku tallennetaan malliin. Myöhempää synkronointia ja muunnoksen aikana varten files on sijoitettava täsmälleen samaan paikkaan kuin ensimmäisen tuonnin aikana.
Suhteessa Workspaceen	Polut tallennetaan suhteessa työtilakansioon. Synkronointia varten files on oltava osa Eclipse-työtilaa. Muunnoksen on käytettävä Eclipse-työtilaa syöttöhakemistona.
Projektiin suhteutettuna	Polut tallennetaan suhteessa projektiin. Synkronointia varten files ovat osa projektia Eclipsen sisällä. Muunnoksen tulee käyttää projektikansiota syöttöhakemistona.
Suhteessa Pathiin	Polut tallennetaan suhteessa annettuun polkuun. Synkronointia varten files on sijoitettava täsmälleen samaan paikkaan. Muutoksen syöttöhakemisto on sama kuin suhteellinen polku tuonnin aikana.

Kaikki tämän valintaikkunan asetukset tallennetaan pysyvästi. Henkilökohtaisia ​​mukautuksia ei saa tehdä uudelleen joka kerta, kun tuonti suoritetaan. Tämä tekee tuonnin työnkulusta helppoa ja nopeaa.
2.3. Mallien päivittäminen hakemistopuusta
Paina Synkronoi-painiketta synkronoidaksesi tuodun mallin sen hakemistopolun kanssa. Projektin juuripolku on tallennettu malliin, joten se synkronoituu samaan hakemistoon kuin ennenkin. Ota Synkronoi-painike käyttöön avaamalla malli ja valitsemalla mikä tahansa elementti. Synkronoi-painikkeen painamisen jälkeen avautuu vertailueditori, jossa nykyinen perhemalli ja nykyisen hakemistorakenteen malli ovat vastakkain (katso Kuva 4, "Mallin päivitys hakemistopuusta vertailueditorissa").
Kuva 4. Mallin päivitys hakemistopuusta vertailueditorissa   Vertailueditoria käytetään kaikissa pure::variantsissa malliversioiden vertaamiseen, mutta tässä tapauksessa sitä käytetään fyysisen hakemistorakenteen (näkyy oikeassa alakulmassa) vertaamiseen nykyiseen pure::variants-malliin (vasemmalla alapuolella). Kaikki muutokset luetellaan erillisinä kohteina editorin yläosassa, järjestyksessä vaikuttavien elementtien mukaan.
Kohteen valitseminen tästä luettelosta korostaa molempien mallien vastaavan muutoksen. Example, lisätty elementti on merkitty oikealla puolella olevalla laatikolla ja yhdistetty sen mahdolliseen sijaintiin mallissa vasemmalla puolella. Ylemmän ja alemman editori-ikkunoiden yhdistämistyökalurivi tarjoaa työkalut yksittäisten tai jopa kaikkien (ei-ristiriitaisten) muutosten kopioimiseen kokonaisuutena hakemistopuumallista ominaisuusmalliin.
Huom
Synkronointi tehdään viimeksi käytettyjen maahantuoja-asetusten kanssa. Tämä mahdollistaa mallin päivittämisen muilla asetuksilla, jotka on tehty tuonnin aikana.

Relation Indexerin käyttäminen

Lähdekoodin hallinnan liitin parantaa suhteita View jossa on tietoa pure::variants-mallin elementtien ja lähdekoodin välisistä yhteyksistä. Relaatiot lisätään ominaisuuksille, joita käytetään ps:condxml- ja ps:condtext-elementtien olosuhteissa.
ps:lippu ja ps:lippufile elementit esiprosessorin vakioiden sijainti C/C++-lähteessä files näytetään. Lisäksi yhteensopivien esiprosessorin vakioiden sijainnit näytetään valitulle ominaisuudelle käyttämällä ominaisuuden yksilöllisten nimien ja esiprosessorin vakioiden välistä kartoitusta.
3.1. Suhdeindeksin lisääminen projektiin
Relaatioindeksin voi aktivoida erityisellä projektin ominaisuussivulla. Valitse projekti ja valitse pikavalikosta Ominaisuudet. Valitse tulevasta valintaikkunasta Relation Indexer -sivu.
Kuva 5. Relation Indexerin projektin ominaisuussivu

Relaatioindeksi aktivoidaan projektille valitsemalla Ota Relation Indexer käyttöön -vaihtoehto (1). Indeksoijan käyttöönoton jälkeen on vielä joitain vaihtoehtoja projektikohtaisen toiminnan määrittämiseen. Pure::variants Conditions- ja C/C++ Preprocessor Constants -indeksien indeksointi voidaan aktivoida erikseen (2). Lista kanssa file nimikuvioita (3) käytetään valitsemaan files indeksointiin. Vain files, jotka vastaavat yhtä kuvioista, skannataan. Lisää "*" kuvioksi skannataksesi kaikki files projektista.
Projektin indeksoijan aktivoinnin jälkeen projektiin lisätään rakentaja. Tämän rakentajan skannaukset muuttuivat files uusille suhteille pure::variants-mallin elementteihin automaattisesti.
3.2. Suhteet lähdekoodiin
Aktivoidulla relaatioindeksillä Relations View sisältää lisämerkintöjä. Näissä merkinnöissä näkyy nimi file ja varianttipisteen rivinumero. Työkalun kärjessä näkyy sopiva osa file. Kaksoisnapsauttamalla merkintää file avataan editoriin.
puhdas::variantit Olosuhteet
Pure::variants-ehtoa voidaan käyttää sisällyttämään tai jättämään pois a:n osia file riippuen ominaisuusvalinnasta. Kuntoindeksoija etsii tällaisia ​​sääntöjä ja poimii viitatut ominaisuudet. Jos tällainen ominaisuus on valittu editorissa Relations View näyttää kaikki files ja rivit, joissa ehto valitulla ominaisuudella sijaitsee (katso kuva 6, "Ehdon esitys suhteissa View”).
Kuva 6. Ehdon esitys suhteissa ViewYksityiskohtaisen selvityksen ehtojen määrittämisestä saat pure::variantsin käyttöoppaan luvun 9.5.7 osiosta ps:condtext (Viite–>Ennalta määritetyt lähdeelementtityypit–>ps:condtext).
C/C++ esiprosessorin vakiot
C/C++ Preprocessor Indexer skannaa files esikäsittelysäännöissä käytetyille vakioille (esim. #ifdef, #ifndef, …).
Jos ps:lippu tai ps:lippufile -elementti on valittu Relations View näyttää määritellyn esiprosessorin vakion käytön.
Suhteet View näyttää myös esiprosessorin vakiot, jotka on yhdistetty ominaisuuksiin kartoituskuvioiden avulla. Tätä varten kuvioita laajennetaan valitun ominaisuuden tiedoilla. Tuloksena olevia symboleja käytetään vastaavien esiprosessorin vakioiden etsimiseen. Kuva 7, “C/C++-esiprosessorin vakion esitys suhteissa View” näyttää example mallilla fame{Nimi}. Mallia on laajennettu ominaisuuden ainutlaatuisella nimellä fameNative. Indeksoidussa koodissa on 76 paikkaa, joissa käytetään esiprosessorin vakiota fameNative.
Nämä sijainnit näkyvät Suhteet-kohdassa View. Mallit voidaan määrittää asetuksissa (katso Kohta 3.3, "Asetukset").
Kuva 7. C/C++-esiprosessorin vakion esitys relaatioissa View

3.3. Asetukset
Jos haluat muuttaa indeksoijan oletustoimintoa, avaa Eclipse-asetukset ja valitse Relation Indexer -sivu Varianttien hallinta -luokasta. Sivulla on kaksi luetteloa.
Kuva 8. Relaatioindeksin asetussivuYlempi luettelo sisältää oletusarvon file kuviot indeksoijalle (1). Tämä luettelo on ensimmäinen malliasetus äskettäin käyttöön otetuille projekteille.
Alempi lista sisältää ominaisuuksien ja esiprosessorin vakioiden välisen kuvauksen (2). Tätä kartoitusta käytetään kaikissa projekteissa. Taulukko 1, "Tuetut kartoituskorvaukset" näyttää kaikki mahdolliset korvaukset.
Taulukko 1. Tuetut kartoituskorvaukset

Jokerimerkki	Kuvaus	Example: OminaisuusA
Nimi	valitun ominaisuuden yksilöllinen nimi	FLAG_{Nimi} – FLAG_FeatureA
NIMI	isoilla kirjaimilla valitun ominaisuuden yksilöllinen nimi	FLAG_{NAME} – FLAG_FEATUREA
nimi	pienet kirjaimet valitun ominaisuuden yksilöllinen nimi	lippu_{nimi} – lippu_ominaisuus

Asiakirjat / Resurssit

pure-systems 2024 -liitin lähdekoodinhallintaohjelmistoon [pdfKäyttöopas 2024, 2024 Liitin lähdekoodin hallintaohjelmistolle, liitin lähdekoodin hallintaohjelmistolle, lähdekoodin hallintaohjelmisto, hallintaohjelmisto, ohjelmisto

Viitteet

• Käyttöopas