grynas::variantai – Jungtis skirta
Šaltinio kodo valdymo vadovas
Parametric Technology GmbH
6.0.7.685 versija, skirta grynai::variants 6.0
Autoriaus teisės © 2003-2024 Parametric Technology GmbH
2024

Įvadas

„pure::variants“ šaltinio kodo valdymo jungtis (jungtis) leidžia kūrėjams valdyti šaltinio kodo kintamumą naudojant „pure::variants“. Grynųjų::variantų šaltinio kodo valdymas suteikia lanksčią galimybę sinchronizuoti katalogų struktūras ir šaltinio kodą files lengvai su grynais::variantų modeliais. Tokiu būdu variantų valdymas gali būti pritaikytas net sudėtingiems programinės įrangos projektams. Be to, jungtys tarp grynų::variantų funkcijų ir šaltinio kodo gali būti lengviau valdomos naudojant kūrėją ir yra labai prieinamos naudojant šaltinio kodo valdymą.
1.1. Programinės įrangos reikalavimai
„Pure::variants“ šaltinio kodo valdymo jungtis yra „pure::variants“ plėtinys ir pasiekiamas visose palaikomose platformose.
1.2. Montavimas
Norėdami gauti išsamios informacijos apie tai, kaip įdiegti jungtį, skaitykite skyrių pure::variants Jungtys gryname::variants sąrankos vadove (meniu Žinynas -> Žinynas Turinys ir tada pure::variants sąrankos vadovas -> pure::variants Jungtys).
1.3. Apie šį vadovą
Skaitytojas turėtų turėti pagrindinių žinių ir patirties su grynaisiais::variantais. Prieš skaitydami šį vadovą, perskaitykite jo įvadinę medžiagą. Vadovą galima rasti internetiniame žinyne ir spausdinti PDF formatu čia.

Jungties naudojimas

2.1. Pradedant grynai::variantai
Priklausomai nuo naudojamo diegimo metodo, paleiskite „pure::variants“ įgalintą „Eclipse“ arba „Windows“ programos meniu pasirinkite elementą „pure::variants“.
Jei variantų valdymo perspektyva dar nesuaktyvinta, tai padarykite pasirinkdami ją iš meniu Langas iš Open Perspective->Other….
2.2. Importuokite katalogų medį į šeimos modelį
Prieš importuojant katalogų medį į šeimos modelį, reikia sukurti variantų projektą. Taip pat rekomenduojama, kad funkcijos jau būtų apibrėžtos funkcijų modelyje. Jei reikia pagalbos dėl šių veiksmų, skaitykite gryną::variants dokumentaciją.
Faktinis importavimas pradedamas projektų kontekstiniame meniu pasirinkus veiksmą Importuoti… view arba naudodami meniu Importuoti… File meniu. Kategorijoje Variantų valdymas pasirinkite Variantų modeliai arba Projektai ir paspauskite Kitas. Kitame puslapyje pasirinkite Importuoti šeimos modelį iš šaltinio aplankų ir dar kartą paspauskite Next.
Pasirinkite importuojamo šaltinio kodo tipą
Pasirodo importavimo vedlys (žr. 1 pav. „Importavimo vedlio puslapis, kuriame galima pasirinkti šaltinio kodo tipą, kurį galima importuoti“). Pasirinkite projekto tipą, kurį norite importuoti, ir paspauskite Next. Kiekviename tipe yra iš anksto nustatytas rinkinys file tipus, kuriuos reikia importuoti į modelį.
1 pav. Importavimo vedlio puslapis, kad pasirinktumėte šaltinio kodo tipą, kurį galima importuotiPasirinkite šaltinį ir tikslą
Kitame vedlio puslapyje (2 pav. „Importavimo vedlio puslapis, skirtas pasirinkti importavimo šaltinį ir tikslą“) turi būti nurodytas šaltinio katalogas ir tikslinis modelis.
Paspauskite mygtuką Naršyti…, kad pasirinktumėte katalogą, kuriame yra šaltinio kodas, kurį reikia importuoti. Pagal numatytuosius nustatymus pasirinkta dabartinė darbo sritis, nes tai gali būti naudingas taškas norint pradėti naršyti.
Žemiau galite nurodyti įtraukti ir neįtraukti šabloną. Šie šablonai turi būti java reguliarios išraiškos. Kiekvienas įvesties kelias, palyginti su šaltinio šakniniu aplanku, yra patikrintas pagal šį šabloną. Jei įtraukimo šablonas atitinka, aplankas importuojamas, jei neįtraukimo šablonas nesutampa. Tai reiškia, kad įtraukimo šablonas iš anksto pasirenka importuotinus aplankus, o neįtraukimo šablonas apriboja šį išankstinį pasirinkimą.
Pasirinkus šaltinio kodo katalogą, turi būti apibrėžtas tikslinis modelis. Todėl pasirinkite projekto variantą arba aplanką, kuriame turėtų būti saugomas modelis, ir įveskite modelio pavadinimą. The file vardas automatiškai pratęsiamas .ccfm plėtiniu, jei jis nenurodytas šiame dialogo lange. Pagal numatytuosius nustatymus jo pavadinimas bus toks pat kaip ir paties modelio pavadinimas. Tai rekomenduojamas nustatymas.
Nurodius tinkamą šaltinio aplanką ir norimo modelio pavadinimą, dialogas gali būti baigtas paspaudus Finish. Jei paspaudžiamas mygtukas Kitas, pasirodo kitas puslapis, kuriame galima atlikti papildomus nustatymus.
2 pav. Importavimo vedlio puslapis, kuriame galite pasirinkti importavimo šaltinį ir tiksląPakeiskite importavimo nuostatas
Paskutiniame vedlio puslapyje (3 pav. „Importavimo vedlio puslapis, skirtas individualiai konfigūracijai apibrėžti“), yra parinkčių, kurias galima atlikti norint pritaikyti importuojamo programinės įrangos projekto importavimo elgseną.
Dialogo puslapyje rodoma lentelė, kurioje file yra apibrėžti tipai, į kuriuos bus atsižvelgta importuojant.
Kiekviena eilutė susideda iš keturių laukų.

