sof::variantlar – uchun ulagich
Manba kodini boshqarish bo'yicha qo'llanma
Parametric Technology GmbH
Pure::variants 6.0.7.685 uchun 6.0 versiyasi
Mualliflik huquqi © 2003-2024 Parametric Technology GmbH
2024

Kirish

pure::variants Manba kodini boshqarish uchun ulagich (Ulagich) ishlab chiquvchilarga pure::variants yordamida manba kodining o‘zgaruvchanligini boshqarish imkonini beradi. Pure::variants manba kodini boshqarish katalog tuzilmalari va manba kodini sinxronlashtirish uchun moslashuvchan imkoniyatni taqdim etadi. filesof::variants modellari bilan oson. Shunday qilib, variantlarni boshqarish hatto murakkab dasturiy ta'minot loyihalarida ham qo'llanilishi mumkin. Bundan tashqari, pure::variants xususiyatlari va manba kodi o'rtasidagi ulanishlar quruvchi bilan osonroq boshqarilishi mumkin va ular Source Code Management orqali yuqori darajada foydalanish mumkin.
1.1. Dasturiy ta'minot talablari
Manba kodini boshqarish uchun sof::variants ulagichi pure::variants uchun kengaytma bo‘lib, barcha qo‘llab-quvvatlanadigan platformalarda mavjud.
1.2. O'rnatish
Ulagichni qanday o'rnatish haqida batafsil ma'lumot uchun pure::variants konnektorlari bo'limiga murojaat qiling (menyu Yordam -> Yordam mazmuni va so'ng sof::variants O'rnatish qo'llanmasi -> sof::variants Ulagichlar).
1.3. Ushbu qo'llanma haqida
O'quvchi toza::variantlar haqida asosiy bilim va tajribaga ega bo'lishi kutiladi. Iltimos, ushbu qo'llanmani o'qishdan oldin uning kirish materiali bilan tanishing. Qo'llanma onlayn yordamda, shuningdek chop etiladigan PDF formatida bu yerda mavjud.

Ulagichdan foydalanish

2.1. Pure::variantsdan boshlab
Amaldagi o'rnatish usuliga qarab, toza::variants-yoqilgan Eclipse-ni ishga tushiring yoki Windows-da dastur menyusidan sof::variants-ni tanlang.
Variantlarni boshqarish istiqboli hali faollashtirilmagan boʻlsa, buni Oyna menyusidagi Ochiq Perspektiv->Boshqa…-dan tanlash orqali bajaring.
2.2. Katalog daraxtini oilaviy modelga import qiling
Oilaviy modelga katalog daraxtini import qilishdan oldin variantlar loyihasi yaratilishi kerak. Bundan tashqari, Xususiyatlar modelida allaqachon aniqlangan xususiyatlarga ega bo'lish tavsiya etiladi. Ushbu qadamlar bo'yicha yordam olish uchun pure::variants hujjatlariga murojaat qiling.
Haqiqiy import Loyihalar kontekst menyusida Import… amalini tanlash orqali boshlanadi view yoki Import… menyusidagi File menyu. Variantlarni boshqarish toifasidan Variant modellari yoki loyihalarni tanlang va Keyingiga bosing. Keyingi sahifada oilaviy modelni manba papkalaridan import qilish-ni tanlang va yana Keyingiga bosing.
Import qilish uchun manba kodi turini tanlang
Import ustasi paydo bo'ladi (1-rasmga qarang, "Import qilinishi mumkin bo'lgan manba kodining turini tanlash uchun import ustasi sahifasi"). Import qilinadigan loyiha turini tanlang va Keyingiga bosing. Har bir tur oldindan belgilangan to'plamni o'z ichiga oladi file modelga import qilinadigan turlar.
Rasm 1. Import qilinishi mumkin bo'lgan manba kodining turini tanlash uchun import ustasi sahifasiManba va maqsadni tanlang
Keyingi sehrgar sahifasida (2-rasm, “Import uchun manba va maqsadni tanlash uchun import ustasi sahifasi”) manba katalogi va maqsadli model ko'rsatilishi kerak.
Import qilinadigan manba kodi mavjud katalogni tanlash uchun Browse… tugmasini bosing. Sukut bo'yicha joriy ish maydoni tanlangan, chunki bu navigatsiyani boshlash uchun foydali nuqta bo'lishi mumkin.
Quyida siz namunani kiritish va chiqarib tashlashni belgilashingiz mumkin. Ushbu naqsh java muntazam ifodalari bo'lishi kerak. Manba ildiz papkasiga nisbatan har bir kirish yo'li ushbu naqsh bilan tekshiriladi. Agar qo'shilgan naqsh mos bo'lsa, chiqarib tashlash namunasi mos kelmasa, jild import qilinadi. Ya'ni, qo'shilish namunasi import qilinadigan papkalarni oldindan tanlaydi, istisno naqsh bu oldindan tanlashni cheklaydi.
Manba kodi katalogini tanlagandan so'ng maqsadli modelni aniqlash kerak. Shuning uchun variant loyihasini yoki model saqlanishi kerak bo'lgan papkani tanlang va model nomini kiriting. The file nom, agar ushbu dialog oynasida berilmagan bo'lsa, .ccfm kengaytmasi bilan avtomatik ravishda kengaytiriladi. Odatiy bo'lib, u model nomi bilan bir xil nomga o'rnatiladi. Bu tavsiya etilgan sozlamalar.
Maqsadli manba papkasi va kerakli model nomi ko'rsatilgandan so'ng, "Finish" tugmasini bosish orqali dialog oynasi tugatilishi mumkin. Agar "Keyingi" tugmasi bosilsa, qo'shimcha sozlamalarni amalga oshirish mumkin bo'lgan boshqa sahifa paydo bo'ladi.
Rasm 2. Import uchun manba va maqsadni tanlash uchun import ustasi sahifasiImport sozlamalarini o'zgartirish
Sehrgarning oxirgi sahifasida (Shakl 3, “Individual konfiguratsiyani aniqlash uchun import ustasi sahifasi”) import qilinadigan dasturiy taʼminot loyihasi uchun import xatti-harakatlarini sozlash uchun bajarilishi mumkin boʻlgan afzalliklar mavjud.
Muloqot sahifasi jadvalni ko'rsatadi, bu erda file import jarayonida hisobga olinadigan turlar aniqlanadi.
Har bir qator to'rtta maydondan iborat.

