您可以使用指定目录下对象的不同版本,也可以在指定的目录下添加现有对象作为新的项目成员。添加到该目录中的对象必须按提供上下文项目的格式(例如,项目引用格式或工作区引用格式)指定。
如果对象存在目录条目,那么该命令将使用对应目录条目下的指定对象。如果对象不存在目录条目,那么将自动检出该目录并与指定的任务关联。然后将为该对象创建目录条目以用于该目录的上下文项目。如果上下文项目处于工作状态,那么您必须是该项目的拥有者。如果上下文项目处于准备状态,那么您必须是构建管理员。
如果要使用子组件的其他版本,那么以下条件适用。如果子组件不是可修改的产品,并且所含组件与父项目不同,那么该产品的不同版本将与当前任务关联。
关于此任务
ccm use -p|-project -dir dir_spec [-t|-task task_spec] project_spec...
ccm use -dir dir_spec [-t|-task task_spec] file_spec...
- -dir dir_spec
- 指定在哪个目录下添加不同版本的对象或现有对象。dir_spec 是 file_spec(请参阅 File specification),您可以将其设置为单个目录对象并提供上下文项目。Project reference form 或 Work area reference form 提供此类上下文项目。
- file_spec
- 指定您要使用的对象版本。请参阅File specification以获取详细信息。
- project_spec
- 指定要使用的项目。请参阅Project specification以获取详细信息。
可能需要对共享项目进行特殊处理(请参阅shared_project_directory_checkin)。
- -t|-task -task_spec
- 指定与曾在添加新成员时检出的任何目录关联的任务。如果省略该选项,那么将使用当前任务。对象添加到目录中之后,如果该目录处于静态状态(例如集成),那么会将其自动检出。如果目录处于您可写入的状态,那么将使用新成员更新现有的目录版本。请参阅Task specification以获取详细信息。
示例
- 使用项目 SubPrj-2 的不同版本:
ccm
use -p SubPrj-2:project:1
- 使用由选择规则选择的 clear.c 版本。
ccm use -rules clear.c
- 向项目 TopPrj-top:project:1 的根目录添加项目 SubPrj-one:project:1。(当前目录可以是任何目录;项目可能没有受维护工作区。)
ccm use -p -dir
TopPrj@TopPrj-top -task 31 SubPrj-one:project:1
- 使用项目 TopPrj-top:project:1 根目录下的 dir1 目录中的对象 a.txt-1.2:ascii:1。
ccm
use -dir TopPrj\dir1@TopPrj-top -task 31 a.txt-1.2:ascii:1
- 使用对象 a.txt-1.1:ascii:1 的不同版本。
ccm use -dir TopPrj\dir1@TopPrj-top a.txt-1.1:ascii:1