mama :: fesuiaiga – Fesoʻotaʻi mo
Source Code Management Manual
Parametric Technology GmbH
Version 6.0.7.685 mo mama ::variants 6.0
Puletaofia © 2003-2024 Parametric Technology GmbH
2024

Folasaga

mama :: fesuia'iga Feso'ota'i mo le Pulea Fa'asinoala Puna (Connector) e mafai ai e le au atina'e ona fa'atautaia le fesuiaiga o fa'amatalaga puna e fa'aaoga ai le mama :: fesuiaiga. O le Source Code Management of pure::variants e maua ai se avanoa fetuutuunai e fa'amaopoopo fa'asologa o fa'atonuga ma fa'ailoga puna. files faigofie ma mama ::variants faʻataʻitaʻiga. O le mea lea e mafai ai ona fa'aogaina le pulega fa'apitoa e o'o lava i galuega fa'akomepiuta lavelave. E le gata i lea, o feso'ota'iga i le va o le mama::variants features ma source code e mafai ona fa'afaigofie ona fa'afoeina ma le faufale ma e mafai ona maua e ala i le Source Code Management.
1.1. Polokalama Manaoga
O le mama ::variants Connector for Source Code Management o se faʻaopoopoga mo mama::variants ma o loʻo avanoa i luga o faʻavae lagolago uma.
1.2. Fa'apipi'i
Fa'amolemole fa'afeso'ota'i le vaega mama::variants Feso'ota'i i le mama::variants Setup Guide mo fa'amatalaga au'ili'ili pe fa'afefea ona fa'apipi'i le feso'ota'iga (menu Fesoasoani -> Fesoasoani I totonu ona mama lea::variants Setup Guide -> mama::variants Connectors).
1.3. E uiga i lenei tusi lesona
O le tagata faitau e fa'amoemoe e maua le poto masani e uiga i le poto masani ma le mama ::variants. Fa'amolemole fa'afeso'ota'i mea tomua a'o le'i faitauina lenei tusi lesona. O lo'o maua le tusi lesona ile fesoasoani i luga ole laiga fa'apea fo'i ile fa'asologa o le PDF e mafai ona lolomi iinei.

Fa'aaogāina Feso'ota'i