• Tavsif maydonida aniqlash uchun qisqa tavsiflovchi matn mavjud file turi.
• The File nom namunasi maydoni tanlash uchun ishlatiladi files maydonlar qiymatiga mos kelganda import qilinadi. Maydon quyidagi sintaksisdan foydalanadi:

1. Eng keng tarqalgan foydalanish holati a bo'lishi mumkin file kengaytma. Odatiy sintaksis - .EXT, bu erda EXT - kerakli file kengaytmasi (masalan, .java).
2. Yana bir keng tarqalgan holat - bu alohida file, make kabifile. Shuning uchun, aniq mos kelishi mumkin file nomi. Buning uchun shunchaki kiriting file maydonga nom kiriting (masalan, build.xml).
3. Ba'zi hollarda xaritalash istaklari aniqroq, shuning uchun faqat filemaxsus naqshga mos keladigan s import qilinishi kerak. Bu talabga mos kelish uchun File nom namunasi maydoni.
   Muntazam iboralar sintaksisini tavsiflash bu yordamning maqsadidan oshib ketadi. Iltimos, sof::variants foydalanuvchi qoʻllanmasidagi (masalan, .*) mos yozuvlar bobining oddiy iboralar boʻlimiga murojaat qiling.

• Mapped element type maydoni a o'rtasidagi xaritalashni o'rnatadi file turi va sof::variants oila elementi turi. Oila elementi turi manba uchun tavsiflovchi hisoblanadi file import qilingan modeldagi xaritalangan elementga qo'shimcha ma'lumot berish uchun. Odatda tanlovlar ps:class yoki ps:makefile.
• Xaritalangan file turi maydoni a orasidagi xaritalashni o'rnatadi file turi va sof::variantlari file turi. The file pure::variants ni yozing - bu manba uchun tavsiflovchi file import qilingan modeldagi xaritalangan elementga qo'shimcha ma'lumot berish uchun. Odatiy tanlovlar amalga oshirish uchun nazarda tutiladi yoki ta'rif uchun def files.

