puro :: variants – Konektor para sa
Manwal sa Pagdumala sa Source Code
Parametric Technology GmbH
Bersyon 6.0.7.685 para sa puro :: variants 6.0
Copyright © 2003-2024 Parametric Technology GmbH
2024

Pasiuna

pure :: variants Connector for Source Code Management (Connector) makapahimo sa mga developers sa pagdumala sa source code variability gamit ang pure::variants. Ang Pagdumala sa Source Code sa puro:: mga variant naghatag usa ka flexible nga oportunidad sa pag-synchronize sa mga istruktura sa direktoryo ug source code files dali nga adunay puro:: variants nga mga modelo. Sa ingon ang pagdumala sa mga variant mahimong magamit nga praktikal bisan sa komplikado nga mga proyekto sa software. Dugang pa, ang mga koneksyon tali sa purong:: mga variant nga mga bahin ug source code mahimong madumala nga mas sayon ​​uban sa magtutukod ug ma-access kaayo pinaagi sa Source Code Management.
1.1. Mga Kinahanglanon sa Software
Ang pure::variants Connector for Source Code Management usa ka extension para sa pure::variants ug anaa sa tanang gisuportahan nga plataporma.
1.2. Pag-instalar
Palihog konsultaha ang seksyon nga puro::variants Connectors sa pure::variants Setup Guide para sa detalyadong impormasyon kon unsaon pag-install sa connector (menu Help -> Help Contents ug dayon pure::variants Setup Guide -> pure::variants Connectors).
1.3. Mahitungod niini nga manwal
Ang magbabasa gilauman nga adunay sukaranan nga kahibalo ug mga kasinatian nga adunay puro:: mga variant. Palihug konsultaha ang pasiuna nga materyal niini sa dili pa basahon kini nga manwal. Ang manwal anaa sa online nga tabang ingon man sa printable PDF format dinhi.

Paggamit sa Konektor

