pure::variants – Konektor za
Priručnik za upravljanje izvornim kodom
Parametric Technology GmbH
Verzija 6.0.7.685 za pure::varijante 6.0
Autorsko pravo © 2003-2024 Parametric Technology GmbH
2024

Uvod

pure::variants Konektor za upravljanje izvornim kodom (konektor) omogućava programerima da upravljaju varijabilnošću izvornog koda koristeći pure::variants. Upravljanje izvornim kodom pure::varijanti pruža fleksibilnu priliku za sinhronizaciju struktura direktorija i izvornog koda filelako sa modelima pure::variants. Na taj način se varijantno upravljanje može primijeniti izvodljivo čak i na složene softverske projekte. Štaviše, veze između pure::variants karakteristika i izvornog koda mogu se lakše upravljati pomoću graditelja i vrlo su dostupne putem upravljanja izvornim kodom.
1.1. Softverski zahtjevi
Pure::variants konektor za upravljanje izvornim kodom je proširenje za pure::variants i dostupan je na svim podržanim platformama.
1.2. Instalacija
Molimo pogledajte odjeljak pure::variants Konektori u Pure::variants Vodiču za postavljanje za detaljne informacije o tome kako instalirati konektor (meni Help -> Help Contents, a zatim pure::variants Vodič za postavljanje -> pure::variants Connectors).
1.3. O ovom priručniku
Od čitaoca se očekuje da ima osnovna znanja i iskustva sa pure::varijantama. Prije čitanja ovog priručnika pogledajte njegov uvodni materijal. Priručnik je dostupan u online pomoći, kao iu PDF formatu za ispis ovdje.

Korišćenje konektora

2.1. Počinje pure::variants
U zavisnosti od korišćenog načina instalacije ili pokrenite pure::variants-enabled Eclipse ili pod Windowsom izaberite pure::variants stavku iz menija programa.
Ako perspektiva upravljanja varijantama već nije aktivirana, učinite to tako što ćete je izabrati iz Open Perspective->Other… u meniju Prozor.
2.2. Uvezite stablo imenika u porodični model
Prije uvoza stabla direktorija u porodični model, potrebno je kreirati projekt varijanti. Takođe je sugestivno da se karakteristike već definišu u modelu karakteristika. Za pomoć oko ovih koraka pogledajte dokumentaciju pure::variants.
Stvarni uvoz se pokreće odabirom akcije Import... bilo u kontekstualnom meniju Projekti view ili sa menijem Uvoz... u File meni. Odaberite Variant Models ili Projects iz kategorije Variant Management i pritisnite Next. Na sljedećoj stranici odaberite Uvezi porodični model iz izvornih mapa i ponovo pritisnite Sljedeće.
Odaberite vrstu izvornog koda za uvoz
Pojavljuje se čarobnjak za uvoz (pogledajte sliku 1, „Stranica čarobnjaka za uvoz za odabir vrste izvornog koda koji se može uvesti”). Odaberite tip projekta za uvoz i pritisnite Next. Svaki tip sadrži unaprijed definirani skup file vrste za uvoz u model.
Slika 1. Stranica čarobnjaka za uvoz za odabir tipa izvornog koda koji se može uvestiOdaberite Izvor i cilj
Na sljedećoj stranici čarobnjaka (Slika 2, “Stranica čarobnjaka za uvoz za odabir izvora i cilja za uvoz”) izvorni direktorij i ciljni model moraju biti specificirani.
Pritisnite dugme Browse… da izaberete direktorijum u kome postoji izvorni kod koji treba da se uveze. Podrazumevano je odabran trenutni radni prostor jer bi ovo moglo biti korisna tačka za početak navigacije.
U nastavku možete odrediti uzorak uključivanja i isključivanja. Ovi šabloni moraju biti java regularni izrazi. Svaka ulazna putanja, u odnosu na izvorni korijenski folder, provjerava se ovim uzorkom. Ako se uzorak uključivanja podudara, mapa se uvozi, ako se uzorak isključivanja ne podudara. Što znači da uzorak uključivanja unaprijed odabire mape za uvoz, uzorak isključivanja ograničava ovaj predizbor.
Nakon odabira direktorija izvornog koda, ciljni model mora biti definiran. Stoga odaberite varijantu projekta ili mapu u kojoj bi model trebao biti pohranjen i unesite naziv modela. The file ime se automatski proširuje ekstenzijom .ccfm ako nije dato u ovom dijalogu. Podrazumevano će biti postavljeno na isto ime kao i sam naziv modela. Ovo je preporučena postavka.
Nakon što se specificiraju korisni izvorni folder i naziv željenog modela, dijalog se može završiti pritiskom na Završi. Ako se pritisne dugme Dalje, otvara se sledeća stranica na kojoj se mogu izvršiti dodatna podešavanja.
Slika 2. Stranica čarobnjaka za uvoz za odabir izvora i cilja za uvozPromijenite postavke uvoza
Na posljednjoj stranici čarobnjaka (Slika 3, „Stranica čarobnjaka za uvoz za definisanje pojedinačne konfiguracije”) postoje postavke koje se mogu učiniti za prilagođavanje ponašanja uvoza za uvezeni softverski projekat.
Stranica dijaloga prikazuje tabelu u kojoj je file definisani su tipovi, koji će se uzeti u obzir u procesu uvoza.
Svaki red se sastoji od četiri polja.

