pur::variants – Konnettur għal
Manwal tal-Ġestjoni tal-Kodiċi Sors
Parametric Technology GmbH
Verżjoni 6.0.7.685 għal pur::variants 6.0
Copyright © 2003-2024 Parametric Technology GmbH
2024

Introduzzjoni

pure::variants Konnettur għall-Ġestjoni tal-Kodiċi Sors (Konnettur) jippermetti lill-iżviluppaturi jimmaniġġjaw il-varjabbiltà tal-kodiċi tas-sors bl-użu ta 'pur::variants. Il-Ġestjoni tal-Kodiċi Sors ta 'pur::variants tipprovdi opportunità flessibbli biex tissinkronizza l-istrutturi tad-direttorju u l-kodiċi tas-sors files faċilment ma pur::varjanti mudelli. B'hekk il-ġestjoni tal-varjanti tista' tiġi applikata prattikabbli anke għal proġetti ta' softwer kumplessi. Barra minn hekk, il-konnessjonijiet bejn il-karatteristiċi pur::variants u l-kodiċi tas-sors jistgħu jiġu ġestiti aktar faċli mal-bennej u huma aċċessibbli ħafna permezz tal-Ġestjoni tal-Kodiċi Sors.
1.1. Rekwiżiti tas-Software
Il-pur::variants Connector għall-Immaniġġjar tal-Kodiċi Sors huwa estensjoni għal pur::variants u huwa disponibbli fuq il-pjattaformi kollha appoġġjati.
1.2. Installazzjoni
Jekk jogħġbok ikkonsulta t-taqsima pure::variants Connectors fil-pure::variants Setup Guide għal informazzjoni dettaljata dwar kif tinstalla l-konnettur (menu Għajnuna -> Help Kontenut u mbagħad pure::variants Setup Guide -> pure::variants Connectors).
1.3. Dwar dan il-manwal
Il-qarrej huwa mistenni li jkollu għarfien bażiku dwar u esperjenzi b'pur::variants. Jekk jogħġbok ikkonsulta l-materjal introduttorju tiegħu qabel taqra dan il-manwal. Il-manwal huwa disponibbli f'għajnuna onlajn kif ukoll f'format PDF stampabbli hawn.

Bl-użu tal-Konnettur

