pure::variants – Savienotājs priekš
Avota koda pārvaldības rokasgrāmata
Parametric Technology GmbH
6.0.7.685 versija tīram::variants 6.0
Autortiesības © 2003-2024 Parametric Technology GmbH
2024

Ievads

Pure::variants Savienotājs avota koda pārvaldībai (savienotājs) ļauj izstrādātājiem pārvaldīt pirmkoda mainīgumu, izmantojot pure::variants. Pure::variants pirmkoda pārvaldība nodrošina elastīgu iespēju sinhronizēt direktoriju struktūras un pirmkodu files viegli ar pure::variants modeļiem. Tādējādi variantu pārvaldība var tikt piemērota pat sarežģītiem programmatūras projektiem. Turklāt savienojumus starp pure::variants funkcijām un pirmkodu var vieglāk pārvaldīt ar veidotāju, un tie ir ļoti pieejami, izmantojot avota koda pārvaldību.
1.1. Programmatūras prasības
Pure::variants savienotājs pirmkoda pārvaldībai ir pure::variants paplašinājums un ir pieejams visās atbalstītajās platformās.
1.2. Uzstādīšana
Lūdzu, skatiet sadaļu pure::variants Connectors in the Pure::variants Iestatīšanas rokasgrāmata, lai iegūtu detalizētu informāciju par savienotāja uzstādīšanu (izvēlne Palīdzība -> Palīdzības saturs un pēc tam pure::variants Iestatīšanas rokasgrāmata -> pure::variants Connectors).
1.3. Par šo rokasgrāmatu
Lasītājam ir jāsaņem pamatzināšanas un pieredze ar tīrajiem::variantiem. Pirms šīs rokasgrāmatas lasīšanas, lūdzu, iepazīstieties ar tās ievadmateriālu. Rokasgrāmata ir pieejama tiešsaistes palīdzībā, kā arī drukājamā PDF formātā šeit.

Izmantojot savienotāju

2.1. Sākot no tīra::varianti
Atkarībā no izmantotās instalēšanas metodes vai nu palaidiet pure::variants iespējoto Eclipse vai sistēmā Windows programmas izvēlnē atlasiet vienumu pure::variants.
Ja variantu pārvaldības perspektīva vēl nav aktivizēta, izdariet to, atlasot to izvēlnē Logs no Open Perspective->Other….
2.2. Importējiet direktoriju koku ģimenes modelī
Pirms direktoriju koka importēšanas ģimenes modelī ir jāizveido variantu projekts. Ir arī ieteicams, ka funkcijas jau ir definētas funkciju modelī. Lūdzu, skatiet tīro::variants dokumentāciju, lai saņemtu palīdzību par šīm darbībām.
Faktiskā importēšana tiek sākta, projektu konteksta izvēlnē atlasot darbību Importēt… view vai izmantojot izvēlni Importēt… File izvēlne. Kategorijā Variantu pārvaldība atlasiet Variantu modeļi vai projekti un nospiediet Tālāk. Nākamajā lapā atlasiet Importēt ģimenes modeli no avota mapēm un vēlreiz nospiediet Next.
Izvēlieties importējamā avota koda veidu
Parādās importēšanas vednis (skatiet 1. attēlu, “Importēšanas vedņa lapa, lai atlasītu importējamā avota koda veidu”). Izvēlieties importējamā projekta veidu un nospiediet Tālāk. Katrs veids satur iepriekš noteiktu kopu file veidus, ko importēt modelī.
1. attēls. Importēšanas vedņa lapa, lai atlasītu importējamā avota koda veiduAtlasiet Avots un Mērķis
Nākamajā vedņa lapā (2. attēls, “Importēšanas vedņa lapa, lai atlasītu importēšanas avotu un mērķi”) ir jānorāda avota direktorijs un mērķa modelis.
Nospiediet pogu Pārlūkot…, lai atlasītu direktoriju, kurā atrodas avota kods, kas jāimportē. Pēc noklusējuma ir atlasīta pašreizējā darbvieta, jo tas varētu būt noderīgs punkts, lai sāktu navigāciju.
Tālāk varat norādīt iekļaut un izslēgt modeli. Šiem modeļiem ir jābūt java regulārām izteiksmēm. Katrs ievades ceļš attiecībā pret avota saknes mapi tiek pārbaudīts ar šo modeli. Ja iekļaušanas raksts atbilst, mape tiek importēta, ja izslēgšanas modelis neatbilst. Tas nozīmē, ka iekļaušanas modelis iepriekš atlasa importējamās mapes, bet izslēgšanas modelis ierobežo šo sākotnējo atlasi.
Pēc avota koda direktorija izvēles ir jādefinē mērķa modelis. Tāpēc atlasiet projekta variantu vai mapi, kurā modelis jāsaglabā, un ievadiet modeļa nosaukumu. The file nosaukums tiek automātiski paplašināts ar paplašinājumu .ccfm, ja tas nav norādīts šajā dialoglodziņā. Pēc noklusējuma tam tiks iestatīts tāds pats nosaukums kā paša modeļa nosaukumam. Šis ir ieteicamais iestatījums.
Kad ir norādīta lietderīga avota mape un vēlamais modeļa nosaukums, dialoglodziņš var tikt pabeigts, nospiežot Finish. Ja tiek nospiesta poga Tālāk, tiek atvērta nākamā lapa, kurā var veikt papildu iestatījumus.
2. attēls. Importēšanas vedņa lapa, lai atlasītu importēšanas avotu un mērķiMainiet importēšanas preferences
Pēdējā vedņa lapā (3. attēls, “Importēšanas vedņa lapa, lai definētu atsevišķu konfigurāciju”) ir preferences, kuras var veikt, lai pielāgotu importēšanas darbību importētajam programmatūras projektam.
Dialoga lapā tiek parādīta tabula, kurā file ir definēti veidi, kas tiks ņemti vērā importēšanas procesā.
Katra rinda sastāv no četriem laukiem.

