pure::variants – priključek za
Priročnik za upravljanje izvorne kode
Parametric Technology GmbH
Različica 6.0.7.685 za pure::variants 6.0
Avtorske pravice © 2003-2024 Parametric Technology GmbH
2024

Uvod

pure::variants Connector za upravljanje izvorne kode (Connector) razvijalcem omogoča upravljanje spremenljivosti izvorne kode z uporabo pure::variants. Upravljanje izvorne kode pure::variants ponuja prilagodljivo priložnost za sinhronizacijo struktur imenikov in izvorne kode fileenostavno z modeli pure::variants. Tako je upravljanje variant mogoče uporabiti tudi pri kompleksnih programskih projektih. Poleg tega lahko povezave med funkcijami pure::variants in izvorno kodo lažje upravljate z graditeljem in so zelo dostopne prek upravljanja izvorne kode.
1.1. Zahteve za programsko opremo
Pure::variants Connector za upravljanje izvorne kode je razširitev za pure::variants in je na voljo na vseh podprtih platformah.
1.2. Namestitev
Prosimo, glejte razdelek pure::variants Connectors v pure::variants Setup Guide za podrobne informacije o tem, kako namestiti konektor (meni Pomoč -> Vsebina pomoči in nato pure::variants Setup Guide -> pure::variants Connectors).
1.3. O tem priročniku
Od bralca se pričakuje, da ima osnovno znanje in izkušnje s čistimi::variantami. Pred branjem tega priročnika si oglejte uvodno gradivo. Priročnik je na voljo v spletni pomoči in v formatu PDF za tiskanje tukaj.

Uporaba priključka

2.1. Začetek pure::variants
Odvisno od uporabljenega načina namestitve bodisi zaženite Eclipse, ki podpira pure::variants, ali v sistemu Windows izberite postavko pure::variants v meniju programa.
Če perspektiva upravljanja različic še ni aktivirana, jo izberite v možnosti Odpri perspektivo->Drugo… v meniju Okno.
2.2. Uvozite imeniško drevo v družinski model
Pred uvozom drevesa imenikov v družinski model je treba ustvariti projekt različic. Priporočljivo je tudi, da so funkcije že definirane v modelu funkcij. Za pomoč glede teh korakov si oglejte dokumentacijo pure::variants.
Dejanski uvoz se začne z izbiro dejanja Uvozi… v kontekstnem meniju Projekti view ali z menijem Uvozi… v File meni. V kategoriji Variant Management izberite Variant Models ali Projects in pritisnite Next. Na naslednji strani izberite Uvoz družinskega modela iz izvornih map in znova pritisnite Naprej.
Izberite vrsto izvorne kode za uvoz
Prikaže se čarovnik za uvoz (glejte sliko 1, »Stran čarovnika za uvoz za izbiro vrste izvorne kode, ki jo je mogoče uvoziti«). Izberite vrsto projekta za uvoz in pritisnite Naprej. Vsaka vrsta vsebuje vnaprej določen niz file vrste za uvoz v model.
Slika 1. Stran čarovnika za uvoz za izbiro vrste izvorne kode, ki jo je mogoče uvozitiIzberite Vir in Cilj
Na naslednji strani čarovnika (Slika 2, »Stran čarovnika za uvoz za izbiro vira in cilja za uvoz«) morata biti navedena izvorni imenik in ciljni model.
Pritisnite gumb Prebrskaj ..., da izberete imenik, kjer obstaja izvorna koda, ki jo želite uvoziti. Privzeto je izbran trenutni delovni prostor, ker je to lahko koristna točka za začetek navigacije.
Spodaj lahko določite vzorec vključitve in izključitve. Ti vzorci morajo biti regularni izrazi Java. Vsaka vhodna pot glede na izvorno korensko mapo se preveri s tem vzorcem. Če se vzorec vključitve ujema, se mapa uvozi, če se vzorec izključitve ne ujema. Kar pomeni, da vzorec za vključitev vnaprej izbere mape za uvoz, vzorec za izključitev to vnaprejšnjo izbiro omeji.
Po izbiri imenika izvorne kode je treba definirati ciljni model. Zato izberite variantni projekt ali mapo, kjer naj bo model shranjen, in vnesite ime modela. The file ime se samodejno razširi s pripono .ccfm, če ni navedena v tem pogovornem oknu. Privzeto bo nastavljeno na isto ime kot ime modela. To je priporočena nastavitev.
Ko določite primerno izvorno mapo in želeno ime modela, lahko pogovorno okno zaključite s pritiskom na Dokončaj. Če pritisnete gumb Naprej, se prikaže nadaljnja stran, kjer lahko izvedete dodatne nastavitve.
Slika 2. Stran čarovnika za uvoz za izbiro vira in cilja za uvozSpremenite nastavitve uvoza
Na zadnji strani čarovnika (Slika 3, »Stran čarovnika za uvoz za definiranje posamezne konfiguracije«) obstajajo nastavitve, s katerimi lahko prilagodite vedenje uvoza za projekt uvožene programske opreme.
Stran pogovornega okna prikazuje tabelo, kjer je file določene vrste, ki jih bo upošteval postopek uvoza.
Vsaka vrstica je sestavljena iz štirih polj.

