pure-systems 2024 原始碼管理軟體連接器使用手冊

pure::variants – 連接器
原始碼管理手冊
參數技術有限公司
pure::variants 6.0.7.685 的版本 6.0
版權所有 © 2003-2024 Parametric Technology GmbH
2024

內容隱藏

介紹

pure::variants 原始碼管理連接器 (Connector) 使開發人員能夠使用 pure::variants 管理原始碼可變性。 pure::variants 的原始碼管理提供了同步目錄結構和原始碼的靈活機會 file使用 pure::variants 模型可以輕鬆實現。因此，變體管理甚至可以實用地應用於複雜的軟體專案。此外，pure::variants 功能和原始程式碼之間的連接可以透過建構器更輕鬆地管理，並且可以透過原始碼管理進行高度存取。
1.1. 軟件要求
用於原始碼管理的 pure::variants 連接器是 pure::variants 的擴展，可在所有支援的平台上使用。
1.2. 安裝
請參閱 pure::variants 設置指南中的 pure::variants 連接器部分，了解有關如何安裝連接器的詳細信息（菜單幫助 -> 幫助內容，然後是 pure::variants 設置指南 -> pure::variants 連接器）。
1.3.關於本手冊
讀者應具備 pure::variants 的基本知識和經驗。在閱讀本手冊之前，請先查閱其介紹資料。該手冊可在線上幫助中找到，也可在此處以可列印的 PDF 格式取得。

使用連接器

2.1.開始純::變體
根據所使用的安裝方法，啟動啟用 pure::variants 的 Eclipse 或在 Windows 下從程式選單中選擇 pure::variants 項目。
如果「變體管理」透視圖尚未激活，請從「視窗」功能表中的「開啟透視圖」->「其他...」中選擇它來啟動。
2.2.將目錄樹導入族模型
在將目錄樹匯入族模型之前，必須建立變體項目。此外，建議已經在特徵模型中定義特徵。請參閱 pure::variants 文件以取得這些步驟的協助。
實際導入是透過在專案的上下文選單中選擇“導入...”操作來開始的 view 或使用導入…選單中的 File 菜單。從變體管理類別中選擇變體模型或項目，然後按下一步。在下一頁上，選擇從來源資料夾匯入族模型，然後再次按下一步。
選擇要匯入的原始碼類型
出現匯入精靈（請參閱圖 1，「匯入精靈的頁面，用於選擇可以匯入的原始碼類型」）。選擇要匯入的項目類型，然後按下一步。每種類型都包含一組預先定義的 file 要導入到模型的類型。
圖 1. 用於選擇可以匯入的原始程式碼類型的匯入精靈頁面選擇來源和目標
在下一個嚮導頁面上（圖 2，“用於選擇導入來源和目標的導入精靈頁面”）必須指定來源目錄和目標模型。
按下瀏覽...按鈕選擇應匯入的原始程式碼所在的目錄。預設情況下，選擇目前工作區，因為這可能是開始導覽的有用點。
您可以在下方指定包含和排除模式。這些模式必須是 java 正規表示式。使用這些模式檢查相對於來源根資料夾的每個輸入路徑。如果包含模式匹配，則匯入資料夾，如果排除模式不匹配。這表示包含模式會預先選擇要匯入的資料夾，排除模式會限制此預先選擇。
選擇原始碼目錄後，必須定義目標模型。因此，選擇應儲存模型的變體項目或資料夾並輸入模型名稱。這 file 如果此對話方塊中未給予名稱，則會自動使用 .ccfm 副檔名進行擴充。預設情況下，它將設定為與模型名稱本身相同的名稱。這是推薦的設定。
指定方便的來源資料夾和所需的模型名稱後，可以按下「完成」來結束該對話方塊。如果按下「下一步」按鈕，則會出現另一個頁面，可以在其中進行其他設定。
圖 2. 用於選擇匯入來源和目標的匯入精靈頁面更改導入首選項
在最後一個嚮導頁面上（圖 3，“定義單一配置的導入精靈頁面””）可以透過一些首選項來自訂導入軟體專案的導入行為。
對話方塊頁面顯示一個表格，其中 file 類型已定義，導入過程將考慮這些類型。
每行由四個字段組成。

描述欄位包含一個簡短的描述性文字來標識 file 類型。
這 File 名稱模式欄位用於選擇 file當它們與字段值匹配時將被導入。該欄位使用以下語法：