• Laukā Apraksts ir īss aprakstošs teksts, lai identificētu file veids.
• The File nosaukuma raksta lauks tiek izmantots atlasei files, kas jāimportē, ja tie atbilst lauku vērtībai. Laukā tiek izmantota šāda sintakse:

1. Visizplatītākais lietošanas gadījums var būt a file pagarinājumu. Parastā sintakse ir .EXT, kur EXT ir vēlamais file paplašinājumu (piemēram, .java).
2. Vēl viena izplatīta situācija ir īpaša file, kā markafile. Tāpēc ir iespējams precīzi saskaņot file nosaukums. Lai to izdarītu, vienkārši ievadiet file nosaukumu laukā (piemēram, build.xml).
3. Dažos gadījumos kartēšanas vēlmes ir konkrētākas, tāpēc tikai files, kas atbilst īpašam modelim, ir jāimportē. Lai atbilstu šai prasībai, ir iespējams izmantot regulārās izteiksmes File nosaukuma raksta lauks.
   Regulāro izteiksmju sintakses aprakstīšana pārsniegtu šīs palīdzības nolūku. Lūdzu, skatiet atsauces nodaļas regulāro izteiksmju sadaļu tīrā::variants lietotāja rokasgrāmatā (piemēram, .*).

• Laukā Mapped element type tiek iestatīta kartēšana starp a file tips un tīrs::variants saimes elementa tips. Ģimenes elementa veids ir avota deskriptors file lai sniegtu papildu informāciju kartētajam elementam importētajā modelī. Tipiskas atlases ir ps:class vai ps:makefile.
• Kartē file tipa lauks iestata kartēšanu starp a file veids un tīrs::variants file veids. The file ierakstiet pure::variants ir avota deskriptors file lai sniegtu papildu informāciju kartētajam elementam importētajā modelī. Tipiskas atlases ir impl ieviešanai vai def definīcijai files.

