safi::lahaja - Kiunganishi cha
Mwongozo wa Usimamizi wa Msimbo wa Chanzo
Teknolojia ya Parametric GmbH
Toleo la 6.0.7.685 kwa safi::lahaja 6.0
Hakimiliki © 2003-2024 Parametric Technology GmbH
2024

Utangulizi

safi::lahaja Kiunganishi cha Usimamizi wa Msimbo wa Chanzo (Kiunganishi) huwezesha wasanidi programu kudhibiti utofauti wa msimbo wa chanzo kwa kutumia::lahaja safi. Usimamizi wa Msimbo wa Chanzo wa::lahaja safi hutoa fursa rahisi ya kusawazisha miundo ya saraka na msimbo wa chanzo files kwa urahisi na mifano safi::lahaja. Kwa hivyo usimamizi wa anuwai unaweza kutumika kutekelezwa hata kwa miradi ngumu ya programu. Zaidi ya hayo miunganisho kati ya vipengele safi::lahaja na msimbo chanzo vinaweza kudhibitiwa kwa urahisi na mjenzi na vinaweza kufikiwa kwa urahisi kupitia Usimamizi wa Msimbo wa Chanzo.
1.1. Mahitaji ya Programu
Kiunganishi safi::lahaja cha Usimamizi wa Msimbo wa Chanzo ni kiendelezi cha::lahaja safi na kinapatikana kwenye mifumo yote inayotumika.
1.2. Ufungaji
Tafadhali angalia sehemu safi::vigezo Viunganishi katika::vigezo safi Mwongozo wa Kuweka kwa maelezo ya kina kuhusu jinsi ya kusakinisha kiunganishi (menu Usaidizi -> Yaliyomo ya Usaidizi na kisha safi::Vigezo vya Kuweka Mwongozo -> safi::viunganishi vingine).
1.3. Kuhusu mwongozo huu
Msomaji anatarajiwa kuwa na maarifa ya kimsingi kuhusu na uzoefu na safi::lahaja. Tafadhali tazama nyenzo zake za utangulizi kabla ya kusoma mwongozo huu. Mwongozo unapatikana katika usaidizi wa mtandaoni na pia katika umbizo la PDF linaloweza kuchapishwa hapa.

Kutumia Kiunganishi

