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

Panimula

pure::variants Connector for Source Code Management (Connector) ay nagbibigay-daan sa mga developer na pamahalaan ang source code variability gamit ang pure::variants. Ang Pamamahala ng Source Code ng pure::variants ay nagbibigay ng nababaluktot na pagkakataon upang i-synchronize ang mga istruktura ng direktoryo at source code files madali gamit ang pure::variants na mga modelo. Sa gayon ang pamamahala ng mga variant ay maaaring mailapat nang praktikal kahit sa mga kumplikadong proyekto ng software. Higit pa rito, ang mga koneksyon sa pagitan ng pure::variants na mga feature at source code ay maaaring mas madaling pamahalaan sa tagabuo at lubos na naa-access sa pamamagitan ng Source Code Management.
1.1. Mga Kinakailangan sa Software
Ang pure::variants Connector para sa Source Code Management ay isang extension para sa pure::variants at available sa lahat ng sinusuportahang platform.
1.2. Pag-install
Mangyaring kumonsulta sa seksyong pure::variants Connectors sa pure::variants Setup Guide para sa detalyadong impormasyon kung paano i-install ang connector (menu Help -> Help Contents at pagkatapos ay pure::variants Setup Guide -> pure::variants Connectors).
1.3. Tungkol sa manwal na ito
Ang mambabasa ay inaasahang magkaroon ng mga pangunahing kaalaman tungkol sa at mga karanasan sa mga purong::variants. Mangyaring kumonsulta sa panimulang materyal nito bago basahin ang manwal na ito. Ang manual ay makukuha sa online na tulong gayundin sa napi-print na PDF na format dito.

Gamit ang Connector