• Polje Opis sadrži kratak opisni tekst za identifikaciju file tip.
• The File ime šablona se koristi za odabir files koje treba uvesti kada se poklapaju sa vrijednostima polja. Polje koristi sljedeću sintaksu:

1. Najčešći slučaj upotrebe može biti a file proširenje. Uobičajena sintaksa je .EXT, gdje je EXT željeni file proširenje (npr. .java).
2. Druga uobičajena situacija je posebna file, kao markafile. Stoga je moguće tačno podudarati file ime. Da biste to učinili, samo unesite file ime u polje (npr. build.xml).
3. U nekim slučajevima su želje za mapiranjem konkretnije, dakle samo files koji se podudaraju s posebnim uzorkom treba uvesti. Da bi se ispunili ovaj zahtjev, moguće je koristiti regularne izraze u File polje obrasca imena.
   Opisivanje sintakse regularnih izraza premašilo bi namjeru ove pomoći. Molimo pogledajte odeljak regularnih izraza u referentnom poglavlju u korisničkom vodiču pure::variants (npr. .*).

• Polje tipa mapirani element postavlja mapiranje između a file tip i tip elementa porodice pure::variants. Tip elementa porodice je deskriptor za izvor file da pruži dodatne informacije mapiranom elementu u uvezenom modelu. Tipični odabiri su ps:class ili ps:makefile.
• The Mapped file polje tipa postavlja mapiranje između a file tip i čiste::varijante file tip. The file tip u pure::variants je deskriptor za izvor file da pruži dodatne informacije mapiranom elementu u uvezenom modelu. Tipični odabiri su impl za implementacije ili def za definiciju files.

Slika 3. Stranica čarobnjaka za uvoz za definiranje pojedinačne konfiguracijeNovo file tipovi se mogu dodati pomoću dugmeta Dodaj mapiranje. Sva polja se popunjavaju nedefiniranom vrijednošću i mora ih popuniti korisnik. Da biste uredili vrijednost u polju, samo kliknite na polje mišem. Vrijednost se može uređivati ​​i može se mijenjati. Nije moguće promijeniti zadanu vrijednost file obrasci naziva tabele. Da bi prilagođavanje bilo fleksibilno, moguće je poništiti odabir a file otkucajte poništavanjem odabira reda. Poništen odabir file obrasci imena ostaju u konfiguraciji, ali ih uvoznik neće koristiti. Korisnički definiran file tipovi se mogu ponovo ukloniti pomoću dugmeta Ukloni mapiranje.
Podrazumevano drugo files file obrazac imena je dostupan u tabeli, ali je poništen. Obično se ne želi uvesti sve files, ali to se može lako promijeniti odabirom odgovarajućeg reda.
Postoje tri opšte opcije uvoza za prilagođavanje ponašanja uvoznika.

• Nemojte uvoziti direktorije bez podudaranja files (npr. CVS direktoriji).
  Ako uvoznik pronađe direktorij u kojem nema podudaranja file nalazi se u njemu i gdje nijedan poddirektorij nema podudaranja file, direktorij neće biti uvezen. Ovo je često korisno ako projektima upravljaju sistemi za upravljanje verzijama kao što je CVS. Za CVS, svaki relevantni direktorij sadrži CVS-direktorij gdje je irelevantan files se pohranjuju. Ako je ova opcija odabrana i CVS-files se ne podudaraju ni sa jednim file tipa definiranog gore, direktorij se neće uvoziti kao komponenta u porodični model.
