可以更改项目的工作区特性,例如,工作区路径和是否维护工作区。如果未指定项目,该命令将更新其工作区与当前工作目录关联的项目。
关于此任务
ccm wa|work_area ([-wa|-maintain_wa] | [-nwa|-no_wa])
([-cb|-copy_based] | [-lb|-link_based|-ncb|-not_copy_based])
([-rel|-relative] | [-nrel|-not_relative])
([-mod|-modifiable] | [-nmod|-not_modifiable])
([-wat|-wa_time] | [-nwat|-no_wa_time])
([-tl|-translate|-translation] | [-ntl|-no_translate|-no_translation])
[-set|-path|-setpath absolute_path]
[-pst|-project_subdir_template template_value]
([-r|-recurse] | [-nr|-norecurse|-no_recurse])
ccm wa|work_area ([-wa|-maintain_wa] | [-nwa|-no_wa])
([-cb|-copy_based] | [-ncb|-not_copy_based])
([-rel|-relative] | [-nrel|-not_relative])
([-mod|-modifiable] | [-nmod|-not_modifiable])
([-wat|-wa_time] | [-nwat|-no_wa_time])
([-tl|-translate|-translation] | [-ntl|-no_translate|-no_translation])
[-set|-path|-setpath absolute_path]
[-pst|-project_subdir_template template_value]
([-r|-recurse] | [-nr|-norecurse|-no_recurse]) [-p|-project]
project_spec...
- -cb|-copy_based
- 指定任何工作区均基于副本。
- -lb|-link_based|-ncb|-not_copy_based
- 指定任何工作区均基于链接。此选项仅对 UNIX 用户可用。
- -mod|-modifiable_wa
- 指定工作区中的文件具有许可权集,这样即使在尚未检出文件的情况下,文件仍然可修改。缺省值为 nmod|-not_modifiable_wa。
- -nmod|-not_modifiable_wa
- 指定工作区中的文件具有许可权集,以便在缺省情况下,仅当文件处于可写状态(例如工作状态)时才可修改。缺省值为 -not_modifiable_wa。
- -nr|-no_recurse
- 当应用这些选项时不会递归项目层次结构。
仅更改指定项目。缺省值为 -no_recurse。
- -nrel|-not_relative
- 指定所有工作区均位于绝对路径中。
- -ntl|-no_translate|-no_translation
- 指定工作区中的 ASCII 文件在 Windows 和 UNIX 之间复制,且不进行换行转换。缺省值为 -translate。
- -nwa|-no_wa
- 指定不维护项目的工作区。缺省值为 -maintain_wa。
- -nwat|-no_wa_time
- 指定项目工作区中的文件使用时间戳记。时间戳记必须显示修改时间,而非将文件复制到工作区中的时间。缺省值为 -no_wa_time。
- -p|-project
- 不需要指定此选项。
- project_spec
- 指定要修改的项目。请参阅项目规范以获取详细信息。
- -pst|-project_subdir_template template_value
- 将项目的指定工作区路径(项目在该路径中与文件系统同步)切换至新的位置。此参数仅更改工作区路径中针对项目的部分。要将工作区更改为文件系统的其他部分,或将工作区与其他平台同步,请参阅 setpath_absolute_path 选项。
- 缺省目录是您主目录中的 ccm_wa 且后跟 database_name,所有项目工作区都会在这个目录中创建。缺省情况下,项目名称和版本将附加到 database_name。可以通过修改工作区模板,将名称中针对项目的部分更改为包括 project_name、project_version、release、platform 和 delimiter。
- 如果接口主机可识别前一路径,那么它将移动到新位置。否则,使用此选项执行 work_area 命令时,将创建工作区。
- -r|-recurse
- 使项目层次结构中的所有项目都随指定项目更新。缺省值为 -nr|-norecurse。
- -rel|-relative
- 指定将所有工作区放在父项目路径的相对路径上。
- -set|-path|-setpath absolute_path
- 将项目的指定工作区路径切换至新位置。此选项将更改工作区路径中未针对项目的部分。要通过修改工作区模板来更改名称中针对项目的部分,例如,project_name、project_version、release、platform 和 delimiter,请参阅 -project_subdir_template 选项。
- 如果接口主机可识别前一路径,那么它将移动到新位置。否则,使用此选项执行 work_area 命令时,将创建工作区。
- 仅当您是构建管理员或者是 ccm_admin 角色的用户时,才能更改只读项目的工作区路径。
- tl|-translate|-translation
- 指定在 Windows 和 UNIX 之间复制工作区中的 ASCII 文件,且进行换行符转换。
- -wa|-maintain_wa
- 维护工作区。设置此选项可同步工作区,并使其保持同步状态。
- 要通过 CLI 停止同步,可随时输入 CTRL+C。
- 如果停止同步,将显示错误消息,报告您的工作区中可能出错。但是,直到您尝试使用工作区时,才会出现这类错误。为避免出现问题,请在使用工作区前对整个工作区执行同步。
- 仅当您是 ccm_admin 角色时,才能在对只读项目的父项目使用 -recurse 选项时使用此选项。构建管理员可以直接对已发布的项目使用该命令。
- -wat|-wa_time
- 指定项目工作区中的文件使用时间戳记。时间戳记必须显示文件复制到工作区中的时间,而非修改时间。缺省值为 -no_wa_time。