таза::variants – үчүн туташтыргыч
Булак кодун башкаруу боюнча колдонмо
Parametric Technology GmbH
6.0.7.685 версиясы таза::variants 6.0 үчүн
Copyright © 2003-2024 Parametric Technology GmbH
2024

Introduction

pure::variants Булак кодун башкаруу үчүн туташтыргыч (Туташтыргыч) иштеп чыгуучуларга pure::variants аркылуу баштапкы коддун өзгөрмөлүүлүгүн башкарууга мүмкүндүк берет. Pure ::variantsтын Source Code Management каталог структураларын жана баштапкы кодду синхрондоштурууга ийкемдүү мүмкүнчүлүк берет fileтаза ::variants моделдери менен оңой. Ошентип, варианттарды башкаруу татаал программалык долбоорлорго да колдонулушу мүмкүн. Мындан тышкары, таза ::variants функциялары менен баштапкы коддун ортосундагы байланыштар куруучу менен оңой башкарылышы мүмкүн жана Source Code Management аркылуу жеткиликтүү.
1.1. Программалык камсыздоого талаптар
Pure::variants Connector for Source Code Management таза::variants үчүн кеңейтүү болуп саналат жана бардык колдоого алынган платформаларда жеткиликтүү.
1.2. Орнотуу
Туташтыргычты кантип орнотуу керектиги жөнүндө толук маалымат алуу үчүн pure::variants Туташтыргычтар бөлүмүн караңыз (меню Жардам -> Жардам мазмуну жана андан кийин таза::variants Орнотуу колдонмосу -> таза::variants Туташтыргычтар).
1.3. Бул колдонмо жөнүндө
Окурман таза::variants жөнүндө негизги билимге жана тажрыйбага ээ болушу күтүлүүдө. Сураныч, бул колдонмону окуудан мурун анын кириш материалы менен таанышыңыз. Колдонмо онлайн жардамында, ошондой эле басып чыгаруучу PDF форматында бул жерде жеткиликтүү.

Connector колдонуу

2.1. Pure::variants баштап
Колдонулган орнотуу ыкмасына жараша, таза ::variants иштетилген Eclipseти баштаңыз же Windows астында программанын менюсунан таза ::variants пунктун тандаңыз.
Эгерде Variant Management перспективасы иштетилбеген болсо, аны Терезе менюсунан Ачык Перспектива->Башка… тандоосу менен жасаңыз.
2.2. Каталог дарагын үй-бүлөлүк моделге импорттоо
Үй-бүлөлүк моделге каталог дарагын импорттоодон мурун варианттар долбоору түзүлүшү керек. Ошондой эле Функция моделинде аныкталган өзгөчөлүктөргө ээ болуу сунушталат. Сураныч, бул кадамдар боюнча жардам алуу үчүн pure::variants документтерин караңыз.
Иш жүзүндө импорттоо Долбоорлордун контексттик менюсунда Импорт… аракетин тандоо менен башталат view же Импорттоо… менюсунда File меню. Variant Management категориясынан Variant Models же Долбоорлорду тандап, Кийинки баскычын басыңыз. Кийинки бетте булак папкаларынан Үй-бүлө моделин импорттоо тандаңыз жана кайра Кийинки баскычын басыңыз.
Импорттоо үчүн баштапкы коддун түрүн тандаңыз
Импорт чебери пайда болот (1-сүрөттү караңыз, “Импорттолушу мүмкүн болгон баштапкы коддун түрүн тандоо үчүн импорт чеберинин барагы”). Импорттоо үчүн долбоордун түрүн тандап, Кийинки баскычын басыңыз. Ар бир түрү алдын ала белгиленген топтомун камтыйт file моделге импорттоо үчүн түрлөрү.
Сүрөт 1. Импорттолушу мүмкүн болгон баштапкы коддун түрүн тандоо үчүн импорт чеберинин бетиБулакты жана Максатты тандаңыз
Кийинки уста бетинде (2-сүрөт, "Импорттун булагын жана булагын тандоо үчүн импорт чеберинин бети") баштапкы каталог жана максаттуу модель көрсөтүлүшү керек.
Импорттолуучу баштапкы код бар каталогду тандоо үчүн Серептөө… баскычын басыңыз. Демейки боюнча учурдагы иш мейкиндиги тандалган, анткени бул навигацияны баштоо үчүн пайдалуу чекит болушу мүмкүн.
Төмөндө сиз үлгүнү камтуу жана чыгарууну белгилей аласыз. Бул үлгү java регулярдуу туюнтмалар болушу керек. Булак түпкү папкасына салыштырмалуу ар бир киргизүү жолу ушул үлгү менен текшерилет. Киргизилген үлгү дал келсе, папка импорттолот, эгерде чыгарып салуу үлгүсү дал келбесе. Киргизүү үлгүсү импорттоо үчүн папкаларды алдын ала тандайт дегенди билдирет, чыгарып салуу үлгүсү бул алдын ала тандоону чектейт.
Булак коду каталогун тандагандан кийин максаттуу моделди аныктоо керек. Ошондуктан вариант долбоорун же модель сактала турган папканы тандап, моделдин атын киргизиңиз. The file аты бул диалогдо берилбесе, .ccfm кеңейтүүсү менен автоматтык түрдө узартылат. Демейки боюнча, ал моделдин аталышы менен бирдей атка коюлат. Бул сунушталган жөндөө.
Керектүү булак папкасын жана керектүү моделдин аталышын көрсөткөндөн кийин, диалог "Бүтүрүү" баскычын басуу менен бүтүшү мүмкүн. Кийинки баскыч басылса, кошумча жөндөөлөрдү жасоого боло турган башка барак чыгат.
Сүрөт 2. Импорттоо үчүн булакты жана максатты тандоо үчүн импорт чеберинин бетиИмпорттун артыкчылыктарын өзгөртүү
акыркы уста бетинде (3-сүрөт, “Индивидуалдык конфигурацияны аныктоо үчүн импорт чеберинин бети”) импорттолгон программалык камсыздоо долбоору үчүн импорттоо жүрүм-турумун ыңгайлаштыруу үчүн жасала турган артыкчылыктар бар.
Диалог барагында таблица көрсөтүлгөн file түрлөрү аныкталат, алар импорттоо процессинде каралат.
Ар бир сап төрт талаадан турат.

