íon::athraithigh – Ceanglóir le haghaidh
Lámhleabhar Bainistíochta Cód Foinse
Teicneolaíocht Paraiméadrach GmbH
Leagan 6.0.7.685 le haghaidh íon:: leaganacha 6.0
Cóipcheart © 2003-2024 Parametric Technology GmbH
2024

Réamhrá

íon ::varants Cuireann nascóirí do Bhainistíocht an Chóid Fhoinsigh (Ceanglóir) ar chumas na bhforbróirí inathraitheacht an chóid foinse a bhainistiú ag baint úsáide as leaganacha íon::. Soláthraíonn Bainistíocht an Chóid Fhoinsigh de ghlan::athraithigh deis sholúbtha chun struchtúir eolaire agus an cód foinse a shioncronú files go héasca le samhlacha íon::athraithigh. Mar sin is féidir an bhainistíocht malairtí a chur i bhfeidhm fiú ar thionscadail chasta bogearraí. Ina theannta sin naisc idir íon::d'fhéadfadh gnéithe athraitheacha agus cód foinse a bheith níos éasca leis an tógálaí a bhainistiú agus tá siad an-inrochtana trí Bhainistíocht an Chóid Fhoinsigh.
1.1. Riachtanais Bogearraí
Is síneadh é an nascóirí íon::leaganacha do Bhainistíocht an Chóid Fhoinsigh le haghaidh leaganacha íon:: agus tá sé ar fáil ar gach ardán tacaithe.
1.2. Suiteáil
Féach ar an gcuid íon::athraithigh Nascóirí sa íon::leathruithe Treoir Socraithe chun faisnéis mhionsonraithe a fháil ar conas an cónascaire a shuiteáil (Cabhair roghchlár -> Clár na gCabhrach agus ansin íon::leathruithe Treoir Socraithe -> íon::athraithigh Nascóirí).
1.3. Maidir leis an lámhleabhar seo
Táthar ag súil go mbeidh eolas bunúsach ag an léitheoir agus eispéiris bhunúsacha le::leaganacha íona. Féach ar a ábhar tosaigh le do thoil roimh an lámhleabhar seo a léamh. Tá an lámhleabhar ar fáil i gcabhair ar líne agus i bhformáid PDF inphriontáilte anseo.

Ag baint úsáide as nascóirí