2.1. Inaanza safi ::aina
Kulingana na mbinu ya usakinishaji iliyotumika aidha anza Eclipse safi::variants-enabled au chini ya Windows chagua safi::vipengee vya anuwai kutoka kwa menyu ya programu.
Ikiwa mtazamo wa Usimamizi wa Lahaja bado haujaamilishwa, fanya hivyo kwa kuuchagua kutoka kwa Mtazamo Fungua-> Nyingine... kwenye menyu ya Dirisha.
2.2. Ingiza Mti wa Saraka kuwa Mfano wa Familia
Kabla ya kuingiza mti wa saraka kwenye Mfano wa Familia, mradi wa vibadala lazima uundwe. Pia inapendekezwa kuwa na vipengele vilivyofafanuliwa katika Kielelezo cha Kipengele tayari. Tafadhali angalia hati safi::lahaja kwa usaidizi kuhusu hatua hizi.
Uingizaji halisi unaanza kwa kuchagua Leta... kitendo katika menyu ya muktadha wa Miradi view au kwa Leta... menyu kwenye File menyu. Chagua Miundo Lahaja au Miradi kutoka kwa kitengo cha Usimamizi wa Kibadala na ubonyeze Ijayo. Katika ukurasa unaofuata chagua Leta Kielelezo cha Familia kutoka kwa folda chanzo na ubonyeze Inayofuata tena.
Chagua aina ya msimbo wa chanzo ili kuleta
Kichawi cha uingizaji kinaonekana (ona Mchoro 1, "Ukurasa wa mchawi wa kuingiza ili kuchagua aina ya msimbo wa chanzo unaoweza kuingizwa"). Chagua aina ya mradi ili kuleta na ubonyeze Inayofuata. Kila aina ina seti iliyofafanuliwa awali ya file aina za kuagiza kwa mfano.
Kielelezo 1. Ukurasa wa mchawi wa kuingiza ili kuchagua aina ya msimbo wa chanzo ambao unaweza kuletwaChagua Chanzo na Lengo
Kwenye ukurasa unaofuata wa mchawi (Kielelezo 2, "Ukurasa wa mchawi wa kuingiza ili kuchagua chanzo na lengo la uingizaji") saraka ya chanzo na kielelezo lengwa lazima kibainishwe.
Bonyeza kitufe cha Vinjari... ili kuchagua saraka ambapo msimbo wa chanzo upo ambao unapaswa kuingizwa. Kwa chaguo-msingi nafasi ya kazi ya sasa imechaguliwa kwa sababu hii inaweza kuwa hatua muhimu ya kuanza kuelekeza.
Hapo chini unaweza kubainisha kujumuisha na kutenga muundo. Muundo huu lazima uwe misemo ya kawaida ya java. Kila njia ya ingizo, inayohusiana na folda ya chanzo, inaangaliwa na muundo huu. Ikiwa muundo unaojumuisha unaofanana, folda italetwa, ikiwa mchoro wa kutenga haulingani. Ikimaanisha kuwa mchoro unaojumuisha hauchagui mapema folda za kuleta, mchoro wa kutenga hauzuii uteuzi huu wa mapema.
Baada ya kuchagua saraka ya msimbo wa chanzo muundo unaolengwa lazima ufafanuliwe. Kwa hivyo chagua mradi lahaja au folda ambapo kielelezo kinapaswa kuhifadhiwa na uweke jina la kielelezo. The file jina hupanuliwa kiotomatiki kwa kiendelezi cha .ccfm ikiwa halitatolewa kwenye kidirisha hiki. Kwa chaguo-msingi itawekwa kwa jina sawa na jina la mfano lenyewe. Huu ndio mpangilio unaopendekezwa.
Baada ya folda ya chanzo inayofaa na jina la kielelezo linalohitajika kubainishwa, kidadisi kinaweza kukamilika kwa kubofya Maliza. Ikiwa kitufe kifuatacho kimebonyezwa, ukurasa zaidi unakuja ambapo mipangilio ya ziada inaweza kufanywa.
Kielelezo 2. Ukurasa wa mchawi wa kuagiza ili kuchagua chanzo na lengo la uingizajiBadilisha Mapendeleo ya Kuingiza
Kwenye ukurasa wa mwisho wa mchawi (Kielelezo 3, “Ukurasa wa mchawi wa kuingiza ili kufafanua usanidi wa mtu binafsi”) kuna mapendeleo ambayo yanaweza kufanywa ili kubinafsisha tabia ya kuleta kwa mradi wa programu ulioletwa.
Ukurasa wa mazungumzo unaonyesha jedwali ambapo file aina hufafanuliwa, ambayo itazingatiwa na mchakato wa kuagiza.
Kila mstari una sehemu nne.

• Sehemu ya Maelezo ina maandishi mafupi ya kufafanua kutambua file aina.
• The File uga wa muundo wa jina hutumika kuchagua files za kuingizwa zinapolingana na thamani ya uga. Sehemu hutumia syntax ifuatayo:

1. Matumizi ya kawaida zaidi inaweza kuwa a file ugani. Sintaksia ya kawaida ni .EXT, ambapo EXT inatakikana file kiendelezi (km .java).
2. Hali nyingine ya kawaida ni maalum file, kama kutengenezafile. Kwa hiyo, inawezekana kwa mechi juu ya halisi file jina. Ili kufanya hivyo, ingiza tu file jina kwenye uwanja (kwa mfano build.xml).
3. Katika baadhi ya matukio matamanio ya ramani ni maalum zaidi, hivyo tu files zinazofanana na muundo maalum zinapaswa kuingizwa. Ili kutoshea hitaji hili inawezekana kutumia misemo ya kawaida katika File uwanja wa muundo wa jina.
   Kuelezea sintaksia ya misemo ya kawaida kungezidi dhamira ya usaidizi huu. Tafadhali rejelea sehemu ya misemo ya kawaida ya sura ya marejeleo katika mwongozo safi wa mtumiaji::lahaja (km .*).

• Sehemu ya aina ya kipengele Kimechorwa huweka ramani kati ya a file aina na safi::aina ya kipengele cha familia. Aina ya kipengele cha familia ni kifafanuzi cha chanzo file ili kutoa maelezo zaidi kwa kipengele kilichowekwa kwenye ramani katika muundo ulioingizwa. Chaguo za kawaida ni ps:class au ps:makefile.
• Ramani file uga wa aina huweka ramani kati ya a file aina na safi ::lahaja file aina. The file type in pure::variants ni kifafanuzi cha chanzo file ili kutoa maelezo zaidi kwa kipengele kilichowekwa kwenye ramani katika muundo ulioingizwa. Chaguo za kawaida ni impl kwa ajili ya utekelezaji au def kwa ufafanuzi files.