3. attēls. Importēšanas vedņa lapa, lai definētu atsevišķu konfigurācijuJauns file veidus var pievienot, izmantojot pogu Pievienot kartēšanu. Visi lauki ir aizpildīti ar vērtību undefined, un tie ir jāaizpilda lietotājam. Lai rediģētu vērtību laukā, vienkārši noklikšķiniet uz lauka ar peli. Vērtība kļūst rediģējama un to var mainīt. Noklusējumu nav iespējams mainīt file tabulas nosaukumu modeļi. Lai pielāgošana būtu elastīga, ir iespējams atcelt atlasi a file ierakstiet, noņemot rindas atlasi. Noņemta atlase file nosaukumu raksti paliek konfigurācijā, bet importētājs tos neizmantos. Lietotāja definēts file veidus var noņemt vēlreiz, izmantojot pogu Noņemt kartēšanu.
Pēc noklusējuma Cits files file nosaukuma raksts ir pieejams tabulā, taču tas ir noņemts. Parasti nevēlas importēt visu files, taču to var viegli mainīt, izvēloties atbilstošo rindu.
Ir trīs vispārīgas importēšanas iespējas, lai pielāgotu importētāja darbību.

• Neimportējiet direktorijus bez atbilstības files (piemēram, CVS direktoriji).
  Ja importētājs atrod direktoriju, kurā nav atbilstības file atrodas tajā un nevienam apakšdirektorijam nav atbilstošas file, direktorijs netiks importēts. Tas bieži ir noderīgi, ja projektus pārvalda versiju pārvaldības sistēmas, piemēram, CVS. CVS gadījumā katrs atbilstošais direktorijs satur CVS direktoriju, ja tam nav nozīmes files tiek glabāti. Ja šī opcija ir atlasīta un CVS-files neatbilst nevienam file iepriekš definētajam tipam, direktorijs netiks importēts kā ģimenes modeļa sastāvdaļa.
• Kārtot files un katalogi.
  Iespējojiet šo opciju, lai kārtotu files un direktorijus alfabētiskā secībā.
• Importa ceļa apstrāde.
  Lai veiktu turpmāku sinhronizāciju, importētājam modelī ir jāsaglabā visu importēto elementu sākotnējais ceļš.
  Daudzos gadījumos ģimenes modeļi tiek kopīgoti ar citiem lietotājiem. Katram lietotājam direktoriju struktūra var būt atšķirīga. Lai atbalstītu visbiežāk sastopamos lietošanas scenārijus, importētājs var strādāt dažādos režīmos:

Absolūti	Absolūtais ceļš uz importēto elementu tiks saglabāts modelī. Vēlākai sinhronizācijai un transformācijas laikā files jānovieto tieši tajā pašā vietā, kur pirmās importēšanas reizē.
Saistībā ar darbvietu	Ceļi tiek saglabāti attiecībā pret darbvietas mapi. Sinhronizācijai files ir jābūt daļai no Eclipse darbvietas. Transformācijai kā ievades direktorijs ir jāizmanto Eclipse darbvieta.
Saistībā ar projektu	Ceļi tiek saglabāti attiecībā pret projektu. Sinhronizācijai files ir daļa no projekta Eclipse. Transformācijai ir jāizmanto projekta mape kā ievades direktorijs.
Saistībā ar ceļu	Ceļi tiek saglabāti attiecībā pret doto ceļu. Sinhronizācijai files jānovieto tieši tajā pašā vietā. Transformācijas ievades direktorijs ir tāds pats kā relatīvais ceļš importēšanas laikā.