2.1. Amata mama ::variants
Fa'alagolago ile auala fa'apipi'i fa'aaoga pe amata le mama::variants-enabled Eclipse po'o lalo ole Windows filifili le mea mama::variants mai le lisi o le polokalame.
Afai e le'i fa'agaoioia le va'aiga o le Pulega Va'aiga, fai lea e ala i le filifilia mai le Tatala Va'aiga-> Isi... i le lisi o Fa'amalama.
2.2. Fa'aulufale mai se Laau Fa'atonu i totonu o se Fa'ata'ita'iga a Aiga
A'o le'i fa'aulufaleina mai se la'au fa'atonu i totonu o se Fa'ata'ita'iga a Aiga, e tatau ona fai se galuega fa'aopoopo. E fa'apea fo'i le fa'ailoaina o foliga i totonu o se Fa'ata'ita'iga Fa'atusa ua uma. Fa'amolemole fa'afeso'ota'i le fa'amaumauga mama::variants mo se fesoasoani e uiga i la'asaga nei.
O le fa'aulufale mai moni e amata i le filifilia o le Fa'aulufale mai... gaioiga pe i totonu o le lisi autu o Poloketi view po'o le Fa'aulufale mai... lisi i le File lisi. Filifili Variant Models po'o Poloketi mai le vaega Variant Management ma fetaomi le Next. I luga o le itulau o lo'o mulimuli mai filifili Fa'aulufale mai se Fa'ata'ita'iga a Aiga mai fa'apogai fa'apogai ma toe fetaomi le Next.
Filifili le ituaiga code puna e fa'aulufale mai
O lo'o aliali mai le fa'aulufale mai (silasila i le Ata 1, "Itulau o le fa'aulufale mai e filifili ai le ituaiga fa'ailoga e ono fa'aulufale mai"). Filifili se galuega-ituaiga e faaulufale mai ma fetaomi le Next. O ituaiga ta'itasi o lo'o iai se seti fa'ata'atia o file ituaiga e faaulufale mai i le faataitaiga.
Ata 1. Itulau o le fa'aulufalega wizard e filifili ai le ituaiga o fa'ailoga e ono fa'aulufale maiFilifili Puna ma Fa'atatau
I le isi itulau wizard (Ata 2, “Itulau o le fa'aulufale mai e filifili le puna ma le sini mo le fa'aulufale mai”) e tatau ona fa'amaoti le fa'atonuga fa'apogai ma le fa'ata'ita'iga.
Oomi le Browse… button e filifili ai le lisi o loʻo iai le source code e tatau ona faʻaulufale mai. E le mafai ona filifili le avanoa faigaluega o lo'o i ai nei aua atonu o se itu aoga lea e amata ai le folau.
O lo'o i lalo e mafai ona e fa'ama'oti fa'aaofia ma fa'ate'a le mamanu. O nei mamanu e tatau ona java masani faʻamatalaga. O ala fa'aoga ta'itasi, e fa'atatau i le fa'apogai a'a fa'apogai, o lo'o siaki i nei mamanu. Afai e fetaui le mamanu e aofia ai, e faaulufale mai se pusa, pe afai e le fetaui le mamanu tuuese. O lona uiga o le fa'aaofia mamanu e mua'i filifilia faila e fa'aulufale mai, o le le fa'aofiina o le mamanu e fa'atapulaaina ai lenei filifiliga.
A uma ona filifilia le source code directory e tatau ona fa'amalamalamaina se fa'ata'ita'iga. O le mea lea, filifili se suiga eseese poʻo se faila e tatau ona teu ai le faʻataʻitaʻiga ma faʻapipiʻi se igoa faʻataʻitaʻiga. O le file e otometi lava ona fa'alautele le igoa i le fa'aopoopoga .ccfm pe a le tu'uina atu i lenei talanoaga. I le faaletonu o le a seti i le igoa tutusa ma le igoa faataitai lava ia. O le tulaga lea ua fautuaina.
A mae'a ona fa'ailoa mai se faila fa'apogai talafeagai ma le igoa fa'ata'ita'i e mana'omia, e mafai ona fa'auma le talanoaga i le oomiina o le Finish. Afai e oomi le Next button, o le a sau se isi itulau e mafai ona fai ai isi faʻaopoopoga.
Ata 2. Itulau ole fa'aulufale mai e filifili le puna ma le fa'amoemoe mo le fa'aulufale maiSuia Mana'oga Fa'aulufale mai
I le itulau fa'ata'ita'i mulimuli (Ata 3, “Itulau o le fa'aulufale mai e fa'amatala ai se fa'atulagaga ta'ito'atasi”) o lo'o iai mana'oga e mafai ona fai e fa'avasega ai le amio fa'aulufale mai mo le poloketi polokalame fa'aulufale mai.
O le itulau o talanoaga o lo'o fa'aalia ai se laulau o lo'o i ai le file ua fa'amalamalamaina ituaiga, o le a iloiloina e le fa'aulufale mai.
O laina ta'itasi e aofia ai ma fa fanua.

• O le Fa'amatalaga fanua o lo'o i ai se fa'amatalaga fa'amatala puupuu e iloa ai le file ituaiga.
• O le File igoa mamanu fanua e fa'aoga e filifili ai files e faaulufale mai pe a fetaui ma le tau o fanua. O lo'o fa'aogaina e le fanua le syntax lea:

1. Ole fa'aoga masani ole a file fa'aopoopoga. Ole syntax masani ole .EXT, ile mea ole EXT ole mana'omia file fa'aopoopoga (eg .java).
2. O le isi tulaga masani o se mea faʻapitoa file, pei o se faifile. O le mea lea, e mafai ona faʻafetaui i le saʻo file igoa. Ina ia faia lenei mea, na o le ulufale i le file igoa ile fanua (eg build.xml).
3. I nisi tulaga o manaoga faafanua e sili atu ona patino, e na'o files e fetaui ma se mamanu faapitoa e tatau ona faaulufale mai. Ina ia fetaui ma lenei manaʻoga e mafai ona faʻaogaina faʻamatalaga masani i le File igoa mamanu fanua.
   O le faamatalaina o le syntax o faaupuga masani o le a sili atu i le faamoemoe o lenei fesoasoani. Fa'amolemole fa'afeso'ota'i le vaega o fa'amatalaga masani o le mataupu fa'asino i le mama::variants ta'iala mo tagata fa'aoga (eg .*).