Kielelezo 3. Ukurasa wa mchawi wa kuingiza ili kufafanua usanidi wa mtu binafsiMpya file aina zinaweza kuongezwa kwa kutumia kitufe cha Ongeza Ramani. Sehemu zote zimejazwa na thamani ambayo haijafafanuliwa na lazima ijazwe na mtumiaji. Ili kuhariri thamani katika sehemu, bonyeza tu kwenye uwanja na kipanya. Thamani inaweza kuhaririwa na inaweza kubadilishwa. Haiwezekani kubadilisha chaguo-msingi file muundo wa majina ya meza. Ili kufanya ubinafsishaji kubadilika, inawezekana kuteua a file chapa kwa kutengua uteuzi wa safu mlalo. Imeacha kuchagua file ruwaza za majina hukaa kwenye usanidi lakini hazitatumiwa na mwigizaji. Mtumiaji amefafanuliwa file aina zinaweza kuondolewa tena kwa kutumia kitufe cha Ondoa Ramani.
Kwa chaguo-msingi Nyingine files file muundo wa jina unapatikana kwenye jedwali lakini umeacha kuchaguliwa. Kwa kawaida haitakiwi kuingiza zote files lakini hii inaweza kubadilishwa kwa urahisi kwa kuchagua safu mlalo.
Kuna chaguo tatu za jumla za kuingiza ili kubinafsisha tabia ya mwagizaji.

• Usiingize saraka bila kulinganisha files (mfano saraka za CVS).
  Ikiwa muagizaji atapata saraka ambapo hakuna inayolingana file iko ndani yake na ambapo hakuna saraka ndogo inayolingana file, saraka haitaletwa. Hii mara nyingi ni muhimu, ikiwa miradi inasimamiwa na mifumo ya usimamizi wa matoleo kama vile CVS. Kwa CVS, kila saraka husika ina saraka ya CVS ambapo haifai files zimehifadhiwa. Ikiwa chaguo hili limechaguliwa na CVS-files hailingani na yoyote file aina iliyofafanuliwa hapo juu, saraka haitaletwa kama kijenzi kwenye Muundo wa Familia.
• Panga files na saraka.
  Washa chaguo hili kupanga files na saraka kila moja kwa mpangilio wa alfabeti.
• Ushughulikiaji wa njia ya kuingiza.
  Kwa ulandanishi zaidi muagizaji anahitaji kuhifadhi njia asili ya vipengee vyote vilivyoagizwa kwenye modeli.
  Mara nyingi Miundo ya Familia inashirikiwa na watumiaji wengine. Muundo wa saraka unaweza kuwa tofauti kwa kila mtumiaji. Ili kusaidia hali za kawaida za utumiaji, mwigizaji anaweza kufanya kazi kwa njia tofauti:

Kabisa	Njia kamili ya kipengee kilichoingizwa itahifadhiwa kwenye modeli. Kwa maingiliano ya baadaye na wakati wa mabadiliko files zinapaswa kuwekwa kwenye eneo sawa kabisa na wakati wa uagizaji wa kwanza.
Kuhusiana na Nafasi ya Kazi	Njia zimehifadhiwa kuhusiana na folda ya nafasi ya kazi. Kwa maingiliano ya files lazima iwe sehemu ya nafasi ya kazi ya Eclipse. Mabadiliko lazima yatumie nafasi ya kazi ya Eclipse kama saraka ya ingizo.
Kuhusiana na Mradi	Njia zimehifadhiwa kulingana na mradi. Kwa maingiliano ya files ni sehemu ya mradi ndani ya Eclipse. Mabadiliko yanapaswa kutumia folda ya mradi kama saraka ya ingizo.
Kuhusiana na Njia	Njia zimehifadhiwa kuhusiana na njia iliyotolewa. Kwa maingiliano ya files zinapaswa kuwekwa kwenye eneo sawa kabisa. Saraka ya ingizo ya ubadilishaji ni sawa na njia ya jamaa wakati wa uagizaji.

