pure::variants – Konektorea
Iturburu Kodea Kudeatzeko Eskuliburua
Parametric Technology GmbH
6.0.7.685 bertsioa pure::variants 6.0
Copyright © 2003-2024 Parametric Technology GmbH
2024

Sarrera

pure::variants Iturburu-kodearen kudeaketarako konektoreak (Konektoreak) garatzaileei iturburu-kodearen aldakortasuna kudeatzeko aukera ematen die pure::variants erabiliz. Pure::variants-en Iturburu Kodea Kudeak aukera malgu bat eskaintzen du direktorio-egiturak eta iturburu-kodea sinkronizatzeko files erraz pure::variants ereduekin. Horrela, aldaerak kudeatzea software-proiektu konplexuetan ere aplika daiteke. Gainera pure::variants funtzioen eta iturburu-kodearen arteko konexioak errazagoa izan daiteke eraikitzailearekin eta oso eskuragarriak dira Iturburu-kodearen kudeaketaren bidez.
1.1. Software-eskakizunak
Pur::variants Iturburu-kodeen kudeaketarako konektorea pure::variants-en luzapena da eta onartzen diren plataforma guztietan dago eskuragarri.
1.2. Instalazioa
Mesedez, kontsultatu pure::variants Konektoreak atala pure::variants Konfigurazio Gidan konektorea nola instalatu buruzko informazio zehatza lortzeko (menua Laguntza -> Laguntza Edukiak eta gero pure::variants Konfigurazio Gida -> pure::variants Konektoreak).
1.3. Eskuliburu honi buruz
Irakurleak::: aldaerei buruz oinarrizko ezagutzak eta esperientziak izatea espero da. Mesedez, kontsultatu bere sarrerako materiala eskuliburu hau irakurri aurretik. Eskuliburua sareko laguntzan eta PDF formatuan inprimatzeko aukera dago hemen.

Konektorea erabiliz