2.1. Ag tosú íon::leaganacha
Ag brath ar an modh suiteála a úsáidtear, cuir tús leis an Eclipse íon::athraitheach atá cumasaithe nó faoi Windows roghnaigh an mhír íon::athraitheach ó roghchlár an chláir.
Mura bhfuil an pheirspictíocht Bainistíochta Athróg i ngníomh cheana féin, déan é sin trí é a roghnú ó Open Perspective->Other… sa roghchlár Fuinneog.
2.2. Iompórtáil Crann Eolaire isteach i Múnla Teaghlaigh
Sula n-iompórtáiltear crann eolaire isteach i Múnla Teaghlaigh, ní mór tionscadal leagan a chruthú. Tá sé le tuiscint freisin go bhfuil gnéithe sainithe i Samhail Gné cheana féin. Féach le do thoil ar an doiciméadú íon::athraitheach chun cabhair a fháil faoi na céimeanna seo.
Cuirtear tús leis an iompórtáil iarbhír tríd an ngníomh Iompórtáil… a roghnú i roghchlár comhthéacs na dTionscadal view nó le Import… roghchlár sa File roghchlár. Roghnaigh Múnlaí Athróg nó Tionscadail ón gcatagóir Bainistiú Athróg agus brúigh Ar Aghaidh. Ar an leathanach seo a leanas roghnaigh Iompórtáil Múnla Teaghlaigh ó fhillteáin foinse agus brúigh Ar Aghaidh arís.
Roghnaigh cineál cód foinse le hiompórtáil
Tá an draoi iompórtála le feiceáil (féach Fíor 1, “Leathanach den draoi iompórtála chun an cineál cód foinse is féidir a allmhairiú a roghnú”). Roghnaigh cineál tionscadail le hiompórtáil agus brúigh Ar Aghaidh. Tá sraith réamhshainithe de gach cineál file cineálacha a allmhairiú chuig an múnla.
Fíor 1. Leathanach den draoi allmhairithe chun an cineál cód foinse a fhéadfar a allmhairiú a roghnúRoghnaigh Foinse agus Sprioc
Ar an gcéad leathanach draoi eile (Fíor 2, “Leathanach den draoi iompórtála chun foinse agus sprioc an iompórtála a roghnú”) ní mór an t-eolaire foinse agus an tsamhail sprice a shonrú.
Brúigh an cnaipe Brabhsáil… chun an t-eolaire ina bhfuil an cód foinse ar cheart a iompórtáil a roghnú. De réir réamhshocraithe, roghnaítear an spás oibre reatha toisc go bhféadfadh sé seo a bheith ina phointe úsáideach le tosú ar an nascleanúint.
Anseo thíos is féidir leat patrún a áireamh agus a eisiamh. Caithfidh na patrúin seo a bheith ina nathanna rialta java. Seiceáiltear gach cosán ionchuir, i gcoibhneas leis an bhfréamhfhillteán foinse, leis na patrúin seo. Má mheaitseálann an patrún san áireamh, iompórtáiltear fillteán, mura n-oireann an patrún eisiata. Is é atá i gceist leis an bpátrún cuimsithe ná na fillteáin atá le hiompórtáil roimh ré, cuireann an patrún eisiata srian leis an réamhroghnú seo.
Tar éis an t-eolaire cód foinse a roghnú ní mór spriocshamhail a shainiú. Mar sin roghnaigh tionscadal athraitheach nó fillteán inar cheart an tsamhail a stóráil agus cuir isteach ainm samhail. Tá an file leathnaítear an t-ainm go huathoibríoch leis an síneadh .ccfm mura dtugtar é sa dialóg seo. De réir réamhshocraithe socrófar é faoin ainm céanna leis an ainm múnla féin. Seo an socrú molta.
Tar éis fillteán foinse fóirsteanach agus an t-ainm múnla atá ag teastáil a shonrú, féadfar an dialóg a chríochnú trí Críochnaigh a bhrú. Má tá an cnaipe Ar Aghaidh brúite, tá leathanach eile ag teacht aníos inar féidir socruithe breise a dhéanamh.
Fíor 2. Leathanach den draoi allmhairithe chun an fhoinse agus an sprioc don allmhairiú a roghnúAthraigh Roghanna Iompórtála
Ar an leathanach draoi deiridh (Fíor 3, “Leathanach den draoi allmhairithe chun cumraíocht aonair a shainiú”) tá roghanna ann is féidir a dhéanamh chun an t-iompar allmhairithe a shaincheapadh don tionscadal bogearraí allmhairithe.
Taispeánann an leathanach dialóg tábla ina bhfuil an file sainmhínítear cineálacha, a bhreithneoidh an próiseas allmhairithe.
Tá ceithre réimse i ngach líne.

• Tá téacs gearr tuairisciúil sa réimse Cur Síos chun an file cineál.
• Tá an File úsáidtear réimse patrún ainm chun a roghnú files a allmhairiú nuair a mheaitseálann siad le luach na réimsí. Úsáideann an réimse an chomhréir seo a leanas:

1. B'fhéidir gurb é an cás úsáide is coitianta a file síneadh. Is é an comhréir gnách .EXT, áit a bhfuil EXT an inmhianaithe file síneadh (m.sh. .java).
2. Is cás comónta eile cás speisialta file, cosúil le déanamhfile. Dá bhrí sin, is féidir a mheaitseáil ar an cruinn file ainm. Chun seo a dhéanamh, ach dul isteach ar an file ainm isteach sa réimse (m.sh. build.xml).
3. I gcásanna áirithe bíonn na mianta mapála níos sainiúla, mar sin amháin fileba chóir s a thagann le patrún speisialta a allmhairiú. Chun an riachtanas seo a fheistiú is féidir nathanna cainte rialta a úsáid sa File réimse patrún ainm.
   Bheadh ​​cur síos ar chomhréir na nathanna cainte rialta níos mó ná rún na cabhrach seo. Breathnaigh le do thoil ar an rannán ar nathanna rialta sa chaibidil thagartha sa treoir úsáideora ghlan::athraithigh (eg .*).

• Socraíonn an réimse cineál eilimint Mhapáilte an mhapáil idir a file cineál agus íon::athróga cineál eilimint teaghlaigh. Is é an cineál eilimint teaghlaigh ná tuairisceoir don fhoinse file tuilleadh faisnéise a sholáthar don eilimint léarscáilithe sa tsamhail allmhairithe. Is iad na roghanna tipiciúla ná ps:class nó ps:déanfile.
• An Mapáil file Leagann cineál réimse an mhapáil idir a file cineál agus leagan íon:: file cineál. Tá an file clóscríobh i bhfoirm íon:: is tuairisceoir don fhoinse é leaganacha file tuilleadh faisnéise a sholáthar don eilimint léarscáilithe sa tsamhail allmhairithe. Tá roghanna tipiciúla impl le haghaidh cur chun feidhme nó def le haghaidh sainmhínithe files.