• Lauke Aprašymas yra trumpas aprašomasis tekstas, skirtas identifikuoti file tipo.
• The File vardo šablono laukas naudojamas pasirinkti files, kuriuos reikia importuoti, kai jie atitinka laukų vertę. Lauke naudojama ši sintaksė:

1. Dažniausias naudojimo atvejis gali būti a file pratęsimas. Įprasta sintaksė yra .EXT, kur norima EXT file plėtinį (pvz., .java).
2. Kita dažna situacija yra ypatinga file, kaip gaminysfile. Todėl galima tiksliai sutapti file pavadinimas. Norėdami tai padaryti, tiesiog įveskite file pavadinimą į lauką (pvz. build.xml).
3. Kai kuriais atvejais kartografavimo norai yra konkretesni, todėl tik files, kurios atitinka specialų modelį, turėtų būti importuojamos. Kad atitiktų šį reikalavimą, galima naudoti reguliariąsias išraiškas File pavadinimo šablono laukas.
   Reguliariųjų posakių sintaksės aprašymas viršytų šios pagalbos tikslą. Žr. grynojo::variants vartotojo vadovo nuorodų skyriaus reguliariųjų išraiškų skyrių (pvz., .*).

• Lauke Mapped element type nustatomas susiejimas tarp a file tipas ir grynas::variants šeimos elemento tipas. Šeimos elemento tipas yra šaltinio aprašas file pateikti papildomos informacijos apie susietą elementą importuotame modelyje. Tipiški pasirinkimai yra ps:class arba ps:makefile.
• Žemėlapis file tipo laukas nustato susiejimą tarp a file tipas ir grynas::variantai file tipo. The file įveskite pure::variants yra šaltinio deskriptorius file pateikti papildomos informacijos apie susietą elementą importuotame modelyje. Tipiški pasirinkimai yra impl įgyvendinimui arba def apibrėžimui files.