• O le fanua ituaiga elemene fa'afanua fa'atulagaina le fa'afanua i le va a file ituaiga ma se mama::variants ituaiga elemene aiga. O le ituaiga elemene aiga o se faʻamatalaga mo le puna file e tuʻuina atu faʻamatalaga atili i le elemene faʻafanua i le faʻataʻitaʻiga faʻaulufale mai. O filifiliga masani o le ps:class poʻo le ps:makefile.
• Le Faafanua file ituaiga fanua seti le faafanua i le va a file ituaiga ma se mama ::variants file ituaiga. O le file type i le mama::variants o se fa'amatalaga mo le puna file e tuʻuina atu faʻamatalaga atili i le elemene faʻafanua i le faʻataʻitaʻiga faʻaulufale mai. O filifiliga masani e faʻatatau mo faʻatinoga poʻo le faʻamaonia mo faʻamatalaga files.

Ata 3. Itulau ole fa'aulufale mai e fa'amatala ai se fa'atulagaga ta'ito'atasiFou file e mafai ona faaopoopo ituaiga e ala i le faaaogaina o le Add Mapping button. O fanua uma e faʻatumu i le tau e leʻi faʻamalamalamaina ma e tatau ona faʻatumu e le tagata faʻaoga. Ina ia faasa'o se tau i totonu o se fanua, na'o le kiliki i totonu o le fanua ma le isumu. O le tau e mafai ona faʻasaʻo ma mafai ona suia. E le mafai ona suia le faaletonu file igoa mamanu o le laulau. Ina ia mafai ona fetu'una'i se fa'avasegaga, e mafai ona fa'a'ese'ese a file lolomi e ala i le soloia o le laina. Ua le filifilia file fa'asologa o igoa e tumau i le fa'atulagaina ae o le a le fa'aaogaina e le tagata fa'aulufale mai. Fa'amatalaga fa'aoga file e mafai ona toe ave'ese ituaiga e ala i le fa'aogaina o le ki o le Aveese Mapping.
E ala i le faaletonu o le isi files file o lo'o maua le mamanu igoa ile laulau ae ua le filifilia. E masani lava e le mana'o e fa'aulufale uma mai files ae e mafai ona faigofie ona suia e ala i le filifilia o le laina e tusa ai.
E tolu filifiliga fa'aulufaleina lautele e fa'avasega ai le amio a le tagata fa'aulufale mai.

• Aua le fa'aulufale mai fa'amaumauga e aunoa ma se fa'atusa files (eg CVS directories).
  Afai e maua e le tagata fa'aulufale mai se lisi e leai se fetaui file o lo'o i totonu ma e leai se subdirectory e tutusa file, o le a le fa'aulufale mai le lisi. E masani ona aoga lenei mea, pe a fai o poloketi e pulea e faiga faʻatonutonu e pei o le CVS. Mo CVS, o fa'atonuga talafeagai ta'itasi o lo'o i ai se CVS-fa'asinomaga pe a le talafeagai files ua teuina. Afai e filifilia lenei filifiliga ma le CVS-filee le fetaui ma soo se mea file ituaiga o lo'o fa'amatalaina i luga, o le a le fa'aulufaleina mai le fa'atonu o se vaega i totonu o le Fa'ata'ita'iga a le Aiga.
• Fa'avasega files ma fa'atonuga.
  Fa'aaga le filifiliga e fa'avasega files ma fa'atonuga ta'itasi i le fa'asologa o alafapeta.