Fíor 3. Leathanach den draoi allmhairithe chun cumraíocht aonair a shainiúNua file is féidir cineálacha a chur leis tríd an gcnaipe Cuir Mapáil leis a úsáid. Líontar gach réimse leis an luach neamhshainithe agus ní mór don úsáideoir iad a líonadh isteach. Chun luach i réimse a chur in eagar, níl le déanamh ach cliceáil isteach sa réimse leis an luch. Éiríonn an luach in eagar agus is féidir é a athrú. Ní féidir an réamhshocrú a athrú file patrúin ainmneacha an tábla. Chun saincheaptha a dhéanamh solúbtha, is féidir a file clóscríobh tríd an tsraith a dhíroghnú. Díroghnaithe file fanann patrúin ainmneacha sa chumraíocht ach ní úsáidfidh an t-allmhaireoir iad. Úsáideoir sainithe file is féidir cineálacha a bhaint arís tríd an gcnaipe Bain Mapáil a úsáid.
De réir réamhshocraithe, Eile files file Tá patrún ainm ar fáil sa tábla ach díroghnaithe é. De ghnáth níl sé ag iarraidh a allmhairiú go léir files ach is féidir é seo a athrú go héasca ach an dá réir a roghnú.
Tá trí rogha allmhairithe ghinearálta ann chun iompar an allmhaireora a shaincheapadh.

• Ná iompórtáil eolaire gan meaitseáil files (m.sh. eolairí CVS).
  Má fhaigheann an t-allmhaireoir eolaire nuair nach bhfuil aon mheaitseáil file atá ann agus nuair nach bhfuil aon fhochomhadlann ag meaitseáil file, ní iompórtálfar an t-eolaire. Is minic a bhíonn sé seo úsáideach, má tá tionscadail á mbainistiú ag córais bhainistíochta leaganacha mar CVS. Maidir le CVS, tá eolaire CVS i ngach eolaire nuair nach mbaineann sé le hábhar files a stóráil. Má roghnaítear an rogha seo agus an CVS-files nach bhfuil ag teacht le haon file den chineál a shainítear thuas, ní iompórtálfar an t-eolaire mar chomhpháirt isteach sa tSamhail Teaghlaigh.
• Sórtáil files agus eolairí.
  Cumasaigh an rogha seo a shórtáil files agus eolairí gach ceann in ord aibítre.
• Iompórtáil láimhseáil cosáin.
  Le haghaidh tuilleadh sioncronaithe ní mór don allmhaireoir cosán bunaidh na n-eilimintí allmhairithe go léir a stóráil sa mhúnla.
  I go leor cásanna roinntear Múnlaí Teaghlaigh le húsáideoirí eile. Féadfaidh an struchtúr eolaire a bheith difriúil do gach úsáideoir. Chun tacú leis na cásanna úsáide is coitianta is féidir leis an allmhaireoir oibriú ar mhodhanna éagsúla:

Absalóideach	Déanfar an cosán iomlán chuig an eilimint allmhairithe a stóráil sa mhúnla. Le haghaidh sioncrónaithe níos déanaí agus le linn an chlaochlaithe beidh an files a chur ar an suíomh díreach céanna agus a bhí le linn an chéad allmhairiú.
Maidir le Spás Oibre	Stóráiltear na cosáin i gcoibhneas leis an bhfillteán spás oibre. Le haghaidh sioncrónaithe an files a bheith mar chuid de spás oibre Eclipse. Caithfidh an claochlú spás oibre Eclipse a úsáid mar eolaire ionchuir.
Maidir le Tionscadal	Stóráiltear na cosáin i gcoibhneas leis an tionscadal. Le haghaidh sioncrónaithe an files mar chuid den tionscadal taobh istigh de Eclipse. Caithfidh an claochlú fillteán an tionscadail a úsáid mar eolaire ionchuir.
I gcoibhneas le Conair	Stóráiltear na cosáin i gcoibhneas leis an gcosán tugtha. Le haghaidh sioncrónaithe an files a chur ar an suíomh díreach céanna. Tá an t-eolaire ionchuir claochlaithe mar an gcéanna leis an gcosán coibhneasta le linn an allmhairithe.

