pure::variants – үшін қосқыш
Бастапқы кодты басқару жөніндегі нұсқаулық
Parametric Technology GmbH
6.0.7.685 таза::нұсқалары үшін 6.0 нұсқасы
Авторлық құқық © 2003-2024 Parametric Technology GmbH
2024

Кіріспе

pure::variants Бастапқы кодты басқаруға арналған қосқыш (қосқыш) әзірлеушілерге pure::variants арқылы бастапқы кодтың өзгермелілігін басқаруға мүмкіндік береді. Pure::variants бастапқы кодты басқару каталог құрылымдары мен бастапқы кодты синхрондау үшін икемді мүмкіндік береді fileтаза ::variants үлгілерімен оңай. Осылайша, нұсқаларды басқару тіпті күрделі бағдарламалық жобаларға да қолдануға болады. Сонымен қатар, pure::variants мүмкіндіктері мен бастапқы код арасындағы байланыстарды құрастырушымен оңай басқаруға болады және олар Source Code Management арқылы қол жетімді.
1.1. Бағдарламалық қамтамасыз ету талаптары
Pure::variants Бастапқы кодты басқаруға арналған қосқыш таза::variants кеңейтімі болып табылады және барлық қолдау көрсетілетін платформаларда қолжетімді.
1.2. Орнату
Қосқышты орнату жолы туралы толық ақпаратты pure::variants ішіндегі қосқыштар бөлімінен қараңыз (мәзір Анықтама -> Анықтама мазмұны, содан кейін таза::variants Орнату нұсқаулығы -> таза::variants Қосқыштар).
1.3. Осы нұсқаулық туралы
Оқырман таза::варианттар туралы негізгі білімге және тәжірибеге ие болуы керек. Осы нұсқаулықты оқымас бұрын оның кіріспе материалымен танысыңыз. Нұсқаулықты онлайн анықтамада, сондай-ақ басып шығаруға болатын PDF пішімінде осы жерден алуға болады.

Қосқышты пайдалану

