pastër::variante – Lidhës për
Manuali i Menaxhimit të Kodit Burim
Parametric Technology GmbH
Versioni 6.0.7.685 për të pastër::variantet 6.0
E drejta e autorit © 2003-2024 Parametric Technology GmbH
2024
Hyrje
Pure::variants Lidhësi për menaxhimin e kodit burimor (Connector) u mundëson zhvilluesve të menaxhojnë ndryshueshmërinë e kodit burim duke përdorur pure::variante. Menaxhimi i kodit burimor të pure::varianteve ofron një mundësi fleksibël për të sinkronizuar strukturat e direktorive dhe kodin burimor files lehtësisht me modele të pastra::variante. Kështu, menaxhimi i varianteve mund të zbatohet praktikisht edhe në projekte komplekse softuerike. Për më tepër, lidhjet midis veçorive të pastra::variante dhe kodit burimor mund të menaxhohen më lehtë me ndërtuesin dhe janë shumë të aksesueshme nëpërmjet Menaxhimit të Kodit Burim.
1.1. Kërkesat e softuerit
Lidhësi i pastër::variante për menaxhimin e kodit burimor është një shtesë për variantet e pastra::variantet dhe është i disponueshëm në të gjitha platformat e mbështetura.
1.2. Instalimi
Ju lutemi, konsultohuni me seksionin "Pure::variants" Lidhëzuesit në "Udhëzuesin e konfigurimit të pastër::variantet" për informacion të detajuar se si të instaloni lidhësin (menyja "Ndihmë" -> Përmbajtja e ndihmës dhe më pas "Udhëzuesi i konfigurimit" të pastër::variantet -> "Pure::variantet" Lidhësit.
1.3. Rreth këtij manuali
Lexuesi pritet të ketë njohuri bazë dhe përvoja me::variantet e pastra. Ju lutemi, konsultohuni me materialin e tij hyrës përpara se të lexoni këtë manual. Manuali është i disponueshëm në ndihmën online, si dhe në formatin PDF të printueshëm këtu.
Duke përdorur lidhësin
2.1. Fillimi i pastër::variante
Në varësi të metodës së instalimit të përdorur, ose filloni Eclipse të aktivizuar nga pure::variants ose nën Windows zgjidhni artikullin pure::variants nga menyja e programit.
Nëse perspektiva e Menaxhimit të Variantit nuk është tashmë e aktivizuar, bëjeni duke e zgjedhur atë nga Perspektiva e hapur->Tjetër… në menynë Dritare.
2.2. Importoni një pemë drejtorie në një model familjar
Përpara se të importoni një pemë direktorie në një model familjar, duhet të krijohet një projekt variantesh. Gjithashtu është sugjeruese që tashmë të ketë veçori të përcaktuara në një Model Feature. Ju lutemi konsultohuni me dokumentacionin e pastër::variant për ndihmë rreth këtyre hapave.
Importimi aktual fillon duke zgjedhur veprimin Import… ose në menynë e kontekstit të Projekteve view ose me menynë Import… në File menu. Zgjidhni Modele Variante ose Projekte nga kategoria Menaxhimi i Variantit dhe shtypni Next. Në faqen e mëposhtme zgjidhni Importo një Model Familje nga dosjet burimore dhe shtypni përsëri Tjetër.
Zgjidhni llojin e kodit burimor për të importuar
Shfaqet magjistari i importit (shih Figurën 1, “Faqja e magjistarit të importit për të zgjedhur llojin e kodit burimor që mund të importohet”). Zgjidhni një lloj projekti për të importuar dhe shtypni Next. Çdo lloj përmban një grup të paracaktuar të file llojet për të importuar në model.
Figura 1. Faqja e magjistarit të importit për të zgjedhur llojin e kodit burimor që mund të importohet
Zgjidhni Burimin dhe Synimin
Në faqen tjetër të magjistarit (Figura 2, "Faqja e magjistarit të importit për të zgjedhur burimin dhe objektivin për importin") duhet të specifikohen direktoria burimore dhe modeli i synuar.
Shtypni butonin Browse… për të zgjedhur drejtorinë ku ekziston kodi burimor që duhet të importohet. Si parazgjedhje është zgjedhur hapësira aktuale e punës sepse kjo mund të jetë një pikë e dobishme për të filluar lundrimin.
Më poshtë mund të specifikoni modelin e përfshirjes dhe përjashtimit. Këto modele duhet të jenë shprehje të rregullta java. Çdo shteg hyrës, në lidhje me dosjen rrënjësore të burimit, kontrollohet me këto modele. Nëse modeli i përfshirjes përputhet, një dosje importohet, nëse modeli i përjashtimit nuk përputhet. Do të thotë se modeli i përfshirjes i zgjedh paraprakisht dosjet për import, modeli i përjashtimit e kufizon këtë parazgjedhje.
Pas zgjedhjes së drejtorisë së kodit burim duhet të përcaktohet një model i synuar. Prandaj zgjidhni një projekt variant ose një dosje ku modeli duhet të ruhet dhe vendosni një emër modeli. Të file emri zgjerohet automatikisht me shtesën .ccfm nëse nuk është dhënë në këtë dialog. Si parazgjedhje do të vendoset në të njëjtin emër si vetë emri i modelit. Ky është cilësimi i rekomanduar.
Pasi të specifikohet një dosje burimi i përshtatshëm dhe emri i modelit të dëshiruar, dialogu mund të përfundojë duke shtypur Finish. Nëse shtypet butoni Next, do të shfaqet një faqe tjetër ku mund të bëhen cilësime shtesë.
Figura 2. Faqja e magjistarit të importit për të zgjedhur burimin dhe objektivin për import
Ndrysho Preferencat e Importit
Në faqen e fundit të magjistarit (Figura 3, “Faqja e magjistarit të importit për të përcaktuar një konfigurim individual”) ka preferenca që mund të bëhen për të personalizuar sjelljen e importit për projektin e softuerit të importuar.
Faqja e dialogut tregon një tabelë ku file janë përcaktuar llojet, që do të merren parasysh në procesin e importit.
Çdo rresht përbëhet nga katër fusha.
- Fusha Përshkrimi përmban një tekst të shkurtër përshkrues për të identifikuar file lloji.
- Të File Fusha e modelit të emrit përdoret për të zgjedhur files për t'u importuar kur ato përputhen me vlerën e fushave. Fusha përdor sintaksën e mëposhtme:
- Rasti më i zakonshëm i përdorimit mund të jetë a file shtrirje. Sintaksa e zakonshme është .EXT, ku EXT është e dëshiruara file zgjerimi (p.sh. .java).
- Një situatë tjetër e zakonshme është një e veçantë file, si një markëfile. Prandaj, është e mundur që të përputhen në mënyrë të saktë file emri. Për ta bërë këtë, thjesht futni file emrin në fushë (p.sh. build.xml).
- Në disa raste dëshirat e hartës janë më specifike, pra vetëm fileDuhet të importohen ato që përputhen me një model të veçantë. Për t'iu përshtatur kësaj kërkese është e mundur të përdoren shprehje të rregullta në File fusha e modelit të emrit.
Përshkrimi i sintaksës së shprehjeve të rregullta do të tejkalonte synimin e kësaj ndihme. Ju lutemi, konsultohuni me seksionin e shprehjeve të rregullta të kapitullit të referencës në udhëzuesin e përdorimit të pastër::variantet (p.sh. .*).
- Fusha e tipit të elementit Mapped vendos hartëzimin midis a file lloji dhe një lloj i pastër::variant i elementit të familjes. Lloji i elementit të familjes është një përshkrues për burimin file për të dhënë informacion të mëtejshëm për elementin e hartuar në modelin e importuar. Zgjedhjet tipike janë ps:class ose ps:makefile.
- Harta file fusha e tipit vendos hartëzimin ndërmjet a file lloji dhe një i pastër::variante file lloji. Të file shkruani pure::variantet është një përshkrues për burimin file për të dhënë informacion të mëtejshëm për elementin e hartuar në modelin e importuar. Zgjedhjet tipike janë impl për implementime ose definim për përkufizim files.
Figura 3. Faqja e magjistarit të importit për të përcaktuar një konfigurim individual
E re file llojet mund të shtohen duke përdorur butonin Shto Hartë. Të gjitha fushat plotësohen me vlerën e papërcaktuar dhe duhet të plotësohen nga përdoruesi. Për të modifikuar një vlerë në një fushë, thjesht klikoni në fushë me miun. Vlera bëhet e redaktueshme dhe mund të ndryshohet. Nuk është e mundur të ndryshohet parazgjedhja file modelet e emrave të tabelës. Për ta bërë një personalizim fleksibël, është e mundur të çaktivizoni një file shkruani duke hequr zgjedhjen e rreshtit. U anulua file modelet e emrave qëndrojnë në konfigurim, por nuk do të përdoren nga importuesi. Përcaktuar nga përdoruesi file llojet mund të hiqen përsëri duke përdorur butonin Hiq hartën.
Si parazgjedhje një Tjetër files file modeli i emrit është i disponueshëm në tabelë, por është çzgjedhur. Zakonisht nuk kërkohet të importohen të gjitha files por kjo mund të ndryshohet lehtësisht duke zgjedhur rreshtin sipas.
Ekzistojnë tre opsione të përgjithshme të importit për të personalizuar sjelljen e importuesit.
- Mos importoni direktori pa përputhshmëri files (p.sh. drejtoritë CVS).
Nëse importuesi gjen një direktori ku nuk përputhet file është në të dhe ku asnjë nëndrejtori nuk ka përputhje file, drejtoria nuk do të importohet. Kjo është shpesh e dobishme, nëse projektet menaxhohen nga sisteme të menaxhimit të versioneve si CVS. Për CVS-në, çdo drejtori përkatëse përmban një drejtori CVS ku nuk ka lidhje files janë të ruajtura. Nëse zgjidhet ky opsion dhe CVS-files nuk përputhen me asnjë file lloji i përcaktuar më sipër, drejtoria nuk do të importohet si një komponent në Modelin e Familjes. - Rendit files dhe drejtoritë.
Aktivizo këtë opsion për të renditur files dhe drejtoritë secila sipas rendit alfabetik. - Trajtimi i rrugës së importit.
Për sinkronizim të mëtejshëm, importuesi duhet të ruajë rrugën origjinale të të gjithë elementëve të importuar në model.
Në shumë raste Modelet Familjare ndahen me përdorues të tjerë. Struktura e drejtorisë mund të jetë e ndryshme për çdo përdorues. Për të mbështetur skenarët më të zakonshëm të përdorimit, importuesi mund të punojë në mënyra të ndryshme:
| Absolute | Rruga absolute drejt elementit të importuar do të ruhet në model. Për sinkronizimin e mëvonshëm dhe gjatë transformimit fileDuhet të vendosen në të njëjtin vend si gjatë importit të parë. |
| Në lidhje me hapësirën e punës | Shtigjet ruhen në lidhje me dosjen e hapësirës së punës. Për sinkronizim files duhet të jetë pjesë e hapësirës së punës Eclipse. Transformimi duhet të përdorë hapësirën e punës Eclipse si direktori hyrëse. |
| Në lidhje me projektin | Shtigjet ruhen në lidhje me projektin. Për sinkronizim files janë pjesë e projektit brenda Eclipse. Transformimi duhet të përdorë dosjen e projektit si direktori hyrëse. |
| Në lidhje me rrugën | Shtigjet ruhen në lidhje me shtegun e dhënë. Për sinkronizim files duhet të vendosen në të njëjtin vend. Drejtoria e hyrjes së transformimit është e njëjtë me rrugën relative gjatë importimit. |
Të gjitha preferencat e këtij dialogu ruhen vazhdimisht. Përshtatjet personale nuk duhet të ribëhen sa herë që ekzekutohet importi. Kjo e bën rrjedhën e punës së importit të lehtë dhe të shpejtë.
2.3. Përditësimi i modeleve nga Pema e Drejtorisë
Shtypni butonin Sinkronizoj 
për të sinkronizuar një model të importuar me rrugën e tij të drejtorisë. Rruga rrënjësore e projektit ruhet në model, kështu që do të sinkronizohet në të njëjtën direktori si më parë. Për të aktivizuar butonin "Sinkronizimi", hapni modelin dhe zgjidhni çdo element. Pas shtypjes së butonit "Sinkronizo" hapet një Redaktues Krahasimi ku kundërshtohet Modeli aktual i Familjes dhe modeli i strukturës aktuale të drejtorisë (shih Figurën 4, "Përditësimi i modelit nga Pema e Drejtorisë në Redaktuesin Krahasues").
Figura 4. Përditësimi i modelit nga Pema e Drejtorisë në Redaktuesin Krahasues 
Redaktori i krahasimit përdoret në të gjithë pure::variantet për të krahasuar versionet e modelit, por në këtë rast përdoret për të krahasuar strukturën e direktoriumit fizik (të shfaqur në anën e poshtme djathtas) me modelin aktual të pastër::variante (në anën e majtë poshtë). Të gjitha ndryshimet renditen si artikuj të veçantë në pjesën e sipërme të redaktorit, të renditura nga elementët e prekur.
Zgjedhja e një artikulli në këtë listë nxjerr në pah ndryshimin përkatës në të dy modelet. Në ishampLe, një element i shtuar shënohet me një kuti në anën e djathtë dhe lidhet me pozicionin e tij të realizueshëm në modelin në anën e majtë. Shiriti i veglave Merge midis dritareve të redaktuesit të sipërm dhe të poshtëm ofron mjete për të kopjuar ndryshimet e vetme apo edhe të gjitha (jo konfliktuale) në tërësi nga modeli i pemës së drejtorisë në modelin e veçorive.
Shënim
Sinkronizimi bëhet me cilësimet e importuesit të përdorura për herë të fundit. Kjo bën të mundur përditësimin e modelit me cilësimet e tjera siç janë bërë gjatë kryerjes së importit.
Përdorimi i indeksit të marrëdhënieve
Lidhësi për Menaxhimin e Kodit Burim përmirëson marrëdhëniet View me informacione rreth lidhjeve ndërmjet elementeve të modelit të pastër::variant dhe kodit burimor. Lidhjet janë shtuar për veçoritë që përdoren në kushtet e elementeve ps:condxml dhe ps:condtext.
Për ps: flag dhe ps: flagfile elemente vendndodhjen e konstantave të paraprocesorit në burimin C/C++ files janë treguar. Përveç kësaj, vendndodhjet e konstantave të përputhshme të paraprocesorit tregohen për një veçori të zgjedhur duke përdorur hartëzimin midis emrave unikë të veçorive dhe konstantave të paraprocesorit.
3.1. Shtimi i indeksuesit të marrëdhënieve në një projekt
Indeksuesi i marrëdhënieve mund të aktivizohet në një faqe të veçantë të pronësisë së projektit. Zgjidhni projektin dhe zgjidhni artikullin Properties në menunë e kontekstit. Në dialogun e ardhshëm zgjidhni faqen Relation Indexer.
Figura 5. Faqja e vetive të projektit për indeksuesin e marrëdhënieve
Indeksuesi i marrëdhënieve aktivizohet për projektin duke zgjedhur opsionin Enable Relation Indexer (1). Pas aktivizimit të indeksuesit, ka disa opsione të tjera për të përcaktuar sjelljen specifike të projektit. Indeksimi i kushteve të pastra:: varianteve dhe konstanteve të paraprocesorit C/C++ mund të aktivizohen veçmas (2). Lista me file Modelet e emrit (3) përdoret për të zgjedhur files për indeksimin. Vetëm fileTë cilat përputhen me një nga modelet skanohen. Shtoni "*" si model për të skanuar të gjitha files të një projekti.
Pas aktivizimit të indeksuesit për një projekt, projektit i shtohet një ndërtues. Skanimet e këtij ndërtuesi ndryshuan files për marrëdhënie të reja me elementët e modelit të pastër::variant automatikisht.
3.2. Marrëdhëniet me kodin burimor
Me indeksuesin e relacionit të aktivizuar, Marrëdhëniet View përmban shënime shtesë. Këto shënime tregojnë emrin e file dhe numri i vijës së pikës së variantit. Maja e mjetit tregon seksionin e duhur të file. Duke klikuar dy herë hyrjen në file do të hapet në një redaktues.
pastër::variante Kushtet
Kushti i pastër::variante mund të përdoret për të përfshirë ose përjashtuar seksionet e a file në varësi të përzgjedhjes së veçorive. Indeksuesi i gjendjes skanon për rregulla të tilla dhe nxjerr veçoritë e referuara. Nëse një veçori e tillë zgjidhet në redaktues, Marrëdhëniet View do të tregojë të gjitha files dhe linjat ku ndodhet një kusht me tiparin e zgjedhur (shih Figurën 6, “Përfaqësimi i një kushti në marrëdhëniet View”).
Figura 6. Paraqitja e një kushti në marrëdhënie View
Për të marrë një shpjegim të detajuar se si të përcaktohen kushtet, konsultohuni me seksionin ps:condtext të kapitullit 9.5.7 të Udhëzuesit të Përdoruesit të pastër::variantet (Referenca–>Llojet e elementeve të burimit të paracaktuara–>ps:condtext).
Konstantet e paraprocesorit C/C++
Indeksuesi i paraprocesorit C/C++ skanon files për konstantet e përdorura në rregullat e paraprocesorit (p.sh. #ifdef, #ifndef, ...).
Nëse një ps:flamur ose ps:flamurfile elementi zgjidhet Relations View tregon përdorimin e konstantës së përcaktuar të paraprocesorit.
Marrëdhëniet View tregon gjithashtu konstantet e paraprocesorit të lidhura me veçoritë duke përdorur modele hartografike. Për këtë, modelet zgjerohen me të dhënat e veçorisë së zgjedhur. Simbolet që rezultojnë përdoren për të kërkuar konstante të përputhshme të paraprocesorit. Figura 7, “Përfaqësimi i një konstante të paraprocesorit C/C++ në marrëdhëniet View”, tregon një ishample me famën e modelit{Emri}. Modeli është zgjeruar me emrin unik të veçorisë në fameNative. Në kodin e indeksuar ka 76 vendndodhje ku përdoret fameNative konstante e paraprocesorit.
Këto vendndodhje tregohen në Marrëdhëniet View. Modelet mund të përcaktohen në preferencat (shih seksionin 3.3, "Preferencat").
Figura 7. Paraqitja e një konstante të paraprocesorit C/C++ në marrëdhëniet View
3.3. Preferencat
Për të ndryshuar sjelljen e paracaktuar të indeksuesit hapni preferencat Eclipse dhe zgjidhni faqen Relation Indexer në kategorinë Variant Management. Faqja tregon dy lista.
Figura 8. Faqja e Preferencave të Indeksit të Relacionit
Lista e sipërme përmban parazgjedhjen file modelet për indeksuesin (1). Kjo listë është konfigurimi fillestar i modelit për projektet e sapo aktivizuara.
Lista e poshtme përmban hartëzimin midis veçorive dhe konstanteve të paraprocesorit (2). Kjo hartë përdoret për të gjitha projektet. Tabela 1, "Zëvendësimet e mbështetura të hartës" tregon të gjitha zëvendësimet e mundshme.
Tabela 1. Zëvendësimet e mbështetura të hartës
| Wildcard | Përshkrimi | Example: Tipar A |
| Emri | Emri Unik i veçorisë së zgjedhur | FLAG_{Emri} – FLAG_FeatureA |
| EMRI | shkronja e madhe Emri unik i veçorisë së zgjedhur | FLAG_{NAME} – FLAG_FEATUREA |
| emri | shkronja e vogël Emri unik i veçorisë së zgjedhur | flag_{emri} – flag_featurea |
Dokumentet / Burimet
 |
Pure-systems 2024 Lidhës për softuerin e menaxhimit të kodit burimor [pdf] Manuali i Përdoruesit 2024, 2024 Lidhës për softuerin e menaxhimit të kodit burimor, lidhës për softuerin e menaxhimit të kodit burimor, Softuerin e menaxhimit të kodit burimor, Softuerin e menaxhimit, softuerin |