Stóráiltear gach rogha den dialóg seo go leanúnach. Ní ceadmhach na saincheaptha pearsanta a athdhéanamh gach uair a ritheann an t-iompórtáil. Déanann sé seo an sreabhadh oibre allmhairithe éasca agus tapa.
2.3. Samhlacha ó Chrann Eolaire a Nuashonrú
Brúigh an cnaipe Sioncrónaigh chun samhail iompórtáilte a shioncronú lena cosán eolaire. Stóráiltear bunchosán an tionscadail sa mhúnla ionas go ndéanfar é a shioncronú chuig an eolaire céanna agus a rinneadh roimhe seo. Chun an cnaipe Sioncrónaigh a chumasú, oscail an tsamhail agus roghnaigh aon eilimint. Tar éis an cnaipe Sioncrónaigh a bhrú, osclaítear Eagarthóir Déan Comparáid áit a gcuirtear i gcoinne an tSamhail Teaghlaigh reatha agus múnla an struchtúir eolaire reatha (féach Fíor 4, “Nuashonrú múnla ón gCrann Eolaire in Eagarthóir Déan Comparáid”).
Fíor 4. Nuashonrú múnla ón gCrann Eolaire in Déan comparáid idir Eagarthóir   Úsáidtear an t-eagarthóir comparáide ar fud íon::athraithigh chun leaganacha samhla a chur i gcomparáid ach sa chás seo úsáidtear é chun struchtúr an eolaire fisiceach (léirithe ar an taobh íochtair ar dheis) a chur i gcomparáid leis an múnla íon::athraitheach reatha (an taobh clé íochtair). Tá na hathruithe go léir liostaithe mar mhíreanna ar leith sa chuid uachtarach den eagarthóir, arna n-ordú de réir na n-eilimintí lena mbaineann.
Nuair a roghnaítear mír ar an liosta seo, leagtar béim ar an athrú faoi seach sa dá mhúnla. Sa seanample, tá eilimint bhreise marcáilte le bosca ar thaobh na láimhe deise agus ceangailte lena suíomh indéanta sa mhúnla ar thaobh na láimhe clé. Soláthraíonn an barra uirlisí Merge idir fuinneoga eagarthóirí uachtaracha agus íochtair uirlisí chun athruithe aonair nó fiú na hathruithe uile (neamhchoimhlinte) a chóipeáil ina n-iomláine ón múnla crann eolaire go dtí an Samhail Gné.
Nóta
Déantar an sioncrónú leis na socruithe allmhaireora is déanaí a úsáideadh. Mar sin is féidir an tsamhail a nuashonrú le socruithe eile mar a rinneadh agus an t-iompórtáil déanta.

Ag Úsáid Innéacsóir Gaol

Cuireann an Cónascaire do Bhainistíocht an Chóid Fhoinsigh feabhas ar an gCaidreamh View le faisnéis faoi naisc idir eilimintí samhla íon::athróga agus cód foinse. Cuirtear caidrimh leis le haghaidh gnéithe a úsáidtear i gcoinníollacha na n-eilimintí ps:condxml agus ps: comhthéacs.
Le haghaidh ps: bratach agus ps: bratachfile gnéithe suíomh tairisigh réamhphróiseálaí san fhoinse C/C++ files léirithe. Ina theannta sin taispeántar láithreacha na dtairiseacha réamhphróiseálaí meaitseála le haghaidh gné roghnaithe trí úsáid a bhaint as an léarscáiliú idir ainmneacha gné-uathúla agus tairisigh réamhphróiseálaithe.
3.1. An tInnéacsóir Caidrimh a Chur le Tionscadal
Is féidir an t-innéacsóir caidrimh a ghníomhachtú ar leathanach maoine tionscadail speisialta. Roghnaigh an tionscadal agus roghnaigh an mhír Airíonna sa roghchlár comhthéacs. Sa dialóg atá le teacht roghnaigh an Innéacsóir Gaol leathanach.
Fíor 5. Leathanach Maoine an Tionscadail don Innéacsóir Caidrimh