Visas šī dialoglodziņa preferences tiek saglabātas pastāvīgi. Personiskos pielāgojumus nedrīkst atkārtoti veikt katru reizi, kad tiek veikta importēšana. Tas padara importēšanas darbplūsmu vienkāršu un ātru.
2.3. Modeļu atjaunināšana no direktoriju koka
Nospiediet pogu Sinhronizēt lai sinhronizētu importēto modeli ar tā direktorija ceļu. Projekta saknes ceļš tiek saglabāts modelī, tāpēc tas tiks sinhronizēts ar to pašu direktoriju kā iepriekš. Lai iespējotu pogu Sinhronizēt, atveriet modeli un atlasiet jebkuru elementu. Pēc pogas Sinhronizēt nospiešanas tiek atvērts salīdzināšanas redaktors, kurā ir pretstats pašreizējais ģimenes modelis un pašreizējās direktoriju struktūras modelis (skatiet 4. attēlu, “Modeļa atjaunināšana no direktoriju koka salīdzināšanas redaktorā”).
4. attēls. Modeļa atjauninājums no direktoriju koka salīdzināšanas redaktorā   Salīdzināšanas redaktors tiek izmantots visā pure::variants, lai salīdzinātu modeļu versijas, bet šajā gadījumā tiek izmantots, lai salīdzinātu fiziskā direktorija struktūru (tiek parādīta apakšējā labajā pusē) ar pašreizējo pure::variants modeli (apakšējā kreisajā pusē). Visas izmaiņas ir uzskaitītas kā atsevišķi vienumi redaktora augšējā daļā, sakārtoti pēc ietekmētajiem elementiem.
Atlasot vienumu šajā sarakstā, tiek izceltas attiecīgās izmaiņas abos modeļos. Bijušajāample, pievienotais elements ir atzīmēts ar lodziņu labajā pusē un savienots ar tā iespējamo pozīciju modelī kreisajā pusē. Rīkjosla sapludināšana starp augšējo un apakšējo redaktora logu nodrošina rīkus, lai kopētu atsevišķas vai pat visas (nekonfliktējošās) izmaiņas kopumā no direktoriju koka modeļa uz funkciju modeli.
Piezīme
Sinhronizācija tiek veikta ar pēdējiem izmantotajiem importētāja iestatījumiem. Tas ļauj atjaunināt modeli ar citiem iestatījumiem, kas veikti importēšanas laikā.

Relāciju indeksētāja izmantošana

Avota koda pārvaldības savienotājs uzlabo attiecības View ar informāciju par savienojumiem starp pure::variants modeļa elementiem un pirmkodu. Attiecības tiek pievienotas līdzekļiem, kas tiek izmantoti ps:condxml un ps:condtext elementu apstākļos.
ps:flag un ps:flagfile elementi priekšprocesora konstantu atrašanās vieta C/C++ avotā files ir parādīti. Turklāt atlasītajam objektam tiek parādītas atbilstošo priekšprocesora konstantu atrašanās vietas, izmantojot kartēšanu starp līdzekļu unikālo nosaukumu un priekšprocesora konstantēm.
3.1. Relāciju indeksētāja pievienošana projektam
Attiecību indeksētāju var aktivizēt īpašā projekta rekvizītu lapā. Atlasiet projektu un konteksta izvēlnē atlasiet vienumu Rekvizīti. Gaidāmajā dialoglodziņā atlasiet lapu Relāciju indeksētājs.
5. attēls. Relāciju indeksētāja projekta rekvizītu lapa

