pure::variants – Bağlayıcı
Kaynak Kodu Yönetim Kılavuzu
Parametrik Teknoloji GmbH
pure::variants 6.0.7.685 için 6.0 sürümü
Telif Hakkı © 2003-2024 Parametric Technology GmbH
2024
giriiş
Kaynak Kodu Yönetimi için pure::variants Bağlayıcısı (Bağlayıcı), geliştiricilerin pure::variants kullanarak kaynak kodu değişkenliğini yönetmesini sağlar. pure::variants'ın Kaynak Kodu Yönetimi, dizin yapılarını ve kaynak kodunu senkronize etmek için esnek bir fırsat sunar files, pure::variants modelleriyle kolayca. Böylece varyant yönetimi, karmaşık yazılım projelerine bile uygulanabilir. Dahası, pure::variants özellikleri ve kaynak kodu arasındaki bağlantılar, oluşturucu ile daha kolay yönetilebilir ve Kaynak Kodu Yönetimi aracılığıyla oldukça erişilebilirdir.
1.1. Yazılım Gereksinimleri
Kaynak Kod Yönetimi için pure::variants Bağlayıcısı, pure::variants için bir eklentidir ve desteklenen tüm platformlarda mevcuttur.
1.2. Kurulum
Konnektörün nasıl kurulacağına ilişkin ayrıntılı bilgi için lütfen pure::variants Kurulum Kılavuzu'ndaki pure::variants Konnektörü bölümüne bakın (menü Yardım -> Yardım İçeriği ve ardından pure::variants Kurulum Kılavuzu -> pure::variants Konnektörü).
1.3. Bu kılavuz hakkında
Okuyucunun pure::variantlar hakkında temel bilgi ve deneyime sahip olması beklenir. Lütfen bu kılavuzu okumadan önce giriş materyaline bakın. Kılavuz çevrimiçi yardımda ve yazdırılabilir PDF formatında burada mevcuttur.
Bağlayıcıyı Kullanma
2.1. pure::variants'ı başlatma
Kullanılan kurulum yöntemine bağlı olarak, pure::variants özelliği etkinleştirilmiş Eclipse'i başlatın veya Windows altında program menüsünden pure::variants öğesini seçin.
Varyant Yönetimi perspektifi henüz etkinleştirilmemişse, Pencere menüsünde Perspektifi Aç->Diğer… seçeneğini seçerek etkinleştirin.
2.2. Bir Dizin Ağacını Bir Aile Modeline Aktarma
Bir dizin ağacını bir Aile Modeli'ne aktarmadan önce, bir varyantlar projesi oluşturulmalıdır. Ayrıca, bir Özellik Modelinde önceden tanımlanmış özelliklerin olması önerilir. Bu adımlar hakkında yardım için lütfen pure::variants belgelerine bakın.
Gerçek içe aktarma, Projeler bağlam menüsünden İçe Aktar... eylemi seçilerek başlatılır. view veya İçe Aktar… menüsüyle File menü. Variant Management kategorisinden Variant Models veya Projects'i seçin ve Next'e basın. Sonraki sayfada Import a Family Model from source folders'ı seçin ve tekrar Next'e basın.
İçe aktarılacak kaynak kodu türünü seçin
İçe aktarma sihirbazı görünür (bkz. Şekil 1, “İçe aktarılabilecek kaynak kodu türünü seçmek için içe aktarma sihirbazının sayfası”). İçe aktarılacak bir proje türü seçin ve İleri'ye basın. Her tür, önceden tanımlanmış bir dizi file modele aktarılacak tipler.
Şekil 1. İçe aktarılabilecek kaynak kodu türünü seçmek için içe aktarma sihirbazının sayfası
Kaynak ve Hedefi Seçin
Bir sonraki sihirbaz sayfasında (Şekil 2, “İçe aktarma sihirbazının içe aktarma için kaynak ve hedef seçme sayfası”) kaynak dizin ve hedef model belirtilmelidir.
İçeri aktarılması gereken kaynak kodunun bulunduğu dizini seçmek için Gözat… düğmesine basın. Varsayılan olarak geçerli çalışma alanı seçilir çünkü bu, gezinmeye başlamak için yararlı bir nokta olabilir.
Aşağıda include ve except desenini belirtebilirsiniz. Bu desenler Java düzenli ifadeleri olmalıdır. Kaynak kök klasörüne göre her giriş yolu bu desenle kontrol edilir. Include deseni eşleşirse, bir klasör içe aktarılır, eğer exclude deseni eşleşmezse. Yani include deseni içe aktarılacak klasörleri önceden seçer, exclude deseni bu ön seçimi kısıtlar.
Kaynak kod dizinini seçtikten sonra bir hedef model tanımlanmalıdır. Bu nedenle, modelin depolanacağı bir değişken proje veya klasör seçin ve bir model adı girin. file Bu iletişim kutusunda verilmezse, ad otomatik olarak .ccfm uzantısıyla genişletilir. Varsayılan olarak, model adının kendisiyle aynı ada ayarlanır. Bu önerilen ayardır.
Uygun bir kaynak klasörü ve istenen model adı belirtildikten sonra, Finish'e basılarak iletişim kutusu sonlandırılabilir. Next düğmesine basılırsa, ek ayarların yapılabileceği başka bir sayfa açılır.
Şekil 2. İçe aktarma sihirbazının içe aktarma için kaynak ve hedefi seçme sayfası
İçe Aktarma Tercihlerini Değiştir
Son sihirbaz sayfasında (Şekil 3, "Bireysel bir yapılandırmayı tanımlamak için içe aktarma sihirbazının sayfası”) İçe aktarılan yazılım projesi için içe aktarma davranışını özelleştirmek için yapılabilecek tercihler vardır.
İletişim kutusu sayfası, aşağıdakilerin yer aldığı bir tabloyu gösterir: file İthalat sürecinde dikkate alınacak tipler tanımlanır.
Her satır dört alandan oluşmaktadır.
- Açıklama alanı, ürünü tanımlayan kısa bir açıklayıcı metin içerir. file tip.
- The File isim deseni alanı seçmek için kullanılır fileAlan değerleriyle eşleştiklerinde içe aktarılacaklar. Alan aşağıdaki sözdizimini kullanır:
- En yaygın kullanım örneği şu olabilir: file uzantı. Genel sözdizimi .EXT'dir, burada EXT istenen uzantıdır file uzantı (örneğin .java).
- Bir diğer yaygın durum ise özel bir durumdur file, bir marka gibifileBu nedenle, tam olarak aynı eşleşmeyi yapmak mümkündür file adı. Bunu yapmak için, sadece şunu girin file Alana adını yazın (örneğin build.xml).
- Bazı durumlarda haritalama istekleri daha spesifiktir, bu nedenle yalnızca fileözel bir desene uyanlar içe aktarılmalıdır. Bu gereksinimi karşılamak için düzenli ifadeler kullanmak mümkündür File isim desen alanı.
Düzenli ifadelerin sözdizimini tanımlamak bu yardımın amacını aşacaktır. Lütfen pure::variants kullanıcı kılavuzunun referans bölümünün düzenli ifadeler bölümüne bakın (örn. .*).
- Eşlenen öğe türü alanı, bir öğe ile bir öğe arasındaki eşlemeyi ayarlar. file tür ve saf::variants ailesi eleman türü. Aile eleman türü, kaynak için bir tanımlayıcıdır file içe aktarılan modeldeki eşlenen öğeye daha fazla bilgi sağlamak için. Tipik seçimler ps:class veya ps:make'dirfile.
- Haritalanmış file tür alanı, bir ile bir arasındaki eşlemeyi ayarlar file tür ve saf::varyantlar file türü. file pure::variants türündeki tür, kaynak için bir tanımlayıcıdır file içe aktarılan modeldeki eşlenen öğeye daha fazla bilgi sağlamak için. Tipik seçimler, uygulamalar için impl veya tanım için def'tir files.
Şekil 3. Bireysel bir yapılandırmayı tanımlamak için içe aktarma sihirbazının sayfası
Yeni file türler Add Mapping düğmesi kullanılarak eklenebilir. Tüm alanlar tanımsız değerle doldurulur ve kullanıcı tarafından doldurulmalıdır. Bir alandaki değeri düzenlemek için fareyle alana tıklamanız yeterlidir. Değer düzenlenebilir hale gelir ve değiştirilebilir. Varsayılanı değiştirmek mümkün değildir file tablonun isim desenleri. Özelleştirmeyi esnek hale getirmek için, bir file satır seçimini kaldırarak yazın. Seçili değil file isim kalıpları yapılandırmada kalır ancak ithalatçı tarafından kullanılmaz. Kullanıcı tanımlı file Türler tekrar Eşlemeyi Kaldır düğmesi kullanılarak kaldırılabilir.
Varsayılan olarak Diğer files file tabloda ad deseni mevcuttur ancak seçili değildir. Genellikle tümünü içe aktarmak istenmez fileancak bu, ilgili satır seçilerek kolayca değiştirilebilir.
İthalatçının davranışını özelleştirmek için üç genel ithalat seçeneği vardır.
- Eşleşmeyen dizinleri içe aktarmayın files (örneğin CVS dizinleri).
İthalatçı eşleşen bir dizin bulamazsa file içindedir ve hiçbir alt dizinin eşleşen bir dizini yoktur file, dizin içe aktarılmayacaktır. Bu, projeler CVS gibi sürüm yönetim sistemleri tarafından yönetiliyorsa genellikle yararlıdır. CVS için, her ilgili dizin, ilgisiz olanların bulunduğu bir CVS dizini içerir files saklanır. Bu seçenek seçilirse ve CVS-files hiçbirine uymuyor file Yukarıda tanımlanan türde dizin, Aile Modeli'ne bir bileşen olarak aktarılmayacaktır. - Düzenlemek files ve dizinler.
Sıralamak için bu seçeneği etkinleştirin files ve dizinler her biri alfabetik sırayla. - İthalat yolu işleme.
Daha ileri senkronizasyon için, içe aktarıcının içe aktarılan tüm elemanların orijinal yolunu modele depolaması gerekir.
Birçok durumda Aile Modelleri diğer kullanıcılarla paylaşılır. Dizin yapısı her kullanıcı için farklı olabilir. En yaygın kullanım senaryolarını desteklemek için içe aktarıcı farklı modlarda çalışabilir:
| Mutlak | İçe aktarılan öğeye giden mutlak yol modele kaydedilecektir. Daha sonraki senkronizasyon ve dönüşüm sırasında files'lerin ilk ithalat sırasındakiyle aynı yere yerleştirilmesi gerekmektedir. |
| Çalışma Alanına Göre | Yollar çalışma alanı klasörüne göre depolanır. Senkronizasyon için files, Eclipse çalışma alanının bir parçası olmalıdır. Dönüşüm, giriş dizini olarak Eclipse çalışma alanını kullanmalıdır. |
| Projeye Göre | Yollar projeye göre depolanır. Senkronizasyon için files, Eclipse içindeki projenin bir parçasıdır. Dönüşüm, girdi dizini olarak proje klasörünü kullanmalıdır. |
| Yola Göre | Yollar verilen yola göre depolanır. Senkronizasyon için files tam olarak aynı yere yerleştirilmelidir. Dönüşüm giriş dizini, içe aktarma sırasındaki bağıl yol ile aynıdır. |
Bu iletişim kutusunun tüm tercihleri kalıcı olarak saklanır. Kişisel özelleştirmeler her içe aktarma çalıştırıldığında tekrar yapılmamalıdır. Bu, içe aktarma iş akışını kolay ve hızlı hale getirir.
2.3. Dizin Ağacından Modelleri Güncelleme
Senkronize Et düğmesine basın 
içe aktarılan bir modeli dizin yoluyla senkronize etmek için. Projenin kök yolu modelde saklanır, böylece daha önce olduğu gibi aynı dizine senkronize olur. Senkronize et düğmesini etkinleştirmek için modeli açın ve herhangi bir öğeyi seçin. Senkronize et düğmesine bastıktan sonra, geçerli Aile Modeli ve geçerli dizin yapısının modelinin karşı karşıya geldiği bir Karşılaştırma Düzenleyicisi açılır (bkz. Şekil 4, “Karşılaştırma Düzenleyicisinde Dizin Ağacından Model Güncellemesi”).
Şekil 4. Karşılaştırma Düzenleyicisi'ndeki Dizin Ağacından model güncellemesi 
Karşılaştırma düzenleyicisi pure::variants'ta model sürümlerini karşılaştırmak için kullanılır ancak bu durumda fiziksel dizin yapısını (sağ alt tarafta gösterilir) geçerli pure::variants modeliyle (sol alt taraf) karşılaştırmak için kullanılır. Tüm değişiklikler düzenleyicinin üst kısmında etkilenen öğelere göre sıralanmış ayrı öğeler olarak listelenir.
Bu listedeki bir öğenin seçilmesi her iki modeldeki ilgili değişikliği vurgular. Örnekteample, eklenen bir eleman sağ taraftaki bir kutu ile işaretlenir ve sol taraftaki modeldeki uygulanabilir pozisyonu ile bağlanır. Üst ve alt düzenleyici pencereleri arasındaki Birleştirme araç çubuğu, tek tek veya hatta tüm (çatışmayan) değişiklikleri bir bütün olarak dizin ağacı modelinden Özellik Modeline kopyalamak için araçlar sağlar.
Not
Senkronizasyon son kullanılan ithalatçı ayarlarıyla yapılır. Bu, modeli ithalat yapılırken yapılan diğer ayarlarla güncellemeyi mümkün kılar.
İlişki İndeksleyicisini Kullanma
Kaynak Kodu Yönetimi için Bağlayıcı, İlişkileri geliştirir View pure::variants model elemanları ile kaynak kodu arasındaki bağlantılar hakkında bilgiyle. ps:condxml ve ps:condtext elemanlarının koşullarında kullanılan özellikler için ilişkiler eklendi.
ps:flag ve ps:flag içinfile elemanlar C/C++ kaynağında önişlemci sabitlerinin konumu files gösterilir. Ek olarak, özellik benzersiz adları ve ön işlemci sabitleri arasındaki eşlemeyi kullanarak seçili bir özellik için eşleşen ön işlemci sabitlerinin konumları gösterilir.
3.1. Bir Projeye İlişki İndeksleyicinin Eklenmesi
İlişki indeksleyicisi özel bir proje özellik sayfasında etkinleştirilebilir. Projeyi seçin ve bağlam menüsünden Özellikler öğesini seçin. Yaklaşan iletişim kutusunda İlişki İndeksleyicisi sayfasını seçin.
Şekil 5. İlişki İndeksleyicisi için Proje Özellik Sayfası
İlişki dizinleyicisi, İlişki Dizinleyicisini Etkinleştir seçeneği seçilerek proje için etkinleştirilir (1). Dizinleyici etkinleştirildikten sonra projeye özgü davranışı tanımlamak için birkaç seçenek daha vardır. Pure::variants Koşulları ve C/C++ Önişlemci Sabitlerinin dizinlenmesi ayrı ayrı etkinleştirilebilir (2). file isim desenleri (3) seçmek için kullanılır files dizinleme içindir. Sadece filedesenlerden biriyle eşleşenler taranır. Tümünü taramak için desen olarak “*” ekleyin fileBir projenin s'si.
Bir proje için dizinleyiciyi etkinleştirdikten sonra projeye bir oluşturucu eklenir. Bu oluşturucu değiştirilmiş olanları tarar filepure::variants model elemanlarına otomatik olarak yeni ilişkiler kurmak için s.
3.2. Kaynak Kodla İlişkiler
Aktif ilişki indeksleyicisi ile İlişkiler View ek girdiler içerir. Bu girdiler, adını gösterir file ve değişken noktasının satır numarası. Araç ipucu, uygun bölümü gösterir fileGirişe çift tıklayarak file Bir editörde açılacaktır.
pure::variants Koşullar
pure::variants koşulu, bir bölümü dahil etmek veya hariç tutmak için kullanılabilir. file bir özellik seçimine bağlı olarak. Koşul Dizinleyicisi bu tür kuralları tarar ve başvurulan özellikleri çıkarır. Editörde böyle bir özellik seçilirse İlişkiler View hepsini gösterecek files ve seçili özelliğe sahip bir koşulun bulunduğu satırlar (bkz. Şekil 6, “İlişkilerde Bir Koşulun Temsili View”).
Şekil 6. İlişkilerdeki Bir Durumun Temsili View
Koşulların nasıl tanımlanacağına dair detaylı bir açıklama almak için pure::variants Kullanıcı Kılavuzu'nun 9.5.7. bölümünün ps:condtext bölümüne bakın (Referans–>Önceden Tanımlanmış Kaynak Eleman Türleri–>ps:condtext).
C/C++ Ön İşlemci Sabitleri
C/C++ Ön İşlemci Dizinleyicisi taramaları fileÖnişlemci kurallarında kullanılan sabitler için s (örneğin #ifdef, #ifndef, …).
Eğer bir ps:flag veya ps:flagfile Öğe seçildi İlişkiler View Tanımlı önişlemci sabitinin kullanımını gösterir.
İlişkiler View Ayrıca, eşleme desenleri kullanılarak özelliklere bağlı ön işlemci sabitlerini gösterir. Bunun için desenler, seçili özelliğin verileriyle genişletilir. Ortaya çıkan semboller, eşleşen ön işlemci sabitlerini aramak için kullanılır. Şekil 7, “İlişkilerde C/C++ Ön İşlemci Sabitinin Temsili View" eski bir sevgiliyi gösteriyorample, fame{Name} deseniyle. Desen, özelliğin benzersiz adıyla fameNative'e genişletilir. Dizinli kodda, önişlemci sabiti fameNative'in kullanıldığı 76 konum vardır.
Bu konumlar İlişkilerde gösterilir ViewDesenler tercihlerde tanımlanabilir (bkz. Bölüm 3.3, “Tercihler”).
Şekil 7. İlişkilerde C/C++ Ön İşlemci Sabitinin Temsili View
3.3. Tercihler
Dizinleyicinin varsayılan davranışını değiştirmek için Eclipse tercihlerini açın ve Variant Management kategorisinde Relation Indexer sayfasını seçin. Sayfa iki liste gösterir.
Şekil 8. İlişki Dizinleyici Tercihi sayfası
Üst liste varsayılanı içerir file dizinleyici için desenler (1). Bu liste, yeni etkinleştirilen projeler için ilk desen ayarıdır.
Alttaki liste, özellikler ve ön işlemci sabitleri arasındaki eşlemeyi içerir (2). Bu eşleme tüm projeler için kullanılır. Tablo 1, “Desteklenen Eşleme Değiştirmeleri” tüm olası değiştirmeleri gösterir.
Tablo 1. Desteklenen Eşleme Değiştirmeleri
| Joker | Tanım | Example: ÖzellikA |
| İsim | seçili özelliğin benzersiz adı | FLAG_{Ad} – FLAG_FeatureA |
| İSİM | büyük harfli seçili özelliğin benzersiz adı | BAYRAK_{AD} – BAYRAK_ÖZELLİĞİA |
| isim | seçili özelliğin küçük harfli Benzersiz Adı | bayrak_{isim} – bayrak_özelliğia |
Belgeler / Kaynaklar
 |
pure-systems 2024 Kaynak Kodu Yönetim Yazılımı için Bağlayıcı [pdf] Kullanıcı Kılavuzu 2024, 2024 Kaynak Kodu Yönetim Yazılımı için Bağlayıcı, Kaynak Kodu Yönetim Yazılımı için Bağlayıcı, Kaynak Kodu Yönetim Yazılımı, Yönetim Yazılımı, Yazılım |