• Description талаасы аныктоо үчүн кыскача сүрөттөмө текстти камтыйт file түрү.
• The File аты үлгү талаа тандоо үчүн колдонулат fileлар талаалардын маанисине дал келгенде импорттолот. Талаада төмөнкү синтаксис колдонулат:

1. Эң кеңири таралган колдонуу болушу мүмкүн file узартуу. Кадимки синтаксис .EXT, мында EXT каалаган file кеңейтүү (мисалы, .java).
2. Дагы бир жалпы жагдай өзгөчө болуп саналат file, жасоо сыяктууfile. Демек, так дал келүүгө болот file аты. Бул үчүн, жөн гана киргизиңиз file талаага атын киргизиңиз (мисалы, build.xml).
3. Кээ бир учурларда картага түшүрүү каалоолору конкреттүү, ошондуктан гана fileатайын үлгүгө дал келген с импорттолушу керек. Бул талапка ылайык келүү үчүн, анда туруктуу сөз айкаштарын колдонууга болот File аты үлгү талаасы.
   Туруктуу сөз айкаштарынын синтаксисин сыпаттоо бул жардамдын максатынан ашат. Сураныч, таза::variants колдонуучу колдонмосундагы маалымдама бөлүмүндөгү кадимки туюнтмалар бөлүмүн караңыз (мисалы, .*).

• Карталанган элемент түрү талаасы а ортосундагы картаны орнотот file түрү жана таза::variants үй-бүлөлүк элемент түрү. Үй-бүлөлүк элементтин түрү булак үчүн дескриптор болуп саналат file импорттолгон моделдеги карталанган элементке кошумча маалымат берүү. Типтүү тандоолор ps:class же ps:makefile.
• Карталанган file type талаасы а ортосундагы картаны орнотот file түрү жана таза::variants file түрү. The file pure::variants менен териңиз бул булактын дескриптору file импорттолгон моделдеги карталанган элементке кошумча маалымат берүү. Типтүү тандоолор ишке ашыруу үчүн көрсөтүлөт же аныктоо үчүн аныкталат files.