Mapendeleo yote ya mazungumzo haya yanahifadhiwa kila wakati. Mageuzi ya kibinafsi hayafai kufanywa upya kila wakati uletaji unapoendeshwa. Hii inafanya utiririshaji wa kazi wa kuagiza kuwa rahisi na haraka.
2.3. Inasasisha Miundo kutoka kwa Saraka ya Tree
Bonyeza kitufe cha Sawazisha kusawazisha muundo ulioingizwa na njia yake ya saraka. Njia ya msingi ya mradi imehifadhiwa kwenye modeli kwa hivyo itasawazisha kwenye saraka sawa na hapo awali. Ili kuwezesha kitufe cha Sawazisha, fungua kielelezo na uchague kipengele chochote. Baada ya kubonyeza kitufe cha Sawazisha Kihariri cha Kulinganisha kinafunguliwa ambapo Mfano wa Familia wa sasa na muundo wa saraka ya sasa unapingwa (ona Mchoro 4, "Sasisho la Muundo kutoka kwa Mti wa Saraka katika Linganisha Kihariri").
Kielelezo 4. Sasisho la mfano kutoka kwa Mti wa Saraka katika Linganisha Mhariri   Kihariri cha kulinganisha kinatumika kote katika::lahaja zote kulinganisha matoleo ya kielelezo lakini katika kesi hii hutumiwa kulinganisha muundo wa saraka halisi (unaoonyeshwa katika upande wa kulia wa chini) na modeli safi ya sasa::vibadala (upande wa kushoto wa chini). Mabadiliko yote yameorodheshwa kama vitu tofauti katika sehemu ya juu ya kihariri, iliyoagizwa na vipengele vilivyoathiriwa.
Kuchagua kipengee katika orodha hii huangazia mabadiliko husika katika miundo yote miwili. Katika example, kipengee kilichoongezwa kina alama na kisanduku upande wa kulia na kuunganishwa na nafasi yake inayowezekana katika mfano wa upande wa kushoto. Upau wa vidhibiti wa Unganisha kati ya madirisha ya kihariri ya juu na ya chini hutoa zana za kunakili mabadiliko moja au hata yote (yasiyohitilafiana) kwa ujumla kutoka kwa muundo wa saraka hadi Kielelezo cha Kipengele.
Kumbuka
Usawazishaji unafanywa na mipangilio ya mwisho iliyotumika ya kuingiza. Hii inafanya uwezekano wa kusasisha modeli na mipangilio mingine kama ilivyofanywa wakati uletaji ulifanyika.

Kwa kutumia Relation Indexer

Kiunganishi cha Usimamizi wa Msimbo wa Chanzo huongeza Mahusiano View yenye maelezo kuhusu miunganisho kati ya vipengee safi vya ::variants na msimbo wa chanzo. Uhusiano huongezwa kwa vipengele vinavyotumika katika hali ya vipengele vya ps:condxml na ps:condtext.
Kwa ps:bendera na ps:benderafile vipengele vya eneo la vibadilishaji vya awali katika chanzo cha C/C++ files zinaonyeshwa. Kwa kuongezea, maeneo ya vichakato-tangulizi vinavyolingana yanaonyeshwa kwa kipengele kilichochaguliwa kwa kutumia ramani kati ya vipengele vya kipekee vya majina na vichakataji awali.
3.1. Kuongeza Kielelezo cha Uhusiano kwa Mradi
Kiashiria cha uhusiano kinaweza kuamilishwa kwenye ukurasa maalum wa mali ya mradi. Chagua mradi na uchague kipengee cha Sifa kwenye menyu ya muktadha. Katika mazungumzo yanayokuja chagua ukurasa wa Kielezo cha Uhusiano.
Kielelezo 5. Ukurasa wa Mali ya Mradi kwa Kielelezo cha Uhusiano

