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 的源代码管理提供了灵活的机会来同步目录结构和源代码 files 很容易与 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
根据所使用的安装方法，启动启用 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应导入与特殊模式匹配的 s。为了满足此要求，可以在 File 名称模式字段。
描述正则表达式的语法超出了本帮助的目的。请参阅 pure::variants 用户指南参考章节中的正则表达式部分（例如 .*）。

映射元素类型字段设置 file 类型和 pure::variants 系列元素类型。系列元素类型是源的描述符 file 为导入模型中的映射元素提供更多信息。典型的选择是 ps:class 或 ps:makefile.

已映射 file 类型字段设置 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-file不匹配任何 file 类型如上所述，目录将不会作为组件导入到系列模型中。
种类 files 和目录。
启用此选项以进行排序 files 和目录均按字母顺序排列。

导入路径处理。
为了进一步同步，导入器需要将所有导入元素的原始路径存储到模型中。
在许多情况下，家庭模型与其他用户共享。每个用户的目录结构可能不同。为了支持最常见的使用场景，导入器可以在不同的模式下工作：

绝对	导入元素的绝对路径将存储在模型中。为了便于以后同步以及在转换过程中 file必须将其放置在与第一次导入时完全相同的位置。
相对于工作区	路径相对于工作区文件夹存储。为了同步 files 必须是 Eclipse 工作区的一部分。转换必须使用 Eclipse 工作区作为输入目录。
相对于项目	路径是相对于项目存储的。为了同步， file是 Eclipse 中项目的一部分。转换必须使用项目文件夹作为输入目录。
相对于路径	路径是相对于给定路径存储的。为了同步 file必须放在完全相同的位置。转换输入目录与导入期间的相对路径相同。

此对话框的所有首选项均会永久保存。每次导入时无需重新进行个人自定义。这使得导入工作流程变得简单快捷。
2.3. 从目录树更新模型
按下同步按钮将导入的模型与其目录路径同步。项目的根路径存储在模型中，因此它将同步到与之前相同的目录。要启用“同步”按钮，请打开模型并选择任何元素。按下“同步”按钮后，将打开一个比较编辑器，其中当前系列模型和当前目录结构的模型相对应（参见图 4，“从比较编辑器中的目录树更新模型”）。
图 4. 比较编辑器中目录树的模型更新 比较编辑器用于整个 pure::variants 中比较模型版本，但在本例中用于比较物理目录结构（显示在右下方）与当前 pure::variants 模型（左下方）。所有更改都作为单独的项目列在编辑器的上部，按受影响的元素排序。
在此列表中选择一个项目会突出显示两个模型中的相应变化。在 examp例如，添加的元素在右侧用一个框标记，并在左侧与其在模型中的可行位置相关联。上下编辑器窗口之间的合并工具栏提供了将单个甚至所有（非冲突）更改作为一个整体从目录树模型复制到特征模型的工具。
笔记
同步是通过上次使用的导入器设置完成的。这样就可以使用导入过程中进行的其他设置来更新模型。

使用关系索引器

源代码管理连接器增强了关系 View 包含 pure::variants 模型元素与源代码之间的连接信息。添加了用于 ps:condxml 和 ps:condtext 元素条件的特征的关系。
对于 ps:flag 和 ps:flagfile 元素预处理器常量在 C/C++ 源代码中的位置 files 被显示出来。此外，通过使用特征唯一名称和预处理器常量之间的映射，还显示了所选特征的匹配预处理器常量的位置。
3.1. 将关系索引器添加到项目
关系索引器可以在特殊的项目属性页上激活。选择项目并在上下文菜单中选择“属性”项。在即将出现的对话框中选择“关系索引器”页。
图 5. 关系索引器的项目属性页

通过选择“启用关系索引器”选项 (1)，可以为项目激活关系索引器。启用索引器后，还有一些选项可以定义项目特定的行为。pure::variants 条件和 C/C++ 预处理器常量的索引可以单独激活 (2)。列表 file 名称模式（3）用于选择 files 用于索引。仅 file扫描与其中一个模式匹配的 s。添加“*”作为模式以扫描所有 file一个项目的。
激活项目的索引器后，构建器将添加到项目中。此构建器扫描已更改的 files 自动为 pure::variants 模型元素建立新关系。
3.2. 与源代码的关系
使用激活的关系索引器 View 包含其他条目。这些条目显示了 file 以及变体点的行号。工具提示会显示 file。双击条目 file 将在编辑器中打开。
pure::variants 条件
pure::variants 条件可用于包含或排除 file 取决于特征选择。条件索引器扫描此类规则并提取引用的特征。如果在编辑器中选择了此类特征，则关系 View 将显示全部 file以及具有所选特征的条件所在的行（参见图 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 的模式为 fame{Name}。该模式使用功能的唯一名称扩展为 fameNative。在索引代码中，有 76 个位置使用了预处理器常量 fameNative。
此位置显示在关系中 View。可以在首选项中定义模式（参见第 3.3 节 “首选项”）。
图 7. 关系中的 C/C++ 预处理器常量的表示 View

3.3. 偏好设置
要更改索引器的默认行为，请打开 Eclipse 首选项并选择“变体管理”类别中的“关系索引器”页面。该页面显示两个列表。
图 8. 关系索引器首选项页面上面的列表包含默认的 file 索引器的模式（1）。此列表是新启用的项目的初始模式设置。
下面的列表包含功能和预处理器常量之间的映射 (2)。此映射适用于所有项目。表 1“支持的映射替换”显示了所有可能的替换。
表 1. 支持的映射替换

通配符	描述	Example：特征A
姓名	所选特征的唯一名称	FLAG_{名称} – FLAG_FeatureA
姓名	所选特征的大写唯一名称	FLAG_{NAME} – FLAG_FEATUREA
姓名	所选特征的小写唯一名称	flag_{name} – flag_featurea