• Fa'aulufaleina auala.
  Mo le fa'aopoopoina atili e mana'omia e le tagata fa'aulufaleina le auala muamua o elemene fa'aulufale mai uma i totonu o le fa'ata'ita'iga.
  I le tele o tulaga Fa'ata'ita'iga a Aiga fa'asoa fa'atasi ma isi tagata fa'aoga. Atonu e eseese le fausaga o le lisi mo tagata ta'itasi. Ina ia lagolagoina le tele o fa'aoga masani e mafai e le tagata fa'aulufale mai ona galue i auala eseese:

Moni	O le ala atoatoa i le elemene faaulufale mai o le a teuina i totonu o le faʻataʻitaʻiga. Mo le fa'amaopoopoina mulimuli ma le taimi o le suiga o le files e tatau ona tuʻu i luga o le nofoaga tonu e tasi e pei o le taimi muamua faaulufale mai.
Fegalegaleai ma Galuega	O auala o lo'o teuina fa'atatau i le pusa o galuega. Mo le fa'amaopoopoina o le files e tatau ona avea ma vaega o le Eclipse workspace. O le suiga e tatau ona fa'aogaina le Eclipse workspace e fai ma fa'atonuga fa'aoga.
Fa'atatau ile Poloketi	O auala o lo'o teuina fa'atatau i le poloketi. Mo le fa'amaopoopoina o le files o se vaega o le poloketi i totonu ole Eclipse. O le suiga e tatau ona fa'aogaina le faila o le poloketi e fai ma fa'atonuga.
Fa'atatau i le Ala	O ala o lo'o teuina fa'atatau i le ala ua tu'uina atu. Mo le fa'amaopoopoina o le files e tatau ona tu'u i le nofoaga tonu lava e tasi. O le lisi o mea e sui ai e tutusa ma le ala fa'atatau i le taimi o le fa'aulufale mai.