Shakl 3. Shaxsiy konfiguratsiyani aniqlash uchun import ustasi sahifasiYangi file “Xarita qoʻshish” tugmasi yordamida turlarni qoʻshish mumkin. Barcha maydonlar aniqlanmagan qiymat bilan to'ldiriladi va foydalanuvchi tomonidan to'ldirilishi kerak. Maydondagi qiymatni tahrirlash uchun sichqoncha bilan maydonni bosish kifoya. Qiymat tahrirlanadigan bo'ladi va o'zgartirilishi mumkin. Standartni o'zgartirish mumkin emas file jadval naqshlarini nomlash. Moslashtirishni moslashuvchan qilish uchun a ni bekor qilish mumkin file qatorni bekor qilish orqali yozing. Tanlov bekor qilindi file nom namunalari konfiguratsiyada qoladi, lekin import qiluvchi tomonidan foydalanilmaydi. Foydalanuvchi aniqlangan file Xaritani olib tashlash tugmasi yordamida turlarni yana olib tashlash mumkin.
Odatiy bo'lib Boshqa files file nom namunasi jadvalda mavjud, lekin tanlov bekor qilingan. Odatda hammasini import qilish istamaydi files, lekin bu tegishli qatorni tanlash orqali osongina o'zgartirilishi mumkin.
Import qiluvchining xatti-harakatlarini sozlash uchun uchta umumiy import varianti mavjud.

• Kataloglarni mos kelmasdan import qilmang files (masalan, CVS kataloglari).
  Agar import qiluvchi mos kelmaydigan katalogni topsa file unda va hech bir quyi katalogda mos kelmaydigan joy mavjud file, katalog import qilinmaydi. Agar loyihalar CVS kabi versiyalarni boshqarish tizimlari tomonidan boshqarilsa, bu ko'pincha foydalidir. CVS uchun har bir tegishli katalogda ahamiyatsiz bo'lgan CVS-katalog mavjud files saqlanadi. Agar ushbu parametr tanlansa va CVS-files hech biriga mos kelmaydi file yuqorida belgilangan turdagi, katalog Oilaviy Modelga komponent sifatida import qilinmaydi.
• Saralash files va kataloglar.
  Saralash uchun ushbu parametrni yoqing files va kataloglarning har biri alifbo tartibida.
• Import yo'lini boshqarish.
  Keyinchalik sinxronizatsiya qilish uchun importer barcha import qilingan elementlarning asl yo'lini modelga saqlashi kerak.
  Ko'p hollarda Oila modellari boshqa foydalanuvchilar bilan baham ko'riladi. Katalog tuzilishi har bir foydalanuvchi uchun har xil bo'lishi mumkin. Eng keng tarqalgan foydalanish stsenariylarini qo'llab-quvvatlash uchun importer turli rejimlarda ishlashi mumkin:

Mutlaq	Import qilingan elementga mutlaq yo'l modelda saqlanadi. Keyinchalik sinxronlash uchun va transformatsiya paytida files birinchi import paytida bo'lgani kabi bir xil joyga joylashtirilishi kerak.
Ish maydoniga nisbatan	Yo'llar ish maydoni papkasiga nisbatan saqlanadi. Sinxronizatsiya uchun files Eclipse ish maydonining bir qismi bo'lishi kerak. Transformatsiya Eclipse ish maydonidan kirish katalogi sifatida foydalanishi kerak.
Loyihaga nisbatan	Yo'llar loyihaga nisbatan saqlanadi. Sinxronizatsiya uchun files Eclipse ichidagi loyihaning bir qismidir. Transformatsiya loyiha papkasidan kirish katalogi sifatida foydalanishi kerak.
Yo'lga nisbatan	Yo'llar berilgan yo'lga nisbatan saqlanadi. Sinxronizatsiya uchun filelar aynan bir xil joyga joylashtirilishi kerak. Transformatsiya kiritish katalogi import paytidagi nisbiy yo'l bilan bir xil bo'ladi.

