пок :: вариантҳои - Пайвасткунак барои
Дастури идоракунии коди манбаъ
Parametric Technology GmbH
Версияи 6.0.7.685 барои пок :: вариантҳои 6.0
Copyright © 2003-2024 Parametric Technology GmbH
2024

Муқаддима

pure ::variants Пайвасткунак барои идоракунии коди манбаъ (Пайвасткунак) ба таҳиягарон имкон медиҳад, ки тағирёбии коди сарчашмаро бо истифода аз ::variants идора кунанд. Идоракунии коди манбаъҳои пок ::variants имкони чандирро барои ҳамоҳангсозии сохторҳои директория ва коди манбаъ фароҳам меорад fileбо моделҳои пок ::variants ба осонӣ. Ҳамин тариқ, идоракунии вариантҳо метавонад ҳатто дар лоиҳаҳои мураккаби нармафзор татбиқ карда шавад. Ғайр аз он, пайвастшавӣ байни хусусиятҳои pure::variants ва рамзи сарчашма метавонанд бо созанда осонтар идора карда шаванд ва тавассути Идоракунии коди манбаъ хеле дастрасанд.
1.1. Талаботи нармафзор
Пайвасткунаки пок ::variants барои идоракунии коди манбаъ васеъшавӣ барои пок::variants аст ва дар ҳама платформаҳои дастгирӣ дастрас аст.
1.2. Насбкунӣ
Лутфан, бо қисмати Пайвасткунакҳо дар пок::variants Дастури насбкунӣ барои маълумоти муфассал дар бораи чӣ гуна насб кардани пайвасткунак (менюи Кӯмак -> Мундариҷаи Кӯмак ва сипас Дастури насби пок::variants -> Пайвасткунакҳои пок::variants) муроҷиат кунед.
1.3. Дар бораи ин дастур
Интизор меравад, ки хонанда дониши асосӣ дар бораи :: вариантҳои тоза дошта бошад. Лутфан пеш аз хондани ин дастур бо маводи муқаддимавии он машварат кунед. Дастур дар кӯмаки онлайн ва инчунин дар формати чопии PDF дар ин ҷо дастрас аст.

Истифодаи Connector