3 pav. Importavimo vedlio puslapis individualiai konfigūracijai apibrėžtiNauja file tipus galima pridėti naudojant mygtuką Pridėti atvaizdavimą. Visi laukai užpildyti reikšme neapibrėžta ir juos turi užpildyti vartotojas. Norėdami redaguoti reikšmę lauke, tiesiog spustelėkite lauką pele. Reikšmė tampa redaguojama ir gali būti pakeista. Neįmanoma pakeisti numatytojo file lentelės pavadinimų modeliai. Kad tinkinimas būtų lankstus, galima panaikinti a pasirinkimą file įveskite, panaikindami eilutės pasirinkimą. Pasirinkimas panaikintas file pavadinimų šablonai lieka konfigūracijoje, bet importuotojas jų nenaudos. Apibrėžtas naudotojas file tipai gali būti pašalinti dar kartą naudojant mygtuką Pašalinti atvaizdavimą.
Pagal numatytuosius nustatymus Kitas files file vardo šablonas yra lentelėje, bet atžymėtas. Paprastai nenorima importuoti visų files, tačiau tai galima lengvai pakeisti pasirinkus atitinkamą eilutę.
Yra trys bendros importavimo parinktys, leidžiančios tinkinti importuotojo elgesį.

• Neimportuokite katalogų nesuderinus files (pvz., CVS katalogai).
  Jei importuotojas randa katalogą, kuriame nėra atitikimo file yra jame ir kur joks pakatalogis neturi atitikimo file, katalogas nebus importuotas. Tai dažnai naudinga, jei projektus valdo versijų valdymo sistemos, tokios kaip CVS. CVS atveju kiekviename atitinkamame kataloge yra CVS katalogas, kur tai nesvarbu files yra saugomi. Jei pasirinkta ši parinktis ir CVS-files neatitinka jokių file aukščiau apibrėžto tipo, katalogas nebus importuojamas kaip komponentas į šeimos modelį.
• Rūšiuoti files ir katalogus.
  Norėdami rūšiuoti, įjunkite šią parinktį files ir katalogus abėcėlės tvarka.
• Importo kelio tvarkymas.
  Tolesniam sinchronizavimui importuotojas turi išsaugoti pradinį visų importuotų elementų kelią į modelį.
  Daugeliu atvejų šeimos modeliai bendrinami su kitais vartotojais. Katalogų struktūra kiekvienam vartotojui gali skirtis. Kad palaikytų dažniausiai pasitaikančius naudojimo scenarijus, importuotojas gali dirbti įvairiais režimais:

Absoliutus	Absoliutus kelias iki importuoto elemento bus išsaugotas modelyje. Vėlesniam sinchronizavimui ir transformacijos metu files turi būti dedamos tiksliai toje pačioje vietoje kaip ir pirmą kartą importuojant.
Darbo srities atžvilgiu	Keliai saugomi darbo srities aplanko atžvilgiu. Norėdami sinchronizuoti, files turi būti Eclipse darbo srities dalis. Transformacijai reikia naudoti „Eclipse“ darbo sritį kaip įvesties katalogą.
Projekto atžvilgiu	Keliai saugomi atsižvelgiant į projektą. Norėdami sinchronizuoti, fileyra „Eclipse“ projekto dalis. Transformacija turi naudoti projekto aplanką kaip įvesties katalogą.
Path atžvilgiu	Keliai saugomi atsižvelgiant į nurodytą kelią. Norėdami sinchronizuoti, files turi būti dedamos lygiai toje pačioje vietoje. Transformacijos įvesties katalogas yra toks pat kaip santykinis kelias importuojant.