Ushbu dialog oynasining barcha afzalliklari doimiy ravishda saqlanadi. Shaxsiy sozlashlar har safar import boshlanganda qayta bajarilmasligi kerak. Bu import ish jarayonini oson va tez qiladi.
2.3. Katalog daraxtidan modellarni yangilash
Sinxronizatsiya tugmasini bosing import qilingan modelni katalog yo'li bilan sinxronlashtirish uchun. Loyihaning ildiz yo'li modelda saqlanadi, shuning uchun u avvalgidek bir xil katalogga sinxronlanadi. Sinxronizatsiya tugmasini yoqish uchun modelni oching va istalgan elementni tanlang. Sinxronlashtirish tugmachasini bosgandan so'ng, joriy Oila modeli va joriy katalog tuzilmasining modeli qarama-qarshi bo'lgan Taqqoslash muharriri ochiladi (4-rasmga qarang, "Taqqoslash muharririda katalog daraxtidan modelni yangilash").
Shakl 4. Taqqoslash muharriridagi Katalog daraxtidan model yangilanishi   Taqqoslash muharriri barcha pure::variants versiyalarida model versiyalarini solishtirish uchun ishlatiladi, lekin bu holda jismoniy katalog tuzilishini (pastki o'ng tomonda ko'rsatilgan) joriy sof::variants modeli (pastki chap tomon) bilan solishtirish uchun ishlatiladi. Barcha o'zgarishlar tahrirlovchining yuqori qismida ta'sirlangan elementlar bo'yicha tartiblangan alohida elementlar sifatida ko'rsatilgan.
Ushbu ro'yxatdagi elementni tanlash ikkala modeldagi tegishli o'zgarishlarni ta'kidlaydi. Sobiqample, qo'shilgan element o'ng tomonda quti bilan belgilanadi va chap tomonda modeldagi mumkin bo'lgan holati bilan bog'lanadi. Yuqori va pastki muharrir oynalari o'rtasida birlashtirish asboblar paneli katalog daraxti modelidan Xususiyat modeliga bir butun yoki hatto barcha (ziddiyatsiz) o'zgarishlarni nusxalash uchun vositalarni taqdim etadi.
Eslatma
Sinxronizatsiya oxirgi ishlatilgan importer sozlamalari bilan amalga oshiriladi. Bu import amalga oshirilganda modelni boshqa sozlamalar bilan yangilash imkonini beradi.

Relation Indexer-dan foydalanish

Manba kodini boshqarish uchun ulagich aloqalarni yaxshilaydi View pure::variants model elementlari va manba kodi o'rtasidagi aloqalar haqida ma'lumot bilan. Aloqalar ps:condxml va ps:condtext elementlari sharoitida ishlatiladigan xususiyatlar uchun qo'shiladi.
Ps: bayroq va ps: bayroq uchunfile C/C++ manbasida preprotsessor konstantalarining joylashishini elementlar files ko'rsatilgan. Bundan tashqari, tanlangan xususiyat uchun mos keladigan preprotsessor konstantalarining joylashuvi xususiyatning noyob nomlari va preprotsessor konstantalari o'rtasidagi xaritalash yordamida ko'rsatiladi.
3.1. Loyihaga aloqalar indeksatorini qo'shish
Aloqa indeksatori loyihaning maxsus mulk sahifasida faollashtirilishi mumkin. Loyihani tanlang va kontekst menyusidagi Xususiyatlar bandini tanlang. Kelgusi muloqot oynasida Relation Indexer sahifasini tanlang.
Shakl 5. Munosabatlar indeksi uchun loyiha mulk sahifasi

