чисто::варијанти – Конектор за
Прирачник за управување со изворниот код
Параметриска технологија GmbH
Верзија 6.0.7.685 за чиста::варијанти 6.0
Авторски права © 2003-2024 Parametric Technology GmbH
2024
Вовед
pure::variants Конекторот за управување со изворниот код (Конектор) им овозможува на програмерите да управуваат со варијабилноста на изворниот код користејќи чисти::варијанти. Управувањето со изворниот код на чисти::варијанти обезбедува флексибилна можност за синхронизирање структури на директориуми и изворен код fileЛесно е со чисти::варијанти модели. Така, управувањето со варијанти може да се примени дури и на сложени софтверски проекти. Понатаму, врските помеѓу чистите::варијанти карактеристики и изворниот код може полесно да се управуваат со градителот и се многу достапни преку Управувањето со изворниот код.
1.1. Софтверски барања
Чистиот::варијанти приклучок за управување со изворниот код е екстензија за чисти::варијанти и е достапен на сите поддржани платформи.
1.2. Инсталација
Консултирајте се со делот pure::variants Конектори во Pure::variants Водичот за поставување за детални информации за тоа како да го инсталирате конекторот (мени Помош -> Содржини за помош и потоа Водич за поставување чисти::варијанти -> Pure::variants Конектори).
1.3. За овој прирачник
Од читателот се очекува да има основни познавања и искуства со чисти::варијанти. Ве молиме консултирајте се со неговиот воведен материјал пред да го прочитате овој прирачник. Прирачникот е достапен во онлајн помош, како и во PDF формат за печатење овде.
Користење на конектор
2.1. Почнувајќи чисто::варијанти
Во зависност од употребениот метод на инсталација, или стартувајте го Eclipse со овозможено чисто::варијанти или под Windows изберете ја ставката pure::variants од програмското мени.
Ако перспективата за управување со варијанти не е веќе активирана, направете го тоа со избирање од Отвори перспектива->Друго… во менито Прозорец.
2.2. Увезете стебло на директориуми во семеен модел
Пред да увезете дрво на директориуми во семеен модел, треба да се креира проект за варијанти. Исто така, сугестивно е веќе да се дефинираат карактеристики во модел на карактеристики. Консултирајте ја чистата::варијанти документација за помош околу овие чекори.
Вистинскиот увоз се започнува со избирање на акцијата Увоз… или во контекстното мени на Проектите view или со менито Увоз… во File мени. Изберете варијантни модели или проекти од категоријата Управување со варијанти и притиснете Следно. На следната страница изберете Внеси семеен модел од изворните папки и повторно притиснете Следно.
Изберете тип на изворен код за увоз
Се појавува волшебникот за увоз (видете Слика 1, „Страница на волшебникот за увоз за да го изберете типот на изворниот код што може да се увезе“). Изберете тип на проект за увоз и притиснете Следно. Секој тип содржи предефиниран сет на file типови за увоз во моделот.
Слика 1. Страница од волшебникот за увоз за да го изберете типот на изворниот код што може да се увезе
Изберете Извор и Цел
На следната страница на волшебникот (Слика 2, „Страница на волшебникот за увоз за избор на изворот и целта за увоз“) мора да се наведат изворниот директориум и целниот модел.
Притиснете го копчето Browse… за да го изберете директориумот каде што постои изворниот код што треба да се увезе. Стандардно, тековниот работен простор е избран бидејќи ова може да биде корисна точка за да започнете со навигација.
Подолу можете да наведете вклучи и исклучи шема. Овие шаблони треба да бидат редовни изрази на Java. Секоја влезна патека, во однос на изворната основна папка, се проверува со оваа шема. Ако шаблонот за вклучување се совпаѓа, папка се увезува, ако шемата за исклучување не се совпаѓа. Што значи дека шаблонот за вклучување ги избира претходно папките за увоз, шаблонот за исклучување го ограничува ова предизбор.
По изборот на директориумот на изворниот код мора да се дефинира целен модел. Затоа изберете варијантен проект или папка каде што треба да се складира моделот и внесете име на моделот. На file името се проширува автоматски со наставката .ccfm ако не е дадено во овој дијалог. Стандардно ќе биде поставено на истото име како и самото име на моделот. Ова е препорачаната поставка.
Откако ќе се назначи соодветна изворна папка и саканото име на моделот, дијалогот може да се заврши со притискање на Finish. Ако се притисне копчето Следно, се појавува дополнителна страница каде што може да се направат дополнителни поставки.
Слика 2. Страница од волшебникот за увоз за да го изберете изворот и целта за увоз
Променете ги поставките за увоз
На последната страница на волшебникот (Слика 3, „Страница на волшебникот за увоз за дефинирање на индивидуална конфигурација”) постојат преференции што може да се направат за да се приспособи однесувањето на увозот за увезениот софтверски проект.
На страницата за дијалог е прикажана табела каде што file се дефинираат типови, кои ќе бидат разгледани во процесот на увоз.
Секоја линија се состои од четири полиња.
- Полето Опис содржи краток описен текст за да се идентификува file тип.
- На File полето за шаблон за име се користи за избор files да се увезат кога се совпаѓаат со вредноста на полињата. Полето ја користи следнава синтакса:
- Најчеста употреба може да биде а file продолжување. Вообичаената синтакса е .EXT, каде што EXT е посакуваната file екстензија (на пр. .java).
- Друга вообичаена ситуација е посебна file, како маркаfile. Затоа, можно е да се совпадне точно file име. За да го направите ова, само внесете го file име во полето (на пр. build.xml).
- Во некои случаи желбите за мапирање се поспецифични, па само fileТреба да се увезат оние што се совпаѓаат со посебна шема. За да одговара на ова барање, можно е да се користат регуларни изрази во File поле за шема за име.
Опишувањето на синтаксата на регуларните изрази би ја надминало намерата на оваа помош. Ве молиме погледнете го делот за регуларни изрази од референтното поглавје во упатството за корисникот чисто::варијанти (на пр. .*).
- Полето Мапиран тип на елемент го поставува пресликувањето помеѓу a file тип и чист::variants фамилијарен тип на елемент. Типот на семејниот елемент е дескриптор за изворот file за да се обезбедат дополнителни информации за мапираниот елемент во увезениот модел. Типични селекции се ps:class или ps:makefile.
- Мапираниот file полето тип го поставува мапирањето помеѓу a file тип и чист::варијанти file тип. На file внесете pure::variants е дескриптор за изворот file за да се обезбедат дополнителни информации за мапираниот елемент во увезениот модел. Типичните селекции се импл за имплементации или дефиниција за дефиниција files.
Слика 3. Страна од волшебникот за увоз за да се дефинира индивидуална конфигурација
Ново file типовите може да се додадат со користење на копчето Додај мапирање. Сите полиња се пополнети со недефинирана вредност и мора да ги пополни корисникот. За да уредите вредност во полето, само кликнете на полето со глувчето. Вредноста станува уредлива и може да се промени. Не е можно да се смени стандардната file модели на имиња на табелата. За да се направи приспособувањето флексибилно, можно е да се отселектира a file напишете со поништување на изборот на редот. Деизбрано file шемите на имиња остануваат во конфигурацијата, но нема да се користат од увозникот. Кориснички дефинирано file типовите може повторно да се отстранат со користење на копчето Отстрани мапирање.
Стандардно Друго files file шаблонот за име е достапен во табелата, но е поништен. Обично не се сака да се увезат сите files, но ова може лесно да се промени со избирање на соодветниот ред.
Постојат три општи опции за увоз за прилагодување на однесувањето на увозникот.
- Не увезувајте директориуми без совпаѓање files (на пр. CVS директориуми).
Ако увозникот најде директориум каде што нема совпаѓање file е во него и каде што ниту еден поддиректориум нема совпаѓање file, директориумот нема да се увезе. Ова е често корисно, ако проектите се управувани од системи за управување со верзии како CVS. За CVS, секој релевантен директориум содржи CVS-директориум каде што е ирелевантно files се складираат. Ако оваа опција е избрана и CVS-fileне се совпаѓаат со ниеден file тип дефиниран погоре, директориумот нема да се увезе како компонента во семејниот модел. - Подреди fileи директориуми.
Овозможете ја оваа опција за сортирање files и директориуми секој по азбучен ред. - Ракување со патека за увоз.
За понатамошна синхронизација, увозникот треба да ја зачува оригиналната патека на сите увезени елементи во моделот.
Во многу случаи, семејните модели се споделуваат со други корисници. Структурата на директориумот може да биде различна за секој корисник. За поддршка на најчестите сценарија за употреба, увозникот може да работи во различни режими:
| Апсолутна | Апсолутната патека до увезениот елемент ќе биде зачувана во моделот. За подоцнежна синхронизација и за време на трансформацијата на fileТие треба да се стават на истата локација како при првиот увоз. |
| Во однос на работниот простор | Патеките се зачувуваат во однос на папката работниот простор. За синхронизација на files мора да биде дел од работниот простор на Eclipse. Трансформацијата треба да го користи работниот простор Eclipse како влезен директориум. |
| Во однос на проектот | Патеките се зачувани во однос на проектот. За синхронизација на files се дел од проектот во Eclipse. Трансформацијата треба да ја користи проектната папка како влезен директориум. |
| Во однос на патеката | Патеките се зачувуваат во однос на дадената патека. За синхронизација на fileтие треба да бидат поставени на точно иста локација. Директориумот за внесување трансформација е ист како релативната патека за време на увозот. |
Сите преференци на овој дијалог се чуваат постојано. Личните прилагодувања не смеат повторно да се прават секојпат кога ќе се изврши увозот. Ова го прави работниот тек на увозот лесен и брз.
2.3. Ажурирање на модели од дрвото на директориуми
Притиснете го копчето Синхронизирај 
за да синхронизирате увезен модел со патеката на директориумот. Коренската патека на проектот е зачувана во моделот, така што ќе се синхронизира во истиот директориум како порано. За да го овозможите копчето Синхронизирај, отворете го моделот и изберете кој било елемент. По притискање на копчето Синхронизирај се отвора Уредувач за споредување каде што се спротивставуваат тековниот семеен модел и моделот на тековната структура на директориумот (види Слика 4, „Ажурирање на моделот од стеблото на директориуми во уредувачот за споредување“).
Слика 4. Ажурирање на моделот од Дрвото на директориумот во уредувачот за споредување 
Уредувачот за споредување се користи низ чисти::варијанти за да се споредуваат верзии на моделот, но во овој случај се користи за споредба на структурата на физичкиот директориум (прикажана во долната десна страна) со тековниот модел на чисти::варијанти (долната лева страна). Сите промени се наведени како посебни ставки во горниот дел на уредникот, подредени според засегнатите елементи.
Изборот на ставка во оваа листа ја нагласува соодветната промена во двата модели. Во ексampЛе, додадениот елемент е означен со кутија од десната страна и поврзан со неговата изводлива положба во моделот од левата страна. Лентата со алатки Merge помеѓу горните и долните прозорци на уредувачот обезбедува алатки за копирање на единечни или дури и сите (неконфликтни) промени како целина од моделот на дрвото на директориуми до моделот на карактеристики.
Забелешка
Синхронизацијата се врши со последните употребени поставки на увозникот. Ова овозможува да се ажурира моделот со други поставки како што беа направени додека беше извршен увозот.
Користење на индекс на односи
Конекторот за управување со изворниот код ги подобрува односите View со информации за врски помеѓу чисти::варијанти елементи на моделот и изворниот код. Се додаваат релации за карактеристики кои се користат во услови на елементите ps:condxml и ps:condtext.
За ps: flag и ps: flagfile елементи на локацијата на константите на претпроцесорот во C/C++ изворот fileсе прикажани. Дополнително, локациите на соодветните константи на претпроцесорот се прикажани за избраната карактеристика со користење на мапирањето помеѓу единствените имиња на карактеристиките и константите на предпроцесорот.
3.1. Додавање на индекс на релации во проект
Индексирачот на релации може да се активира на посебна страница со имот на проектот. Изберете го проектот и изберете ја ставката Својства во контекстното мени. Во претстојниот дијалог изберете ја страницата за индексирање на односи.
Слика 5. Страница со својство на проектот за индексот на релации
Индексатор на релации се активира за проектот со избирање на опцијата Enable Relation Indexer (1). По вклучувањето на индексаторот, има уште неколку опции за дефинирање на специфичното однесување на проектот. Индексирањето на чисти::варијанти Услови и C/C++ константи на претпроцесор може да се активираат посебно (2). Списокот со file шеми за име (3) се користи за избор на files за индексирање. Само fileСе скенираат оние кои одговараат на еден од шаблоните. Додајте го „*“ како шема за да ги скенирате сите fileна еден проект.
По активирањето на индексаторот за проект, во проектот се додава градител. Скенирањето на овој градител е променето files за нови односи со чисти::варијанти елементи на моделот автоматски.
3.2. Односите со изворниот код
Со активиран индексатор на релации, Relations View содржи дополнителни записи. Овие записи го покажуваат името на file и бројот на линијата на точката на варијантата. Врвот на алатката го покажува соодветниот дел од file. Со двоен клик на записот на file ќе се отвори во уредник.
чисто::варијанти Услови
Условот чисто::варијанти може да се користи за вклучување или исклучување на делови од a file во зависност од изборот на карактеристика. Индексаторот на состојби скенира за такви правила и ги извлекува референцираните карактеристики. Ако таква карактеристика е избрана во уредникот, Relations View ќе покаже сè files и линии каде што се наоѓа услов со избраната карактеристика (види Слика 6, „Претставување на услов во односите View”).
Слика 6. Претставување на состојба во односите View
За да добиете детално објаснување за тоа како да ги дефинирате условите, консултирајте се со делот ps:condtext од поглавје 9.5.7 од чистото::варијанти Упатството за корисникот (Референца–>Предефинирани типови на изворни елементи–>ps:condtext).
C/C++ Константи на претпроцесор
Индексирачот на предпроцесор C/C++ скенира files за константи кои се користат во правилата на претпроцесорот (на пр. #ifdef, #ifndef, ...).
Ако пс:знаме или пс:знамеfile елементот е избран Relations View ја покажува употребата на дефинираната константа на претпроцесорот.
Односите View покажува и константи на претпроцесор поврзани со карактеристики со користење на шеми за мапирање. За ова шаблоните се прошируваат со податоците на избраната карактеристика. Резултирачките симболи се користат за пребарување на соодветните константи на претпроцесорот. Слика 7, „Претставување на C/C++ претпроцесорска константа во релациите View“, покажува поранешенample со шаблонот слава{Име}. Шаблонот е проширен со уникатното име на функцијата во fameNative. Во индексираниот код има 76 локации каде што се користи препроцесорската константа fameNative.
Овие локации се прикажани во Односите View. Моделите може да се дефинираат во преференциите (види Дел 3.3, „Преференци“).
Слика 7. Претставување на C/C++ претпроцесорска константа во релациите View
3.3. Преференци
За да го промените стандардното однесување на индексаторот, отворете ги поставките за Eclipse и изберете ја страницата Индексатор на односи во категоријата Управување со варијанти. На страницата се прикажани две списоци.
Слика 8. Страница за претпочитање на индексот на релации
Горната листа ги содржи стандардните file обрасци за индексаторот (1). Оваа листа е почетната поставка за шаблон за новоовозможени проекти.
Долниот список го содржи мапирањето помеѓу карактеристиките и константите на претпроцесорот (2). Ова мапирање се користи за сите проекти. Табела 1, „Поддржани замени за мапирање“ ги прикажува сите можни замени.
Табела 1. Поддржани замени за мапирање
| Звук | Опис | Example: Карактеристика А |
| Име | Единственото име на избраната карактеристика | ЗНАМЕ_{Име} – FLAG_FeatureA |
| ИМЕ | големата буква Единствено име на избраната карактеристика | FLAG_{NAME} – FLAG_FEATUREA |
| име | малата буква Единствено име на избраната карактеристика | flag_{name} – flag_featurea |
Документи / ресурси
 |
Pure-systems 2024 конектор за софтвер за управување со изворен код [pdf] Упатство за користење 2024, 2024 Конектор за софтвер за управување со изворен код, конектор за софтвер за управување со изворен код, софтвер за управување со изворен код, софтвер за управување, софтвер |