• Sortiraj files i direktorije.
  Omogućite ovu opciju za sortiranje files i direktorije svaki po abecednom redu.
• Rukovanje putanjom uvoza.
  Za dalju sinhronizaciju uvoznik treba da pohrani originalnu putanju svih uvezenih elemenata u model.
  U mnogim slučajevima porodični modeli se dijele s drugim korisnicima. Struktura direktorija može biti različita za svakog korisnika. Kako bi podržao najčešće scenarije upotrebe, uvoznik može raditi na različite načine:

Apsolutno	Apsolutna putanja do uvezenog elementa će biti pohranjena u model. Za kasniju sinhronizaciju i tokom transformacije filemoraju se postaviti na potpuno istu lokaciju kao i prilikom prvog uvoza.
U odnosu na radni prostor	Putanja se pohranjuju u odnosu na folder radnog prostora. Za sinhronizaciju files mora biti dio Eclipse radnog prostora. Transformacija mora koristiti Eclipse radni prostor kao ulazni direktorij.
U odnosu na projekat	Staze se pohranjuju u odnosu na projekat. Za sinhronizaciju files su dio projekta unutar Eclipsea. Transformacija mora koristiti direktorij projekta kao ulazni direktorij.
U odnosu na put	Staze se pohranjuju u odnosu na datu putanju. Za sinhronizaciju filemoraju biti postavljeni na potpuno istoj lokaciji. Ulazni direktorij transformacije je isti kao relativna staza za vrijeme uvoza.

Sve postavke ovog dijaloga se stalno pohranjuju. Lične prilagodbe ne smiju se ponavljati svaki put kada se uvoz pokrene. To čini tok rada uvoza lakim i brzim.
2.3. Ažuriranje modela iz stabla direktorija
Pritisnite dugme Sinhronizuj za sinkronizaciju uvezenog modela s njegovom putanjom direktorija. Osnovni put projekta je pohranjen u modelu tako da će se sinkronizirati u isti direktorij kao i prije. Da biste omogućili dugme Sinhroniziraj, otvorite model i odaberite bilo koji element. Nakon pritiska na tipku Synchronize otvara se Compare Editor u kojem se suprotstavljaju trenutni model porodice i model trenutne strukture direktorija (pogledajte sliku 4, “Ažuriranje modela iz stabla direktorija u uređivaču za usporedbu”).
Slika 4. Ažuriranje modela iz stabla direktorija u uređivaču usporedbi   Uređivač za usporedbu se koristi u pure::varijantama za upoređivanje verzija modela, ali se u ovom slučaju koristi za poređenje fizičke strukture direktorija (prikazano u donjem desnom dijelu) sa trenutnim pure::variants modelom (donja lijeva strana). Sve promjene su navedene kao zasebne stavke u gornjem dijelu uređivača, poređane prema zahvaćenim elementima.
Odabirom stavke na ovoj listi ističe se odgovarajuća promjena u oba modela. U exampLe, dodani element je označen okvirom na desnoj strani i povezan sa svojom izvodljivom pozicijom u modelu sa leve strane. Traka sa alatkama za spajanje između gornjeg i donjeg prozora uređivača pruža alate za kopiranje pojedinačnih ili čak svih (nekonfliktnih) promjena u cjelini iz modela stabla direktorija u model karakteristika.
Napomena
Sinhronizacija se vrši s posljednjim korištenim postavkama uvoznika. Ovo omogućava ažuriranje modela drugim postavkama koje su napravljene tokom uvoza.

Korištenje Relation Indexer

Konektor za upravljanje izvornim kodom poboljšava odnose View sa informacijama o vezama između elemenata modela pure::variants i izvornog koda. Relacije se dodaju za karakteristike koje se koriste u uslovima elemenata ps:condxml i ps:condtext.
Za ps:flag i ps:flagfile elementi lokacije predprocesorskih konstanti u C/C++ izvoru files su prikazani. Osim toga, lokacije odgovarajućih konstanti pretprocesora prikazane su za odabranu karakteristiku korištenjem mapiranja između jedinstvenih imena karakteristika i konstanti pretprocesora.
3.1. Dodavanje indeksa relacija projektu
Indekser odnosa može se aktivirati na posebnoj stranici svojstava projekta. Odaberite projekt i odaberite stavku Svojstva u kontekstnom izborniku. U predstojećem dijalogu izaberite stranicu Indeks relacija.
Slika 5. Stranica svojstava projekta za indeks relacija