Munosabat indeksatori loyiha uchun Enable Relation Indexer variantini tanlash orqali faollashtiriladi (1). Indeksatorni ishga tushirgandan so'ng, loyihaning o'ziga xos xatti-harakatlarini aniqlash uchun yana bir nechta variant mavjud. Pure::variants shartlari va C/C++ preprotsessor konstantalarini indekslash alohida faollashtirilishi mumkin (2). bilan ro'yxat file nom naqshlari (3) ni tanlash uchun ishlatiladi files indekslash uchun. Faqat filenaqshlardan biriga mos keladigan s skanerlanadi. Hammasini skanerlash uchun naqsh sifatida “*” qo‘shing fileloyihaning s.
Loyiha uchun indekser faollashtirilgandan so'ng loyihaga quruvchi qo'shiladi. Bu quruvchi skanerlari oʻzgartirildi files yangi munosabatlar uchun sof::variants model elementlarini avtomatik ravishda.
3.2. Manba kodeksi bilan munosabatlar
Faollashtirilgan munosabat indeksi bilan Relations View qo'shimcha yozuvlarni o'z ichiga oladi. Ushbu yozuvlar nomini ko'rsatadi file va variant nuqtasi satr raqami. Asbob uchi tegishli bo'limni ko'rsatadi file. Kirishni ikki marta bosish orqali file muharrirda ochiladi.
pure::variants Shartlar
Pure::variants sharti a ning bo‘limlarini kiritish yoki chiqarib tashlash uchun ishlatilishi mumkin file xususiyatni tanlashga bog'liq. Condition Indexer bunday qoidalarni tekshiradi va havola qilingan xususiyatlarni chiqaradi. Agar muharrirda bunday xususiyat tanlangan bo'lsa, Aloqalar View hammasini ko'rsatadi files va tanlangan xususiyatga ega shart joylashgan satrlar (6-rasmga qarang, “Munosabatlarda shartni aks ettirish View”).
Shakl 6. Munosabatlarda shartning ifodalanishi ViewShartlarni qanday aniqlash haqida batafsil tushuntirish olish uchun sof::variants foydalanuvchi qo‘llanmasining 9.5.7-bobining ps:condtext bo‘limiga murojaat qiling (Ma’lumotnoma–>Oldindan belgilangan manba elementi turlari–>ps:condtext).
C/C++ preprotsessor konstantalari
C/C++ Preprocessor Indexer skanerlaydi files preprotsessor qoidalarida ishlatiladigan konstantalar uchun (masalan, #ifdef, #ifndef, …).
Agar ps: bayroq yoki ps: bayroqfile elementi Aloqalar tanlanadi View belgilangan preprotsessor konstantasidan foydalanishni ko'rsatadi.
Aloqalar View shuningdek, xaritalash naqshlari yordamida xususiyatlar bilan bog'langan preprotsessor konstantalarini ko'rsatadi. Buning uchun naqshlar tanlangan xususiyat ma'lumotlari bilan kengaytiriladi. Olingan belgilar mos keladigan preprotsessor konstantalarini qidirish uchun ishlatiladi. 7-rasm, “Aloqalarda C/C++ preprotsessor konstantining ifodalanishi View” sobiqni ko'rsatadiample naqshli shuhrat {Name}. Naqsh xususiyatning noyob nomi bilan fameNative uchun kengaytirilgan. Indekslangan kodda fameNative protsessor doimiysi qo'llaniladigan 76 ta joy mavjud.
Bu joylar Aloqalar bo'limida ko'rsatilgan View. Naqshlar afzalliklarda aniqlanishi mumkin (3.3-bo'lim, "Afzalliklar" ga qarang).
7-rasm. C/C++ preprotsessor konstantasining munosabatlarda ko‘rinishi View

3.3. Afzalliklar
Indeksatorning standart xatti-harakatlarini o'zgartirish uchun Eclipse afzalliklarini oching va Variantlarni boshqarish toifasida Relation Indexer sahifasini tanlang. Sahifada ikkita ro'yxat ko'rsatilgan.
Shakl 8. Munosabat indekslovchi afzal sahifasiYuqori ro'yxat standartni o'z ichiga oladi file indeksator uchun naqshlar (1). Ushbu ro'yxat yangi yoqilgan loyihalar uchun dastlabki namuna sozlamalari.
Pastki ro'yxatda xususiyatlar va protsessor konstantalari o'rtasidagi xaritalash mavjud (2). Ushbu xaritalash barcha loyihalar uchun ishlatiladi. 1-jadval, "Qo'llab-quvvatlanadigan xaritalarni almashtirishlar" barcha mumkin bo'lgan almashtirishlarni ko'rsatadi.
Jadval 1. Qo'llab-quvvatlanadigan xaritalarni almashtirish

Joker belgi	Tavsif	Example: XususiyatA
Ism	tanlangan xususiyatning noyob nomi	FLAG_{Ism} – FLAG_FeatureA
NAME	bosh harf tanlangan xususiyatning Noyob nomi	FLAG_{NAME} – FLAG_FEATUREA
nomi	kichik harf tanlangan xususiyatning Noyob nomi	bayroq_{ism} - bayroq_featurea

Hujjatlar / manbalar

pure-systems 2024 Manba kodini boshqarish dasturi uchun ulagich [pdf] Foydalanuvchi qo‘llanmasi 2024, 2024 Manba kodini boshqarish dasturi uchun ulagich, manba kodini boshqarish dasturi uchun ulagich, manba kodini boshqarish dasturi, boshqaruv dasturi, dasturiy ta’minot

Ma'lumotnomalar

• Foydalanuvchi uchun qo'llanma