O mea uma e fiafia i ai o lenei talanoaga e teu pea. E le tatau ona toe faia le fa'avasegaga a le tagata lava ia i taimi uma e fa'aulu mai ai. O le mea lea e faigofie ma vave ai le fa'aulufaleina o galuega.
2.3. Fa'afouina Fa'ata'ita'iga mai le Directory Tree
Oomi le faamau Synchronize e fa'amaopoopo se fa'ata'ita'iga fa'aulufale mai ma lona ala fa'atonu. O le aʻa ala o le poloketi o loʻo teuina i totonu o le faʻataʻitaʻiga ina ia faʻafetaui i le lisi tutusa e pei ona muamua. Ina ia mafai ai le Synchronize button, tatala le faʻataʻitaʻiga ma filifili soʻo se elemene. A uma ona oomi le ki Fa'atasi e tatala le Fa'atusa Fa'atonu i le mea o lo'o fa'afeagai ai le Fa'ata'ita'iga a le Aiga o lo'o i ai nei ma le fa'ata'ita'iga o le fa'atulagaga o lo'o i ai nei (silasila i le Ata 4, "Fa'ata'ita'iga fa'afouga mai le La'au Fa'atonu i Fa'atusa Fa'atonu").
Ata 4. Fa'afouga fa'ata'ita'iga mai le Directory Tree i Fa'atusa Fa'atonu   O lo'o fa'aoga le fa'atonu fa'atusatusa i le fa'atusa mama:: fa'atusa e fa'atusatusa ai fa'ata'ita'iga fa'ata'ita'iga ae i le tulaga lea e fa'aogaina e fa'atusatusa ai le fa'atulagaina o fa'atonuga fa'aletino (fa'aali i le itu taumatau pito i lalo) ma le fa'ata'ita'iga mama::variants o lo'o iai (itu agavale pito i lalo). O suiga uma o loʻo lisiina o ni mea eseese i le pito i luga o le faatonu, faʻatonuina e elemene afaina.
O le filifilia o se mea i totonu o lenei lisi e faʻamaonia ai suiga taʻitasi i faʻataʻitaʻiga e lua. I le example, o se elemene faaopoopo ua faailogaina i se pusa i le itu taumatau ma fesootai ma lona tulaga talafeagai i le faataitaiga i le itu tauagavale. O le Merge toolbar i le va o le pito i luga ma le pito i lalo faʻamalama faʻamalama e maua ai meafaigaluega e kopi ai le tasi poʻo mea uma (e le feteʻenaʻi) suiga atoa mai le faʻataʻitaʻiga laʻau tusi i le Faʻataʻitaʻiga Faʻataʻitaʻiga.
Manatua
O le fa'amaopoopoina o lo'o faia fa'atasi ma fa'aoga fa'aulufaleina mulimuli na fa'aaoga. Ole mea lea e mafai ai ona fa'afouina le fa'ata'ita'iga ma isi fa'atulagaga e pei ona faia a'o fa'aulufale mai.

Fa'aaogā Fa'asinoga Fa'asinoga

O le Feso'ota'i mo le Pulea Fa'asinoala Puna e fa'aleleia ai le So'otaga View fa'atasi ai ma fa'amatalaga e uiga i feso'ota'iga i le va o le mama::variants fa'ata'ita'iga elemene ma le fa'ailoga puna. E fa'aopoopoina sootaga mo foliga o lo'o fa'aogaina i tulaga o le ps:condxml ma le ps:condtext elemene.
Mo ps:flag ma ps:flagfile elemene le nofoaga o mea e fai muamua i le C/C++ puna files o lo'o fa'aalia. E le gata i lea, o nofoaga o lo'o fa'atusaina ai fa'asologa o le mua'i fa'ata'ita'iga o lo'o fa'aalia mo se vaega filifilia e ala i le fa'aogaina o le fa'afanua i le va o igoa fa'apitoa ma fa'asologa o taimi muamua.
3.1. Fa'aopoopoina le Fa'asinoga Fa'amatalaga i se Poloketi
E mafai ona fa'agaoioia le faasino igoa o feso'ota'iga i luga o se itulau fa'apitoa o meatotino. Filifili le poloketi ma filifili le mea totino i le lisi autu. I le talanoaga o lo'o loma, filifili le itulau Fa'asinoga Fa'asinomaga.
Ata 5. Itulau o Meatotino Poloketi mo le Su'esu'ega Fa'asinomaga

O lo'o fa'agaoioia le fa'asino igoa o feso'ota'iga mo le poloketi e ala i le filifilia o le filifiliga Enable Relation Indexer (1). A mae'a ona fa'agaoioi le fa'asino igoa o lo'o iai nisi filifiliga e fa'amatala ai le amio fa'apitoa o le poloketi. Le fa'asino igoa o mama::variants Tulaga ma C/C++ Preprocessor Constants e mafai ona fa'agaoioia eseese (2). Le lisi ma file igoa mamanu (3) e faaaoga e filifili ai le files mo le faasino igoa. Na'o files e fetaui ma se tasi o mamanu o lo'o va'aia. Fa'aopoopo le "*" e fai ma fa'ata'ita'iga e su'e uma ai files o se poloketi.
A mae'a ona fa'agaoioia le fa'asino igoa mo se poloketi e fa'aopoopoina se faufale i le poloketi. Na suia su'esu'ega a le faufale files mo sootaga fou i mama::variants fa'atusa elemene otometi.
3.2. O Fesoota'iga ma le Source Code
Faatasi ai ma le faasino igoa sootaga ua faagaoioia le Fegalegaleaiga View o lo'o iai fa'amatalaga fa'aopoopo. O fa'amaumauga nei o lo'o fa'aalia ai le igoa o le file ma le numera laina o le itu eseese. O le pito o meafaigaluega o loʻo faʻaalia ai le vaega talafeagai o le file. E ala i le kiliki-lua o le mea e ulufale ai le file o le a tatalaina i se faatonu.
mama ::variants Tulaga
Ole tulaga mama::variants e mafai ona fa'aoga e aofia ai pe fa'aesea ai vaega ole a file fa'alagolago i se vaega filifilia. E su'esu'e e le Fa'asinoga Tulaga ia tulafono ma aveese mai ai vaega fa'asino. Afai e filifilia sea ituaiga i le faatonu o le Relations View o le a faʻaalia uma files ma laina o loʻo i ai se tulaga o loʻo i ai le vaega filifilia (silasila i le Ata 6, "Faʻatusaina o se Tulaga i le Fegalegaleaiga View”).
Ata 6. Fa'atusaina o se Tulaga i le Va'aiga ViewIna ia maua se faʻamatalaga auiliili i le faʻamalamalamaina o tulaga, faʻafesoʻotaʻi le vaega ps:condtext o le mataupu 9.5.7 o le mama::variants User's Guide (Reference–>Predefined Source Element Types–>ps:condtext).
C/C++ Preprocessor Constants
O le C/C++ Preprocessor Indexer e su'e files mo fa'aoga tumau o lo'o fa'aaogaina i tulafono a le fa'atonu (eg #ifdef, #ifndef, …).
Afai o le ps:flag po'o le ps:flagfile elemene ua filifilia le Fegalegaleaiga View o lo'o fa'aalia ai le fa'aogaina o le fa'asologa o le mua'i fa'atonu.
O Sootaga View o lo'o fa'aalia ai fo'i fa'asologa o lo'o fa'agasolo muamua e feso'ota'i i foliga e ala i le fa'aogaina o fa'asologa o fa'afanua. Mo lenei mea o loʻo faʻalauteleina faʻataʻitaʻiga ma faʻamaumauga o le vaega filifilia. O fa'ailoga fa'ai'uga e fa'aoga e su'e ai fa'atutusa mea fa'apolopolo muamua. Ata 7, “Fa'atusa o le C/C++ Preprocessor Constant i le Fegalegaleaiga View” o loo faaali atu ai e se tasi sa iai muamuaample ma le mamanu ta'uta'ua{Name}. O le mamanu ua faʻalauteleina i le igoa tulaga ese o le faʻaaliga i fameNative. I le fa'ailoga fa'asino igoa o lo'o i ai nofoaga e 76 e fa'aoga ai le fa'aupuga masani fameNative.
O nei nofoaga o loʻo faʻaalia i le Fegalegaleaiga View. O mamanu e mafai ona faauigaina i mea e fiafia i ai (tagai i le Vaega 3.3, “O Le Fa'atonuga”).
Ata 7. Fa'atusa o le C/C++ Preprocessor Constant i le Fegalegaleaiga View

3.3. O Fa'atonuga
Ina ia suia le amio le lelei a le faasino igoa tatala le Eclipse e fiafia i ai ma filifili le Relation Indexer itulau i le Variant Management category. O le itulau o loʻo faʻaalia ai lisi e lua.
Ata 8. Itulau o le Fa'asinoga Fa'asinoga Fa'apitoaO le lisi pito i luga o loʻo i ai le faaletonu file mamanu mo le faasino igoa (1). O le lisi lea o le fa'atulagaga muamua mo galuega fa'ato'a mafai.
O le lisi pito i lalo o loʻo i ai le faʻafanua i le va o foliga ma faʻasologa o mea muamua (2). O lenei fa'afanua e fa'aoga mo galuega uma. Laulau 1, "Sui Suiga Faafanua Lagolago" o loʻo faʻaalia ai suiga uma e mafai.
Laulau 1. Suiga Fa'afanua Lagolago

Wildcard	Fa'amatalaga	Example: FeatureA
Igoa	le Igoa Tulaga o le vaega ua filifilia	FLAG_{Igoa} – FLAG_FeatureA
IGOA	mataitusi pito i luga Igoa Tulaga o le vaega ua filifilia	FLAG_{NAME} – FLAG_FEATUREA
igoa	mata'itusi la'ititi Igoa Tulaga o le vaega ua filifilia	fu'a_{igoa} - fu'a_featura

Pepa / Punaoa

mama-faiga 2024 Fesoʻotaʻi mo Punaoa Code Pulea Polokalama [pdf] Tusi Taiala 2024, 2024 Feso'ota'i mo Polokalama Pulea Fa'asinoala Puna, Fa'afeso'ota'i mo Polokalama Pulea Fa'asinoala Puna, Polokalama Pulea Fa'asinoala Puna, Polokalama Pulea, Polokalama

Fa'asinomaga

• Tusi Taiala