Kielezo cha uhusiano kimeamilishwa kwa mradi kwa kuchagua chaguo la Wezesha Kielezo cha Uhusiano (1). Baada ya kuwezesha indexer kuna chaguzi zaidi za kufafanua tabia maalum ya mradi. Uwekaji faharasa wa::lahaja safi Masharti na C/C++ Preprocessor Constants inaweza kuwashwa tofauti (2). Orodha na file muundo wa majina (3) hutumika kuchagua files kwa indexing. Pekee files zinazolingana na muundo mmoja huchanganuliwa. Ongeza "*" kama mchoro ili kuchanganua yote files ya mradi.
Baada ya kuamsha indexer kwa mradi mjenzi huongezwa kwenye mradi huo. Michanganuo hii ya wajenzi imebadilika files kwa mahusiano mapya kwa vipengee safi vya ::variants kiotomatiki.
3.2. Mahusiano na Kanuni ya Chanzo
Na indexer uhusiano ulioamilishwa Mahusiano View ina maingizo ya ziada. Maingizo haya yanaonyesha jina la file na nambari ya mstari wa sehemu ya lahaja. Ncha ya zana inaonyesha sehemu inayofaa ya file. Kwa kubofya mara mbili ingizo la file itafunguliwa kuwa mhariri.
safi::lahaja Masharti
Hali safi::lahaja inaweza kutumika kujumuisha au kutenga sehemu za a file kulingana na uteuzi wa kipengele. Kielezo cha Hali huchanganua sheria kama hizo na kutoa vipengele vilivyorejelewa. Ikiwa kipengele kama hicho kimechaguliwa katika mhariri Mahusiano View itaonyesha yote files na mistari ambapo hali iliyo na kipengele kilichochaguliwa iko (ona Mchoro 6, "Uwakilishi wa Hali katika Mahusiano View”).
Kielelezo 6. Uwakilishi wa Hali katika Mahusiano ViewIli kupata maelezo ya kina kuhusu jinsi ya kufafanua masharti, rejea sehemu ya ps:muktadha wa sura ya 9.5.7 ya Mwongozo safi wa::ahaja wa Mtumiaji (Rejea–>Aina za Vipengee Vilivyoainishwa vya Chanzo–>ps:muktadha).
C/C++ Preprocessor Constants
C/C++ Preprocessor Indexer huchanganua files kwa viambatisho vinavyotumika katika sheria za uchakataji (km #ifdef, #ifndef, …).
Ikiwa ps:bendera au ps:benderafile kipengele ni kuchaguliwa Mahusiano View inaonyesha matumizi ya kichakataji awali kilichobainishwa mara kwa mara.
Mahusiano View pia huonyesha vichakataji awali vilivyounganishwa kwa vipengele kwa kutumia ruwaza za ramani. Kwa hili ruwaza zinapanuliwa na data ya kipengele kilichochaguliwa. Alama zinazotokana hutumika kutafuta vibadilishaji vya awali vinavyolingana. Kielelezo cha 7, "Uwakilishi wa Kichakataji cha C/C++ Mara kwa Mara katika Mahusiano View” inaonyesha example yenye muundo maarufu{Jina}. Mchoro huo umepanuliwa kwa jina la kipekee la kipengele hadi fameNative. Katika msimbo wa indexed kuna maeneo 76 ambapo preprocessor mara kwa mara fameNative hutumiwa.
Maeneo haya yanaonyeshwa kwenye Mahusiano View. Mifumo inaweza kubainishwa katika mapendeleo (tazama Sehemu ya 3.3, "Mapendeleo").
Kielelezo 7. Uwakilishi wa Kichakataji cha C/C++ Mara kwa Mara katika Mahusiano View

3.3. Mapendeleo
Ili kubadilisha tabia chaguo-msingi ya kiashiria fungua mapendeleo ya Eclipse na uchague ukurasa wa Kielezo cha Uhusiano katika kitengo cha Usimamizi wa Lahaja. Ukurasa unaonyesha orodha mbili.
Kielelezo 8. Ukurasa wa Mapendeleo wa Kielezo cha UhusianoOrodha ya juu ina chaguo-msingi file mifumo ya kiashiria (1). Orodha hii ni mpangilio wa awali wa muundo wa miradi mipya iliyowezeshwa.
Orodha ya chini ina upangaji kati ya vipengele na viambishi awali vya kuchakata (2). Ramani hii inatumika kwa miradi yote. Jedwali la 1, "Ubadilishaji Ramani Unaotumika" linaonyesha uingizwaji wote unaowezekana.
Jedwali 1. Ubadilishaji Ramani Unaoungwa mkono

Wildcard	Maelezo	Example: KipengeleA
Jina	Jina la Kipekee la kipengele kilichochaguliwa	FLAG_{Jina} - FLAG_FeatureA
NAME	herufi kubwa Jina la Kipekee la kipengele kilichochaguliwa	FLAG_{NAME} - FLAG_FEATUREA
jina	herufi ndogo Jina la Kipekee la kipengele kilichochaguliwa	bendera_{jina} - bendera_featurea

Nyaraka / Rasilimali

Kiunganishi cha mifumo safi ya 2024 cha Programu ya Kusimamia Msimbo wa Chanzo [pdf] Mwongozo wa Mtumiaji 2024, 2024 Kiunganishi cha Programu ya Kudhibiti Msimbo wa Chanzo, Kiunganishi cha Programu ya Kudhibiti Msimbo wa Chanzo, Programu ya Kudhibiti Msimbo wa Chanzo, Programu ya Usimamizi, Programu

Marejeleo

• Mwongozo wa Mtumiaji