• Polje Opis vsebuje kratko opisno besedilo za prepoznavanje file vrsta.
• The File polje z vzorcem imena se uporablja za izbiro files, ki jih je treba uvoziti, ko se ujemajo z vrednostjo polj. Polje uporablja naslednjo sintakso:

1. Najpogostejši primer uporabe je lahko a file razširitev. Običajna sintaksa je .EXT, kjer je EXT želeno file razširitev (npr. .java).
2. Druga pogosta situacija je posebna file, kot izdelavafile. Zato je možno natančno ujemanje file ime. Če želite to narediti, samo vnesite file ime v polje (npr. build.xml).
3. V nekaterih primerih so želje po preslikavi bolj specifične, torej le fileki se ujemajo s posebnim vzorcem, je treba uvoziti. Za izpolnjevanje te zahteve je mogoče uporabiti regularne izraze v File polje vzorca imena.
   Opis sintakse regularnih izrazov bi presegel namen te pomoči. Oglejte si razdelek o regularnih izrazih v referenčnem poglavju v uporabniškem priročniku pure::variants (npr. .*).

• Polje Vrsta preslikanega elementa nastavi preslikavo med a file tip in tip elementa družine pure::variants. Tip družinskega elementa je deskriptor za vir file za zagotavljanje dodatnih informacij preslikanemu elementu v uvoženem modelu. Tipični izbori so ps:class ali ps:makefile.
• Zemljevid file polje tipa nastavi preslikavo med a file tip in čiste::variante file vrsto. The file type in pure::variants je deskriptor za vir file za zagotavljanje dodatnih informacij preslikanemu elementu v uvoženem modelu. Tipične izbire so impl za implementacije ali def za definicijo files.

Slika 3. Stran čarovnika za uvoz za definiranje posamezne konfiguracijeNovo file vrste lahko dodate z uporabo gumba Dodaj preslikavo. Vsa polja so izpolnjena z vrednostjo undefined in jih mora izpolniti uporabnik. Če želite urediti vrednost v polju, kliknite na polje z miško. Vrednost postane urejena in jo je mogoče spremeniti. Privzetih nastavitev ni mogoče spremeniti file vzorci imen tabele. Da bi bila prilagoditev prilagodljiva, je mogoče preklicati izbiro a file vnesite tako, da prekličete izbiro vrstice. Preklican izbor file vzorci imen ostanejo v konfiguraciji, vendar jih uvoznik ne bo uporabil. Uporabniško določeno file vrste lahko znova odstranite z gumbom Odstrani preslikavo.
Privzeto je Drugo files file vzorec imena je na voljo v tabeli, vendar ni izbran. Običajno se ne želi uvoziti vseh files, vendar je to mogoče enostavno spremeniti z izbiro ustrezne vrstice.
Obstajajo tri splošne možnosti uvoza za prilagajanje vedenja uvoznika.

• Ne uvažajte imenikov brez ujemanja files (npr. imeniki CVS).
  Če uvoznik najde imenik, v katerem ni ujemanja file je v njem in kjer noben podimenik nima ustreznega file, imenik ne bo uvožen. To je pogosto uporabno, če projekte upravljajo sistemi za upravljanje različic, kot je CVS. Za CVS vsak ustrezen imenik vsebuje imenik CVS, kjer to ni pomembno files so shranjeni. Če je ta možnost izbrana in CVS-files se ne ujemajo z nobenim file tip, definiran zgoraj, imenik ne bo uvožen kot komponenta v družinski model.
• Razvrsti files in imeniki.
  Omogočite to možnost za razvrščanje files in imeniki po abecednem vrstnem redu.