Cuirtear an t-innéacsóir caidrimh i ngníomh don tionscadal tríd an rogha Innéacsóir Caidrimh a Chumasú (1) a roghnú. Tar éis an t-innéacsóir a chumasú tá roinnt roghanna eile ann chun iompar sonrach an tionscadail a shainiú. Is féidir innéacsú: íon: Coinníollacha agus Tairisigh Réamhphróiseálaí C/C++ a chur i ngníomh ar leithligh (2). An liosta le file úsáidtear patrúin ainm (3) chun an files le haghaidh innéacsú. Amháin files a thagann le ceann de na patrúin a scanadh. Cuir an “*” leis mar phatrún chun gach ceann a scanadh files de thionscadal.
Tar éis an t-innéacsóir a ghníomhachtú do thionscadal cuirtear tógálaí leis an tionscadal. Athraíodh an scanáil tógálaí seo files le haghaidh caidreamh nua le::athróga samhlacha íon go huathoibríoch.
3.2. An Caidreamh leis an gCód Foinse
Le innéacsóir caidreamh gníomhachtaithe an Chaidreamh View tá iontrálacha breise ann. Léiríonn na hiontrálacha seo ainm an file agus uimhir líne an phointe athraitheach. Taispeánann an leid uirlisí an chuid chuí den file. Trí chliceáil faoi dhó ar an iontráil an file osclófar ina eagarthóir é.
íon::varants Coinníollacha
Is féidir an coinníoll íon::athraitheach a úsáid chun codanna d'a file ag brath ar rogha gné. Déanann an tInnéacsóir Coinníollacha scanadh ar na rialacha sin agus sliocht na gnéithe tagartha. Má roghnaítear gné den sórt sin san eagarthóir an Caidreamh View taispeánfaidh go léir files agus línte ina bhfuil coinníoll leis an ngné roghnaithe suite (féach Fíor 6, “Léiriú ar Choinníoll sa Chaidreamh View”).
Fíor 6. Léiriú ar Choinníoll sa Chaidreamh ViewChun míniú mionsonraithe a fháil ar conas coinníollacha a shainiú, féach ar an rannán ps:condtext de chaibidil 9.5.7 den íon::athraithigh Treoir Úsáideora (Tagairt –> Cineálacha Eilimint Foinse Réamhshainithe–>ps:condtext).
C/C++ Tairisigh Réamhphróiseálaí
Déanann an tInnéacsóir Réamhphróiseálaí C/C++ scanadh files le haghaidh tairisigh a úsáidtear i rialacha réamhphróiseálaithe (eg #ifdef, #ifndef, …).
Más ps:bratach nó ps:bratach éfile Roghnaítear eilimint an Chaidreamh View léiríonn sé úsáid an tairiseach réamhphróiseálaí sainithe.
An Caidreamh View taispeánann sé freisin tairisigh réamhphróiseálaí ceangailte le gnéithe trí úsáid a bhaint as patrúin mapála. Chun seo déantar na patrúin a leathnú le sonraí an ghné roghnaithe. Úsáidtear na siombailí dá bharr chun tairisigh réamhphróiseálaí meaitseála a chuardach. Fíor 7, “Léiriú ar Tairiseach Réamhphróiseálaí C/C++ sa Chaidreamh View” léiríonn seanample clú agus cáil an phatrúin {Name}. Leathnaítear an patrún le hainm uathúil an ghné go FameNative. Sa chód innéacsaithe tá 76 ionad ina n-úsáidtear clú tairiseach an réamhphróiseálaí.
Taispeántar na suíomhanna seo sa Chaidreamh View. Is féidir na patrúin a shainiú sna roghanna (féach Roinn 3.3, “Na Roghanna”).
Fíor 7. Léiriú ar Tairiseach Réamhphróiseálaí C/C++ sa Chaidreamh View

3.3. Na Roghanna
Chun iompraíocht réamhshocraithe an innéacsora a athrú oscail na sainroghanna Eclipse agus roghnaigh an leathanach Innéacsóir Gaolta sa chatagóir Bainistiú Athróg. Taispeánann an leathanach dhá liosta.
Fíor 8. Leathanach Rogha Innéacstóra GaolTá an réamhshocrú sa liosta uachtarach file patrúin don innéacsóir (1). Is é an liosta seo an socrú patrún tosaigh do thionscadail nua-chumasaithe.
Sa liosta íochtair tá an mhapáil idir gnéithe agus tairisigh réamhphróiseálaí (2). Úsáidtear an léarscáiliú seo do gach tionscadal. Léiríonn Tábla 1, “Athchur Mapála Tacaithe” gach athsholáthar féideartha.
Tábla 1. Athsholáthairtí Mapála Tacaithe

saoróg	Cur síos	Example: GnéA
Ainm	an Ainm Uathúil ar an ngné roghnaithe	FLAG_{Ainm} – FLAG_FeatureA
AINM	sa chás uachtair Ainm Uathúil na gné roghnaithe	FLAG_{NAME} – FLAG_FEATUREA
ainm	sa chás íochtair Ainm Uathúil na gné roghnaithe	bratach_{ainm} – flag_featurea

Doiciméid / Acmhainní

Cónascaire íonchórais 2024 le haghaidh Bogearraí Bainistíochta Cóid Foinse [pdfLámhleabhar Úsáideora 2024, 2024 Nascóir le haghaidh Bogearraí Bainistíochta Cóid Foinse, Nascóir le haghaidh Bogearraí Bainistíochta Cóid Foinse, Bogearraí Bainistíochta Cóid Foinse, Bogearraí Bainistíochta, Bogearraí

Tagairtí

• Lámhleabhar Úsáideora