Visos šio dialogo parinktys išsaugomos nuolat. Asmeniniai tinkinimai neturi būti perdaryti kiekvieną kartą, kai vykdomas importavimas. Tai palengvina ir greitina importo darbo eigą.
2.3. Modelių atnaujinimas iš katalogų medžio
Paspauskite sinchronizavimo mygtuką sinchronizuoti importuotą modelį su jo katalogo keliu. Šakninis projekto kelias yra saugomas modelyje, todėl jis bus sinchronizuojamas su tuo pačiu katalogu kaip ir anksčiau. Norėdami įjungti mygtuką Sinchronizuoti, atidarykite modelį ir pasirinkite bet kurį elementą. Paspaudus mygtuką Sinchronizuoti, atidaromas palyginimo rengyklė, kurioje priešinamasi dabartiniam šeimos modeliui ir dabartinės katalogo struktūros modeliui (žr. 4 pav. „Modelio atnaujinimas iš katalogų medžio palyginimo rengyklėje“).
4 pav. Modelio atnaujinimas iš katalogų medžio palyginimo rengyklėje   Palyginimo rengyklė naudojama visame „pure::variants“ modelio versijoms palyginti, tačiau šiuo atveju ji naudojama palyginti fizinio katalogo struktūrą (rodomą apatinėje dešinėje pusėje) su dabartiniu „pure::variants“ modeliu (apatinėje kairėje pusėje). Visi pakeitimai pateikiami kaip atskiri elementai viršutinėje redaktoriaus dalyje, išdėstyti pagal paveiktus elementus.
Pasirinkus elementą šiame sąraše, paryškinami atitinkami abiejų modelių pakeitimai. Buvusiojeampe, papildomas elementas pažymėtas langeliu dešinėje ir susietas su galima jo padėtimi modelyje kairėje pusėje. Viršutinio ir apatinio redaktoriaus langų sujungimo įrankių juosta suteikia įrankius, leidžiančius kopijuoti pavienius arba net visus (nesuderinamus) pakeitimus iš katalogų medžio modelio į funkcijų modelį.
Pastaba
Sinchronizuojama naudojant paskutinius naudotus importuotojo nustatymus. Tai leidžia atnaujinti modelį su kitais parametrais, atliktais importuojant.

Santykių indeksavimo priemonės naudojimas

Šaltinio kodo valdymo jungtis pagerina ryšius View su informacija apie ryšius tarp pure::variants modelio elementų ir šaltinio kodo. Pridedami ryšiai funkcijoms, kurios naudojamos ps:condxml ir ps:condtext elementų sąlygomis.
Skirta ps:flag ir ps:flagfile elementų pirminio procesoriaus konstantų vieta C/C++ šaltinyje files rodomi. Be to, atitinkamų pirminio procesoriaus konstantų vietos rodomos pasirinktai funkcijai, naudojant unikalių funkcijų pavadinimų ir pirminio procesoriaus konstantų susiejimą.
3.1. Santykių rodyklės pridėjimas prie projekto
Ryšių rodyklė gali būti suaktyvinta specialiame projekto ypatybių puslapyje. Pasirinkite projektą ir kontekstiniame meniu pasirinkite elementą Ypatybės. Būsimame dialogo lange pasirinkite puslapį Ryšių indeksavimo priemonė.
5 pav. Ryšių indeksavimo priemonės projekto ypatybių puslapis