Сүрөт 3. Жеке конфигурацияны аныктоо үчүн импорт чеберинин бетиЖаңы file Карталарды кошуу баскычын колдонуу менен түрлөрүн кошууга болот. Бардык талаалар аныкталбаган маани менен толтурулат жана колдонуучу тарабынан толтурулат. Талаадагы маанини түзөтүү үчүн, чычкан менен талааны чыкылдатыңыз. Мааниси түзөтүүгө болот жана өзгөртүлүшү мүмкүн. Бул демейки өзгөртүү мүмкүн эмес file столдун үлгүлөрүн атагыла. Ыңгайлаштыруу ийкемдүү кылуу үчүн, а тандоону алып салууга болот file катарды тандоодон чыгаруу менен териңиз. Тандоодон чыгарылды file ат үлгүлөрү конфигурацияда калат, бирок импортер тарабынан колдонулбайт. Колдонуучу аныкталды file түрлөрү Картаны өчүрүү баскычын колдонуу менен кайра жок кылынышы мүмкүн.
Демейки боюнча Башка files file аты үлгүсү таблицада бар, бирок тандоо жок. Адатта, бардыгын импорттоону каалабайт fileс, бирок бул ылайыктуу катарды тандоо менен оңой эле өзгөртө алат.
Импорттоочунун жүрүм-турумун ыңгайлаштыруу үчүн үч жалпы импорт варианты бар.

• Дал келүүсүз каталогдорду импорттобоңуз files (мисалы, CVS каталогдору).
  Эгерде импортер дал келбеген каталогду тапса file анын ичинде жана эч бир подкаталог дал келбеген жерде file, каталог импорттолбойт. Эгерде долбоорлор CVS сыяктуу версияларды башкаруу системалары тарабынан башкарылса, бул көбүнчө пайдалуу. CVS үчүн, ар бир тиешелүү каталогдо тиешеси жок жерде CVS-каталог бар fileс сакталат. Бул параметр тандалган болсо жана CVS-fileэч кимге дал келбейт file түрү жогоруда аныкталган болсо, каталог Үй-бүлө моделине компонент катары импорттолбойт.
• Сорттоо fileс жана каталогдор.
  Сорттоо үчүн бул параметрди иштетиңиз files жана каталогдор ар бири алфавиттик тартипте.
• Импорттук жол менен иштөө.
  Андан ары синхрондоштуруу үчүн импортер бардык импорттолгон элементтердин баштапкы жолун моделге сакташы керек.
  Көп учурларда Үй-бүлөлүк моделдер башка колдонуучулар менен бөлүшүлөт. Каталог структурасы ар бир колдонуучу үчүн ар кандай болушу мүмкүн. Көбүнчө колдонуу сценарийлерин колдоо үчүн импортер ар кандай режимдерде иштей алат:

Абсолюттук	Импорттолгон элементке абсолюттук жол моделде сакталат. Кийинчерээк синхрондоштуруу үчүн жана трансформация учурунда fileлар биринчи импорттоо учурундагыдай эле жерге жайгаштырылышы керек.
Иш мейкиндигине карата	Жолдор иш папкасына салыштырмалуу сакталат. Синхрондоштуруу үчүн files Eclipse иш мейкиндигинин бир бөлүгү болушу керек. Трансформация Eclipse жумушчу мейкиндигин киргизүү каталогу катары колдонушу керек.
Долбооруна карата	Жолдор долбоорго салыштырмалуу сакталат. Синхрондоштуруу үчүн files Eclipse ичиндеги долбоордун бир бөлүгү. Трансформация долбоордун папкасын киргизүү каталогу катары колдонушу керек.
Жолго карата	Жолдор берилген жолго салыштырмалуу сакталат. Синхрондоштуруу үчүн fileлар так ошол эле жерге коюлушу керек. Трансформация киргизүү каталогу импорттоо учурундагы салыштырмалуу жол менен бирдей.