2.1. Nagsisimula sa puro::variants
Depende sa paraan ng pag-install na ginamit, simulan ang pure::variants-enabled Eclipse o sa ilalim ng Windows piliin ang pure::variants item mula sa menu ng programa.
Kung ang pananaw ng Pamamahala ng Variant ay hindi pa aktibo, gawin ito sa pamamagitan ng pagpili nito mula sa Open Perspective->Other... sa Window menu.
2.2. Mag-import ng Directory Tree sa isang Family Model
Bago mag-import ng directory tree sa isang Family Model, kailangang gumawa ng proyekto ng mga variant. Gayundin, iminumungkahi na magkaroon ng mga tampok na tinukoy sa isang Feature Model na. Mangyaring kumonsulta sa dokumentasyon ng pure::variants para sa tulong tungkol sa mga hakbang na ito.
Ang aktwal na pag-import ay sinisimulan sa pamamagitan ng pagpili sa Import… aksyon alinman sa menu ng konteksto ng Mga Proyekto view o gamit ang Import… menu sa File menu. Piliin ang Variant Models o Projects mula sa kategoryang Variant Management at pindutin ang Next. Sa susunod na pahina piliin ang Mag-import ng Family Model mula sa mga source folder at pindutin muli ang Susunod.
Pumili ng uri ng source code na ii-import
Lumilitaw ang import wizard (tingnan ang Figure 1, "Pahina ng import wizard upang piliin ang uri ng source code na maaaring ma-import"). Pumili ng uri ng proyekto na ii-import at pindutin ang Susunod. Ang bawat uri ay naglalaman ng isang paunang natukoy na hanay ng file mga uri upang i-import sa modelo.
Figure 1. Pahina ng import wizard upang piliin ang uri ng source code na maaaring ma-importPiliin ang Pinagmulan at Target
Sa susunod na pahina ng wizard (Figure 2, "Pahina ng import wizard upang piliin ang pinagmulan at ang target para sa pag-import") ang pinagmulang direktoryo at ang target na modelo ay dapat na tukuyin.
Pindutin ang Browse... button para piliin ang direktoryo kung saan umiiral ang source code na dapat i-import. Bilang default, pinili ang kasalukuyang workspace dahil maaaring ito ay isang kapaki-pakinabang na punto upang simulan ang pag-navigate.
Sa ibaba maaari mong tukuyin ang isama at ibukod ang pattern. Ang mga pattern na ito ay dapat na java regular na expression. Ang bawat input path, na nauugnay sa source root folder, ay nasuri gamit ang pattern na ito. Kung tugma ang isama ang pattern, mag-i-import ang isang folder, kung hindi tumutugma ang pattern sa pagbubukod. Ibig sabihin, pinipili ng isamang pattern ang mga folder na ii-import, pinaghihigpitan ng pattern ng pagbubukod ang preselection na ito.
Pagkatapos piliin ang direktoryo ng source code dapat tukuyin ang isang target na modelo. Samakatuwid pumili ng isang variant na proyekto o isang folder kung saan dapat iimbak ang modelo at maglagay ng pangalan ng modelo. Ang file awtomatikong pinalawak ang pangalan gamit ang .ccfm extension kung hindi ito ibinigay sa dialog na ito. Bilang default, itatakda ito sa parehong pangalan ng pangalan ng modelo mismo. Ito ang inirerekomendang setting.
Pagkatapos matukoy ang isang kapaki-pakinabang na folder ng pinagmulan at ang nais na pangalan ng modelo, maaaring matapos ang dialog sa pamamagitan ng pagpindot sa Tapos na. Kung pinindot ang Next button, lalabas ang isang karagdagang page kung saan maaaring gawin ang mga karagdagang setting.
Figure 2. Pahina ng import wizard upang piliin ang pinagmulan at ang target para sa pag-importBaguhin ang Mga Kagustuhan sa Pag-import
Sa huling pahina ng wizard (Figure 3, "Pahina ng import wizard upang tukuyin ang isang indibidwal na configuration”) may mga kagustuhang maaaring gawin upang i-customize ang gawi sa pag-import para sa na-import na proyekto ng software.
Ang pahina ng dialog ay nagpapakita ng isang talahanayan kung saan ang file ang mga uri ay tinukoy, na isasaalang-alang ng proseso ng pag-import.
Ang bawat linya ay binubuo ng apat na field.

• Ang field ng Paglalarawan ay naglalaman ng isang maikling naglalarawang teksto upang matukoy ang file uri.
• Ang File Ang field ng pattern ng pangalan ay ginagamit upang pumili files na mai-import kapag tumugma ang mga ito sa halaga ng mga field. Ginagamit ng field ang sumusunod na syntax:

1. Ang pinakakaraniwang usecase ay maaaring a file extension. Ang karaniwang syntax ay .EXT, kung saan EXT ang gusto file extension (hal. .java).
2. Ang isa pang karaniwang sitwasyon ay isang espesyal file, parang gawafile. Samakatuwid, posible na tumugma sa eksaktong file pangalan. Upang gawin ito, ipasok lamang ang file pangalan sa field (hal. build.xml).
3. Sa ilang mga kaso ang mga hangarin sa pagmamapa ay mas tiyak, kaya lamang files na tumutugma sa isang espesyal na pattern ay dapat na ma-import. Upang magkasya sa pangangailangang ito, posibleng gumamit ng mga regular na expression sa File field ng pattern ng pangalan.
   Ang paglalarawan sa syntax ng mga regular na expression ay lalampas sa layunin ng tulong na ito. Mangyaring kumonsulta sa seksyon ng mga regular na expression ng reference na kabanata sa pure::variants na gabay ng gumagamit (hal .*).

• Itinatakda ng field na Mapped element type ang pagmamapa sa pagitan ng a file uri at isang purong::variants uri ng elemento ng pamilya. Ang uri ng elemento ng pamilya ay isang descriptor para sa pinagmulan file upang magbigay ng karagdagang impormasyon sa naka-map na elemento sa na-import na modelo. Ang mga karaniwang pagpipilian ay ps:class o ps:makefile.
• Ang Mapa file itinatakda ng field ng uri ang pagmamapa sa pagitan ng a file uri at isang purong::variants file uri. Ang file type in pure::variants is a descriptor for the source file upang magbigay ng karagdagang impormasyon sa naka-map na elemento sa na-import na modelo. Ang mga karaniwang pagpipilian ay impl para sa mga pagpapatupad o def para sa kahulugan files.

Figure 3. Pahina ng import wizard upang tukuyin ang isang indibidwal na configurationBago file maaaring idagdag ang mga uri sa pamamagitan ng paggamit ng Add Mapping button. Ang lahat ng mga patlang ay pinunan ng hindi natukoy na halaga at dapat punan ng gumagamit. Para mag-edit ng value sa isang field, i-click lang sa field gamit ang mouse. Ang halaga ay nagiging nae-edit at maaaring baguhin. Hindi posibleng baguhin ang default file mga pattern ng pangalan ng talahanayan. Upang gawing flexible ang pagpapasadya, posibleng alisin sa pagkakapili ang a file mag-type sa pamamagitan ng pagtanggal sa pagkakapili sa row. Inalis sa pagkakapili file mananatili ang mga pattern ng pangalan sa configuration ngunit hindi gagamitin ng importer. Tinukoy ng user file maaaring tanggalin muli ang mga uri sa pamamagitan ng paggamit ng button na Remove Mapping.
Bilang default, isang Iba files file Ang pattern ng pangalan ay magagamit sa talahanayan ngunit inalis sa pagkakapili. Karaniwang hindi ito gustong i-import lahat files ngunit ito ay madaling mabago sa pamamagitan ng pagpili ng ayon sa hilera.
May tatlong pangkalahatang opsyon sa pag-import para i-customize ang gawi ng importer.

• Huwag mag-import ng mga direktoryo nang walang tugma files (eg mga direktoryo ng CVS).
  Kung ang importer ay nakahanap ng isang direktoryo kung saan walang tugma file ay nasa loob nito at kung saan walang subdirectory na may tugma file, hindi mai-import ang direktoryo. Madalas itong kapaki-pakinabang, kung ang mga proyekto ay pinamamahalaan ng mga sistema ng pamamahala ng bersyon tulad ng CVS. Para sa CVS, ang bawat nauugnay na direktoryo ay naglalaman ng isang CVS-direktoryo kung saan hindi nauugnay files ay naka-imbak. Kung napili ang opsyong ito at ang CVS-files ay hindi tumutugma sa anumang file uri na tinukoy sa itaas, ang direktoryo ay hindi mai-import bilang isang bahagi sa Modelo ng Pamilya.
• Pagbukud-bukurin files at mga direktoryo.
  Paganahin ang pagpipiliang ito upang pagbukud-bukurin files at mga direktoryo bawat isa sa alpabetikong pagkakasunud-sunod.
• Pag-import ng path handling.
  Para sa karagdagang pag-synchronize, kailangang iimbak ng importer ang orihinal na landas ng lahat ng na-import na elemento sa modelo.
  Sa maraming pagkakataon, ang Mga Modelo ng Pamilya ay ibinabahagi sa ibang mga user. Maaaring iba ang istraktura ng direktoryo para sa bawat user. Upang suportahan ang pinakakaraniwang mga sitwasyon sa paggamit, maaaring gumana ang importer sa iba't ibang mga mode:

Ganap	Ang ganap na landas patungo sa na-import na elemento ay maiimbak sa modelo. Para sa pag-synchronize sa ibang pagkakataon at sa panahon ng pagbabagong-anyo ang files ay kailangang ilagay sa eksaktong parehong lokasyon tulad ng sa unang pag-import.
May kaugnayan sa Workspace	Ang mga path ay naka-imbak na may kaugnayan sa workspace folder. Para sa pag-synchronize ang files ay kailangang maging bahagi ng Eclipse workspace. Ang pagbabago ay kailangang gumamit ng Eclipse workspace bilang input directory.
Kaugnay ng Proyekto	Ang mga landas ay naka-imbak na may kaugnayan sa proyekto. Para sa pag-synchronize ang files ay bahagi ng proyekto sa loob ng Eclipse. Ang pagbabago ay kailangang gumamit ng folder ng proyekto bilang direktoryo ng input.
Kamag-anak sa Path	Ang mga landas ay naka-imbak na may kaugnayan sa ibinigay na landas. Para sa pag-synchronize ang files ay kailangang ilagay sa eksaktong parehong lokasyon. Ang direktoryo ng input ng pagbabago ay pareho sa relatibong landas sa panahon ng pag-import.

Ang lahat ng mga kagustuhan ng dialog na ito ay patuloy na iniimbak. Ang mga personal na pagpapasadya ay hindi dapat muling gawin sa tuwing tatakbo ang pag-import. Ginagawa nitong madali at mabilis ang daloy ng trabaho sa pag-import.
2.3. Pag-update ng Mga Modelo mula sa Directory Tree
Pindutin ang button na I-synchronize upang i-synchronize ang isang na-import na modelo sa path ng direktoryo nito. Ang root path ng proyekto ay naka-imbak sa modelo upang ito ay mag-synchronize sa parehong direktoryo tulad ng dati. Upang paganahin ang button na I-synchronize, buksan ang modelo at pumili ng anumang elemento. Pagkatapos pindutin ang button na I-synchronize ang isang Compare Editor ay magbubukas kung saan ang kasalukuyang Modelo ng Pamilya at ang modelo ng kasalukuyang istraktura ng direktoryo ay sumasalungat (tingnan ang Figure 4, "Pag-update ng modelo mula sa Directory Tree sa Compare Editor").
Figure 4. Update ng modelo mula sa Directory Tree sa Compare Editor   Ang compare editor ay ginagamit sa kabuuan ng pure::variants upang ihambing ang mga bersyon ng modelo ngunit sa kasong ito ay ginagamit upang ihambing ang pisikal na istraktura ng direktoryo (ipinapakita sa kanang bahagi sa ibaba) sa kasalukuyang pure::variants na modelo (ibabang kaliwang bahagi). Ang lahat ng mga pagbabago ay nakalista bilang hiwalay na mga item sa itaas na bahagi ng editor, na iniutos ng mga apektadong elemento.
Ang pagpili ng isang item sa listahang ito ay nagha-highlight sa kaukulang pagbabago sa parehong mga modelo. Sa exampAt, ang isang idinagdag na elemento ay minarkahan ng isang kahon sa kanang bahagi at konektado sa posible nitong posisyon sa modelo sa kaliwang bahagi. Ang Merge toolbar sa pagitan ng upper at lower editor window ay nagbibigay ng mga tool upang kopyahin ang isa o kahit lahat (hindi magkasalungat) na pagbabago sa kabuuan mula sa directory tree model hanggang sa Feature Model.
Tandaan
Ginagawa ang pag-synchronize gamit ang huling ginamit na mga setting ng importer. Ginagawa nitong posible na i-update ang modelo sa iba pang mga setting na ginawa habang ginagawa ang pag-import.

Gamit ang Relation Indexer

Ang Konektor para sa Pamamahala ng Source Code ay nagpapahusay sa Mga Relasyon View na may impormasyon tungkol sa mga koneksyon sa pagitan ng pure::variants na mga elemento ng modelo at source code. Idinagdag ang mga relasyon para sa mga feature na ginagamit sa mga kundisyon ng mga elemento ng ps:condxml at ps:condtext.
Para sa ps:flag at ps:flagfile elemento ang lokasyon ng mga preprocessor constant sa C/C++ source files ay ipinapakita. Bilang karagdagan, ang mga lokasyon ng pagtutugma ng mga constant ng preprocessor ay ipinapakita para sa isang napiling tampok sa pamamagitan ng paggamit ng pagmamapa sa pagitan ng mga natatanging pangalan ng tampok at mga constant ng preprocessor.
3.1. Pagdaragdag ng Relation Indexer sa isang Proyekto
Maaaring i-activate ang relation indexer sa isang espesyal na page ng property ng proyekto. Piliin ang proyekto at piliin ang item na Properties sa menu ng konteksto. Sa paparating na dialog piliin ang pahina ng Relation Indexer.
Larawan 5. Pahina ng Property ng Proyekto para sa Relation Indexer

Ang relation indexer ay isinaaktibo para sa proyekto sa pamamagitan ng pagpili sa Enable Relation Indexer na opsyon (1). Pagkatapos paganahin ang indexer may ilang higit pang mga opsyon upang tukuyin ang partikular na pag-uugali ng proyekto. Ang pag-index ng pure::variants Conditions at C/C++ Preprocessor Constants ay maaaring i-activate nang hiwalay (2). Ang listahan na may file Ang mga pattern ng pangalan (3) ay ginagamit upang piliin ang files para sa pag-index. Tanging files na tumutugma sa isa sa mga pattern ay na-scan. Idagdag ang "*" bilang pattern upang i-scan ang lahat fileng isang proyekto.
Pagkatapos i-activate ang indexer para sa isang proyekto, isang tagabuo ang idinagdag sa proyekto. Nagbago ang mga pag-scan ng builder na ito files para sa mga bagong relasyon sa pure::variants model elements awtomatikong.
3.2. Ang Mga Kaugnayan sa Source Code
Gamit ang activated relation indexer ang Relations View naglalaman ng mga karagdagang entry. Ipinapakita ng mga entry na ito ang pangalan ng file at ang numero ng linya ng variant point. Ipinapakita ng tool tip ang naaangkop na seksyon ng file. Sa pamamagitan ng pag-double click sa entry ang file ay bubuksan sa isang editor.
pure::variants Mga kundisyon
Maaaring gamitin ang pure::variants na kundisyon para isama o ibukod ang mga seksyon ng a file depende sa pagpili ng tampok. Ang Condition Indexer ay nag-scan para sa mga naturang panuntunan at kinukuha ang mga na-refer na feature. Kung ang ganitong tampok ay pinili sa editor ang Relations View ipapakita ang lahat files at mga linya kung saan matatagpuan ang isang kundisyon na may napiling feature (tingnan ang Figure 6, “Representasyon ng isang Kondisyon sa Relasyon View”).
Figure 6. Representasyon ng isang Kondisyon sa Relasyon ViewUpang makakuha ng detalyadong paliwanag kung paano tukuyin ang mga kundisyon, kumonsulta sa seksyong ps:condtext ng kabanata 9.5.7 ng pure::variants User's Guide (Reference–>Predefined Source Element Types–>ps:condtext).
C/C++ Preprocessor Constants
Nag-scan ang C/C++ Preprocessor Indexer files para sa mga constant na ginagamit sa mga tuntunin ng preprocessor (hal. #ifdef, #ifndef, …).
Kung isang ps:flag o ps:flagfile elemento ay pinili ang Relations View ipinapakita ang paggamit ng tinukoy na preprocessor constant.
Ang Mga Relasyon View nagpapakita rin ng mga preprocessor constant na konektado sa mga feature sa pamamagitan ng paggamit ng mga pattern ng pagmamapa. Para dito ang mga pattern ay pinalawak gamit ang data ng napiling tampok. Ang mga resultang simbolo ay ginagamit upang maghanap para sa pagtutugma ng preprocessor constants. Figure 7, “Representasyon ng isang C/C++ Preprocessor Constant sa Relations View” pakita ng isang example na may pattern na katanyagan {Name}. Pinalawak ang pattern gamit ang natatanging pangalan ng feature sa fameNative. Sa naka-index na code mayroong 76 na lokasyon kung saan ginagamit ang preprocessor constant na fameNative.
Ang mga lokasyong ito ay ipinapakita sa Relations View. Ang mga pattern ay maaaring tukuyin sa mga kagustuhan (tingnan ang Seksyon 3.3, "Ang Mga Kagustuhan").
Figure 7. Representasyon ng isang C/C++ Preprocessor Constant sa Relations View

3.3. Ang Mga Kagustuhan
Upang baguhin ang default na gawi ng indexer, buksan ang mga kagustuhan sa Eclipse at piliin ang pahina ng Relation Indexer sa kategoryang Pamamahala ng Variant. Ang pahina ay nagpapakita ng dalawang listahan.
Figure 8. Relation Indexer Preference pageAng itaas na listahan ay naglalaman ng default file mga pattern para sa indexer (1). Ang listahang ito ay ang paunang setting ng pattern para sa mga bagong pinaganang proyekto.
Ang mas mababang listahan ay naglalaman ng pagmamapa sa pagitan ng mga feature at preprocessor constants (2). Ang pagmamapa na ito ay ginagamit para sa lahat ng mga proyekto. Ipinapakita ng Talahanayan 1, "Mga Sinusuportahang Pagpapalit sa Pagma-map" ang lahat ng posibleng kapalit.
Talahanayan 1. Mga Suportadong Pagpapalit sa Mapping

Wildcard	Paglalarawan	Example: FeatureA
Pangalan	ang Natatanging Pangalan ng napiling tampok	FLAG_{Pangalan} – FLAG_FeatureA
NAME	ang upper case na Natatanging Pangalan ng napiling feature	FLAG_{NAME} – FLAG_FEATUREA
pangalan	ang maliit na titik Natatanging Pangalan ng napiling tampok	flag_{name} – flag_featurea

Mga Dokumento / Mga Mapagkukunan

pure-systems 2024 Connector para sa Source Code Management Software [pdf] User Manual 2024, 2024 Connector para sa Source Code Management Software, Connector para sa Source Code Management Software, Source Code Management Software, Management Software, Software

Mga sanggunian

• User Manual