open

简介

打开或创建工作副本。

vb open REPOSITORY [VERSION] [OPTIONS]

示例

  • 克隆 https://laylahe@code.softbridge.com/projectz 项目，再打开工作副本：

vb open https://laylahe@code.softbridge.com/projectz
# C:\Users\36657\Documents\VisionByte\vb.exe clone "https://laylahe@code.softbridge.com/projectz" C:/Users/36657/Desktop/open/projectz.vbyte
# password for https://laylahe@code.softbridge.com/projectz: **************
# remember password (Y/n)? y
# Round-trips: 3   Artifacts sent: 0  received: 2692
# Clone done, wire bytes sent: 944  received: 3215212  remote: 123.207.33.94
# Rebuilding repository meta-data...
#   100.0% complete...
#...

  • 在 project 文件夹里创建 demo.vbyte 仓库的工作副本：

$ vb open --nested --workdir project demo.vbyte
project-name: <unnamed>
repository:   C:/Users/Administrator/Desktop/jenkins_home/workspace/VisionByte/Document/projectz/source/test/open/demo.vbyte
local-root:   C:/Users/Administrator/Desktop/jenkins_home/workspace/VisionByte/Document/projectz/source/test/open/project/
config-db:    C:\Users\Administrator\AppData\Local//SOFTBRIDGE//__vbglobal__
project-code: 0d4245ee4894a7ab5dec928553b6f0f81c4b4ffe
checkout:     f9c14bc42536d0401aec6ef141019251c2e306f9 2024-11-25 20:15:55 UTC
tags:         trunk
comment:      initial empty check-in (user: Administrator)
check-ins:    1

说明

创建仓库的工作副本（也叫签出、工作树、工作目录），默认工作副本将在其根下创建，使用 --workdir DIR 选项则在指定文件中创建工作副本。

如果指定了签出版本，则签出该版本工程。否则，将使用主分支（ trunk ）上的最新签入进行签出操作。

也可以对一个仓库创建多个工作副本，每个工作副本可以有自己独立的工作状态（包括不同的分支或提交），实际上是同一个仓库的不同工作副本。 这意味着，当你在一个工作副本中对仓库进行修改时，这些修改会反映在仓库的对象数据库中，从而影响到其他所有工作副本以及主仓库。

REPOSITORY 可以是本地已存在的仓库名，也可以是远程仓库的 URI 地址。

如果 REPOSITORY 是 clone 命令可识别的格式之一的 URI 地址，则 open 命令首先克隆远程仓库，然后再创建克隆仓库的工作副本。

克隆仓库将保存在当前目录中，使用 --repodir DIR 选项保存仓库在指定文件中。

克隆的名称将取自 URI 的最后一项。对于 http: 和 https: 的 URI，可以在 URI 末尾附加一个额外的术语以获取指定仓库名称。

例如：

vb open https://visionbyte-scm.org/home/new-name

克隆的 URI 地址：https://hub.visionbyte.com/home，额外的 new-name 术语意味着克隆的仓库将被称为 new-name.vbyte 。

选项

--empty

将工作副本初始化为空，但仍与本地仓库连接。如果提交此工作副本，它将成为仓库中的新初始提交

-f|--force

即使工作副本不为空或自动同步失败，也继续强制性打开

--force-missing

强制打开缺少内容的仓库

-k|--keep

仅修改清单文件

--nested

允许在已打开的工作副本内打开其他仓库

--nosync

即使自动同步设置已打开，也不要打开之前自动同步仓库

--repodir DIR

如果 REPOSITORY 是 URI 地址，则将克隆的仓库保存在指定文件中，而不是当前目录中

--setmtime

设置所有文件的时间戳为上次修改它们的签入的时间，以便于匹配它们的 SCM 端时间

--verbose

如果传递了 URI，则此标志将传递给克隆操作，否则无效

--workdir DIR

将工作副本保存在指定文件中，而不是当前中。如果文件不存在，则创建它

参见

close, clone