2.1. Таза::нұсқаларды бастау
Қолданылатын орнату әдісіне байланысты таза::variants қосылған Eclipse бағдарламасын бастаңыз немесе Windows жүйесінде бағдарлама мәзірінен таза::variants элементін таңдаңыз.
Варианттарды басқару перспективасы әлі іске қосылмаған болса, оны Терезе мәзіріндегі Ашық перспектива->Басқа... тармағынан таңдау арқылы орындаңыз.
2.2. Каталогтар ағашын отбасы үлгісіне импорттау
Каталогтар ағашын Отбасы үлгісіне импорттамас бұрын нұсқалар жобасын жасау керек. Сондай-ақ, Функция үлгісінде анықталған мүмкіндіктердің болуы ұсынылады. Осы қадамдар туралы анықтама алу үшін pure::variants құжаттамасын қараңыз.
Нақты импорттау жобалардың мәтінмәндік мәзіріндегі Импорттау… әрекетін таңдау арқылы басталады view немесе Импорттау… мәзірінде File мәзір. Варианттарды басқару санатынан Вариант үлгілері немесе жобаларды таңдап, «Келесі» түймесін басыңыз. Келесі бетте бастапқы қалталардан отбасы үлгісін импорттау опциясын таңдап, «Келесі» түймесін қайтадан басыңыз.
Импортталатын бастапқы код түрін таңдаңыз
Импорттау шебері пайда болады («Импортталуы мүмкін бастапқы код түрін таңдау үшін импорттау шеберінің беті» 1-суретті қараңыз). Импортталатын жоба түрін таңдап, «Келесі» түймесін басыңыз. Әрбір түр алдын ала анықталған жиынын қамтиды file үлгіге импортталатын түрлер.
Сурет 1. Импортталуы мүмкін бастапқы код түрін таңдау үшін импорттау шеберінің бетіКөз және Мақсатты таңдаңыз
Шебердің келесі бетінде (2-сурет, «Импорттау үшін көз мен мақсатты таңдау үшін импорттау шеберінің беті») бастапқы каталог пен мақсатты үлгі көрсетілуі керек.
Импортталатын бастапқы код бар каталогты таңдау үшін Шолу… түймесін басыңыз. Әдепкі бойынша ағымдағы жұмыс кеңістігі таңдалады, себебі бұл шарлауды бастау үшін пайдалы нүкте болуы мүмкін.
Төменде қосу және шығару үлгісін көрсетуге болады. Бұл үлгі java тұрақты өрнектері болуы керек. Бастапқы түбір қалтасына қатысты әрбір енгізу жолы осы үлгімен тексеріледі. Қосылу үлгісі сәйкес келсе, алып тастау үлгісі сәйкес келмесе, қалта импортталады. Қосылу үлгісі импортталатын қалталарды алдын ала таңдайтынын білдіреді, алып тастау үлгісі бұл алдын ала таңдауды шектейді.
Бастапқы код каталогын таңдағаннан кейін мақсатты үлгі анықталуы керек. Сондықтан нұсқалық жобаны немесе үлгі сақталатын қалтаны таңдап, үлгі атауын енгізіңіз. The file аты осы диалогта берілмесе, .ccfm кеңейтімімен автоматты түрде ұзартылады. Әдепкі бойынша ол үлгі атауының өзі сияқты атқа орнатылады. Бұл ұсынылған параметр.
Қажетті бастапқы қалта және қажетті үлгі атауы көрсетілгеннен кейін, диалогты Аяқтау түймесін басу арқылы аяқтауға болады. «Келесі» түймесі басылса, қосымша параметрлерді жасауға болатын басқа бет шығады.
Сурет 2. Импорттау үшін көз мен мақсатты таңдау үшін импорттау шеберінің бетіИмпорттау теңшелімдерін өзгерту
Шебердің соңғы бетінде (3-сурет, «Жеке конфигурацияны анықтау үшін импорттау шеберінің беті”) импортталған бағдарламалық жасақтама жобасы үшін импорттау әрекетін теңшеуге болатын теңшелімдер бар.
Диалогтық бет кестені көрсетеді, онда file түрлері анықталады, олар импорт процесінде қарастырылады.
Әрбір жол төрт өрістен тұрады.

• Сипаттама өрісінде анықтау үшін қысқаша сипаттама мәтіні бар file түрі.
• The File атау үлгісі өрісі таңдау үшін пайдаланылады files өрістер мәніне сәйкес келгенде импортталады. Өріс келесі синтаксисті пайдаланады:

1. Ең көп тараған қолдану түрі а болуы мүмкін file ұзарту. Әдеттегі синтаксис .EXT, мұнда EXT қажет file кеңейтім (мысалы, .java).
2. Тағы бір жалпы жағдай - ерекше file, жасау сияқтыfile. Сондықтан дәл сәйкестендіруге болады file аты. Мұны істеу үшін жай ғана енгізіңіз file өріске атауды енгізіңіз (мысалы, build.xml).
3. Кейбір жағдайларда картаға түсіру тілектері нақтырақ, сондықтан тек fileарнайы үлгіге сәйкес келетіндерді импорттау керек. Бұл талапқа сай болу үшін тұрақты өрнектерді қолдануға болады File атау үлгісі өрісі.
   Тұрақты тіркестердің синтаксисін сипаттау бұл көмектің мақсатынан асып түседі. Pure::variants пайдаланушы нұсқаулығындағы анықтамалық тараудың тұрақты өрнектер бөлімін қараңыз (мысалы, .*).

• Салыстырылған элемент түрі өрісі a арасындағы салыстыруды орнатады file түрі және таза::variants отбасы элементінің түрі. Отбасы элементінің түрі көзге арналған дескриптор болып табылады file импортталған үлгідегі салыстырылған элементке қосымша ақпаратты беру үшін. Әдеттегі таңдаулар ps:class немесе ps:make болып табыладыfile.
• Карталанған file түрі өрісі a арасындағы салыстыруды орнатады file түрі және таза::нұсқалары file түрі. The file pure::variants түрінде теріңіз - дереккөздің дескрипторы file импортталған үлгідегі салыстырылған элементке қосымша ақпаратты беру үшін. Әдеттегі таңдаулар іске асыруға арналған немесе анықтау үшін анықтама болып табылады files.