2.1. Bidu pur::varjanti
Skont il-metodu ta 'installazzjoni użat jew ibda l-Eclipse pur::variants-enabled jew taħt Windows agħżel l-oġġett pur::variants mill-menu tal-programm.
Jekk il-perspettiva tal-Ġestjoni tal-Varjanti mhix diġà attivata, agħmel dan billi tagħżel minn Perspettiva Miftuħa->Oħrajn... fil-menu tat-Tieqa.
2.2. Importa Siġra tad-Direttorju f'Mudell tal-Familja
Qabel ma tiġi importata siġra tad-direttorju f'Mudell tal-Familja, irid jinħoloq proġett ta' varjanti. Huwa wkoll suġġestiv li jkun hemm karatteristiċi definiti f'Mudell tal-Karatteristiċi diġà. Jekk jogħġbok ikkonsulta d-dokumentazzjoni pure::variants għal għajnuna dwar dawn il-passi.
L-importazzjoni attwali tinbeda billi tagħżel l-azzjoni Importa... jew fil-menu tal-kuntest tal-Proġetti view jew bil-menu Import... fil- File menu. Agħżel Mudelli tal-Varjanti jew Proġetti mill-kategorija Ġestjoni tal-Varjanti u agħfas Li jmiss. Fil-paġna li ġejja agħżel Importa Mudell tal-Familja minn folders tas-sors u agħfas Li jmiss għal darb'oħra.
Agħżel it-tip ta 'kodiċi tas-sors għall-importazzjoni
Jidher il-wizard tal-importazzjoni (ara Figura 1, "Paġna tal-wizard tal-importazzjoni biex tagħżel it-tip ta' kodiċi sors li jista' jiġi importat"). Agħżel tip ta' proġett biex timporta u agħfas Li jmiss. Kull tip fih sett predefinit ta ' file tipi għall-importazzjoni għall-mudell.
Figura 1. Paġna tal-wizard tal-importazzjoni biex tagħżel it-tip ta’ kodiċi tas-sors li jista’ jiġi importatAgħżel Sors u Mira
Fil-paġna tal-wizard li jmiss (Figura 2, "Paġna tal-wizard tal-importazzjoni biex tagħżel is-sors u l-mira għall-importazzjoni") id-direttorju tas-sors u l-mudell fil-mira għandhom jiġu speċifikati.
Agħfas il-buttuna Ibbrawżja... biex tagħżel id-direttorju fejn jeżisti l-kodiċi tas-sors li għandu jiġi importat. B'mod awtomatiku l-ispazju tax-xogħol attwali jintgħażel għax dan jista' jkun punt utli biex tibda n-navigazzjoni.
Hawn taħt tista 'tispeċifika tinkludi u teskludi mudell. Dawn il-mudelli għandhom ikunu espressjonijiet regolari java. Kull mogħdija ta 'input, relattiva għall-folder ta' l-għeruq tas-sors, hija kkontrollata b'dawn il-mudell. Jekk il-mudell tal-inklużjoni jaqblu, folder jiġi importat, jekk il-mudell tal-esklużjoni ma jaqbilx. Jiġifieri l-mudell ta 'inklużjoni ma tagħżel minn qabel il-folders għall-importazzjoni, il-mudell ta' esklużjoni ma jirrestrinġi din il-preselezzjoni.
Wara li tagħżel id-direttorju tal-kodiċi tas-sors irid jiġi definit mudell fil-mira. Għalhekk agħżel proġett varjant jew folder fejn għandu jinħażen il-mudell u daħħal isem tal-mudell. Il- file isem huwa estiż awtomatikament bl-estensjoni .ccfm jekk ma jingħatax f'dan id-djalogu. B'mod awtomatiku se jkun issettjat għall-istess isem bħall-isem tal-mudell innifsu. Dan huwa l-issettjar rakkomandat.
Wara li jiġu speċifikati folder tas-sors spedjenti u l-isem tal-mudell mixtieq, id-djalogu jista 'jispiċċa billi tagħfas Finish. Jekk tingħafas il-buttuna Li jmiss, tkun ġejja paġna oħra fejn jistgħu jsiru settings addizzjonali.
Figura 2. Paġna tal-wizard tal-importazzjoni biex tagħżel is-sors u l-mira għall-importazzjoniIbdel il-Preferenzi tal-Importazzjoni
Fl-aħħar paġna tal-wizard (Figura 3, “Paġna tal-wizard tal-importazzjoni biex tiddefinixxi konfigurazzjoni individwali”) hemm preferenzi li jistgħu jsiru biex tippersonalizza l-imġiba tal-importazzjoni għall-proġett tas-softwer importat.
Il-paġna tad-djalogu turi tabella fejn il- file tipi huma definiti, li se jiġu kkunsidrati mill-proċess ta 'importazzjoni.
Kull linja tikkonsisti f'erba' oqsma.

• Il-qasam Deskrizzjoni fih test deskrittiv qasir biex jidentifika l- file tip.
• Il- File qasam tal-mudell tal-isem huwa użat biex tagħżel files li jiġu importati meta jaqblu mal-valur oqsma. Il-qasam juża s-sintassi li ġejja:

1. L-aktar użu komuni jista' jkun a file estensjoni. Is-sintassi tas-soltu hija .EXT, fejn EXT hija dik mixtieqa file estensjoni (eż. .java).
2. Sitwazzjoni komuni oħra hija speċjali file, bħal tagħmelfile. Għalhekk, huwa possibbli li tqabbel fuq l-eżatt file isem. Biex tagħmel dan, daħħal biss il- file isem fil-qasam (eż. build.xml).
3. F'xi każijiet ix-xewqat tal-mapping huma aktar speċifiċi, allura biss files li jaqblu ma 'mudell speċjali għandhom jiġu importati. Biex taqdi dan ir-rekwiżit huwa possibbli li jintużaw espressjonijiet regolari fil- File qasam tal-mudell tal-isem.
   Id-deskrizzjoni tas-sintassi ta 'espressjonijiet regolari jaqbeż l-intenzjoni ta' din l-għajnuna. Jekk jogħġbok ikkonsulta t-taqsima tal-espressjonijiet regolari tal-kapitolu ta' referenza fil-gwida tal-utent pur::variants (eż..*).

• Il-qasam tat-tip tal-element Mapped jistabbilixxi l-immappjar bejn a file tip u tip ta' element tal-familja pur::variants. It-tip tal-element tal-familja huwa deskrittur għas-sors file biex tipprovdi aktar informazzjoni lill-element immappjat fil-mudell importat. Għażliet tipiċi huma ps:class jew ps:makefile.
• Il-Mapped file qasam tat-tip jistabbilixxi l-immappjar bejn a file tip u pur::varjanti file tip. Il- file tip pur::variants huwa deskrittur għas-sors file biex tipprovdi aktar informazzjoni lill-element immappjat fil-mudell importat. Għażliet tipiċi huma impl għall-implimentazzjonijiet jew def għad-definizzjoni files.

Figura 3. Paġna tal-wizard tal-importazzjoni biex tiddefinixxi konfigurazzjoni individwaliĠdid file tipi jistgħu jiġu miżjuda billi tuża l-buttuna Żid Mapping. L-oqsma kollha huma mimlija bil-valur mhux definit u għandhom jimtlew mill-utent. Biex teditja valur f'qasam, ikklikkja fil-qasam bil-maws. Il-valur isir editjabbli u jista' jinbidel. Mhux possibbli li tinbidel l-inadempjenza file mudelli tal-isem tat-tabella. Biex tagħmel customization flessibbli, huwa possibbli li deselect a file ittajpja billi neħħi l-għażla tar-ringiela. Magħżula file mudelli tal-ismijiet jibqgħu fil-konfigurazzjoni iżda mhux se jintużaw mill-importatur. Iddefinit mill-utent file tipi jistgħu jerġgħu jitneħħew billi tuża l-buttuna Neħħi l-Immappjar.
B'mod awtomatiku Oħrajn files file il-mudell tal-isem huwa disponibbli fit-tabella iżda mhux magħżul. Tipikament ma jkunx ried li jimporta kollha files iżda dan jista 'jinbidel faċilment billi tagħżel ir-ringiela skond.
Hemm tliet għażliet ġenerali ta 'importazzjoni biex tippersonalizza l-imġieba ta' l-importatur.

• Timportax direttorji mingħajr tqabbil files (eż. direttorji CVS).
  Jekk l-importatur isib direttorju fejn l-ebda tqabbil file tinsab fiha u fejn l-ebda subdirectory ma għandu tqabbil file, id-direttorju mhux se jiġi importat. Dan huwa spiss utli, jekk il-proġetti huma ġestiti minn sistemi ta 'ġestjoni tal-verżjoni bħal CVS. Għal CVS, kull direttorju rilevanti fih direttorju CVS fejn irrelevanti files huma maħżuna. Jekk tintgħażel din l-għażla u l-CVS-files ma jaqblux ma 'xi file tip definit hawn fuq, id-direttorju mhux se jiġi importat bħala komponent fil-Mudell tal-Familja.
• Issortja files u direttorji.
  Ippermetti din l-għażla biex issolvi files u direttorji kull wieħed f'ordni alfabetiku.