• Obravnava uvozne poti.
  Za nadaljnjo sinhronizacijo mora uvoznik shraniti originalno pot vseh uvoženih elementov v model.
  V mnogih primerih se družinski modeli delijo z drugimi uporabniki. Struktura imenika je lahko drugačna za vsakega uporabnika. Za podporo najpogostejših scenarijev uporabe lahko uvoznik deluje v različnih načinih:

Absolutno	Absolutna pot do uvoženega elementa bo shranjena v model. Za poznejšo sinhronizacijo in med transformacijo filejih je treba postaviti na popolnoma isto mesto kot med prvim uvozom.
Glede na delovni prostor	Poti so shranjene glede na mapo delovnega prostora. Za sinhronizacijo files mora biti del delovnega prostora Eclipse. Transformacija mora uporabiti delovni prostor Eclipse kot vhodni imenik.
Glede na projekt	Poti so shranjene glede na projekt. Za sinhronizacijo fileso del projekta znotraj Eclipse. Transformacija mora uporabiti mapo projekta kot vhodni imenik.
Glede na pot	Poti so shranjene glede na dano pot. Za sinhronizacijo filejih je treba postaviti na povsem isto mesto. Vhodni imenik transformacije je enak relativni poti med uvozom.

Vse nastavitve tega pogovornega okna so trajno shranjene. Osebne prilagoditve se ne smejo ponovno izvesti vsakič, ko se izvaja uvoz. Zaradi tega je potek dela uvoza enostaven in hiter.
2.3. Posodabljanje modelov iz drevesa imenikov
Pritisnite gumb Sinhroniziraj za sinhronizacijo uvoženega modela z njegovo potjo do imenika. Korenska pot projekta je shranjena v modelu, tako da se bo sinhroniziral z istim imenikom kot prej. Če želite omogočiti gumb Sinhroniziraj, odprite model in izberite kateri koli element. Po pritisku na gumb Sinhroniziraj se odpre urejevalnik primerjave, kjer sta trenutni družinski model in model trenutne strukture imenika nasproti (glejte sliko 4, »Posodobitev modela iz drevesa imenikov v urejevalniku primerjave«).
Slika 4. Posodobitev modela iz drevesa imenikov v urejevalniku primerjav   Urejevalnik za primerjavo se uporablja v celotni različici pure::variants za primerjavo različic modela, vendar se v tem primeru uporablja za primerjavo strukture fizičnega imenika (prikazano na spodnji desni strani) s trenutnim modelom pure::variants (spodnja leva stran). Vse spremembe so navedene kot ločene postavke v zgornjem delu urejevalnika, razvrščene po zadevnih elementih.
Izbira elementa na tem seznamu poudari zadevno spremembo v obeh modelih. V bivšemample je dodani element označen s kvadratkom na desni strani in povezan z njegovim izvedljivim položajem v modelu na levi strani. Orodna vrstica za spajanje med zgornjim in spodnjim oknom urejevalnika ponuja orodja za kopiranje posameznih ali celo vseh (nekonfliktnih) sprememb kot celote iz modela drevesa imenikov v model funkcij.
Opomba
Sinhronizacija se izvede z zadnjimi uporabljenimi nastavitvami uvoznika. To omogoča posodobitev modela z drugimi nastavitvami, ki so bile narejene med uvozom.

Uporaba indeksa relacije

Konektor za upravljanje izvorne kode izboljša odnose View z informacijami o povezavah med elementi modela pure::variants in izvorno kodo. Dodane so relacije za funkcije, ki se uporabljajo v pogojih elementov ps:condxml in ps:condtext.
Za ps:flag in ps:flagfile elementi lokacijo konstant predprocesorja v izvoru C/C++ files so prikazani. Poleg tega so lokacije ujemajočih se konstant predprocesorja prikazane za izbrano funkcijo z uporabo preslikave med edinstvenimi imeni funkcij in konstantami predprocesorja.
3.1. Dodajanje kazalnika relacije projektu
Indeksator relacije je mogoče aktivirati na posebni strani z lastnostmi projekta. Izberite projekt in v kontekstnem meniju izberite element Lastnosti. V prihajajočem pogovornem oknu izberite stran Relation Indexer.
Slika 5. Stran z lastnostmi projekta za kazalnik relacije