最常見的用例可能是 file 擴大。通常的語法是 .EXT，其中 EXT 是所需的 file 副檔名（例如 .java）。
另一種常見情況是特殊情況 file，就像一個品牌file。因此，可以精確匹配 file 姓名。為此，只需輸入 file 名稱輸入欄位（例如 build.xml）。

在某些情況下，映射需求更加具體，因此只需 file應匯入與特殊模式相符的內容。為了滿足此要求，可以在中使用正規表示式 File 名稱模式欄位。
描述正規表示式的語法超出了本幫助的目的。請參閱 pure::variants 使用者指南中參考章節的正規表示式部分（例如 .*）。

Mapped 元素類型欄位設定 a 之間的映射 file type 和 pure::variants 系列元素類型。族元素類型是來源的描述符 file 為導入模型中的映射元素提供更多資訊。典型的選擇是 ps:class 或 ps:makefile.

映射的 file type 字段設定 a 之間的映射 file 類型和 pure::variants file 類型。這 file pure::variants 中的型別是來源的描述符 file 為導入模型中的映射元素提供更多資訊。典型的選擇是用於實現的 impl 或用於定義的 def files.

圖 3. 用於定義單獨配置的導入精靈頁面新的 file 可以使用「新增映射」按鈕新增類型。所有欄位均填寫未定義的值，必須由使用者填寫。若要編輯欄位中的值，只需用滑鼠點選該欄位即可。該值變得可編輯並且可以更改。無法更改預設值 file 表的名稱模式。為了讓客製化靈活，可以取消選擇 file 透過取消選擇該行來鍵入。取消選擇 file 名稱模式保留在配置中，但導入器不會使用。使用者定義 file 可以使用「刪除映射」按鈕再次刪除類型。
預設是其他 files file 名稱模式在表中可用，但已取消選擇。通常不希望導入所有 file但這可以透過選擇相應的行輕鬆更改。
可以使用三個常規導入選項來自訂導入器的行為。

不要匯入不符的目錄 files（例如CVS目錄）。
如果導入器發現沒有符合的目錄 file 位於其中且沒有子目錄具有相符的 file，該目錄將不會被導入。如果專案由 CVS 等版本管理系統管理，這通常很有用。對於 CVS，每個相關目錄都包含一個 CVS 目錄，其中不相關的目錄 files 被儲存。如果選擇此選項並且 CVS-files 不符任何 file 類型如上面定義，該目錄不會作為元件匯入到族模型中。
種類 files 和目錄。
啟用此選項進行排序 file和目錄均按字母順序排列。

導入路徑處理。
為了進一步同步，導入器需要將所有導入元素的原始路徑儲存到模型中。
在許多情況下，家庭模型會與其他使用者共用。每個使用者的目錄結構可能不同。為了支援最常見的使用場景，導入器可以在不同的模式下運作：

絕對	導入元素的絕對路徑將儲存到模型中。對於以後的同步和轉換期間 file必須放置在與第一次導入期間完全相同的位置。
相對於工作空間	路徑是相對於工作空間資料夾儲存的。為了同步 files 必須是 Eclipse 工作區的一部分。轉換必須使用 Eclipse 工作區作為輸入目錄。
相對於項目	路徑是相對於專案儲存的。為了同步 file是 Eclipse 內專案的一部分。轉換必須使用項目資料夾作為輸入目錄。
相對於路徑	路徑是相對於給定路徑儲存的。為了同步 file必須放置在完全相同的位置。轉換輸入目錄與導入時的相對路徑相同。

該對話方塊的所有首選項都會永久儲存。每次導入運行時不得重做個人自訂。這使得匯入工作流程變得簡單又快速。
2.3.從目錄樹更新模型
按同步按鈕將導入的模型與其目錄路徑同步。專案的根路徑儲存在模型中，因此它將同步到與先前相同的目錄。若要啟用“同步”按鈕，請開啟模型並選擇任何元素。按下“同步”按鈕後，將開啟“比較編輯器”，其中當前族模型和目前目錄結構的模型是相對的（請參閱圖 4，“從比較編輯器中的目錄樹更新模型”）。
圖 4. 比較編輯器中目錄樹的模型更新 比較編輯器在整個 pure::variants 中用於比較模型版本，但在本例中用於比較實體目錄結構（顯示在右下側）與目前的 pure::variants 模型（左下側）。所有變更都以單獨的項目列出在編輯器的上部，並按受影響的元素排序。
選擇此清單中的一項會突出顯示兩個模型中各自的變更。在前amp例如，新增的元素在右側以框標記，並與其在左側模型中的可行位置連接。上下編輯器視窗之間的合併工具列提供了將單一甚至所有（不衝突）變更作為一個整體從目錄樹模型複製到要素模型的工具。
筆記
同步是使用上次使用的導入器設定完成的。這使得可以使用匯入完成時所做的其他設定來更新模型。