Сурет 3. Жеке конфигурацияны анықтау үшін импорттау шеберінің бетіЖаңа file түрлерді «Салыстыруды қосу» түймесі арқылы қосуға болады. Барлық өрістер анықталмаған мәнмен толтырылады және оны пайдаланушы толтыруы керек. Өрістегі мәнді өңдеу үшін өрісті тінтуірмен шертіңіз. Мән өңделетін болады және өзгертуге болады. Әдепкі мәнді өзгерту мүмкін емес file кестенің үлгілерін атаңыз. Теңшеуді икемді ету үшін a таңдауын алып тастауға болады file жолды таңдауды алып тастау арқылы теріңіз. Таңдау алынып тасталды file атау үлгілері конфигурацияда қалады, бірақ импорттаушы пайдаланбайды. Пайдаланушы анықталды file «Салыстыруды жою» түймесін пайдалану арқылы түрлерді қайтадан жоюға болады.
Әдепкі бойынша Басқа files file атау үлгісі кестеде бар, бірақ таңдау алынып тасталды. Әдетте барлығын импорттау қажет емес files, бірақ оны сәйкес жолды таңдау арқылы оңай өзгертуге болады.
Импорттаушының әрекетін теңшеу үшін үш жалпы импорттау опциясы бар.

• Сәйкес келмейтін каталогтарды импорттамаңыз files (мысалы, CVS каталогтары).
  Егер импорттаушы сәйкес келмейтін каталогты тапса file оның ішінде және ешбір ішкі каталог сәйкес келмейтін жерде file, каталог импортталмайды. Егер жобалар CVS сияқты нұсқаларды басқару жүйелерімен басқарылатын болса, бұл жиі пайдалы. CVS үшін әрбір сәйкес каталог маңызды емес жерде CVS каталогын қамтиды fileс сақталады. Бұл опция таңдалса және CVS-fileешқайсысына сәйкес келмейді file түрі жоғарыда анықталған болса, каталог Отбасы үлгісіне құрамдас ретінде импортталмайды.
• Сұрыптау files және каталогтар.
  Сұрыптау үшін осы опцияны қосыңыз files және каталогтар әрқайсысы алфавиттік тәртіпте.
• Импорт жолын өңдеу.
  Әрі қарай синхрондау үшін импорттаушы модельге барлық импортталған элементтердің бастапқы жолын сақтауы керек.
  Көптеген жағдайларда Отбасы үлгілері басқа пайдаланушылармен ортақ пайдаланылады. Әр пайдаланушы үшін каталог құрылымы әртүрлі болуы мүмкін. Ең көп таралған пайдалану сценарийлерін қолдау үшін импорттаушы әртүрлі режимдерде жұмыс істей алады:

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