2.1. Оғози пок::variants
Вобаста аз усули насбкунии истифодашуда ё Eclipse-и пок::variants-ро оғоз кунед ё дар зери Windows аз менюи барнома ҷузъи пок::variants -ро интихоб кунед.
Агар дурнамои Идоракунии Вариантҳо аллакай фаъол нашуда бошад, ин корро бо интихоби он аз Кушодани Перспектива-> Дигар… дар менюи Тиреза иҷро кунед.
2.2. Дарахти директорияро ба модели оилавӣ ворид кунед
Пеш аз ворид кардани дарахти директория ба модели оилавӣ, лоиҳаи вариантҳо бояд эҷод карда шавад. Инчунин тавсия дода мешавад, ки хусусиятҳо дар Модели Хусусият аллакай муайян карда шаванд. Лутфан барои кӯмак дар бораи ин қадамҳо ба ҳуҷҷатҳои pure::variants муроҷиат кунед.
Воридоти воқеӣ бо интихоби амали Воридот… ё дар менюи контекстии Лоиҳаҳо оғоз мешавад view ё бо менюи Воридот… дар File меню. Моделҳои Вариантҳо ё Лоиҳаҳоро аз категорияи Идоракунии Вариантҳо интихоб кунед ва Next-ро пахш кунед. Дар саҳифаи зерин Импорти Модели оиларо аз ҷузвдонҳои сарчашма интихоб кунед ва боз Ояндаро пахш кунед.
Барои воридот навъи рамзи сарчашмаро интихоб кунед
Устоди воридот пайдо мешавад (ниг. ба расми 1, "Саҳифаи устоди воридот барои интихоби навъи рамзи сарчашма, ки мумкин аст ворид карда шавад"). Навъи лоиҳаро барои воридот интихоб кунед ва Next-ро пахш кунед. Ҳар як намуд маҷмӯи пешакӣ муайяншударо дар бар мегирад file намудҳо барои воридот ба модел.
Расми 1. Саҳифаи устоди воридот барои интихоби навъи коди манбаъ, ки мумкин аст ворид карда шавадСарчашма ва Ҳадафро интихоб кунед
Дар саҳифаи навбатии устод (Расми 2, "Саҳифаи устоди воридот барои интихоби манбаъ ва ҳадафи воридот") директорияи манбаъ ва модели мақсаднок бояд муайян карда шавад.
Барои интихоб кардани директорияе, ки дар он рамзи манбаъ мавҷуд аст, ки бояд ворид карда шавад, тугмаи Бознигариро пахш кунед. Бо нобаёнӣ фазои кории ҷорӣ интихоб карда мешавад, зеро ин метавонад нуқтаи муфид барои оғози паймоиш бошад.
Дар зер шумо метавонед намунаи дохил ва истисноро муайян кунед. Ин намунаҳо бояд ифодаҳои муқаррарии java бошанд. Ҳар як роҳи вуруд, ки нисбат ба ҷузвдони решаи манбаъ, бо ин намуна тафтиш карда мешавад. Агар намунаи дохилшуда мувофиқат кунад, ҷузвдон ворид карда мешавад, агар намунаи истисно мувофиқат накунад. Ин маънои онро дорад, ки намунаи дохилкунӣ ҷузвдонҳоро барои воридот пешакӣ интихоб мекунад, намунаи истисно ин интихоби пешакиро маҳдуд мекунад.
Пас аз интихоби каталоги рамзи сарчашма модели мақсаднок бояд муайян карда шавад. Аз ин рӯ, лоиҳаи вариант ё ҷузвдонеро, ки модел бояд нигоҳ дошта шавад, интихоб кунед ва номи моделро ворид кунед. Дар file ном ба таври худкор бо васеъшавии .ccfm васеъ карда мешавад, агар он дар ин муколама дода нашавад. Бо нобаёнӣ он ба ҳамон ном бо номи худи модел муқаррар карда мешавад. Ин танзимоти тавсияшуда аст.
Пас аз муайян кардани ҷузвдони манбаи мувофиқ ва номи модели дилхоҳ, муколама метавонад бо пахш кардани тугмаи Анҷом анҷом дода шавад. Агар тугмаи Оянда пахш карда шавад, саҳифаи дигар пайдо мешавад, ки дар он танзимоти иловагӣ имконпазир аст.
Расми 2. Саҳифаи устоди воридот барои интихоби манбаъ ва ҳадаф барои воридотТағир додани афзалиятҳои воридот
Дар саҳифаи охирини устод (Расми 3, "Саҳифаи устоди воридот барои муайян кардани конфигуратсияи инфиродӣ”) афзалиятҳое мавҷуданд, ки метавонанд барои танзими рафтори воридот барои лоиҳаи нармафзори воридшуда анҷом дода шаванд.
Саҳифаи муколама ҷадвалеро нишон медиҳад, ки дар он file намудҳо муайян карда мешаванд, ки дар раванди воридот ба назар гирифта мешаванд.
Ҳар як сатр аз чор майдон иборат аст.

• Майдони Тавсиф матни мухтасари тавсифӣ барои муайян кардани он дорад file навъи.
• Дар File майдони намуна барои интихоб истифода мешавад fileвақте ки онҳо ба арзиши майдонҳо мувофиқат мекунанд, ворид карда шаванд. Майдон синтаксиси зеринро истифода мебарад:

1. Истифодаи маъмултарин метавонад а бошад file тамдид. Синтаксиси муқаррарӣ .EXT аст, ки дар он EXT дилхоҳ аст file васеъшавӣ (масалан .java).
2. Вазъияти дигари маъмул як махсус аст file, ба монанди сохтfile. Аз ин рӯ, мумкин аст, ки мувофиқи дақиқ file ном. Барои ин, танҳо ворид кунед file номро ба майдон ворид кунед (масалан build.xml).
3. Дар баъзе мавридҳо хоҳишҳои харитасозӣ мушаххастаранд, бинобар ин танҳо fileс, ки ба намунаи махсус мувофиқат мекунанд, бояд ворид карда шаванд. Барои ба ин талабот мувофиқат кардан мумкин аст, ки ибораҳои муқаррариро дар File майдони намунаи ном.
   Тавсифи синтаксиси ибораҳои муқаррарӣ аз нияти ин кӯмак зиёдтар хоҳад буд. Лутфан ба бахши ибораҳои муқаррарии боби истинод дар дастури истифодабарандаи пок::variants муроҷиат кунед (масалан .*).

• Майдони навъи унсури хариташуда харитасозии байни a file навъи ва як навъи унсури оилаи пок ::variants. Навъи унсури оила тавсифкунандаи манбаъ мебошад file барои додани маълумоти иловагӣ ба унсури хариташуда дар модели воридшуда. Интихоби маъмулӣ ps:class ё ps:make мебошандfile.
• Хариташуда file майдони type харитасозии байни a file навъи ва як :: вариантҳои пок file навъи. Дар file дар пок ::variants нависед тавсифкунандаи манбаъ аст file барои додани маълумоти иловагӣ ба унсури хариташуда дар модели воридшуда. Интихобҳои маъмулӣ барои татбиқ ё муайян барои таъриф ишора мекунанд files.

Расми 3. Саҳифаи устоди воридот барои муайян кардани конфигуратсияи инфиродӣНав file намудҳоро бо истифода аз тугмаи Иловаи Харитасозӣ илова кардан мумкин аст. Ҳама майдонҳо бо арзиши номуайян пур карда мешаванд ва бояд аз ҷониби корбар пур карда шаванд. Барои таҳрир кардани арзиш дар майдон, танҳо бо муш ба майдон клик кунед. Қимат таҳриршаванда мешавад ва метавонад тағир дода шавад. Тағйир додани пешфарз имконнопазир аст file намунаҳои ҷадвалро номбар кунед. Барои тағйир додани мутобиқсозӣ, интихобро бекор кардан мумкин аст file бо интихоби сатр нависед. Интихобшуда file намунаҳои ном дар конфигуратсия боқӣ мемонанд, аммо аз ҷониби воридкунанда истифода намешаванд. Истифодабаранда муайян карда шудааст file намудҳоро бо истифода аз тугмаи Хориҷсозии Харитасозӣ дубора нест кардан мумкин аст.
Бо нобаёнӣ дигар files file Намунаи ном дар ҷадвал мавҷуд аст, аммо интихоб нашудааст. Одатан он намехоҳад, ки ҳамаро ворид кунад files, аммо онро бо интихоби сатри мувофиқ ба осонӣ тағир додан мумкин аст.
Се варианти умумии воридот барои танзими рафтори воридкунанда вуҷуд дорад.

• Феҳристҳоро бидуни мувофиқат ворид накунед files (масалан, директорияҳои CVS).
  Агар воридкунанда феҳристеро пайдо кунад, ки дар он мувофиқат намекунад file дар он аст ва дар он ҷо ягон зеркаталог мувофиқ надорад file, директория ворид карда намешавад. Ин аксар вақт муфид аст, агар лоиҳаҳо аз ҷониби системаҳои идоракунии версияҳо ба монанди CVS идора карда шаванд. Барои CVS, ҳар як феҳристи мувофиқ дорои як директорияи CVS мебошад, ки дар он ҷо номувофиқ аст fileс захира карда мешаванд. Агар ин хосият интихоб шуда бошад ва CVS-fileба ҳеҷ кадоме мувофиқат намекунад file навъи дар боло муайяншуда, директория ҳамчун ҷузъ ба Модели Оила ворид карда намешавад.
• Тартиб додан files ва директорияҳо.
  Барои мураттабкунӣ ин хосиятро фаъол созед files ва директорияҳо ҳар як аз рӯи тартиби алифбо.
• Муомилоти роҳи воридотӣ.
  Барои ҳамоҳангсозии минбаъда воридкунанда бояд роҳи аслии ҳамаи унсурҳои воридшударо дар модел нигоҳ дорад.
  Дар бисёр ҳолатҳо Моделҳои оилавӣ бо корбарони дигар мубодила мешаванд. Сохтори директория барои ҳар як корбар метавонад гуногун бошад. Барои дастгирии сенарияҳои маъмултарини истифода воридкунанда метавонад дар шеваҳои гуногун кор кунад:

Мутлақ	Роҳи мутлақ ба унсури воридшуда дар модел нигоҳ дошта мешавад. Барои синхронизатсияи баъдӣ ва ҳангоми табдилдиҳӣ fileҳо бояд дар ҳамон маконе ҷойгир карда шаванд, ки ҳангоми воридоти аввал.
Нисбат ба фазои корӣ	Роҳҳо нисбат ба ҷузвдони фазои корӣ нигоҳ дошта мешаванд. Барои ҳамоҳангсозӣ files бояд як қисми фазои кории Eclipse бошад. Трансформатсия бояд фазои кории Eclipse-ро ҳамчун директорияи вуруд истифода барад.
Нисбат ба лоиҳа	Роҳҳо нисбат ба лоиҳа нигоҳ дошта мешаванд. Барои ҳамоҳангсозӣ files қисми лоиҳа дар дохили Eclipse мебошанд. Трансформатсия бояд папкаи лоиҳаро ҳамчун директорияи вуруд истифода барад.
Нисбат ба роҳ	Роҳҳо нисбат ба роҳи додашуда нигоҳ дошта мешаванд. Барои ҳамоҳангсозӣ fileҳо бояд дар ҳамон ҷой ҷойгир карда шаванд. Феҳристи вуруди табдилдиҳӣ бо роҳи нисбӣ ҳангоми воридот якхела аст.

Ҳама афзалиятҳои ин муколама ба таври доимӣ нигоҳ дошта мешаванд. Мутобиқсозии шахсӣ набояд ҳар дафъае, ки воридот иҷро мешавад, такрор карда шавад. Ин ҷараёни кори воридотро осон ва зуд месозад.
2.3. Навсозии моделҳо аз дарахти директория
Тугмаи Синхронизатсияро пахш кунед барои ҳамоҳангсозии модели воридшуда бо роҳи феҳристи он. Роҳи решаи лоиҳа дар модел нигоҳ дошта мешавад, то он бо ҳамон директорияе, ки қаблан буд, ҳамоҳанг карда шавад. Барои фаъол кардани тугмаи Синхронизатсия, моделро кушоед ва ягон элементро интихоб кунед. Пас аз пахш кардани тугмаи Ҳамоҳангсозӣ Муҳаррири муқоиса кушода мешавад, ки дар он модели оилаи ҷорӣ ва модели сохтори директорияи ҷорӣ ба ҳам муқобиланд (ниг. ба расми 4, “Навсозии модел аз дарахти директория дар Муҳаррири муқоиса”).
Тасвири 4. Навсозии модел аз дарахти директория дар муҳаррири муқоиса   Муҳаррири муқоиса дар тамоми версияҳои пок::variants барои муқоисаи версияҳои модел истифода мешавад, аммо дар ин ҳолат барои муқоисаи сохтори феҳристи физикӣ (дар тарафи рости поён нишон дода мешавад) бо модели ҳозираи пок ::variants (тарафи чапи поён) истифода мешавад. Ҳама тағиротҳо ҳамчун ҷузъҳои алоҳида дар қисми болоии муҳаррир, ки аз рӯи унсурҳои зарардида тартиб дода шудаанд, номбар карда мешаванд.
Интихоби ҷузъ дар ин рӯйхат тағироти мувофиқро дар ҳарду модел таъкид мекунад. Дар собикample, як унсури иловашуда бо қуттии дар тарафи рост қайд карда мешавад ва бо мавқеи имконпазири он дар модел дар тарафи чап пайваст карда мешавад. Панели асбобҳои Муттаҳид байни тирезаҳои муҳаррири боло ва поёнӣ асбобҳоро барои нусхабардории як ё ҳатто ҳама тағиротҳои (ғайризиқнок) дар маҷмӯъ аз модели дарахти директория ба Модели Хусусият таъмин мекунад.
Шарҳ
Синхронизатсия бо танзимоти охирини воридкунандаи истифодашуда анҷом дода мешавад. Ин имкон медиҳад, ки модел бо танзимоти дигар, ки ҳангоми воридот анҷом дода шудааст, навсозӣ шавад.

Истифодаи Indexer Relation

Пайвасткунак барои идоракунии коди манбаъ муносибатҳоро беҳтар мекунад View бо маълумот дар бораи пайвастшавӣ байни унсурҳои модели пок ::variants ва рамзи сарчашма. Муносибатҳо барои хусусиятҳое, ки дар шароити унсурҳои ps:condxml ва ps:condtext истифода мешаванд, илова карда мешаванд.
Барои ps:flag ва ps:flagfile унсурҳои ҷойгиршавии константаҳои пешазпросессор дар манбаи C/C++ fileс нишон дода шудаанд. Илова бар ин, маконҳои мувофиқи константаҳои пешазпросессор барои як хусусияти интихобшуда бо истифода аз харитасозӣ байни номҳои беназири хусусият ва константаҳои пешазпросессор нишон дода мешаванд.
3.1. Илова кардани Индекси робита ба лоиҳа
Индексери муносибатро дар саҳифаи махсуси моликияти лоиҳа фаъол кардан мумкин аст. Лоиҳаро интихоб кунед ва дар менюи контекстӣ банди Хусусиятҳоро интихоб кунед. Дар муколамаи дарпешистода саҳифаи Indexer Relation -ро интихоб кунед.
Расми 5. Саҳифаи моликияти лоиҳа барои Индексери муносибат

Индексери муносибатҳо барои лоиҳа тавассути интихоби имконоти Индексери муносибатҳо фаъол карда мешавад (1). Пас аз ба кор андохтани индексатор якчанд имконоти дигар барои муайян кардани рафтори мушаххаси лоиҳа вуҷуд доранд. Индексгузории pure::variants Conditions ва C/C++ константаҳои пешазпросессорро алоҳида фаъол кардан мумкин аст (2). Рӯйхат бо file намунаҳои ном (3) барои интихоби fileс барои индексатсия. Фақат fileс, ки ба яке аз намунаҳо мувофиқат мекунанд, скан карда мешаванд. Барои скан кардани ҳама "*" ҳамчун намуна илова кунед fileяк лоиҳа.
Пас аз фаъол кардани индексатор барои лоиҳа сохтмончӣ ба лоиҳа илова карда мешавад. Ин сканҳои бинокор тағир ёфт files барои муносибатҳои нав ба таври худкор унсурҳои модели пок::variants.
3.2. Муносибатҳо бо Кодекси манбаъ
Бо индексатори муносибатҳои фаъол Муносибатҳо View сабтҳои иловагиро дар бар мегирад. Ин сабтҳо номи file ва рақами сатри нуқтаи вариант. Маслиҳати асбоб қисмати мувофиқи онро нишон медиҳад file. Бо ду маротиба клик кардани вуруд file ба мухаррир кушода мешавад.
пок::variants Шароит
Шарти холис::variants метавонад барои дохил кардан ё хориҷ кардани бахшҳои а истифода шавад file вобаста ба интихоби хусусият. Индексатори вазъият чунин қоидаҳоро скан мекунад ва хусусиятҳои истинодшударо истинод мекунад. Агар чунин хусусият дар муҳаррири Муносибатҳо интихоб карда шавад View ҳамаро нишон медиҳад files ва сатрҳое, ки дар он шарт бо хусусияти интихобшуда ҷойгир аст (ниг. ба расми 6, "Таъсири шарт дар муносибатҳо View”).
Расми 6. Намоиши шарт дар муносибатҳо ViewБарои гирифтани тавзеҳи муфассал дар бораи чӣ гуна муайян кардани шартҳо, ба бахши ps:condtext-и боби 9.5.7-и Дастури истифодабарандаи пок::variants муроҷиат кунед (Истиқод–>Намудҳои Элементи Сарчашма–>ps:condtext).
Константаҳои пешазпросессор C/C++
Indexer Preprocessor C/C++ скан мекунад files барои константаҳое, ки дар қоидаҳои пешазпротсессор истифода мешаванд (масалан, #ifdef, #ifndef, …).
Агар ps: flag ё ps: flagfile унсури Муносибатҳо интихоб карда мешавад View истифодаи константаи пешазпротсессори муайяншударо нишон медиҳад.
Муносибатҳо View инчунин константаҳои пешазпросессорро нишон медиҳад, ки бо истифода аз намунаҳои харитасозӣ ба хусусиятҳо пайваст шудаанд. Барои ин намунаҳо бо маълумоти хусусияти интихобшуда васеъ карда мешаванд. Рамзҳои ҳосилшуда барои ҷустуҷӯи константаҳои мувофиқи пешазпросессор истифода мешаванд. Расми 7, “Таъсири протсессори константи C/C++ дар муносибатҳо View” собиқро нишон медиҳадample бо шӯҳрати намунавӣ{Ном}. Намуна бо номи беназири хусусият ба fameNative васеъ карда шудааст. Дар коди индексатсияшуда 76 макон мавҷуд аст, ки дар он протсессори доимии fameNative истифода мешавад.
Ин ҷойҳо дар Муносибатҳо нишон дода шудаанд View. Намунаҳоро дар афзалиятҳо муайян кардан мумкин аст (ниг. Бахши 3.3, “Бартариятҳо”).
Расми 7. Намоиши константи препроцессори C/C++ дар муносибатҳо View

3.3. Афзалиятҳо
Барои тағир додани рафтори пешфарзии индексатор афзалиятҳои Eclipse-ро кушоед ва саҳифаи Индексери Муносибатро дар категорияи Идоракунии Вариантҳо интихоб кунед. Саҳифа ду рӯйхатро нишон медиҳад.
Расми 8. Саҳифаи Preference Indexer RelationРӯйхати боло дорои пешфарз аст file намунаҳо барои индексатор (1). Ин рӯйхат танзимоти намунавӣ барои лоиҳаҳои нав фаъол аст.
Рӯйхати поёнӣ харитасозии байни хусусиятҳо ва константаҳои пешазпросессорро дар бар мегирад (2). Ин харитасозӣ барои ҳама лоиҳаҳо истифода мешавад. Ҷадвали 1, "Ивазкуниҳои дастгиришавандаи харитасозӣ" ҳама ивазкуниҳои имконпазирро нишон медиҳад.
Љадвали 1. Ивазкунињои харитасозии дастгиришаванда

Аломати ваҳшӣ	Тавсифи	Example: ХусусиятА
Ном	Номи ягонаи хусусияти интихобшуда	FLAG_{Ном} – FLAG_FeatureA
НОМ	ҳарфи калон Номи ягонаи хусусияти интихобшуда	FLAG_{NAME} – FLAG_FEATUREA
ном	ҳарфи хурд Номи ягонаи хусусияти интихобшуда	flag_{name} - flag_featurea

Ҳуҷҷатҳо / Сарчашмаҳо

пок-системаҳои 2024 Пайвасткунак барои Software Идоракунии Кодекси манбаъ [pdf] Дастури корбар 2024, 2024 Пайвасткунак барои нармафзори идоракунии коди манбаъ, пайвасткун барои нармафзори идоракунии коди манбаъ, нармафзори идоракунии коди манбаъ, нармафзори идоракунӣ, нармафзор

Иқтибосҳо

• Дастури корбар