• Immaniġġjar tal-mogħdijiet tal-importazzjoni.
  Għal aktar sinkronizzazzjoni l-importatur jeħtieġ li jaħżen il-mogħdija oriġinali tal-elementi kollha importati fil-mudell.
  F'ħafna każijiet il-Mudelli tal-Familja huma kondiviżi ma' utenti oħra. L-istruttura tad-direttorju tista' tkun differenti għal kull utent. Biex jappoġġja l-aktar xenarji ta' użu komuni l-importatur jista' jaħdem f'modi differenti:

Assoluta	Il-mogħdija assoluta għall-element importat se tinħażen fil-mudell. Għal sinkronizzazzjoni aktar tard u matul it-trasformazzjoni l files għandhom jitqiegħdu fuq eżattament l-istess post bħal matul l-ewwel importazzjoni.
Relattiv għall-Ispazju tax-Xogħol	Il-mogħdijiet huma maħżuna relattivi għall-folder tal-ispazju tax-xogħol. Għas-sinkronizzazzjoni l files trid tkun parti mill-ispazju tax-xogħol Eclipse. It-trasformazzjoni trid tuża l-ispazju tax-xogħol Eclipse bħala direttorju tal-input.
Relattiv għall-Proġett	Il-mogħdijiet huma maħżuna relattivi għall-proġett. Għas-sinkronizzazzjoni l files huma parti mill-proġett ġewwa Eclipse. It-trasformazzjoni trid tuża l-folder tal-proġett bħala direttorju tal-input.
Relattiv għal Path	Il-mogħdijiet huma maħżuna relattivi għall-mogħdija mogħtija. Għas-sinkronizzazzjoni l files għandhom jitqiegħdu eżattament fl-istess post. Id-direttorju tad-dħul tat-trasformazzjoni huwa l-istess bħall-mogħdija relattiva matul l-importazzjoni.