Бұл диалогтың барлық теңшелімдері тұрақты сақталады. Жеке теңшеулер импорт іске қосылған сайын қайта жасалмауы керек. Бұл импорттық жұмыс процесін жеңіл және жылдам етеді.
2.3. Каталогтар ағашынан үлгілерді жаңарту
Синхрондау түймесін басыңыз импортталған үлгіні оның каталог жолымен синхрондау үшін. Жобаның түбір жолы үлгіде сақталады, сондықтан ол бұрынғыдай каталогпен синхрондалады. Синхрондау түймесін қосу үшін үлгіні ашып, кез келген элементті таңдаңыз. Синхрондау түймешігін басқаннан кейін ағымдағы Отбасы үлгісі мен ағымдағы каталог құрылымының үлгісі қарсы тұрған Салыстыру өңдегіші ашылады (4-суретті қараңыз, «Салыстыру өңдегішіндегі каталогтар ағашынан үлгіні жаңарту»).
Сурет 4. Салыстыру өңдегішіндегі каталогтар ағашынан үлгі жаңартуы   Салыстыру өңдегіші үлгі нұсқаларын салыстыру үшін таза::variants ішінде пайдаланылады, бірақ бұл жағдайда каталогтың физикалық құрылымын (төменгі оң жақта көрсетіледі) ағымдағы таза::variants үлгісімен (төменгі сол жақта) салыстыру үшін пайдаланылады. Барлық өзгертулер өңдегіштің жоғарғы бөлігінде зардап шеккен элементтер бойынша реттелген бөлек элементтер ретінде тізімделеді.
Бұл тізімдегі элементті таңдау екі үлгідегі де тиісті өзгерісті бөлектейді. Бұрынғыample, қосылған элемент оң жағында қораппен белгіленеді және сол жақта модельдегі оның мүмкін болатын орнымен байланыстырылады. Редактордың жоғарғы және төменгі терезелері арасындағы біріктіру құралдар тақтасы каталогтар ағашының үлгісінен мүмкіндік үлгісіне тұтастай бір немесе тіпті барлық (қайшылықсыз) өзгерістерді көшіруге арналған құралдарды қамтамасыз етеді.
Ескерту
Синхрондау соңғы пайдаланылған импорттаушы параметрлерімен орындалады. Бұл үлгіні импорттау кезінде жасалған басқа параметрлермен жаңартуға мүмкіндік береді.

Relation Indexer пайдалану

Бастапқы кодты басқаруға арналған қосқыш қатынастарды жақсартады View pure::variants үлгі элементтері мен бастапқы код арасындағы байланыстар туралы ақпарат бар. Қатынастар ps:condxml және ps:condtext элементтерінің шарттарында пайдаланылатын мүмкіндіктер үшін қосылады.
ps:жалау және ps:жалау үшінfile C/C++ көзіндегі препроцессор константаларының орналасуын элементтері fileлар көрсетілген. Сонымен қатар, сәйкес келетін препроцессор тұрақтыларының орындары мүмкіндіктің бірегей атаулары мен препроцессор тұрақтылары арасындағы салыстыруды пайдалану арқылы таңдалған мүмкіндік үшін көрсетіледі.
3.1. Қатынас индексін жобаға қосу
Қатынас индексін жобаның арнайы сипат бетінде белсендіруге болады. Жобаны таңдап, контекстік мәзірден «Сипаттар» тармағын таңдаңыз. Алдағы диалогтық терезеде Relation Indexer бетін таңдаңыз.
Сурет 5. Қатынас индексі үшін жоба сипаттары беті

