pure::variants – üçün birləşdirici
Mənbə Kodu İdarəetmə Təlimatı
Parametric Technology GmbH
Saf::variant 6.0.7.685 üçün versiya 6.0
Copyright © 2003-2024 Parametric Technology GmbH
2024
Giriş
pure::variants Mənbə Kodu İdarəetmə Konnektoru (Connector) tərtibatçılara saf::variantlardan istifadə edərək mənbə kodu dəyişkənliyini idarə etməyə imkan verir. Saf::variantların mənbə kodunun idarə edilməsi kataloq strukturlarını və mənbə kodunu sinxronlaşdırmaq üçün çevik imkan verir. filepure::variants modelləri ilə asanlıqla. Beləliklə, variantların idarə edilməsi hətta mürəkkəb proqram layihələrinə də tətbiq oluna bilər. Bundan əlavə, pure::variants xüsusiyyətləri və mənbə kodu arasında əlaqə qurucu ilə daha asan idarə oluna bilər və mənbə kodunun idarə edilməsi vasitəsilə yüksək dərəcədə əlçatandır.
1.1. Proqram Tələbləri
Mənbə Kodunun İdarə Edilməsi üçün təmiz::variants Konnektoru saf::variantların genişləndirilməsidir və bütün dəstəklənən platformalarda mövcuddur.
1.2. Quraşdırma
Konnektorun quraşdırılması haqqında ətraflı məlumat üçün pure::variants Konnektorlar bölməsinə müraciət edin (menyu Help -> Help Contents və sonra pure::variants Quraşdırma Bələdçisi -> pure::variants Bağlayıcılar).
1.3. Bu təlimat haqqında
Oxucunun pure::variants haqqında əsas biliyə və təcrübəyə malik olması gözlənilir. Bu təlimatı oxumazdan əvvəl onun giriş materialı ilə tanış olun. Təlimat onlayn yardımda, həmçinin çap edilə bilən PDF formatında burada mövcuddur.
Bağlayıcıdan istifadə
2.1. Saf::variantlardan başlayaraq
İstifadə olunan quraşdırma metodundan asılı olaraq ya pure::variants-aktiv Eclipse-i işə salın və ya Windows altında proqram menyusundan pure::variants elementini seçin.
Variant İdarəetmə perspektivi artıq aktivləşdirilməyibsə, bunu Pəncərə menyusunda Açıq Perspektiv->Digər…-dən seçməklə edin.
2.2. Kataloq ağacını Ailə Modelinə idxal edin
Kataloq ağacını Ailə Modelinə idxal etməzdən əvvəl variantlar layihəsi yaradılmalıdır. Bundan əlavə, artıq Xüsusiyyət Modelində müəyyən edilmiş xüsusiyyətlərin olması məsləhətdir. Bu addımlarla bağlı yardım üçün pure::variants sənədlərinə müraciət edin.
Faktiki idxal ya Layihələrin kontekst menyusunda İdxal… əməliyyatını seçməklə başlanır view və ya İdxal... menyusunda File menyu. Variant İdarəetmə kateqoriyasından Variant Modelləri və ya Layihələri seçin və Next düyməsini basın. Növbəti səhifədə mənbə qovluqlarından Ailə Modelini Import seçin və yenidən Next düyməsini basın.
Import etmək üçün mənbə kodunun növünü seçin
İdxal köməkçisi görünür (bax Şəkil 1, “İdxal edilə bilən mənbə kodunun növünü seçmək üçün idxal sihirbazının səhifəsi”). Import etmək üçün layihə növünü seçin və Next düyməsini basın. Hər bir növ əvvəlcədən təyin edilmiş dəsti ehtiva edir file modelə idxal etmək üçün növlər.
Şəkil 1. İdxal edilə bilən mənbə kodunun növünü seçmək üçün idxal sihirbazının səhifəsi
Mənbə və Hədəf seçin
Növbəti sehrbaz səhifəsində (Şəkil 2, “İdxal üçün mənbə və hədəf seçmək üçün idxal sihirbazının səhifəsi”) mənbə kataloqu və hədəf modeli göstərilməlidir.
İdxal edilməli olan mənbə kodunun mövcud olduğu qovluğu seçmək üçün Browse… düyməsini basın. Defolt olaraq cari iş sahəsi seçilir, çünki bu naviqasiyaya başlamaq üçün faydalı nöqtə ola bilər.
Aşağıda nümunə daxil etmə və xaric etməni təyin edə bilərsiniz. Bu nümunə java müntəzəm ifadələri olmalıdır. Mənbə kök qovluğuna nisbətən hər bir giriş yolu bu nümunə ilə yoxlanılır. Daxil edilmiş nümunə uyğun gəlirsə, istisna nümunəsi uyğun gəlmirsə, qovluq idxal edilir. Daxil etmək nümunəsi idxal etmək üçün qovluqları əvvəlcədən seçir, istisna nümunəsi bu ön seçimi məhdudlaşdırır.
Mənbə kodu kataloqu seçildikdən sonra hədəf modeli müəyyən edilməlidir. Buna görə də modelin saxlanacağı variant layihəsini və ya qovluğu seçin və model adını daxil edin. The file ad, bu dialoq qutusunda verilmədiyi təqdirdə avtomatik olaraq .ccfm genişlənməsi ilə uzadılır. Defolt olaraq o, model adının özü ilə eyni ada təyin ediləcək. Bu tövsiyə edilən parametrdir.
Məqsədli mənbə qovluğu və istədiyiniz model adı göstərildikdən sonra Bitir düyməsini basmaqla dialoq tamamlana bilər. Sonrakı düyməsi sıxılırsa, əlavə parametrlərin edilə biləcəyi başqa bir səhifə gələcək.
Şəkil 2. İdxal üçün mənbə və hədəf seçmək üçün idxal sihirbazının səhifəsi
İdxal üstünlüklərini dəyişdirin
Son sehrbaz səhifəsində (Şəkil 3, “Fərdi konfiqurasiyanı müəyyən etmək üçün idxal sihirbazının səhifəsi”) idxal edilmiş proqram layihəsi üçün idxal davranışını fərdiləşdirmək üçün edilə bilən üstünlüklər var.
Dialoq səhifəsində cədvəl göstərilir file idxal prosesində nəzərə alınacaq növlər müəyyən edilir.
Hər bir xətt dörd sahədən ibarətdir.
- Təsvir sahəsində müəyyən etmək üçün qısa təsviri mətn var file növü.
- The File ad nümunəsi sahəsindən seçmək üçün istifadə olunur files sahələrin dəyərinə uyğun gələndə idxal ediləcək. Sahə aşağıdakı sintaksisdən istifadə edir:
- Ən çox istifadə olunan hal a ola bilər file uzadılması. Adi sintaksis .EXT-dir, burada EXT arzu olunandır file genişləndirilməsi (məsələn, .java).
- Başqa bir ümumi vəziyyət xüsusidir file, bir make kimifile. Buna görə də dəqiq uyğunlaşmaq mümkündür file ad. Bunu etmək üçün sadəcə daxil edin file sahəyə ad daxil edin (məsələn, build.xml).
- Bəzi hallarda xəritəçəkmə istəkləri daha spesifikdir, buna görə də yalnız filexüsusi nümunəyə uyğun gələnlər idxal edilməlidir. Bu tələbi yerinə yetirmək üçün normal ifadələrdən istifadə etmək olar File ad nümunəsi sahəsi.
Müntəzəm ifadələrin sintaksisini təsvir etmək bu yardımın məqsədini aşır. Zəhmət olmasa, pure::variants istifadəçi təlimatında (məsələn .*) istinad fəslinin müntəzəm ifadələr bölməsinə müraciət edin.
- Xəritələnmiş element növü sahəsi a arasında xəritələşdirməni təyin edir file növü və təmiz::variants ailə element növü. Ailə elementinin növü mənbə üçün deskriptordur file idxal edilmiş modeldə xəritələnmiş elementə əlavə məlumat vermək. Tipik seçimlər ps:class və ya ps:makedirfile.
- Xəritəli file type sahəsi a arasında xəritələşdirməni təyin edir file növü və təmiz::variantları file növü. The file pure::variants yazın mənbə üçün deskriptordur file idxal edilmiş modeldə xəritələnmiş elementə əlavə məlumat vermək. Tipik seçimlər tətbiqlər üçün nəzərdə tutulur və ya tərif üçün defdir files.
Şəkil 3. Fərdi konfiqurasiyanı təyin etmək üçün idxal sihirbazının səhifəsi
Yeni file növlər Xəritəçəkmə əlavə et düyməsini istifadə etməklə əlavə edilə bilər. Bütün sahələr qeyri-müəyyən dəyərlə doldurulur və istifadəçi tərəfindən doldurulmalıdır. Sahədə dəyəri redaktə etmək üçün siçan ilə sahəyə klikləyin. Dəyər redaktə edilə bilən olur və dəyişdirilə bilər. Standartı dəyişdirmək mümkün deyil file cədvəlin ad nümunələri. Fərdiləşdirməni çevik etmək üçün seçimi ləğv etmək mümkündür a file sıra seçimini ləğv edərək yazın. Seçimi ləğv edildi file ad nümunələri konfiqurasiyada qalır, lakin idxalçı tərəfindən istifadə edilməyəcək. İstifadəçi müəyyən edilmişdir file növlər Xəritəçəkməni Sil düyməsini istifadə etməklə yenidən silinə bilər.
Varsayılan olaraq Digər files file ad nümunəsi cədvəldə mövcuddur, lakin seçimi silinib. Bir qayda olaraq, hamısını idxal etmək istənmir files, lakin bu, müvafiq sıranı seçməklə asanlıqla dəyişdirilə bilər.
İdxalçının davranışını fərdiləşdirmək üçün üç ümumi idxal variantı var.
- Uyğunlaşmadan qovluqları idxal etməyin files (məsələn, CVS qovluqları).
İdxalçı uyğun olmayan bir kataloq tapsa file içərisindədir və heç bir alt kataloqun uyğunluğu yoxdur file, kataloq idxal edilməyəcək. Layihələr CVS kimi versiya idarəetmə sistemləri tərəfindən idarə olunursa, bu, çox vaxt faydalıdır. CVS üçün hər bir müvafiq qovluq uyğun olmayan yerlərdə CVS-kataloqdan ibarətdir files saxlanılır. Bu seçim seçilibsə və CVS-files heç birinə uyğun gəlmir file yuxarıda müəyyən edilmiş növ, kataloq Ailə Modelinə komponent kimi idxal edilməyəcək. - Sırala files və kataloqlar.
Çeşidləmək üçün bu seçimi aktiv edin files və qovluqların hər biri əlifba sırası ilə. - İdxal yolu ilə işləmə.
Əlavə sinxronizasiya üçün idxalçı bütün idxal edilmiş elementlərin orijinal yolunu modeldə saxlamalıdır.
Bir çox hallarda Ailə Modelləri digər istifadəçilərlə paylaşılır. Kataloq strukturu hər bir istifadəçi üçün fərqli ola bilər. Ən ümumi istifadə ssenarilərini dəstəkləmək üçün idxalçı müxtəlif rejimlərdə işləyə bilər:
| Mütləq | Import edilmiş elementə gedən mütləq yol modeldə saxlanacaq. Sonrakı sinxronizasiya üçün və transformasiya zamanı files ilk idxal zamanı olduğu kimi eyni yerə yerləşdirilməlidir. |
| İş sahəsinə nisbətən | Yollar iş sahəsi qovluğuna nisbətən saxlanılır. Sinxronizasiya üçün files Eclipse iş sahəsinin bir hissəsi olmalıdır. Transformasiya Eclipse iş sahəsini giriş kataloqu kimi istifadə etməlidir. |
| Layihə ilə əlaqədar | Yollar layihəyə nisbətən saxlanılır. Sinxronizasiya üçün files Eclipse daxilindəki layihənin bir hissəsidir. Transformasiya layihə qovluğundan giriş qovluğu kimi istifadə etməlidir. |
| Yola nisbətən | Yollar verilmiş yola nisbətən saxlanılır. Sinxronizasiya üçün files tam eyni yerdə yerləşdirilməlidir. Transformasiya daxiletmə kataloqu idxal zamanı nisbi yol ilə eynidir. |
Bu dialoqun bütün üstünlükləri davamlı olaraq saxlanılır. Şəxsi fərdiləşdirmələr idxalın hər dəfə yerinə yetirilməsində təkrar edilməməlidir. Bu, idxal iş prosesini asan və sürətli edir.
2.3. Kataloq ağacından modellərin yenilənməsi
Sinxronizasiya düyməsini basın 
idxal edilmiş modeli kataloq yolu ilə sinxronlaşdırmaq üçün. Layihənin kök yolu modeldə saxlanılır ki, o, əvvəlki kimi eyni kataloqla sinxronlaşdırılsın. Sinxronizasiya düyməsini aktivləşdirmək üçün modeli açın və istənilən elementi seçin. Sinxronizasiya düyməsini basdıqdan sonra cari Ailə Modeli ilə cari kataloq strukturunun modelinin əks olunduğu yerdə Müqayisə Redaktoru açılır (bax Şəkil 4, “Müqayisə Redaktorunda Kataloq Ağacından model yeniləməsi”).
Şəkil 4. Müqayisə Redaktorunda Directory Tree-dən model yeniləməsi 
Müqayisə redaktoru bütün təmiz::variantlarda model versiyalarını müqayisə etmək üçün istifadə olunur, lakin bu halda fiziki kataloq strukturunu (aşağı sağ tərəfdə göstərilir) cari təmiz::variants modeli (aşağı sol tərəf) ilə müqayisə etmək üçün istifadə olunur. Bütün dəyişikliklər redaktorun yuxarı hissəsində təsirə məruz qalan elementlər üzrə sıralanmış ayrı-ayrı maddələr kimi qeyd olunur.
Bu siyahıda elementin seçilməsi hər iki modeldə müvafiq dəyişikliyi vurğulayır. Keçmişdəample, əlavə edilmiş element sağ tərəfdə bir qutu ilə qeyd olunur və sol tərəfdən modeldə onun mümkün mövqeyi ilə əlaqələndirilir. Redaktorun yuxarı və aşağı pəncərələri arasında birləşmə alətlər paneli kataloq ağacı modelindən Xüsusiyyət Modelinə bütövlükdə tək və ya hətta bütün (ziddiyyətsiz) dəyişiklikləri köçürmək üçün alətlər təqdim edir.
Qeyd
Sinxronizasiya son istifadə edilən idxalçı parametrləri ilə həyata keçirilir. Bu, modeli idxal zamanı edilən digər parametrlərlə yeniləməyə imkan verir.
Əlaqələr İndeksatorundan istifadə
Mənbə kodunun idarə edilməsi üçün birləşdirici əlaqələri gücləndirir View pure::variants model elementləri və mənbə kodu arasında əlaqələr haqqında məlumat. Əlaqələr ps:condxml və ps:condtext elementlərinin şərtlərində istifadə olunan xüsusiyyətlər üçün əlavə edilir.
ps:bayraq və ps:bayraq üçünfile C/C++ mənbəyində preprosessor sabitlərinin yerini elementlər files göstərilir. Bundan əlavə, funksiyanın unikal adları və preprosessor sabitləri arasında xəritəçəkmədən istifadə etməklə seçilmiş funksiya üçün uyğun olan preprosessor sabitlərinin yerləri göstərilir.
3.1. Münasibət İndeksatorunun Layihəyə əlavə edilməsi
Münasibətlərin indeksatoru xüsusi layihə mülkiyyət səhifəsində aktivləşdirilə bilər. Layihəni seçin və kontekst menyusunda Xüsusiyyətlər elementini seçin. Qarşıdan gələn dialoqda Əlaqələr İndeksi səhifəsini seçin.
Şəkil 5. Münasibətlərin İndeksatoru üçün Layihə Mülkiyyət Səhifəsi
Münasibət indeksləşdiricisi layihə üçün Münasibətlər indeksləşdiricisini aktivləşdir seçimini (1) seçməklə aktivləşdirilir. İndeksləyicini işə saldıqdan sonra layihənin xüsusi davranışını müəyyən etmək üçün daha bir neçə variant var. Pure::variants Şərtlərinin və C/C++ Preprosessor Sabitlərinin indeksləşdirilməsi ayrıca aktivləşdirilə bilər (2). Siyahı ilə file ad nümunələri (3) seçmək üçün istifadə olunur files indeksləşdirmə üçün. Yalnız filenaxışlardan birinə uyğun gələn s skan edilir. Hamısını skan etmək üçün nümunə kimi “*” əlavə edin filebir layihənin s.
Layihə üçün indeksləşdirici aktivləşdirildikdən sonra layihəyə inşaatçı əlavə olunur. Bu qurucu skanları dəyişdirildi files yeni əlaqələr üçün təmiz::variants model elementləri avtomatik olaraq.
3.2. Mənbə Məcəlləsi ilə əlaqələr
Aktivləşdirilmiş əlaqə indeksi ilə Əlaqələr View əlavə qeydləri ehtiva edir. Bu girişlər adını göstərir file və variant nöqtəsinin sətir nömrəsi. Alətin ucu müvafiq bölməni göstərir file. Girişə iki dəfə klikləməklə file redaktorda açılacaq.
pure::variants Şərtlər
Saf::variants şərti a-nın bölmələrini daxil etmək və ya xaric etmək üçün istifadə edilə bilər file xüsusiyyət seçimindən asılı olaraq. Vəziyyət İndeksatoru belə qaydaları skan edir və istinad edilən xüsusiyyətləri çıxarır. Əgər belə bir funksiya redaktorda seçilibsə, Əlaqələr View hamısını göstərəcək files və seçilmiş xüsusiyyəti olan şərtin yerləşdiyi sətirlər (bax Şəkil 6, “Əlaqələrdə bir şərtin təmsili View”).
Şəkil 6. Münasibətlərdə Şərtin Təqdimatı View
Şərtlərin necə müəyyən edilməsinə dair ətraflı izahat əldə etmək üçün pure::variants İstifadəçi Təlimatının 9.5.7-ci fəslinin ps:condtext bölməsinə müraciət edin (İstinad–>Öncədən təyin edilmiş Mənbə Element Növləri–>ps:condtext).
C/C++ preprosessor sabitləri
C/C++ Preprocessor Indexer skan edir files preprosessor qaydalarında istifadə olunan sabitlər üçün (məsələn, #ifdef, #ifndef, …).
Əgər ps:bayraq və ya ps:bayraqfile element Əlaqələr seçilir View müəyyən edilmiş preprosessor sabitinin istifadəsini göstərir.
Münasibətlər View həmçinin xəritəçəkmə nümunələrindən istifadə etməklə xüsusiyyətlərə qoşulmuş preprosessor sabitlərini göstərir. Bunun üçün nümunələr seçilmiş xüsusiyyətin məlumatları ilə genişləndirilir. Alınan simvollar uyğun gələn preprosessor sabitlərini axtarmaq üçün istifadə olunur. Şəkil 7, “Münasibətlərdə C/C++ preprosessor sabitinin təmsili View” keçmişi göstərirample {Name} naxışı ilə. Nümunə xüsusiyyətin unikal adı ilə fameNative-ə genişlənir. İndekslənmiş kodda fameNative preprosessor sabitinin istifadə olunduğu 76 yer var.
Bu yerlər Əlaqələr bölməsində göstərilir View. Nümunələr üstünlüklərdə müəyyən edilə bilər (bax: Bölmə 3.3, “Tercihlər”).
Şəkil 7. Əlaqələrdə C/C++ Preprosessor Sabitinin təmsili View
3.3. Üstünlüklər
İndeksləşdiricinin standart davranışını dəyişdirmək üçün Eclipse üstünlüklərini açın və Variant İdarəetmə kateqoriyasında Əlaqələr İndeksatoru səhifəsini seçin. Səhifədə iki siyahı göstərilir.
Şəkil 8. Relation Indexer Preference səhifəsi
Üst siyahıda standart var file indeksləşdirici üçün nümunələr (1). Bu siyahı yeni aktivləşdirilmiş layihələr üçün ilkin nümunə parametridir.
Aşağı siyahıda xüsusiyyətlər və preprosessor sabitləri arasında xəritə var (2). Bu xəritələmə bütün layihələr üçün istifadə olunur. Cədvəl 1, “Dəstəklənən Xəritəçəkmə Dəyişdirmələri” bütün mümkün dəyişdirmələri göstərir.
Cədvəl 1. Dəstəklənən Xəritəçəkmə Dəyişdirmələri
| Joker simvol | Təsvir | Example: XüsusiyyətA |
| ad | seçilmiş funksiyanın Unikal Adı | FLAG_{Ad} – FLAG_FeatureA |
| NAME | böyük hərf seçilmiş funksiyanın Unikal Adı | FLAG_{NAME} – FLAG_FEATUREA |
| ad | kiçik hərf seçilmiş funksiyanın Unikal Adı | bayraq_{adı} – bayraq_xüsusiyyəti |
Sənədlər / Resurslar
 |
təmiz sistemlər 2024 Mənbə Kodu İdarəetmə Proqramı üçün Bağlayıcı [pdf] İstifadəçi Təlimatı 2024, 2024 Mənbə Kodu İdarəetmə Proqramı üçün Konnektor, Mənbə Kodu İdarəetmə Proqramı üçün Bağlayıcı, Mənbə Kodu İdarəetmə Proqramı, İdarəetmə Proqramı, Proqram təminatı |