Il-preferenzi kollha ta' dan id-djalogu huma maħżuna b'mod persistenti. Il-personalizzazzjonijiet personali m'għandhomx jerġgħu jsiru kull darba li l-importazzjoni taħdem. Dan jagħmel il-fluss tax-xogħol tal-importazzjoni faċli u veloċi.
2.3. Aġġornament tal-Mudelli minn Directory Tree
Agħfas il-buttuna Sinkronizza biex tissinkronizza mudell importat mal-passaġġ tad-direttorju tiegħu. Il-mogħdija ta 'l-għerq tal-proġett hija maħżuna fil-mudell u għalhekk se tissinkronizza ma' l-istess direttorju bħal qabel. Biex tattiva l-buttuna Sinkronizza, iftaħ il-mudell u agħżel kwalunkwe element. Wara li tagħfas il-buttuna Sinkronizza, jinfetaħ Editur Qabbel fejn il-Mudell tal-Familja attwali u l-mudell tal-istruttura tad-direttorju attwali huma opposti (ara Figura 4, "Aġġornament tal-Mudell minn Siġra tad-Direttorju fl-Editur Qabbel").
Figura 4. Aġġornament tal-mudell minn Directory Tree fl-Editur Qabbel   L-editur tat-tqabbil jintuża matul pure::variants biex iqabbel il-verżjonijiet tal-mudell iżda f'dan il-każ jintuża biex iqabbel l-istruttura tad-direttorju fiżiku (wiri fin-naħa t'isfel tal-lemin) mal-mudell kurrenti pur::variants (in-naħa t'isfel tax-xellug). Il-bidliet kollha huma elenkati bħala oġġetti separati fil-parti ta 'fuq tal-editur, ordnati mill-elementi affettwati.
L-għażla ta 'oġġett f'din il-lista tenfasizza l-bidla rispettiva fiż-żewġ mudelli. Fl-example, element miżjud huwa mmarkat b'kaxxa fuq in-naħa tal-lemin u konness mal-pożizzjoni fattibbli tiegħu fil-mudell fuq in-naħa tax-xellug. Il-Toolbar Merge bejn it-twieqi tal-editur ta' fuq u t'isfel jipprovdi għodda biex tikkopja bidliet singoli jew saħansitra kollha (mhux konfliġġenti) kollha kemm huma mill-mudell tas-siġra tad-direttorju għall-Mudell tal-Karatteristiċi.
Nota
Is-sinkronizzazzjoni ssir bl-aħħar settings tal-importatur użati. Dan jagħmilha possibbli li l-mudell jiġi aġġornat b'settings oħra kif magħmula waqt li tkun saret l-importazzjoni.

Bl-użu ta' Relation Indexer

Il-Konnettur għall-Ġestjoni tal-Kodiċi Sors isaħħaħ ir-Relazzjonijiet View b'informazzjoni dwar konnessjonijiet bejn l-elementi tal-mudell pur::variants u l-kodiċi tas-sors. Ir-relazzjonijiet huma miżjuda għal karatteristiċi li jintużaw fil-kundizzjonijiet tal-elementi ps:condxml u ps:condtext.
Għal ps:bandiera u ps:bandierafile elementi l-post tal-kostanti tal-preproċessur fis-sors C/C++ files huma murija. Barra minn hekk il-postijiet tal-kostanti tal-preproċessur li jaqblu huma murija għal karatteristika magħżula bl-użu tal-immappjar bejn ismijiet uniċi tal-karatteristiċi u l-kostanti tal-preproċessur.
3.1. Żieda tal-Indiċier tar-Relazzjoni għal Proġett
L-indiċjar tar-relazzjoni jista 'jiġi attivat fuq paġna speċjali tal-proprjetà tal-proġett. Agħżel il-proġett u agħżel l-oġġett Proprjetajiet fil-menu tal-kuntest. Fid-djalogu li jmiss agħżel il-paġna Relation Indexer.
Figura 5. Paġna tal-Proprjetà tal-Proġett għar-Relation Indexer

L-indiċitur tar-relazzjoni jiġi attivat għall-proġett billi tagħżel l-għażla Ippermetti Indiċier tar-Relazzjoni (1). Wara li tippermetti l-indiċjar hemm xi għażliet aktar biex tiddefinixxi l-imġiba speċifika tal-proġett. L-indiċjar tal-Kundizzjonijiet pur::variants u l-Kostanti ta' Preproċessur C/C++ jistgħu jiġu attivati ​​separatament (2). Il-lista ma file mudelli isem (3) huwa użat biex tagħżel l- files għall-indiċjar. Biss files li jaqblu ma 'wieħed mill-mudelli huma skennjati. Żid il-“*” bħala mudell biex tiskennja kollha files ta 'proġett.
Wara li jiġi attivat l-indiċjar għal proġett, bennej jiżdied mal-proġett. Dan l-iskans tal-bennej inbidlu files għal relazzjonijiet ġodda għal pur::variants mudell elementi awtomatikament.
3.2. Ir-Relazzjonijiet mal-Kodiċi Sors
Bil-indiċi tar-relazzjoni attivat ir-Relazzjonijiet View fih entrati addizzjonali. Dawn l-entrati juru l-isem tal- file u n-numru tal-linja tal-punt varjant. Il-ponta tal-għodda turi s-sezzjoni xierqa tal- file. Billi tikklikkja darbtejn fuq l-entrata file se jinfetaħ f'editur.
pur::varjanti Kundizzjonijiet
Il-kundizzjoni pura::variants tista' tintuża biex tinkludi jew teskludi sezzjonijiet ta' a file jiddependi fuq għażla ta 'karatteristika. L-Indiċjar tal-Kundizzjoni jiskenja għal regoli bħal dawn u jiġbed il-karatteristiċi referenzjati. Jekk karatteristika bħal din hija magħżula fl-editur ir-Relazzjonijiet View se juri kollox files u linji fejn tinsab kundizzjoni bil-karatteristika magħżula (ara Figura 6, “Rappreżentanza ta’ Kundizzjoni fir-Relazzjonijiet View”).
Figura 6. Rappreżentazzjoni ta' Kundizzjoni fir-Relazzjonijiet ViewBiex tikseb spjegazzjoni dettaljata dwar kif tiddefinixxi l-kundizzjonijiet, ikkonsulta t-taqsima ps:condtext tal-kapitolu 9.5.7 tal-Gwida tal-Utent pur::variants (Referenza–>Tipi ta’ Elementi Sors Predefiniti–>ps:condtext).
Kostanti ta' Preproċessur C/C++
Il-C/C++ Preprocessor Indexer jiskenja files għall-kostanti użati fir-regoli tal-preproċessur (eż. #ifdef, #ifndef, …).
Jekk ps:bandiera jew ps:bandierafile l-element jintgħażel ir-Relazzjonijiet View turi l-użu tal-kostanti tal-preproċessur definit.
Ir-Relazzjonijiet View juri wkoll il-kostanti tal-preproċessur konnessi mal-karatteristiċi billi tuża mudelli ta 'mapping. Għal dan il-mudelli huma estiżi bid-dejta tal-karatteristika magħżula. Is-simboli li jirriżultaw huma użati biex ifittxu kostanti ta 'preproċessur li jaqblu. Figura 7, “Rappreżentanza ta' Kostanti ta' Preproċessur C/C++ fir-Relazzjonijiet View” turi example bil-mudell fama{Isem}. Il-mudell huwa estiż bl-isem uniku tal-karatteristika għal fameNative. Fil-kodiċi indiċjat hemm 76 post fejn tintuża l-fameNative kostanti tal-preproċessur.
Dawn il-postijiet huma murija fir-Relazzjonijiet View. Il-mudelli jistgħu jiġu definiti fil-preferenzi (ara t-Taqsima 3.3, "Il-Preferenzi").
Figura 7. Rappreżentazzjoni ta 'Kostanti ta' Preproċessur C/C++ fir-Relazzjonijiet View

3.3. Il-Preferenzi
Biex tibdel l-imġiba awtomatika tal-indiċjar, iftaħ il-preferenzi tal-Eclipse u agħżel il-paġna tal-Indiċjar tar-Relazzjoni fil-kategorija tal-Ġestjoni tal-Varjanti. Il-paġna turi żewġ listi.
Figura 8. Relation Indexer Preferenza paġnaIl-lista ta 'fuq fiha l-default file mudelli għall-indiċi (1). Din il-lista hija l-issettjar tal-mudell inizjali għal proġetti li għadhom kif ġew attivati.
Il-lista t'isfel fiha l-immappjar bejn il-karatteristiċi u l-kostanti tal-preproċessur (2). Dan l-immappjar jintuża għall-proġetti kollha. Tabella 1, "Sostituzzjonijiet ta' Mapping Sostnuti" turi s-sostituzzjonijiet kollha possibbli.
Tabella 1. Sostituzzjonijiet ta' Mapping Sostnuti

Wildcard	Deskrizzjoni	Example: FeatureA
Isem	l-Isem Uniku tal-karatteristika magħżula	FLAG_{Isem} – FLAG_FeatureA
ISEM	l-Isem Uniku b'tipa kbira tal-karatteristika magħżula	FLAG_{NAME} – FLAG_FEATUREA
isem	l-Isem Uniku b'tipa żgħira tal-karatteristika magħżula	bandiera_{isem} – karatteristika_bandiera

Dokumenti / Riżorsi

pure-systems 2024 Konnettur għal Software ta' Ġestjoni tal-Kodiċi Sors [pdfManwal tal-Utent 2024, 2024 Konnettur għal Software ta' Ġestjoni ta' Kodiċi Sors, ​​Konnettur għal Software ta' Ġestjoni ta' Kodiċi Sors, ​​Software ta' Ġestjoni ta' Kodiċi Sors, ​​Software ta' Ġestjoni, Software

Referenzi

• Manwal għall-Utent