使用關係索引器

原始碼管理連接器增強了關係 View 包含有關 pure::variants 模型元素和原始程式碼之間的連接的資訊。為 ps:condxml 和 ps:condtext 元素的條件中所使用的功能新增關係。
對於 ps:flag 和 ps:flagfile elements C/C++ 原始碼中預處理器常數的位置 file顯示 s。此外，透過使用特徵唯一名稱和預處理器常數之間的映射，顯示所選特徵的匹配預處理器常數的位置。
3.1.將關係索引器新增至專案中
關係索引器可以在特殊的項目屬性頁上啟動。選擇項目並在上下文選單中選擇“屬性”項目。在即將出現的對話方塊中，選擇「關係索引器」頁面。
圖 5. 關係索引器的項目屬性頁

透過選擇「啟用關係索引器」選項 (1) 為項目啟動關係索引器。啟用索引器後，還有更多選項定義項目特定行為。 pure::variants 條件和 C/C++ 預處理器常數的索引可以單獨啟動 (2)。該列表與 file 名稱模式 (3) 用於選擇 files 用於索引。僅有的 file匹配其中一種模式的 s 會被掃描。新增“*”作為模式以掃描所有 file一個項目的s。
啟動項目的索引器後，建構器將會新增至項目。此建構器掃描已更改 file自動建立與 pure::variants 模型元素的新關係。
3.2.與原始碼的關係
透過啟動關係索引器，關係 View 包含附加條目。這些條目顯示了名稱 file 以及變異點的行號。工具提示顯示了對應的部分 file。透過雙擊該條目 file 將在編輯器中開啟。
pure::variants 條件
pure::variants 條件可用於包含或排除 a 的部分 file 取決於功能選擇。條件索引器掃描此類規則並提取引用的特徵。如果在編輯器中選擇了此類功能，則關係 View 將顯示全部 file具有所選特徵的條件所在的 s 和行（參見圖 6，「關係中條件的表示」） View”）。
圖 6. 關係中條件的表示 View若要取得如何定義條件的詳細說明，請參閱 pure::variants 使用者指南第 9.5.7 章的 ps:condtext 部分（參考–>預先定義來源元素類型–>ps:condtext）。
C/C++ 預處理器常數
C/C++ 預處理器索引器掃描 files 表示預處理器規則中使用的常數（例如#ifdef、#ifndef、...）。
如果 ps:flag 或 ps:flagfile 元素被選擇為關係 View 顯示定義的預處理器常數的用法。
關係 View 還顯示了透過使用映射模式連接到特徵的預處理器常數。為此，模式將使用所選特徵的資料進行擴展。產生的符號用於搜尋匹配的預處理器常數。 圖 7，「關係中 C/C++ 預處理器常數的表示 View”顯示前任ample 的模式為名稱{Name}。此模式透過該功能的唯一名稱擴展為「fameNative」。在索引程式碼中，有 76 個位置使用了預處理器常數fameNative。
該位置顯示在關係中 View。可以在首選項中定義模式（請參閱第 3.3 節「首選項」）。
圖 7. 關係中 C/C++ 預處理器常數的表示 View

3.3.偏好
若要變更索引器的預設行為，請開啟 Eclipse 首選項並選擇 Variant Management 類別中的 Relation Indexer 頁面。該頁面顯示兩個清單。
圖 8. 關係索引器首選項頁面上面的列表包含預設值 file 索引器 (1) 的模式。此清單是新啟用的項目的初始模式設定。
以下的清單包含特徵和預處理器常數之間的對應 (2)。此映射適用於所有項目。表 1「支援的映射替換」顯示了所有可能的替換。
表 1. 支援的映射替換

通配符	描述	Example: 特徵A
姓名	所選功能的唯一名稱	FLAG_{名稱} – FLAG_FeatureA
姓名	所選功能的大寫唯一名稱	FLAG_{NAME} – FLAG_FEATUREA
姓名	所選功能的小寫唯一名稱	flag_{名稱} – flag_featurea