pur :: amrywiadau - Connector ar gyfer
Llawlyfr Rheoli Cod Ffynhonnell
Technoleg Parametrig GmbH
Fersiwn 6.0.7.685 ar gyfer pur:: amrywiadau 6.0
Hawlfraint © 2003-2024 Parametric Technology GmbH
2024
Rhagymadrodd
pur ::variants Mae Connector for Source Code Management (Connector) yn galluogi datblygwyr i reoli amrywioldeb cod ffynhonnell gan ddefnyddio amrywiadau :: pur. Mae Rheoli Cod Ffynhonnell ar amrywiadau pur:: yn rhoi cyfle hyblyg i gydamseru strwythurau cyfeiriadur a chod ffynhonnell files hawdd gyda modelau pur::amrywiadau. Felly gellir cymhwyso rheolaeth amrywiadau yn ymarferol hyd yn oed i brosiectau meddalwedd cymhleth. At hynny, mae'n bosibl y bydd cysylltiadau rhwng nodweddion pur:: amrywiadau a chod ffynhonnell yn cael eu rheoli'n haws gyda'r adeiladwr ac maent yn hygyrch iawn trwy'r Source Code Management.
1.1. Gofynion Meddalwedd
Mae'r pur::variants Connector for Source Code Management yn estyniad ar gyfer amrywiadau :: pur ac mae ar gael ar bob platfform a gefnogir.
1.2. Gosod
Ymgynghorwch â'r adran bur ::amrywiadau Connectors yn y pur ::amrywiadau Canllaw Setup am wybodaeth fanwl ar sut i osod y cysylltydd (Cymorth dewislen -> Cymorth Cynnwys ac yna pur ::amrywiadau Setup Guide -> pur ::variants Connectors).
1.3. Am y llawlyfr hwn
Disgwylir i'r darllenydd feddu ar wybodaeth sylfaenol a phrofiadau gydag amrywiadau pur::. Edrychwch ar ei ddeunydd rhagarweiniol cyn darllen y llawlyfr hwn. Mae'r llawlyfr ar gael mewn cymorth ar-lein yn ogystal ag mewn fformat PDF y gellir ei argraffu yma.
Defnyddio Connector
2.1. Cychwyn pur::variants
Yn dibynnu ar y dull gosod a ddefnyddir, naill ai dechreuwch yr Eclipse pur ::variants-enabled neu o dan Windows dewiswch yr eitem amrywiadau :: pur o ddewislen y rhaglen.
Os nad yw'r persbectif Rheoli Amrywiadau eisoes wedi'i actifadu, gwnewch hynny trwy ei ddewis o Safbwynt Agored -> Arall ... yn y ddewislen Ffenestr.
2.2. Mewnforio Coeden Cyfeiriadur i Fodel Teulu
Cyn mewnforio coeden gyfeiriadur i Fodel Teulu, mae'n rhaid creu prosiect amrywiadau. Mae hefyd yn awgrymu bod nodweddion wedi'u diffinio mewn Model Nodwedd eisoes. Edrychwch ar y ddogfennaeth amrywiadau pur:: i gael cymorth ynglŷn â'r camau hyn.
Dechreuir y mewnforio gwirioneddol trwy ddewis y weithred Mewnforio… naill ai yn newislen cyd-destun y Prosiectau view neu gyda Mewnforio… ddewislen yn y File bwydlen. Dewiswch Modelau neu Brosiectau Amrywiad o'r categori Rheoli Amrywiadau a gwasgwch Next. Ar y dudalen ganlynol dewiswch Mewnforio Model Teulu o ffolderi ffynhonnell a gwasgwch Next eto.
Dewiswch y math o god ffynhonnell i'w fewnforio
Mae'r dewin mewnforio yn ymddangos (gweler Ffigur 1, “Tudalen y dewin mewnforio i ddewis y math o god ffynhonnell y gellir ei fewnforio”). Dewiswch fath o brosiect i'w fewnforio a gwasgwch Next. Mae pob math yn cynnwys set rhagddiffiniedig o file mathau i'w mewnforio i'r model.
Ffigur 1. Tudalen y dewin mewnforio i ddewis y math o god ffynhonnell y gellir ei fewnforio
Dewiswch Ffynhonnell a Tharged
Ar y dudalen dewin nesaf (Ffigur 2, "Tudalen y dewin mewnforio i ddewis y ffynhonnell a'r targed ar gyfer y mewnforio") rhaid nodi'r cyfeiriadur ffynhonnell a'r model targed.
Pwyswch y botwm Pori… i ddewis y cyfeiriadur lle mae'r cod ffynhonnell yn bodoli y dylid ei fewnforio. Yn ddiofyn, dewisir y man gwaith presennol oherwydd gallai hwn fod yn bwynt defnyddiol i ddechrau llywio.
Isod gallwch nodi cynnwys ac eithrio patrwm. Mae'n rhaid i'r patrwm hwn fod yn ymadroddion rheolaidd java. Mae pob llwybr mewnbwn, o'i gymharu â'r ffolder gwraidd ffynhonnell, yn cael ei wirio gyda'r patrwm hyn. Os yw'r patrwm cynnwys yn cyfateb, caiff ffolder ei fewnforio, os nad yw'r patrwm gwahardd yn cyfateb. Yn golygu bod y patrwm cynnwys yn rhag-ddewis y ffolderi i'w mewnforio, mae'r patrwm eithrio yn cyfyngu ar y rhagddewisiad hwn.
Ar ôl dewis y cyfeiriadur cod ffynhonnell rhaid diffinio model targed. Felly dewiswch brosiect amrywiad neu ffolder lle dylid storio'r model a rhowch enw model. Mae'r file enw yn cael ei ymestyn yn awtomatig gyda'r estyniad .ccfm os nad yw'n cael ei roi yn y dialog hwn. Yn ddiofyn bydd yn cael ei osod i'r un enw ag enw'r model ei hun. Dyma'r gosodiad a argymhellir.
Ar ôl nodi ffolder ffynhonnell hwylus a'r enw model a ddymunir, efallai y bydd yr ymgom yn cael ei orffen trwy wasgu Gorffen. Os bydd y botwm Nesaf yn cael ei wasgu, mae tudalen arall yn dod i fyny lle gellir gwneud gosodiadau ychwanegol.
Ffigur 2. Tudalen y dewin mewnforio i ddewis y ffynhonnell a'r targed ar gyfer y mewnforio
Newid Dewisiadau Mewnforio
Ar dudalen olaf y dewin (Ffigur 3, “Tudalen y dewin mewnforio i ddiffinio cyfluniad unigol”) mae dewisiadau y gellir eu gwneud i addasu'r ymddygiad mewnforio ar gyfer y prosiect meddalwedd a fewnforiwyd.
Mae'r dudalen deialog yn dangos tabl lle mae'r file diffinnir mathau, a fydd yn cael eu hystyried gan y broses fewnforio.
Mae pob llinell yn cynnwys pedwar maes.
- Mae'r maes Disgrifiad yn cynnwys testun disgrifiadol byr i nodi'r file math.
- Mae'r File Defnyddir maes patrwm enw i ddewis files i'w mewnforio pan fyddant yn cyfateb i werth y maes. Mae'r maes yn defnyddio'r gystrawen ganlynol:
- Efallai mai'r achos defnydd mwyaf cyffredin yw a file estyniad. Y gystrawen arferol yw .EXT, lle y dymunir EXT file estyniad (ee .java).
- Mae sefyllfa gyffredin arall yn arbennig file, fel gwneuthuriadfile. Felly, mae'n bosibl cyfateb ar yr union file enw. I wneud hyn, rhowch y file enw i mewn i'r maes (ee adeiladu.xml).
- Mewn rhai achosion mae'r dyheadau mapio yn fwy penodol, felly yn unig files sy'n cyfateb i batrwm arbennig dylid eu mewnforio. I gyd-fynd â'r gofyniad hwn gellir defnyddio ymadroddion rheolaidd yn y File enw maes patrwm.
Byddai desgrifio cystrawen ymadroddion rheolaidd yn rhagori ar fwriad yr help hwn. Edrychwch ar adran ymadroddion rheolaidd y bennod gyfeirio yn y canllaw defnyddiwr pur::amrywiadau (ee .*).
- Mae'r maes math elfen Mapio yn gosod y mapio rhwng a file math a pur::amrywiadau elfen teulu math. Mae'r math o elfen deuluol yn ddisgrifydd ar gyfer y ffynhonnell file i ddarparu rhagor o wybodaeth i'r elfen a fapiwyd yn y model a fewnforiwyd. Detholiadau nodweddiadol yw ps:class neu ps:makefile.
- Y Mapio file maes teip yn gosod y mapio rhwng a file math a pur::variants file math. Mae'r file teipiwch mewn pur::mae amrywiadau yn ddisgrifydd ar gyfer y ffynhonnell file i ddarparu rhagor o wybodaeth i'r elfen a fapiwyd yn y model a fewnforiwyd. Detholiadau nodweddiadol yw imp ar gyfer gweithrediadau neu def ar gyfer diffiniad files.
Ffigur 3. Tudalen y dewin mewnforio i ddiffinio cyfluniad unigol
Newydd file gellir ychwanegu mathau trwy ddefnyddio'r botwm Ychwanegu Mapio. Mae pob maes wedi'i lenwi â'r gwerth heb ei ddiffinio a rhaid i'r defnyddiwr ei lenwi. I olygu gwerth mewn maes, cliciwch i mewn i'r maes gyda'r llygoden. Daw'r gwerth yn olygadwy a gellir ei newid. Nid yw'n bosibl newid y rhagosodiad file patrymau enw'r tabl. Er mwyn gwneud addasiad yn hyblyg, mae'n bosibl dad-ddewis a file teipiwch trwy ddad-ddewis y rhes. Dad-ddethol file mae patrymau enw yn aros yn y ffurfweddiad ond ni fyddant yn cael eu defnyddio gan y mewnforiwr. Defnyddiwr wedi'i ddiffinio file gellir dileu mathau eto trwy ddefnyddio'r botwm Dileu Mapio.
Yn ddiofyn ac Arall files file patrwm enw ar gael yn y tabl ond wedi'i ddad-ddethol. Yn nodweddiadol nid oes eisiau mewnforio'r cyfan files ond gellir newid hyn yn hawdd trwy ddewis y rhes unol.
Mae yna dri opsiwn mewnforio cyffredinol i addasu ymddygiad y mewnforiwr.
- Peidiwch â mewnforio cyfeiriaduron heb eu paru files (ee cyfeirlyfrau CVS).
Os bydd y mewnforiwr yn dod o hyd i gyfeiriadur lle nad oes paru file sydd ynddo a lle nad oes gan unrhyw is-gyfeiriadur gyfatebiaeth file, ni fydd y cyfeiriadur yn cael ei fewnforio. Mae hyn yn aml yn ddefnyddiol, os caiff prosiectau eu rheoli gan systemau rheoli fersiynau fel CVS. Ar gyfer CVS, mae pob cyfeiriadur perthnasol yn cynnwys cyfeiriadur CVS lle mae'n amherthnasol files yn cael eu storio. Os dewisir yr opsiwn hwn a'r CVS-files ddim yn cyfateb i unrhyw file math a ddiffinnir uchod, ni fydd y cyfeiriadur yn cael ei fewnforio fel cydran i'r Model Teulu. - Trefnu files a chyfeiriaduron.
Galluogi'r opsiwn hwn i ddidoli files a chyfeiriaduron pob un yn nhrefn yr wyddor. - Mewnforio trin llwybr.
Ar gyfer cydamseru pellach mae angen i'r mewnforiwr storio llwybr gwreiddiol yr holl elfennau a fewnforiwyd i'r model.
Mewn llawer o achosion rhennir Modelau Teulu â defnyddwyr eraill. Gall strwythur y cyfeiriadur fod yn wahanol ar gyfer pob defnyddiwr. I gefnogi'r senarios defnydd mwyaf cyffredin gall y mewnforiwr weithio mewn gwahanol foddau:
| Yn hollol | Bydd y llwybr absoliwt i'r elfen a fewnforiwyd yn cael ei storio yn y model. Ar gyfer cydamseru diweddarach ac yn ystod y trawsnewid mae'r files rhaid gosod ar yr un lleoliad yn union ag yn ystod y mewnforio cyntaf. |
| Mewn perthynas â Gweithle | Mae'r llwybrau'n cael eu storio mewn perthynas â'r ffolder gweithle. Ar gyfer cydamseru mae'r files rhaid iddo fod yn rhan o weithle Eclipse. Rhaid i'r trawsnewidiad ddefnyddio'r man gwaith Eclipse fel cyfeiriadur mewnbwn. |
| Mewn perthynas â Phrosiect | Mae'r llwybrau'n cael eu storio mewn perthynas â'r prosiect. Ar gyfer cydamseru mae'r files yn rhan o'r prosiect y tu mewn i Eclipse. Mae'n rhaid i'r trawsnewidiad ddefnyddio'r ffolder prosiect fel cyfeiriadur mewnbwn. |
| Perthynol i'r Llwybr | Mae'r llwybrau'n cael eu storio mewn perthynas â'r llwybr penodol. Ar gyfer cydamseru mae'r files rhaid eu gosod yn union yr un lleoliad. Mae'r cyfeiriadur mewnbwn trawsnewid yr un fath â'r llwybr cymharol yn ystod y mewnforio. |
Mae holl ddewisiadau'r ymgom hwn yn cael eu storio'n barhaus. Ni ddylai'r addasiadau personol ail-wneud bob tro y bydd y mewnforio yn rhedeg. Mae hyn yn gwneud y llif gwaith mewnforio yn hawdd ac yn gyflym.
2.3. Diweddaru Modelau o Directory Tree
Pwyswch y botwm Cydamseru 
i gydamseru model wedi'i fewnforio â'i lwybr cyfeiriadur. Mae llwybr gwraidd y prosiect yn cael ei storio yn y model felly bydd yn cydamseru i'r un cyfeiriadur ag o'r blaen. I alluogi'r botwm Cydamseru, agorwch y model a dewiswch unrhyw elfen. Ar ôl pwyso'r botwm Cydamseru agorir Golygydd Cymharu lle gwrthwynebir y Model Teulu cyfredol a'r model o'r strwythur cyfeiriadur cyfredol (gweler Ffigur 4, “Diweddariad model o Directory Tree in Compare Editor”).
Ffigur 4. Diweddariad model o Directory Tree yn Compare Editor 
Defnyddir y golygydd cymharu drwyddi draw ::amrywiadau pur i gymharu fersiynau model ond yn yr achos hwn fe'i defnyddir i gymharu strwythur y cyfeiriadur ffisegol (a ddangosir yn yr ochr dde isaf) â'r model amrywiadau ::amrywiadau pur cyfredol (ochr chwith isaf). Rhestrir yr holl newidiadau fel eitemau ar wahân yn rhan uchaf y golygydd, wedi'u trefnu yn ôl yr elfennau yr effeithir arnynt.
Mae dewis eitem yn y rhestr hon yn amlygu'r newid priodol yn y ddau fodel. Yn y cynample, mae elfen ychwanegol wedi'i marcio â blwch ar yr ochr dde ac yn gysylltiedig â'i safle ymarferol yn y model ar yr ochr chwith. Mae'r bar offer Cyfuno rhwng ffenestri golygydd uchaf ac isaf yn darparu offer i gopïo un neu hyd yn oed yr holl newidiadau (nad ydynt yn gwrthdaro) yn ei gyfanrwydd o'r model coed cyfeiriadur i'r Model Nodwedd.
Nodyn
Mae'r cydamseriad yn cael ei wneud gyda'r gosodiadau mewnforiwr a ddefnyddiwyd ddiwethaf. Mae hyn yn ei gwneud hi'n bosibl diweddaru'r model gyda gosodiadau eraill fel y gwnaed tra gwnaed y mewnforio.
Defnyddio Mynegeiwr Perthynas
Mae'r Cysylltydd ar gyfer Rheoli Cod Ffynhonnell yn gwella'r Cysylltiadau View gyda gwybodaeth am gysylltiadau rhwng elfennau model::amrywiadau pur a chod ffynhonnell. Ychwanegir cysylltiadau ar gyfer nodweddion a ddefnyddir yn amodau'r elfennau ps:condxml a ps:condtext.
Ar gyfer ps:baner a ps:banerfile elfennau lleoliad cysonion rhagbrosesydd yn ffynhonnell C/C++ files yn cael eu dangos. Yn ogystal, dangosir lleoliadau cysonion rhagbrosesydd cyfatebol ar gyfer nodwedd ddetholedig trwy ddefnyddio'r mapio rhwng enwau nodweddion unigryw a chysonion rhagbrosesydd.
3.1. Ychwanegu'r Mynegeiwr Perthynas at Brosiect
Gellir actifadu'r mynegeiwr perthynas ar dudalen eiddo prosiect arbennig. Dewiswch y prosiect a dewiswch yr eitem Priodweddau yn y ddewislen cyd-destun. Yn yr ymgom sydd i ddod dewiswch y dudalen Mynegai Perthynas.
Ffigur 5. Tudalen Eiddo Prosiect ar gyfer y Mynegeiwr Perthynas
Mae'r mynegeiwr perthynas yn cael ei actifadu ar gyfer y prosiect trwy ddewis yr opsiwn Galluogi Mynegai Perthynas (1). Ar ôl galluogi'r mynegeiwr mae mwy o opsiynau i ddiffinio ymddygiad penodol y prosiect. Gellir actifadu mynegeio pur::amrywiadau Amodau a C/C ++ Cysonion Rhagbrosesydd ar wahân (2). Mae'r rhestr gyda file patrymau enw (3) yn cael ei ddefnyddio i ddewis y files ar gyfer mynegeio. Dim ond files sy'n cyfateb i un o'r patrymau yn cael eu sganio. Ychwanegwch y “*” fel patrwm i sganio popeth files o brosiect.
Ar ôl actifadu'r mynegeiwr ar gyfer prosiect ychwanegir adeiladwr at y prosiect. Newidiodd y sganiau adeiladwr hwn files ar gyfer cysylltiadau newydd i pur::amrywiadau elfennau model yn awtomatig.
3.2. Y Perthynas â'r Cod Ffynhonnell
Gyda mynegeiwr perthynas actifedig y Cysylltiadau View yn cynnwys cofnodion ychwanegol. Mae'r cofnodion hyn yn dangos enw'r file a rhif llinell y pwynt amrywiad. Mae'r awgrym offeryn yn dangos yr adran briodol o'r file. Trwy glicio ddwywaith ar y cofnod mae'r file yn cael ei agor yn olygydd.
pur::variants Conditions
Gellir defnyddio'r cyflwr amrywiadau:: pur i gynnwys neu eithrio adrannau o a file yn dibynnu ar ddewis nodwedd. Mae'r Mynegai Cyflwr yn sganio am reolau o'r fath ac yn tynnu'r nodweddion y cyfeirir atynt. Os dewisir nodwedd o'r fath yn y golygydd y Relations View bydd yn dangos y cyfan files a llinellau lle mae cyflwr gyda'r nodwedd a ddewiswyd wedi'i leoli (gweler Ffigur 6, “Cynrychiolaeth o Amod yn y Cysylltiadau View”).
Ffigwr 6. Cynrychioliad o Gyflwr yn y Perthynas View
I gael esboniad manwl ar sut i ddiffinio amodau, gweler yr adran ps:condtext ym mhennod 9.5.7 o'r pur::amrywiadau Canllaw Defnyddiwr (Cyfeirnod -> Mathau Elfennau Ffynhonnell Rhagosodol -> ps:condtext).
C/C++ Cysonion Rhagbrosesydd
Mae'r Mynegai Rhagbrosesydd C/C++ yn sganio files ar gyfer cysonion a ddefnyddir mewn rheolau rhagbrosesydd (ee #ifdef, #ifndef, …).
Os mai ps:baner neu ps:banerfile elfen yn cael ei ddewis y Cysylltiadau View yn dangos y defnydd o gysonyn rhagbrosesydd diffiniedig.
Y Perthynasau View hefyd yn dangos cysonion rhagbrosesydd sy'n gysylltiedig â nodweddion trwy ddefnyddio patrymau mapio. Ar gyfer hyn mae'r patrymau yn cael eu hehangu gyda data'r nodwedd a ddewiswyd. Defnyddir y symbolau canlyniadol i chwilio am gysonion rhagbrosesydd cyfatebol. Ffigur 7, “Cynrychiolaeth Cyson Rhagbrosesydd C/C++ yn y Cysylltiadau View” yn dangos cynampgyda'r patrwm enwogrwydd{Enw}. Mae'r patrwm yn cael ei ehangu gydag enw unigryw'r nodwedd i enwogrwydd. Yn y cod mynegeio mae 76 o leoliadau lle defnyddir yr enwogrwydd cyson rhagbrosesydd.
Dangosir y lleoliadau hyn yn y Cysylltiadau View. Gellir diffinio'r patrymau yn y dewisiadau (gweler Adran 3.3, “Y Dewisiadau”).
Ffigur 7. Cynrychioliad Cyson Rhagbrosesydd C/C++ yn y Cysylltiadau View
3.3. Y Dewisiadau
I newid ymddygiad rhagosodedig y mynegeiwr agorwch y dewisiadau Eclipse a dewiswch y dudalen Mynegeiwr Perthynas yn y categori Rheoli Amrywiadau. Mae'r dudalen yn dangos dwy restr.
Ffigur 8. Tudalen Dewis Mynegeiydd Perthynas
Mae'r rhestr uchaf yn cynnwys y rhagosodiad file patrymau ar gyfer y mynegeiwr (1). Y rhestr hon yw'r gosodiad patrwm cychwynnol ar gyfer prosiectau sydd newydd eu galluogi.
Mae'r rhestr isaf yn cynnwys y mapio rhwng nodweddion a chysonion rhagbrosesydd (2). Defnyddir y mapio hwn ar gyfer pob prosiect. Mae Tabl 1, “Amnewidiadau Mapio â Chymorth” yn dangos yr holl amnewidiadau posibl.
Tabl 1. Amnewid Mapiau â Chymorth
| Cerdyn gwyllt | Disgrifiad | Example: NodweddA |
| Enw | Enw Unigryw y nodwedd a ddewiswyd | FLAG_{Enw} – FLAG_FeatureA |
| ENW | y priflythrennau Enw Unigryw y nodwedd a ddewiswyd | FLAG_{NAME} – FLAG_FEATUREA |
| enw | y llythrennau bach Enw Unigryw y nodwedd a ddewiswyd | flag_{name} – flag_featurea |
Dogfennau / Adnoddau
 |
pur-systems 2024 Connector ar gyfer Meddalwedd Rheoli Cod Ffynhonnell [pdfLlawlyfr Defnyddiwr 2024, 2024 Connector ar gyfer Meddalwedd Rheoli Cod Ffynhonnell, Connector ar gyfer Meddalwedd Rheoli Cod Ffynhonnell, Meddalwedd Rheoli Cod Ffynhonnell, Meddalwedd Rheoli, Meddalwedd |