Indeks relacija se aktivira za projekat odabirom opcije Omogući indeks relacija (1). Nakon omogućavanja indeksera postoje još neke opcije za definiranje ponašanja specifičnog za projekt. Indeksiranje pure::variants uslova i C/C++ konstanti preprocesora može se aktivirati zasebno (2). Lista sa file obrasci imena (3) se koristi za odabir files za indeksiranje. Samo fileSkeniraju se ovi koji odgovaraju jednom od uzoraka. Dodajte “*” kao uzorak da skenirate sve files projekta.
Nakon aktiviranja indeksera za projekat projektu se dodaje builder. Skeniranja ovog graditelja su promijenjena files za nove relacije prema elementima modela pure::variants automatski.
3.2. Odnosi prema izvornom kodu
Sa aktiviranim indekserom relacija Relacije View sadrži dodatne unose. Ovi unosi pokazuju naziv file i broj linije varijantne tačke. Savjet alata prikazuje odgovarajući dio file. Dvoklikom na unos file biće otvoren u uređivaču.
pure::variants Uslovi
Uvjet pure::variants može se koristiti za uključivanje ili isključivanje dijelova a file ovisno o odabiru funkcije. Indeks uslova skenira takva pravila i izdvaja referentne karakteristike. Ako je takva karakteristika odabrana u uređivaču, odnosi se View će pokazati sve files i linije na kojima se nalazi uvjet sa odabranom karakteristikom (pogledajte sliku 6, „Predstavljanje stanja u relacijama View”).
Slika 6. Predstavljanje uslova u relacijama ViewDa biste dobili detaljno objašnjenje kako da definišete uslove, pogledajte odeljak ps:condtext poglavlja 9.5.7 Pure::variants Korisničkog vodiča (Reference–>Unapred definisani tipovi izvornih elemenata–>ps:condtext).
Konstante predprocesora C/C++
Indeks C/C++ pretprocesora skenira files za konstante koje se koriste u pravilima predprocesora (npr. #ifdef, #ifndef, …).
Ako je ps:flag ili ps:flagfile element je odabran Odnosi View prikazuje upotrebu definirane konstante pretprocesora.
Odnosi View također prikazuje konstante pretprocesora povezane sa karakteristikama korištenjem obrazaca mapiranja. Za to se obrasci proširuju podacima odabrane karakteristike. Rezultirajući simboli se koriste za traženje odgovarajućih konstanti pretprocesora. Slika 7, „Predstavljanje C/C++ konstante pretprocesora u relacijama View” pokazuje bivšiample sa uzorkom fame{Name}. Obrazac je proširen jedinstvenim imenom značajke na fameNative. U indeksiranom kodu postoji 76 lokacija na kojima se koristi konstanta preprocesora fameNative.
Ove lokacije su prikazane u odnosima View. Obrasci se mogu definisati u postavkama (pogledajte odeljak 3.3, “Preference”).
Slika 7. Predstavljanje C/C++ konstante pretprocesora u relacijama View

3.3. The Preferences
Da biste promijenili zadano ponašanje indeksera, otvorite Eclipse postavke i odaberite stranicu Indeks relacija u kategoriji Upravljanje varijantama. Stranica prikazuje dvije liste.
Slika 8. Preference indeksera relacijaGornja lista sadrži podrazumevano file obrasci za indekser (1). Ova lista je početna postavka uzorka za novoomogućene projekte.
Donja lista sadrži mapiranje između karakteristika i konstanti pretprocesora (2). Ovo mapiranje se koristi za sve projekte. Tabela 1, “Podržane zamjene mapiranja” prikazuje sve moguće zamjene.
Tabela 1. Podržane zamjene mapiranja

Wildcard	Opis	Example: FeatureA
Ime	Jedinstveni naziv odabrane karakteristike	FLAG_{Naziv} – FLAG_FeatureA
NAME	velika slova Jedinstveni naziv odabrane karakteristike	FLAG_{NAME} – FLAG_FEATUREA
ime	mala slova Jedinstveni naziv odabrane karakteristike	flag_{name} – oznaka_featurea

Dokumenti / Resursi

pure-systems 2024 konektor za softver za upravljanje izvornim kodom [pdf] Korisnički priručnik 2024, 2024 konektor za softver za upravljanje izvornim kodom, konektor za softver za upravljanje izvornim kodom, softver za upravljanje izvornim kodom, softver za upravljanje, softver

Reference

• Uputstvo za upotrebu