Бул диалогдун бардык артыкчылыктары туруктуу сакталат. Жеке ыңгайлаштыруулар импорттолгон сайын кайталанбашы керек. Бул импорттун иштөө процессин жеңил жана тез кылат.
2.3. Каталог дарагынан моделдерди жаңыртуу
Синхрондоштуруу баскычын басыңыз импорттолгон моделди каталог жолу менен синхрондоштуруу үчүн. Долбоордун түпкү жолу модельде сакталат, андыктан ал мурункудай эле каталогго синхрондолот. Синхрондоштуруу баскычын иштетүү үчүн моделди ачып, каалаган элементти тандаңыз. Синхрондоштуруу баскычын басканда, учурдагы Үй-бүлө модели менен учурдагы каталог түзүмүнүн модели карама-каршы турган Салыштыруу редактору ачылат (4-сүрөттү караңыз, “Салыштыруу редакторундагы каталог дарагынын моделин жаңыртуу”).
4-сүрөт. Салыштыруу редакторундагы Каталог дарагынын жаңыртылышы   Салыштыруу редактору бардык таза ::variants моделдердин версияларын салыштыруу үчүн колдонулат, бирок бул учурда физикалык каталогдун түзүмүн (төмөнкү оң жагында көрсөтүлгөн) учурдагы таза::variants модели (төмөнкү сол тарабы) менен салыштыруу үчүн колдонулат. Бардык өзгөртүүлөр таасир эткен элементтер боюнча иреттелген редактордун жогорку бөлүгүндө өзүнчө пункттар катары тизмеленген.
Бул тизмеден бир нерсени тандоо эки моделдеги тиешелүү өзгөртүүнү баса белгилейт. мурдагыample, кошумча элемент оң жагында кутуча менен белгиленет жана сол жагында анын моделдеги мүмкүн болуучу абалы менен байланышкан. Редактордун үстүнкү жана төмөнкү терезелеринин ортосундагы бириктирүү куралдар панели каталог дарагынын моделинен Функция моделине бир бүтүндөй бир же ал тургай бардык (конфликтсиз) өзгөртүүлөрдү көчүрүү үчүн куралдар менен камсыз кылат.
Эскертүү
Синхрондоштуруу акыркы колдонулган импортер орнотуулары менен ишке ашырылат. Бул импорттоо учурунда жасалган башка орнотуулар менен моделди жаңыртууга мүмкүндүк берет.

Relation Indexer колдонуу

Булак кодун башкаруу үчүн туташтыргыч мамилелерди жакшыртат View таза ::variants моделдин элементтеринин жана баштапкы коддун ортосундагы байланыштар жөнүндө маалымат менен. ps:condxml жана ps:condtext элементтеринин шарттарында колдонулган өзгөчөлүктөр үчүн байланыштар кошулат.
ps: flag жана ps: flag үчүнfile C/C++ булагында препроцессордук константалардын ордун элементтери fileлар көрсөтүлөт. Мындан тышкары, дал келген препроцессордук константалардын орундары тандалган функция үчүн өзгөчөлүк уникалдуу аталыштары менен препроцессордук константалардын ортосундагы картаны колдонуу менен көрсөтүлөт.
3.1. Долбоорго байланыш индексин кошуу
Байланыш индекси атайын долбоордун менчик барагында жандырылышы мүмкүн. Долбоорду тандап, контексттик менюдан Properties пунктун тандаңыз. Келе жаткан диалог терезесинде Relation Indexer барагын тандаңыз.
5-сүрөт. Байланыш индекси үчүн Долбоордун мүлк барагы