2.1. Nagsugod nga puro::variants
Depende sa pamaagi sa pag-install nga gigamit mahimong magsugod sa pure::variants-enabled Eclipse o ubos sa Windows pilia ang pure::variants item gikan sa menu sa programa.
Kung ang panglantaw sa Variant Management wala pa ma-activate, buhata kini pinaagi sa pagpili niini gikan sa Open Perspective->Other... sa Window menu.
2.2. Pag-import sa usa ka Direktoryo nga Puno sa usa ka Modelo sa Pamilya
Sa dili pa i-import ang usa ka punoan sa direktoryo sa usa ka Modelo sa Pamilya, kinahanglan nga maghimo usa ka variant nga proyekto. Usab kini gisugyot nga adunay mga bahin nga gihubit sa usa ka Feature Model na. Palihog konsultaha ang pure::variants nga dokumentasyon para sa tabang mahitungod niini nga mga lakang.
Ang aktuwal nga pag-import gisugdan pinaagi sa pagpili sa Import… aksyon bisan sa menu sa konteksto sa Mga Proyekto view o uban sa Import… menu sa File menu. Pilia ang Variant Models o Projects gikan sa kategorya nga Variant Management ug pindota ang Next. Sa sunod nga panid pilia ang Pag-import ug Modelo sa Pamilya gikan sa gigikanan nga mga folder ug pindota ang Sunod pag-usab.
Pagpili og matang sa source code nga i-import
Ang import wizard makita (tan-awa ang Figure 1, "Pahina sa import wizard aron mapili ang matang sa source code nga mahimong i-import"). Pagpili usa ka tipo sa proyekto nga i-import ug pindota ang Next. Ang matag matang naglangkob sa usa ka predefined set sa file mga tipo nga i-import sa modelo.
Figure 1. Panid sa import wizard aron mapili ang matang sa source code nga mahimong ma-importPilia ang Tinubdan ug Target
Sa sunod nga wizard page (Figure 2, "Pahina sa import wizard aron mapili ang gigikanan ug ang target alang sa pag-import") ang tinubdan nga direktoryo ug ang target nga modelo kinahanglang itakda.
Pindota ang Browse… button aron mapili ang direktoryo diin anaa ang source code nga kinahanglang i-import. Pinaagi sa default ang kasamtangan nga workspace gipili tungod kay kini mahimong usa ka mapuslanon nga punto sa pagsugod sa pag-navigate.
Sa ubos mahimo nimong ipiho ang apil ug dili iapil ang pattern. Kini nga mga sumbanan kinahanglan nga java regular nga mga ekspresyon. Ang matag agianan sa pag-input, nga may kalabotan sa gigikanan nga folder sa gigikanan, gisusi sa kini nga sumbanan. Kung ang apil nga pattern match, usa ka folder ang gi-import, kung ang dili iapil nga pattern dili motakdo. Buot ipasabot nga ang paglakip nga sumbanan nagpili daan sa mga folder nga i-import, ang dili iapil nga sumbanan nagpugong niini nga preselection.
Pagkahuman sa pagpili sa direktoryo sa source code kinahanglan nga ipasabut ang usa ka target nga modelo. Busa pagpili og lain nga proyekto o usa ka folder diin ang modelo kinahanglan nga tipigan ug pagsulod sa usa ka modelo nga ngalan. Ang file Awtomatiko nga gipalugway ang ngalan gamit ang .ccfm extension kung wala kini gihatag sa kini nga dialog. Pinaagi sa default kini ibutang sa parehas nga ngalan sa ngalan sa modelo mismo. Kini ang girekomenda nga setting.
Human matino ang angayan nga tinubdan nga folder ug ang gitinguha nga ngalan sa modelo, ang dialog mahimong mahuman pinaagi sa pagpindot sa Finish. Kung ang Sunod nga buton gipugos, usa ka dugang nga panid ang moabut kung diin mahimo ang dugang nga mga setting.
Figure 2. Panid sa import wizard aron mapili ang tinubdan ug ang target sa importUsba ang Import Preferences
Sa katapusang panid sa wizard (Figure 3, "Pahina sa import wizard aron mahibal-an ang usa ka indibidwal nga pagsumpo”) adunay mga gusto nga mahimo aron ipahiangay ang pamatasan sa pag-import alang sa gi-import nga proyekto sa software.
Ang dialog page nagpakita sa usa ka lamesa diin ang file gihubit ang mga tipo, nga pagaisipon sa proseso sa pag-import.
Ang matag linya naglangkob sa upat ka mga field.

• Ang Deskripsyon natad adunay usa ka mubo nga deskriptibo nga teksto aron mailhan ang file tipo.
• Ang File ngalan pattern field gigamit sa pagpili files nga i-import kung kini motugma sa kantidad sa mga uma. Gigamit sa field ang mosunod nga syntax:

1. Ang labing komon nga usecase mahimong a file extension. Ang naandan nga syntax mao ang .EXT, diin ang EXT ang gusto file extension (eg .java).
2. Ang laing komon nga sitwasyon mao ang usa ka espesyal file, sama sa paghimofile. Busa, kini mao ang posible nga sa pagpares sa eksakto file ngalan. Aron mahimo kini, pagsulod lang sa file ngalan sa uma (eg build.xml).
3. Sa pipila ka mga kaso ang mga tinguha sa pagmapa mas espesipiko, mao ra files nga mohaum sa usa ka espesyal nga sumbanan kinahanglan nga imported. Aron mohaum niini nga kinahanglanon posible nga gamiton ang regular nga mga ekspresyon sa File ngalan pattern field.
   Ang paghubit sa syntax sa regular nga mga ekspresyon molapas sa katuyoan niini nga tabang. Palihog konsultaha ang regular nga mga ekspresyon nga seksyon sa reperensiya nga kapitulo sa pure::variants user's guide (eg .*).

• Ang Mapped element type field nagtakda sa mapping tali sa a file type ug usa ka pure::variants family element type. Ang tipo sa elemento sa pamilya usa ka deskriptor alang sa gigikanan file sa paghatag og dugang nga impormasyon ngadto sa mapa nga elemento sa imported nga modelo. Ang kasagarang mga pagpili mao ang ps:class o ps:makefile.
• Ang Mapa file type field nagtakda sa mapping tali sa a file type ug usa ka puro::variants file tipo. Ang file i-type ang pure::variants kay usa ka deskriptor sa tinubdan file sa paghatag og dugang nga impormasyon ngadto sa mapa nga elemento sa imported nga modelo. Ang kasagarang mga pagpili kay impl para sa mga implementasyon o def para sa kahulugan files.

Figure 3. Panid sa import wizard aron ipasabot ang indibidwal nga configurationBag-o file Ang mga tipo mahimong idugang pinaagi sa paggamit sa Add Mapping button. Ang tanan nga mga natad napuno sa kantidad nga wala matino ug kinahanglan nga pun-on sa tiggamit. Aron ma-edit ang usa ka kantidad sa usa ka uma, pag-klik lang sa uma gamit ang mouse. Ang bili mahimong ma-edit ug mahimong usbon. Dili mahimo nga usbon ang default file ngalan patterns sa lamesa. Aron mahimong flexible ang usa ka customization, posible nga i-deselect a file type pinaagi sa pag-deselect sa row. Gi-deselect file Ang mga pattern sa ngalan nagpabilin sa configuration apan dili gamiton sa importer. Gihubit sa tiggamit file Ang mga tipo mahimong tangtangon pag-usab pinaagi sa paggamit sa Remove Mapping button.
Pinaagi sa default usa ka Other files file Ang pattern sa ngalan anaa sa lamesa apan wala mapili. Kasagaran dili gusto nga i-import ang tanan files apan kini dali nga mausab pinaagi sa pagpili sa sumala nga laray.
Adunay tulo ka kinatibuk-ang mga kapilian sa pag-import aron ipasadya ang pamatasan sa tig-import.

• Ayaw pag-import og mga direktoryo nga walay katugbang files (eg mga direktoryo sa CVS).
  Kung makit-an sa importer ang usa ka direktoryo diin wala’y katugbang file anaa niini ug diin walay subdirectory nga adunay katugbang file, ang direktoryo dili ma-import. Kanunay kini nga mapuslanon, kung ang mga proyekto gidumala sa mga sistema sa pagdumala sa bersyon sama sa CVS. Alang sa CVS, ang matag may kalabutan nga direktoryo adunay sulud nga CVS-direktoryo kung diin wala’y kalabotan files gitipigan. Kung gipili kini nga kapilian ug ang CVS-files dili tugma sa bisan unsa file type nga gihubit sa ibabaw, ang direktoryo dili ma-import ingon usa ka sangkap sa Modelo sa Pamilya.
• Pagsunud-sunod files ug mga direktoryo.
  I-enable kini nga opsyon sa paghan-ay files ug mga direktoryo matag usa sa alpabetikong han-ay.
• Pag-import sa agianan sa pagdumala.
  Alang sa dugang nga pag-synchronize kinahanglan nga tipigan sa importer ang orihinal nga agianan sa tanan nga gi-import nga mga elemento sa modelo.
  Sa daghang mga kaso ang Mga Modelo sa Pamilya gipaambit sa ubang mga tiggamit. Ang istruktura sa direktoryo mahimong lahi alang sa matag tiggamit. Aron masuportahan ang kasagarang mga senaryo sa paggamit ang tig-import mahimong molihok sa lainlaing mga paagi:

Hingpit	Ang hingpit nga agianan sa imported nga elemento itago sa modelo. Alang sa ulahi nga pag-synchronize ug sa panahon sa pagbag-o sa files kinahanglan nga ibutang sa eksaktong sama nga lokasyon sama sa panahon sa unang import.
Relatibo sa Workspace	Ang mga agianan gitipigan kalabot sa folder sa workspace. Alang sa pag-synchronize sa files kinahanglan nga mahimong bahin sa Eclipse workspace. Ang pagbag-o kinahanglan nga gamiton ang Eclipse workspace isip input directory.
Relatibo sa Proyekto	Ang mga agianan gitipigan kalabot sa proyekto. Alang sa pag-synchronize sa files kabahin sa proyekto sulod sa Eclipse. Ang pagbag-o kinahanglan nga gamiton ang folder sa proyekto isip direktoryo sa input.
Relatibo sa Dalan	Ang mga agianan gitipigan kalabot sa gihatag nga agianan. Alang sa pag-synchronize sa files kinahanglan nga ibutang sa eksakto nga parehas nga lokasyon. Ang direktoryo sa input sa pagbag-o parehas sa paryente nga agianan sa panahon sa pag-import.

Ang tanan nga mga gusto niini nga diyalogo kanunay nga gitipigan. Ang mga personal nga pagpahiangay kinahanglan dili usbon sa matag higayon nga ang pag-import modagan. Kini naghimo sa import workflow sayon ​​ug paspas.
2.3. Pag-update sa mga Modelo gikan sa Directory Tree
Pindota ang Synchronize button aron i-synchronize ang usa ka imported nga modelo sa iyang direktoryo nga agianan. Ang gamut nga agianan sa proyekto gitipigan sa modelo aron kini mag-synchronize sa parehas nga direktoryo sama kaniadto. Aron mahimo ang buton nga I-synchronize, ablihi ang modelo ug pilia ang bisan unsang elemento. Human sa pagpindot sa Synchronize button usa ka Compare Editor ang giablihan diin ang kasamtangan nga Family Model ug ang modelo sa kasamtangan nga directory structure gisupak (tan-awa ang Figure 4, "Model update from Directory Tree in Compare Editor").
Figure 4. Pag-update sa modelo gikan sa Directory Tree sa Compare Editor   Ang itandi editor gigamit sa tibuok puro:: variants sa pagtandi sa modelo nga bersyon apan sa niini nga kaso gigamit sa pagtandi sa pisikal nga direktoryo nga istruktura (gipakita sa ubos sa tuo nga kilid) uban sa kasamtangan nga puro:: variants modelo (ubos sa wala nga bahin). Ang tanan nga mga pagbag-o gilista isip bulag nga mga butang sa ibabaw nga bahin sa editor, nga gimando sa mga apektadong elemento.
Ang pagpili sa usa ka butang niini nga listahan nagpasiugda sa tagsa-tagsa nga kausaban sa duha ka mga modelo. Sa example, ang usa ka dugang nga elemento gimarkahan sa usa ka kahon sa tuo nga bahin ug konektado sa posible nga posisyon niini sa modelo sa wala nga bahin. Ang Merge toolbar tali sa taas ug ubos nga editor windows naghatag og mga himan sa pagkopya sa usa o bisan sa tanan nga (dili magkasumpaki) nga mga pagbag-o sa kinatibuk-an gikan sa directory tree model ngadto sa Feature Model.
Nota
Ang pag-synchronize gihimo sa katapusang gigamit nga mga setting sa importer. Kini nagpaposible sa pag-update sa modelo sa ubang mga setting sama sa gihimo samtang ang pag-import gihimo.

Paggamit sa Relation Indexer

Ang Konektor alang sa Pagdumala sa Source Code nagpauswag sa mga Relasyon View uban sa impormasyon mahitungod sa mga koneksyon tali sa pure :: variants model elements ug source code. Ang mga relasyon gidugang alang sa mga bahin nga gigamit sa mga kondisyon sa ps:condxml ug ps:condtext nga mga elemento.
Para sa ps:flag ug ps:flagfile elemento ang lokasyon sa preprocessor constants sa C/C++ source files gipakita. Dugang pa ang mga lokasyon sa pagpares sa preprocessor constants gipakita alang sa usa ka pinili nga bahin pinaagi sa paggamit sa mapping tali sa feature nga talagsaon nga mga ngalan ug preprocessor constants.
3.1. Pagdugang sa Relation Indexer sa usa ka Proyekto
Ang relation indexer mahimong ma-aktibo sa usa ka espesyal nga panid sa propyedad sa proyekto. Pilia ang proyekto ug pilia ang butang nga Properties sa menu sa konteksto. Sa umaabot nga dialog pilia ang Relation Indexer nga panid.
Figure 5. Project Property Page para sa Relation Indexer

Ang relation indexer gi-activate para sa proyekto pinaagi sa pagpili sa Enable Relation Indexer option (1). Human ma-enable ang indexer adunay uban pang mga kapilian sa paghubit sa piho nga kinaiya sa proyekto. Ang pag-indeks sa pure::variants Conditions ug C/C++ Preprocessor Constants mahimong ma-activate nga gilain (2). Ang listahan nga adunay file Ang mga pattern sa ngalan (3) gigamit sa pagpili sa files alang sa pag-indeks. Lamang files nga mohaum sa usa sa mga pattern gi-scan. Idugang ang "*" isip sumbanan aron ma-scan ang tanan files sa usa ka proyekto.
Human ma-aktibo ang indexer alang sa usa ka proyekto ang usa ka magtutukod idugang sa proyekto. Kini nga magtutukod scan nausab files alang sa bag-ong mga relasyon ngadto sa puro:: variants modelo nga mga elemento awtomatikong.
3.2. Ang Relasyon sa Source Code
Uban sa gi-activate nga relation indexer ang Relations View adunay dugang nga mga entries. Kini nga mga entry nagpakita sa ngalan sa file ug ang numero sa linya sa lain-laing punto. Ang tip sa himan nagpakita sa angay nga seksyon sa file. Pinaagi sa pag-double click sa entry sa file maablihan sa usa ka editor.
puro::variants Kondisyon
Ang puro::variants nga kondisyon mahimong gamiton aron iapil o dili iapil ang mga seksyon sa a file depende sa pagpili sa feature. Ang Condition Indexer nag-scan alang sa ingon nga mga lagda ug nagkuha sa gi-refer nga mga bahin. Kung ang ingon nga bahin gipili sa editor ang Relations View ipakita ang tanan files ug mga linya diin ang usa ka kondisyon nga adunay gipili nga bahin nahimutang (tan-awa ang Figure 6, "Representasyon sa usa ka Kondisyon sa mga Relasyon View”).
Figure 6. Representasyon sa usa ka Kondisyon sa Relasyon ViewPara makakuha ug detalyadong katin-awan kon unsaon pagpasabot ang mga kondisyon, konsultaha ang seksyon nga ps:condtext sa kapitulo 9.5.7 sa pure::variants User's Guide (Reference–>Predefined Source Element Types–>ps:condtext).
C/C++ Preprocessor Constants
Ang C/C++ Preprocessor Indexer nag-scan files alang sa mga kanunay nga gigamit sa mga lagda sa preprocessor (eg #ifdef, #ifndef, ...).
Kung ps:flag o ps:flagfile Ang elemento gipili ang Relasyon View nagpakita sa paggamit sa gitakda nga preprocessor constant.
Ang mga Relasyon View nagpakita usab sa preprocessor constants konektado sa mga feature pinaagi sa paggamit sa mapping patterns. Alang niini ang mga sumbanan gipalapdan sa datos sa gipili nga bahin. Ang resulta nga mga simbolo gigamit sa pagpangita alang sa pagpares sa preprocessor constants. Figure 7, "Pagrepresentar sa usa ka C/C++ Preprocessor Constant sa Relations View” pakita sa usa ka example nga adunay pattern nga kabantog {Ngalan}. Ang sumbanan gipalapdan sa talagsaon nga ngalan sa bahin sa fameNative. Sa indexed code adunay 76 ka mga lokasyon diin ang preprocessor kanunay nga fameNative gigamit.
Kini nga mga lokasyon gipakita sa Relasyon View. Ang mga sumbanan mahimong ipasabut sa mga gusto (tan-awa ang Seksyon 3.3, "Ang Mga Kagustuhan").
Figure 7. Representasyon sa usa ka C/C++ Preprocessor Constant sa Relations View

3.3. Ang mga Preferences
Aron mabag-o ang default nga pamatasan sa tig-indeks ablihi ang mga gusto sa Eclipse ug pilia ang panid sa Relation Indexer sa kategorya nga Pagdumala sa Variant. Ang panid nagpakita sa duha ka lista.
Figure 8. Relation Indexer Preference nga panidAng taas nga lista naglangkob sa default file mga sumbanan alang sa tig-indeks (1). Kini nga lista mao ang inisyal nga pattern setting para sa bag-ong gipalihok nga mga proyekto.
Ang ubos nga lista naglangkob sa mapping tali sa mga feature ug preprocessor constants (2). Kini nga pagmapa kay gigamit sa tanang proyekto. Ang Talaan 1, "Gisuportahan nga mga Pagpuli sa Mapping" nagpakita sa tanan nga posible nga mga kapuli.
Talaan 1. Gisuportahan nga Pagpuli sa Mapping

Wildcard	Deskripsyon	Example: FeatureA
Ngalan	ang Talagsaong Ngalan sa pinili nga bahin	FLAG_{Ngalan} – FLAG_FeatureA
NGALAN	ang upper case nga Unique Name sa pinili nga feature	FLAG_{NAME} – FLAG_FEATUREA
ngalan	ang gamay nga case Unique Name sa pinili nga feature	flag_{ngalan} – flag_featurea

Mga Dokumento / Mga Kapanguhaan

pure-systems 2024 Connector alang sa Source Code Management Software [pdf] Manwal sa Gumagamit 2024, 2024 Konektor alang sa Source Code Management Software, Konektor alang sa Source Code Management Software, Source Code Management Software, Management Software, Software

Mga pakisayran

• Manwal sa Gumagamit