Projekto santykių indeksavimo priemonė suaktyvinama pasirinkus parinktį Įjungti santykių indeksavimo priemonę (1). Įjungus indeksavimo priemonę, yra dar keletas parinkčių, skirtų konkrečiam projektui apibrėžti. Grynųjų::variantų sąlygų ir C/C++ išankstinio procesoriaus konstantų indeksavimą galima suaktyvinti atskirai (2). Sąrašas su file pavadinimų šablonai (3) naudojami pasirinkti files indeksavimui. Tik files, atitinkančios vieną iš raštų, nuskaitomos. Pridėkite „*“ kaip šabloną, kad nuskaitytumėte viską files projekto.
Aktyvavus projekto indeksatorių, prie projekto pridedamas statytojas. Šis kūrėjas nuskaito pakeistas files naujiems santykiams su pure::variants modelio elementais automatiškai.
3.2. Ryšiai su šaltinio kodu
Su aktyvuotu santykių indeksuokliu Relations View yra papildomų įrašų. Šie įrašai rodo pavadinimą file ir varianto taško eilutės numeris. Įrankio patarimas rodo atitinkamą skyrių file. Dukart spustelėdami įrašą file bus atidarytas redaktoriuje.
grynas::variantai Sąlygos
Sąlyga grynas::variantai gali būti naudojama norint įtraukti arba neįtraukti a skirsnių file priklausomai nuo funkcijos pasirinkimo. Būklės indeksavimo priemonė nuskaito tokias taisykles ir ištraukia nurodytas funkcijas. Jei tokia funkcija pasirinkta redaktoriuje, Santykiai View parodys viską files ir eilutės, kuriose yra sąlyga su pasirinkta funkcija (žr. 6 pav. „Sąlygos vaizdavimas ryšiuose View“).
6 pav. Sąlygos vaizdavimas santykiuose ViewNorėdami gauti išsamų paaiškinimą, kaip apibrėžti sąlygas, skaitykite „pure::variants“ naudotojo vadovo 9.5.7 skyriaus ps:condtext (nuoroda–>Iš anksto nustatyti šaltinio elementų tipai–>ps:condtext) skyrių.
C/C++ pirminio procesoriaus konstantos
C/C++ pirminio procesoriaus indeksavimo priemonė nuskaito files konstantoms, naudojamoms išankstinio procesoriaus taisyklėse (pvz., #ifdef, #ifndef, ...).
Jei ps:flag arba ps:flagfile elementas yra pasirinktas Ryšiai View parodo apibrėžtos išankstinio procesoriaus konstantos naudojimą.
Santykiai View taip pat rodo išankstinio procesoriaus konstantas, sujungtas su funkcijomis naudojant atvaizdavimo šablonus. Tam šablonai išplečiami pasirinktos funkcijos duomenimis. Gauti simboliai naudojami ieškant atitinkančių išankstinio procesoriaus konstantų. 7 pav. „C/C++ pirminio procesoriaus konstantos vaizdavimas santykiuose View“ rodo buvęsample su modelio šlove{Vardas}. Šablonas papildytas unikaliu funkcijos pavadinimu į fameNative. Indeksuotame kode yra 76 vietos, kuriose naudojama išankstinio procesoriaus konstanta fameNative.
Šios vietos rodomos skiltyje Ryšiai View. Šablonus galima apibrėžti nuostatose (žr. 3.3 skyrių, „Nuostatos“).
7 pav. C/C++ pirminio procesoriaus konstantos vaizdavimas santykiuose View

3.3. Parinktys
Norėdami pakeisti numatytąją rodyklės veikimą, atidarykite „Eclipse“ nuostatas ir kategorijoje „Variantų valdymas“ pasirinkite puslapį „Relation Indexer“. Puslapyje rodomi du sąrašai.
8 pav. Ryšių rodyklės nuostatų puslapisViršutiniame sąraše yra numatytasis file rodyklės modeliai (1). Šis sąrašas yra pradinis šablono nustatymas naujai įgalintiems projektams.
Apatiniame sąraše yra funkcijų ir išankstinio procesoriaus konstantų susiejimas (2). Šis žemėlapis naudojamas visiems projektams. 1 lentelėje „Palaikomi žemėlapių pakeitimai“ rodomi visi galimi pakeitimai.
1 lentelė. Palaikomi atvaizdavimo keitimai

Pakaitos simbolis	Aprašymas	Example: funkcijaA
Vardas	Unikalus pasirinktos funkcijos pavadinimas	FLAG_{Name} – FLAG_FeatureA
VARDAS	didžiosiomis raidėmis Unikalus pasirinktos funkcijos pavadinimas	FLAG_{NAME} – FLAG_FEATUREA
pavadinimas	mažosiomis raidėmis Unikalus pasirinktos funkcijos pavadinimas	flag_{name} – flag_featurea

Dokumentai / Ištekliai

pure-systems 2024 jungtis, skirta šaltinio kodo valdymo programinei įrangai [pdf] Naudotojo vadovas 2024, 2024 m. šaltinio kodo valdymo programinės įrangos jungtis, šaltinio kodo valdymo programinės įrangos jungtis, šaltinio kodo valdymo programinė įranga, valdymo programinė įranga, programinė įranga

Nuorodos

• Vartotojo vadovas