Indeksator relacij se za projekt aktivira z izbiro možnosti Omogoči indekser relacij (1). Ko omogočite indeksator, je na voljo še nekaj možnosti za definiranje specifičnega vedenja projekta. Indeksiranje pogojev pure::variants in konstant predprocesorja C/C++ je mogoče aktivirati ločeno (2). Seznam z file vzorci imen (3) se uporabljajo za izbiro files za indeksiranje. Samo fileki se ujemajo z enim od vzorcev, se skenirajo. Dodajte »*« kot vzorec za skeniranje vseh files projekta.
Po aktiviranju indekserja za projekt se projektu doda graditelj. Skeniranje tega graditelja je spremenjeno files za nove relacije do elementov modela pure::variants samodejno.
3.2. Odnosi do izvorne kode
Z aktiviranim indeksatorjem relacij se Relations View vsebuje dodatne vnose. Ti vnosi prikazujejo ime file in številko vrstice variantne točke. Namig orodja prikazuje ustrezen razdelek file. Z dvojnim klikom na vnos file se odpre v urejevalniku.
pure::variants Pogoji
Pogoj pure::variants lahko uporabite za vključitev ali izključitev delov a file odvisno od izbire funkcije. Indeksator pogojev poišče taka pravila in izvleče referenčne funkcije. Če je taka funkcija izbrana v urejevalniku Relations View bo pokazal vse files in črte, kjer se nahaja pogoj z izbrano funkcijo (glejte sliko 6, »Predstavitev pogoja v relacijah View«).
Slika 6. Predstavitev pogoja v relacijah ViewČe želite dobiti podrobno razlago o tem, kako definirati pogoje, si oglejte razdelek ps:condtext v poglavju 9.5.7 uporabniškega priročnika pure::variants (Referenca–>Preddefined Source Element Types–>ps:condtext).
Konstante predprocesorja C/C++
Indeksator predprocesorja C/C++ skenira files za konstante, ki se uporabljajo v pravilih predprocesorja (npr. #ifdef, #ifndef, …).
Če je ps:flag ali ps:flagfile je izbran element Relations View prikazuje uporabo definirane konstante predprocesorja.
Odnosi View prikazuje tudi konstante predprocesorja, povezane s funkcijami z uporabo vzorcev preslikave. V ta namen se vzorci razširijo s podatki izbrane funkcije. Dobljeni simboli se uporabljajo za iskanje ujemajočih se konstant predprocesorja. Slika 7, »Predstavitev konstante predprocesorja C/C++ v relacijah View« pokaže bivšiample z vzorcem fame{Name}. Vzorec je razširjen z edinstvenim imenom funkcije v fameNative. V indeksirani kodi je 76 lokacij, kjer se uporablja konstanta predprocesorja fameNative.
Te lokacije so prikazane v Relacijah View. Vzorce je mogoče določiti v nastavitvah (glejte razdelek 3.3, »Nastavitve«).
Slika 7. Predstavitev konstante predprocesorja C/C++ v relacijah View

3.3. Nastavitve
Če želite spremeniti privzeto vedenje indekserja, odprite nastavitve Eclipse in izberite stran Relation Indexer v kategoriji Variant Management. Stran prikazuje dva seznama.
Slika 8. Stran z nastavitvami kazalnika relacijZgornji seznam vsebuje privzeto file vzorce za indekser (1). Ta seznam je začetna nastavitev vzorca za na novo omogočene projekte.
Spodnji seznam vsebuje preslikavo med funkcijami in konstantami predprocesorja (2). Ta preslikava se uporablja za vse projekte. Tabela 1, »Podprte zamenjave preslikav« prikazuje vse možne zamenjave.
Tabela 1. Podprte zamenjave preslikav

Nadomestni znak	Opis	Example: funkcijaA
Ime	edinstveno ime izbrane funkcije	FLAG_{Ime} – FLAG_FeatureA
IME	Edinstveno ime izbrane funkcije z velikimi črkami	FLAG_{NAME} – FLAG_FEATUREA
ime	Edinstveno ime izbrane funkcije z malimi črkami	zastava_{ime} – funkcija_zastave

Dokumenti / Viri

pure-systems 2024 Connector za programsko opremo za upravljanje izvorne kode [pdfUporabniški priročnik 2024, 2024 priključek za programsko opremo za upravljanje izvorne kode, priključek za programsko opremo za upravljanje izvorne kode, programska oprema za upravljanje izvorne kode, programska oprema za upravljanje, programska oprema

Reference

• Uporabniški priročnik