Relāciju indeksētājs tiek aktivizēts projektam, atlasot opciju Iespējot relāciju indeksētāju (1). Pēc indeksētāja iespējošanas ir vēl dažas opcijas, lai definētu projekta specifisko uzvedību. Pure::variants nosacījumu un C/C++ priekšprocesora konstantu indeksēšanu var aktivizēt atsevišķi (2). Saraksts ar file nosaukumu raksti (3) tiek izmantoti, lai atlasītu files indeksēšanai. Tikai files, kas atbilst vienam no modeļiem, tiek skenēti. Pievienojiet “*” kā modeli, lai skenētu visu files no projekta.
Pēc indeksētāja aktivizēšanas projektam tiek pievienots būvētājs. Šī veidotāja skenēšana ir mainīta files jaunām attiecībām ar pure::variants modeļa elementiem automātiski.
3.2. Saistība ar avota kodu
Ar aktivizētu relāciju indeksētāju Relations View satur papildu ierakstus. Šie ieraksti parāda nosaukumu file un varianta punkta līnijas numurs. Rīka padoms parāda atbilstošo sadaļu file. Veicot dubultklikšķi uz ieraksta, file tiks atvērts redaktorā.
pure::variants Nosacījumi
Nosacījumu Pure::variants var izmantot, lai iekļautu vai izslēgtu a sadaļas file atkarībā no funkcijas izvēles. Stāvokļa indeksētājs meklē šādus noteikumus un izvelk norādītos līdzekļus. Ja šāda funkcija ir atlasīta redaktorā, Relations View parādīs visu files un līnijas, kurās atrodas nosacījums ar atlasīto līdzekli (sk. 6. attēlu, “Nosacījuma attēlojums attiecībās View”).
6. attēls. Nosacījuma attēlojums attiecībās ViewLai iegūtu detalizētu skaidrojumu par nosacījumu definēšanu, skatiet pure::variants lietotāja rokasgrāmatas 9.5.7. nodaļas sadaļu ps:condtext (Atsauce–>Iepriekš definēti avota elementu veidi–>ps:condtext).
C/C++ priekšprocesora konstantes
C/C++ priekšprocesora indeksētājs skenē files konstantēm, ko izmanto priekšprocesora noteikumos (piemēram, #ifdef, #ifndef, …).
Ja ps:flag vai ps:flagfile elements ir atlasīts Relations View parāda definētās priekšprocesora konstantes lietojumu.
Attiecības View parāda arī priekšprocesora konstantes, kas savienotas ar līdzekļiem, izmantojot kartēšanas modeļus. Šim nolūkam modeļi tiek paplašināti ar atlasītā objekta datiem. Iegūtie simboli tiek izmantoti, lai meklētu atbilstošas ​​priekšprocesora konstantes. 7. attēls, “C/C++ priekšprocesora konstantes attēlojums attiecībās View” rāda bijušaisample ar modeli slava{Vārds}. Raksts ir paplašināts ar unikālo funkcijas nosaukumu uz fameNative. Indeksētajā kodā ir 76 vietas, kur tiek izmantota priekšprocesora konstante fameNative.
Šīs atrašanās vietas ir parādītas sadaļā Attiecības View. Modeļus var definēt preferencēs (skatiet 3.3. sadaļu “Iestatījumi”).
7. attēls. C/C++ priekšprocesora konstantes attēlojums attiecībās View

3.3. Preferences
Lai mainītu indeksētāja noklusējuma darbību, atveriet Eclipse preferences un kategorijā Variant Management atlasiet lapu Relation Indexer. Lapā ir redzami divi saraksti.
8. attēls. Relāciju indeksētāja preferenču lapaAugšējā sarakstā ir noklusējuma vērtība file indeksētāja modeļi (1). Šis saraksts ir sākotnējais modeļa iestatījums tikko iespējotiem projektiem.
Apakšējā sarakstā ir attēlojums starp iezīmēm un priekšprocesora konstantēm (2). Šī kartēšana tiek izmantota visiem projektiem. 1. tabulā “Atbalstītās kartēšanas nomaiņas” ir parādītas visas iespējamās nomaiņas.
1. tabula. Atbalstītās kartēšanas nomaiņas

Aizstājējzīme	Apraksts	Example: FeatureA
Vārds	atlasītā objekta unikālais nosaukums	FLAG_{Nosaukums} — FLAG_FeatureA
VĀRDS	ar lielajiem burtiem Unikālais atlasītā objekta nosaukums	FLAG_{NAME} — FLAG_FEATUREA
nosaukums	mazie burti Unikālais atlasītā objekta nosaukums	karodziņš_{nosaukums} — karoga_funkcija

Dokumenti / Resursi

pure-systems 2024 savienotājs pirmkoda pārvaldības programmatūrai [pdfLietotāja rokasgrāmata 2024, 2024 savienotājs pirmkoda pārvaldības programmatūrai, savienotājs avota koda pārvaldības programmatūrai, avota koda pārvaldības programmatūra, pārvaldības programmatūra, programmatūra

Atsauces

• Lietotāja rokasgrāmata