Қатынас индекстеушісі жоба үшін Қатынас индекстеушісін қосу опциясын таңдау арқылы іске қосылады (1). Индексаторды қосқаннан кейін жобаның нақты әрекетін анықтау үшін тағы бірнеше опциялар бар. Pure::variants шарттарын және C/C++ препроцессор тұрақтыларын индекстеуді бөлек қосуға болады (2). бар тізім file атау үлгілері (3) таңдау үшін пайдаланылады files индекстеу үшін. Тек fileүлгілердің біріне сәйкес келетіндер сканерленеді. Барлығын сканерлеу үшін үлгі ретінде «*» қосыңыз fileжобаның с.
Жоба үшін индекстеуіш белсендірілгеннен кейін жобаға құрастырушы қосылады. Бұл құрастырушы сканерлері өзгертілді files таза::variants үлгі элементтеріне автоматты түрде жаңа қатынастар үшін.
3.2. Бастапқы кодқа қатынасы
Белсендірілген қатынас индексімен Қатынастар View қосымша жазбаларды қамтиды. Бұл жазбалар атауын көрсетеді file және нұсқа нүктесінің жол нөмірі. Құрал кеңесі тиісті бөлімді көрсетеді file. Жазбаны екі рет басу арқылы file редакторында ашылады.
pure::variants Шарттар
Pure::variants шарты а бөлімдерін қосу немесе алып тастау үшін пайдаланылуы мүмкін file мүмкіндікті таңдауға байланысты. Шарт индексі осындай ережелерді сканерлейді және сілтеме жасалған мүмкіндіктерді шығарады. Редакторда мұндай мүмкіндік таңдалған болса, Қатынастар View барлығын көрсетеді files және таңдалған мүмкіндігі бар шарт орналасқан жолдар (6-суретті қараңыз, «Қатынастардағы шартты көрсету View”).
Сурет 6. Шартты қатынастарда көрсету ViewШарттарды анықтау әдісі туралы толық түсініктеме алу үшін pure::variants пайдаланушы нұсқаулығының 9.5.7 тарауының ps:condtext бөлімін қараңыз (Анықтама–>Алдын ала анықталған бастапқы элемент түрлері–>ps:condtext).
C/C++ препроцессор тұрақтылары
C/C++ Preprocessor Indexer сканерлейді files препроцессор ережелерінде қолданылатын тұрақтылар үшін (мысалы, #ifdef, #ifndef, …).
Егер ps:flag немесе ps: flagfile элементі Қатынастар таңдалады View анықталған препроцессор тұрақтысының қолданылуын көрсетеді.
Қатынастар View сонымен қатар салыстыру үлгілерін пайдалану арқылы мүмкіндіктерге қосылған препроцессор тұрақтыларын көрсетеді. Бұл үшін үлгілер таңдалған мүмкіндіктің деректерімен кеңейтіледі. Алынған таңбалар препроцессордың сәйкес константаларын іздеу үшін пайдаланылады. 7-сурет, «С/С++ препроцессорының константасының қатынастарда көрсетілуі View” бұрынғысын көрсетедіample {Name} үлгісімен. Үлгі мүмкіндіктің бірегей атауымен fameNative үшін кеңейтілген. Индекстелген кодта fameNative препроцессор тұрақтысы қолданылатын 76 орын бар.
Бұл орындар Қатынастарда көрсетілген View. Үлгілерді теңшелімдерде анықтауға болады (3.3, «Параметрлер» бөлімін қараңыз).
Сурет 7. С/С++ препроцессорының константасының қатынастардағы көрінісі View

3.3. Параметрлер
Индексатордың әдепкі әрекетін өзгерту үшін Eclipse теңшелімдерін ашыңыз және «Нұсқаларды басқару» санатындағы Қатынас индекстеушісі бетін таңдаңыз. Бет екі тізімді көрсетеді.
Сурет 8. Қатынас индекстеуішінің теңшелім бетіЖоғарғы тізімде әдепкі бар file көрсеткішке арналған үлгілер (1). Бұл тізім жаңадан қосылған жобалар үшін бастапқы үлгі параметрі болып табылады.
Төменгі тізім мүмкіндіктер мен препроцессор тұрақтылары арасындағы салыстыруды қамтиды (2). Бұл карта барлық жобалар үшін қолданылады. 1-кесте, «Қолдау көрсетілетін картаны ауыстырулар» барлық ықтимал ауыстыруларды көрсетеді.
Кесте 1. Қолдау көрсетілетін картаны ауыстырулар

Қойылмалы таңба	Сипаттама	Example: МүмкіндікA
Аты	таңдалған мүмкіндіктің бірегей атауы	FLAG_{Атауы} – FLAG_FeatureA
NAME	бас әріп Таңдалған мүмкіндіктің бірегей атауы	FLAG_{NAME} – FLAG_FEATUREA
аты	кіші регистр таңдалған мүмкіндіктің бірегей атауы	жалау_{атауы} – жалау_ерекшелігі

Құжаттар / Ресурстар

pure-systems 2024 бастапқы кодты басқару бағдарламалық құралына арналған қосқыш [pdf] Пайдаланушы нұсқаулығы 2024, 2024 Бастапқы кодты басқару бағдарламалық құралына арналған қосқыш, бастапқы кодты басқару бағдарламалық құралына арналған қосқыш, бастапқы кодты басқару бағдарламалық құралы, басқару бағдарламалық құралы, бағдарламалық құрал

Анықтамалар

• Пайдаланушы нұсқаулығы