Байланыш индекстөөчүсү Долбоор үчүн Relation Indexerти иштетүү параметрин тандоо менен иштетилет (1). Индексаторду иштеткенден кийин, долбоордун конкреттүү жүрүм-турумун аныктоо үчүн дагы бир нече варианттар бар. Pure::variants шарттарын жана C/C++ препроцессордук константаларын индекстөө өзүнчө активдештирилиши мүмкүн (2). менен тизмеси file ат үлгүлөрү (3) тандоо үчүн колдонулат fileиндекстөө үчүн. гана fileүлгүлөрдүн бирине дал келген с сканерден өткөрүлөт. Баарын сканерлөө үчүн үлгү катары “*” кошуңуз fileбир долбоордун с.
Долбоордун индекси иштетилгенден кийин долбоорго куруучу кошулат. Бул куруучунун сканерлери өзгөртүлдү files жаңы мамилелер үчүн таза::variants моделдин элементтерин автоматтык түрдө.
3.2. Булак кодексине болгон мамилелер
Байланыш индекси активдештирилген менен Relations View кошумча жазууларды камтыйт. Бул жазуулар атын көрсөтөт file жана вариант чекитинин сап номери. Куралдын учу тиешелүү бөлүмүн көрсөтөт file. Киргизүүнү эки жолу чыкылдатуу менен file редакторго ачылат.
pure::variants Шарттар
Pure::variants шарты а бөлүмдөрүн кошуу же алып салуу үчүн колдонулушу мүмкүн file бир өзгөчөлүк тандоого жараша. Condition Indexer мындай эрежелерди сканерлейт жана шилтемеленген функцияларды чыгарат. Редактордо ушундай функция тандалган болсо, Relations View баарын көрсөтөт fileлар жана тандалган өзгөчөлүгү бар шарт жайгашкан сызыктар (6-сүрөттү караңыз, “Шарттын мамилелерде чагылдырылышы View”).
Сүрөт 6. Мамилелердеги шарттын чагылдырылышы ViewШарттарды кантип аныктоо керектиги боюнча кеңири түшүндүрмө алуу үчүн pure::variants Колдонуучунун колдонмосунун 9.5.7-бөлүмүнүн ps:condtext бөлүмүнө кайрылыңыз (Шилтеме–>Алдын ала аныкталган булак элементтеринин түрлөрү–>ps:кондтекст).
C/C++ препроцессордук константалары
C/C++ Preprocessor Indexer сканерлейт files препроцессордун эрежелеринде колдонулган константалар үчүн (мисалы, #ifdef, #ifndef, …).
Эгерде ps: flag же ps: flagfile элементи Мамилелер тандалат View аныкталган препроцессордук константасынын колдонулушун көрсөтөт.
The Relations View ошондой эле карта түзүү үлгүлөрүн колдонуу менен функцияларга туташтырылган препроцессордук константаларды көрсөтөт. Бул үчүн үлгүлөр тандалган функциянын маалыматтары менен кеңейтилет. Алынган белгилер дал келген препроцессордук константаларды издөө үчүн колдонулат. 7-сүрөт, “С/С++ препроцессордук константасынын мамилелерде көрсөтүлүшү View” мурункуну көрсөтөтampле үлгүсү менен атагы {Аты}. Үлгү fameNative үчүн өзгөчөлүктүн уникалдуу аталышы менен кеңейтилген. Индекстелген коддо препроцессордун туруктуу fameNative колдонулган 76 жери бар.
Бул жерлер мамилелерде көрсөтүлгөн View. Үлгүлөр артыкчылыктарда аныкталышы мүмкүн (3.3, “Артыкчылыктар” бөлүмүн караңыз).
7-сүрөт. С/С++ препроцессордук константасынын мамилелерде көрсөтүлүшү View

3.3. The Preferences
Индексатордун демейки жүрүм-турумун өзгөртүү үчүн Eclipse артыкчылыктарын ачып, Variant Management категориясынан Relation Indexer барагын тандаңыз. Барак эки тизмени көрсөтөт.
Сүрөт 8. Relation Indexer Preference баракчасыЖогорку тизмеде демейки бар file индекстөөчү үчүн үлгүлөр (1). Бул тизме жаңы иштетилген долбоорлор үчүн баштапкы үлгү орнотуу болуп саналат.
Төмөнкү тизме функциялар менен препроцессордук константалардын ортосундагы картаны камтыйт (2). Бул карта бардык долбоорлор үчүн колдонулат. 1-таблица, "Колдоого алынган карта алмаштыруулар" бардык мүмкүн болгон алмаштырууларды көрсөтөт.
Таблица 1. Колдоого алынган карта алмаштыруу

Wildcard	Description	Example: FeatureA
аты	тандалган функциянын уникалдуу аталышы	FLAG_{Аты} – FLAG_FeatureA
NAME	тандалып алынган функциянын уникалдуу аталышы	FLAG_{NAME} – FLAG_FEATUREA
аты	тандалган өзгөчөлүктүн кичине регистр Уникалдуу аталышы	flag_{name} – flag_featurea

Документтер / Ресурстар

Pure-системалары 2024 Булак кодун башкаруу программасы үчүн туташтыргыч [pdf] Колдонуучунун колдонмосу 2024, 2024 Булак кодун башкаруу программасы үчүн туташтыргыч, баштапкы кодду башкаруу программасы үчүн туташтыргыч, булак кодду башкаруу программасы, башкаруу программасы, программалык камсыздоо

Шилтемелер

• User Manual