2.1. Pura hasita::aldaerak
Erabilitako instalazio-metodoaren arabera, hasi pure::variants-en gaitutako Eclipse edo Windows-en hautatu pure::variants elementua programaren menutik.
Aldaeraren kudeaketaren ikuspegia aktibatuta ez badago, egin ezazu Ireki Perspektiba->Besteak... Leiho menuan hautatuta.
2.2. Inportatu direktorio-zuhaitza familia-eredu batera
Direktorio-zuhaitza Familia Eredu batera inportatu aurretik, aldaeren proiektu bat sortu behar da. Era berean, iradokigarria da Ezaugarri Eredu batean dagoeneko definituta egotea. Mesedez, kontsultatu pure::variants dokumentazioa urrats hauei buruzko laguntza lortzeko.
Benetako inportazioa Proiektuen testuinguruko menuan Inportatu… ekintza hautatuz hasten da view edo Inportatu... menuarekin File menua. Aukeratu Aldaera-ereduak edo Proiektuak Aldaeraren kudeaketa kategoriako eta sakatu Hurrengoa. Hurrengo orrian, hautatu Inportatu familia-eredu bat sorburuko karpetetatik eta sakatu Siguiente berriro.
Aukeratu inportatzeko iturburu-kode mota
Inportazio-morroia agertzen da (ikus 1. irudia, "Inportatu daitekeen iturburu-kode mota hautatzeko inportazio-morroiaren orria"). Hautatu inportatzeko proiektu-mota eta sakatu Hurrengoa. Mota bakoitzak aurrez zehaztutako multzo bat dauka file eredura inportatzeko motak.
1. Irudia. Inportatu daitekeen iturburu-kode mota hautatzeko inportazio-morroiaren orriaHautatu Iturburua eta Helburua
Morroiaren hurrengo orrian (2. Irudia, "Inportazio-morroiaren orria inportazioaren iturria eta helburua hautatzeko") iturburu-direktorioa eta xede-eredua zehaztu behar dira.
Sakatu Arakatu... botoia inportatu behar den iturburu-kodea dagoen direktorioa hautatzeko. Lehenespenez, uneko lan-eremua hautatzen da, nabigatzen hasteko puntu erabilgarria izan daitekeelako.
Jarraian, sartu eta baztertu eredua zehaztu dezakezu. Eredu hauek java adierazpen erregularrak izan behar dute. Sarrerako bide bakoitza, iturburu erro-karpetarekiko, eredu hauekin egiaztatzen da. Sartu eredua bat badator, karpeta bat inportatuko da, baztertzeko eredua bat ez badator. Esan nahi du barne-ereduak inportatu beharreko karpetak aurrez hautatzen dituela, baztertze-ereduak aurrez hautaketa hau mugatzen du.
Iturburu-kodearen direktorioa hautatu ondoren xede-eredu bat definitu behar da. Hori dela eta, hautatu eredua gorde behar den aldaera-proiektu bat edo karpeta bat eta idatzi ereduaren izena. The file izena automatikoki luzatzen da .ccfm luzapenarekin elkarrizketa-koadro honetan ematen ez bada. Lehenespenez, ereduaren izenaren izen bera ezarriko da. Hau da gomendatutako ezarpena.
Iturburu-karpeta egokia eta nahi den modeloaren izena zehaztu ondoren, elkarrizketa-koadroa Amaitu sakatuz amai daiteke. Hurrengo botoia sakatzen bada, beste orrialde bat agertuko da, non ezarpen gehigarriak egin daitezkeen.
2. Irudia. Inportazio-morroiaren orria, inportazioaren iturria eta helburua hautatzekoAldatu inportazio-hobespenak
Morroiaren azken orrialdean (3. irudia, "Inportazio-morroiaren orria konfigurazio indibidual bat definitzeko”) inportatutako software-proiektuaren inportazio-portaera pertsonalizatzeko egin daitezkeen hobespenak daude.
Elkarrizketa-orriak taula bat erakusten du non file motak definitzen dira, inportazio-prozesuan kontuan hartuko direnak.
Lerro bakoitza lau eremuz osatuta dago.

• Deskribapena eremuak deskribapen-testu labur bat dauka identifikatzeko file mota.
• The File izen ereduaren eremua hautatzeko erabiltzen da fileeremuen balioarekin bat datozenean inportatu beharrekoak. Eremuak honako sintaxia erabiltzen du:

1. Erabilera ohikoena a izan daiteke file luzapena. Ohiko sintaxia .EXT da, non EXT nahi dena file luzapena (adib. .java).
2. Ohiko beste egoera bat berezia da file, maketa bat bezalafile. Hori dela eta, posible da zehatza parekatzea file izena. Horretarako, sartu besterik ez file izena eremuan sartu (adib. build.xml).
3. Zenbait kasutan mapatze-nahiak zehatzagoak dira, beraz, soilik fileEredu berezi batekin bat datozenak inportatu behar dira. Baldintza hau egokitzeko, posible da adierazpen erregularrak erabiltzea File izen ereduaren eremua.
   Adierazpen erregularren sintaxia deskribatzeak laguntza honen asmoa gaindituko luke. Mesedez, kontsultatu erreferentzia-kapituluko adierazpen erregularrak atala pure::variants erabiltzailearen gidan (adib.

• Mapatutako elementu mota eremuak a-ren arteko mapa ezartzen du file type eta pure::variants familia elementu mota. Familia-elementu mota iturriaren deskribatzailea da file inportatutako ereduan mapatutako elementuari informazio gehiago emateko. Aukera tipikoak ps:class edo ps:make dirafile.
• Mapatua file type fields a arteko mapa ezartzen du file mota eta::aldaera hutsa file mota. The file type in pure::variants iturriaren deskribatzailea da file inportatutako ereduan mapatutako elementuari informazio gehiago emateko. Hautapen tipikoak inplementazioetarako edo definiziorako def dira files.

3. Irudia. Inportazio-morroiaren orria konfigurazio indibidual bat definitzekoBerria file motak gehi daitezke Gehitu mapak botoia erabiliz. Eremu guztiak definitu gabeko balioarekin betetzen dira eta erabiltzaileak bete behar ditu. Eremu bateko balio bat editatzeko, egin klik saguarekin eremuan. Balioa editagarria bihurtzen da eta alda daiteke. Ezin da lehenetsia aldatu file taularen izen-ereduak. Pertsonalizazioa malgutzeko, posible da a desautatu file idatzi errenkada desautatuta. Deshautatua file izen-ereduak konfigurazioan geratzen dira baina inportatzaileak ez ditu erabiliko. Erabiltzaileak definituta file motak berriro kendu daitezke Kendu mapak botoia erabiliz.
Lehenespenez Beste bat files file izen eredua taulan eskuragarri dago baina desautatuta dago. Normalean ez da guztiak inportatu nahi files baina hau erraz alda daiteke dagokion errenkada hautatuz.
Hiru inportazio-aukera orokor daude inportatzailearen portaera pertsonalizatzeko.

• Ez inportatu direktoriorik bat etorri gabe files (adibidez, CVS direktorioa).
  Inportatzaileak bat datorren direktorio bat aurkitzen badu file bertan dago eta bat-etortzerik ez duen azpidirektoriorik file, direktorioa ez da inportatuko. Hau erabilgarria izan ohi da, proiektuak CVS bezalako bertsioak kudeatzeko sistemen bidez kudeatzen badira. CVS-rako, dagokion direktorio bakoitzak CVS-direktorio bat dauka garrantzirik ez dagoenean files gordetzen dira. Aukera hau hautatzen bada eta CVS-files ez datoz bat inorekin file Goian zehaztutako mota, direktorioa ez da osagai gisa inportatuko Familia Ereduan.
• Ordenatu files eta direktorioa.
  Gaitu aukera hau ordenatzeko files eta direktorio bakoitza ordena alfabetikoan.
• Inportatu bideen kudeaketa.
  Sinkronizazio gehiago lortzeko inportatzaileak inportatutako elementu guztien jatorrizko bidea gorde behar du ereduan.
  Kasu askotan Familia ereduak beste erabiltzaile batzuekin partekatzen dira. Direktorioaren egitura desberdina izan daiteke erabiltzaile bakoitzarentzat. Erabilera-eszenatoki ohikoenak onartzeko inportatzaileak hainbat modutan lan egin dezake:

Absolutua	Inportatutako elementuaren bide absolutua ereduan gordeko da. Geroago sinkronizatzeko eta eraldaketan zehar fileLehen inportazioan zegoen toki berean jarri behar dira.
Laneko eremuari dagokionez	Ibilbideak lan-eremuaren karpetari dagokionez gordetzen dira. Sinkronizaziorako files Eclipse lan-eremuaren parte izan behar du. Eraldaketak Eclipse laneko eremua erabili behar du sarrerako direktorio gisa.
Proiektuari dagokionez	Bideak proiektuarekiko gordetzen dira. Sinkronizaziorako fileEclipse barruan proiektuaren parte dira. Eraldaketak proiektuaren karpeta erabili behar du sarrerako direktorio gisa.
Bideari dagokiona	Bideak emandako bidearekiko gordetzen dira. Sinkronizaziorako filekokapen berdinean jarri behar dira. Transformazio sarrerako direktorioa bide erlatiboaren berdina da inportazioan zehar.

Elkarrizketa-koadro honetako hobespen guztiak etengabe gordetzen dira. Pertsonalizazio pertsonalak ez dira berriro egin behar inportazioa exekutatzen den bakoitzean. Horrek inportazio-fluxua erraza eta azkarra egiten du.
2.3. Direktorio-zuhaitzetik ereduak eguneratzea
Sakatu Sinkronizatu botoia inportatutako eredu bat bere direktorio bidearekin sinkronizatzeko. Proiektuaren erro-bidea ereduan gordetzen da, beraz, lehengo direktorio berean sinkronizatuko da. Sinkronizatu botoia gaitzeko, ireki eredua eta hautatu edozein elementu. Sinkronizatu botoia sakatu ondoren Konparazio editorea irekitzen da, non uneko Familia Eredua eta uneko direktorio-egituraren eredua kontrajartzen diren (ikus 4. Irudia, "Konparazio Editoreko Direktorioen Zuhaitzetik Ereduaren eguneratzea").
4. Irudia. Konparazio Editoreko Directorio-zuhaitzaren ereduaren eguneratzea   Konparazio editorea pure::variants guztietan erabiltzen da ereduaren bertsioak alderatzeko, baina kasu honetan direktorio fisikoaren egitura (beheko eskuinaldean bistaratzen da) egungo pure::variants ereduarekin (beheko ezkerreko aldean) konparatzeko erabiltzen da. Aldaketa guztiak elementu bereizi gisa zerrendatzen dira editorearen goiko aldean, eragindako elementuen arabera ordenatuta.
Zerrenda honetako elementu bat hautatzeak bi ereduetan dagokien aldaketa nabarmentzen du. Adibample, elementu gehigarri bat eskuineko aldean lauki batekin markatzen da eta ezkerreko aldean dagoen ereduan duen posizio bideragarriarekin lotzen da. Bateratu tresna-barrak goiko eta beheko editorearen leihoen artean aldaketa bakarrak edo guztiak (gatazkarik gabekoak) kopiatzeko tresnak eskaintzen ditu direktorio-zuhaitz-eredutik Ezaugarri-eredura.
Oharra
Sinkronizazioa erabilitako azken inportatzaileen ezarpenekin egiten da. Horri esker, inportazioa egin bitartean egindako beste ezarpen batzuekin eredua eguneratzea posible da.

Erlazio-indizea erabiltzea

Iturburu-kodea kudeatzeko konektoreak harremanak hobetzen ditu View pure::variants ereduaren elementuen eta iturburu kodearen arteko loturei buruzko informazioarekin. Erlazioak gehitzen dira ps:condxml eta ps:condtext elementuen baldintzetan erabiltzen diren ezaugarrietarako.
ps:bandera eta ps:banderarentzatfile elementuak C/C++ iturburuko aurreprozesadorearen konstanteen kokapena files erakusten dira. Horrez gain, bat datozen prozesadore-konstanteen kokapenak erakusten dira hautatutako ezaugarri baterako, ezaugarrien izen esklusiboen eta aurreprozesadore-konstanteen arteko mapak erabiliz.
3.1. Erlazio-indizea proiektu bati gehitzea
Erlazio-indizea proiektuaren propietate-orri berezi batean aktibatu daiteke. Hautatu proiektua eta aukeratu laster-menuko Propietateak elementua. Hurrengo elkarrizketa-koadroan, hautatu Harreman-indizea orria.
5. Irudia. Erlazio-indizerako proiektuaren propietate-orria

Erlazio-indexatzailea proiekturako aktibatzen da Gaitu erlazio-indizea aukera (1) hautatuz. Indizea gaitu ondoren, proiektuaren portaera zehatza definitzeko aukera gehiago daude. Pur::variants Baldintzen eta C/C++ Aurreprozesadorearen Konstanteen indexazioa bereiz aktiba daiteke (2). Honekin zerrenda file izen ereduak (3) hautatzeko erabiltzen da files indexatzeko. Bakarrik fileereduetako batekin bat datozenak eskaneatzen dira. Gehitu "*" eredu gisa guztiak eskaneatzeko fileproiektu baten s.
Proiektu baterako indexatzailea aktibatu ondoren, eraikitzaile bat gehitzen zaio proiektuari. Eraikitzaile hau eskaneatzea aldatu da files pure::variants ereduko elementuekiko erlazio berrietarako automatikoki.
3.2. Iturburu-kodearekiko harremanak
Erlazio-indizea aktibatuta Erlazioak View sarrera gehigarriak ditu. Sarrera hauek izena erakusten dute file eta aldaeraren puntuaren lerro-zenbakia. Tresnaren aholkuak atal egokia erakusten du file. Sarreran klik bikoitza eginez file editore batean irekiko da.
purua::aldaerak Baldintzak
Pura::variants baldintza a-ren atalak sartzeko edo baztertzeko erabil daiteke file ezaugarri-hautaketaren arabera. Baldintza-indexatzaileak arau horiek bilatzen ditu eta erreferentziatutako ezaugarriak ateratzen ditu. Ezaugarri bat hautatzen bada editorean Harremanak View guztiak erakutsiko ditu files eta lerroak non hautatutako ezaugarria duen baldintza bat kokatzen den (ikus 6. irudia, “Baldintza baten irudikapena erlazioetan View").
6. Irudia Baldintza baten irudikapena Erlazioetan ViewBaldintzak definitzeko moduari buruzko azalpen zehatza lortzeko, kontsultatu pure::variants Erabiltzailearen Gidaren 9.5.7 kapituluko ps:condtext atala (Erreferentzia–>Aurredefinitutako Iturburu Elementu Motak–>ps:condtext).
C/C++ aurreprozesadorearen konstanteak
C/C++ aurreprozesadorearen indexatzaileak arakatzen du files aurreprozesadoreen arauetan erabiltzen diren konstanteetarako (adibidez, #ifdef, #ifndef, ...).
ps:bandera edo ps:bandera badafile Elementua Harremanak hautatuta dago View definitutako aurreprozesadorearen konstantearen erabilera erakusten du.
Harremanak View kartografia-ereduak erabiliz ezaugarriei lotutako prozesadore-konstanteak ere erakusten ditu. Horretarako ereduak zabaltzen dira hautatutako ezaugarriaren datuekin. Sortzen diren ikurrak bat datozen aurreprozesadorearen konstanteak bilatzeko erabiltzen dira. 7. irudia, “C/C++ aurreprozesadorearen konstante baten irudikapena erlazioetan View” erakusten du example ereduaren fama {Izena}. Eredua ezaugarriaren izen esklusiboarekin hedatzen da fameNative-ra. Kode indizean 76 kokapen daude non aurreprozesadorearen fameNative konstantea erabiltzen den.
Kokapen hauek Harremanetan agertzen dira View. Ereduak hobespenetan defini daitezke (ikus 3.3 atala, "Hobespenak").
7. Irudia. Erlazioetan C/C++ aurreprozesadorearen konstante baten irudikapena View

3.3. Hobespenak
Indizearen portaera lehenetsia aldatzeko, ireki Eclipse hobespenak eta hautatu Harreman-indizea orria Aldaeraren kudeaketa kategorian. Orriak bi zerrenda erakusten ditu.
8. Irudia. Erlazio-indizea Hobespen orriaGoiko zerrendak lehenetsitakoa dauka file indexatzailerako ereduak (1). Zerrenda hau gaitu berri diren proiektuen hasierako ereduaren ezarpena da.
Beheko zerrendan ezaugarrien eta aurreprozesadorearen konstanteen arteko mapeoa dago (2). Mapeo hau proiektu guztietan erabiltzen da. 1. taulan, "Oartutako maparen ordezkapenak" ordezkapen posible guztiak erakusten ditu.
1. taula. Onartutako maparen ordezkapenak

Komodina	Deskribapena	Example: EzaugarriA
Izena	hautatutako eginbidearen izen bakarra	FLAG_{Izena} – FLAG_EzaugarriA
IZENA	hautatutako funtzioaren izen esklusiboa maiuskulaz	FLAG_{NAME} – FLAG_FEATUREA
izena	letra xehea Hautatutako eginbidearen izen esklusiboa	bandera_{izena} – bandera_ezaugarri

Dokumentuak / Baliabideak

pure-systems 2024 iturburu-kodea kudeatzeko softwarerako konektorea [pdfErabiltzailearen eskuliburua 2024, 2024 Iturburu kodea kudeatzeko softwarerako konektorea, iturburu kodea kudeatzeko softwarerako konektorea, iturburu kodea kudeatzeko softwarea, kudeaketa softwarea, softwarea

Erreferentziak

• Erabiltzailearen eskuliburua