目录 搜索
Guides gitattributes giteveryday gitglossary gitignore gitmodules gitrevisions gittutorial gitworkflows Administration git archive git bundle git clean git filter-branch git fsck git gc git instaweb git reflog Basic Snapshotting git add git commit git diff git mv git reset git rm git status Branching and Merging git branch git checkout git log git merge git mergetool git stash git tag Debugging git bisect git blame git grep Email git am git format-patch git request-pull git send-email External Systems git fast-import git svn Getting and Creating Projects git clone git init Git git annotate git archimport git bisect-lk2009 git check-attr git check-mailmap git check-ref-format git checkout-index git cherry git citool git column git credential git credential-cache git credential-store git cvsexportcommit git cvsimport git cvsserver git diff-files git diff-tree git difftool git fast-export git fetch-pack git fmt-merge-msg git get-tar-commit-id git gui git http-backend git http-fetch git http-push git imap-send git index-pack git interpret-trailers git ls-remote git ls-tree git mailinfo git mailsplit git merge-file git merge-index git merge-one-file git merge-tree git mktag git mktree git name-rev git notes git p4 git pack-objects git pack-redundant git pack-refs git parse-remote git patch-id git prune git prune-packed git quiltimport git receive-pack git remote-ext git remote-fd git remote-testgit git repack git replace git rerere git send-pack git sh-i18n git sh-setup git shell git show-branch git show-index git stripspace git unpack-file git unpack-objects git upload-archive git upload-pack git var git verify-commit git verify-tag git whatchanged git worktree Inspection and Comparison git describe git shortlog git show Miscellaneous api credentials api index gitcli gitcore tutorial gitcredentials gitcvs migration gitdiffcore githooks gitk gitnamespaces gitremote helpers gitrepository layout gitsubmodules gittutorial 2 gitweb gitweb.conf pack format User Manual Patching git apply git cherry-pick git rebase git revert Plumbing Commands git cat-file git check-ignore git commit-tree git count-objects git diff-index git for-each-ref git hash-object git ls-files git merge-base git read-tree git rev-list git rev-parse git show-ref git symbolic-ref git update-index git update-ref git verify-pack git write-tree Server Admin git daemon git update-server-info Setup and Config git git config git help Sharing and Updating Projects git fetch git pull git push git remote git submodule
文字

命名

git-p4  - 从 Perforce 存储库导入和提交

概要

git p4 clone [<sync options>] [<clone options>] <p4 depot path>…
git p4 sync [<sync options>] [<p4 depot path>…]git p4 rebase
git p4 submit [<submit options>] [<master branch name>]

描述

该命令提供了一种使用 Git 与 p4 存储库交互的方式。

使用现有的 p4 存储库创建一个新的 Git 存储库git p4 clone,并为其提供一个或多个 p4 depot 路径。将 p4 更改中的新提交合并到git p4 sync。该sync命令还用于包含来自其他 p4 软件仓库路径的新分支。使用提交 Git 回到 p4 git p4 submit。该命令git p4 rebase执行 sync 并将当前分支重新绑定到更新的 p4 远程分支上。

例子

  • 克隆存储库:$ git p4 clone // depot / path / project

  • 在新创建的 Git 仓库中做一些工作:$ cd project $ vi foo.h $ git commit -a -m“edited foo.h”

  • 使用 p4 的最近更改更新 Git 存储库,重新定位顶层的工作:$ git p4 rebase

  • 提交你的提交到 p4:$ git p4 submit

命令

Clone

通常git p4 clone用于从现有的 p4 存储库创建新的 Git 目录:

$ git p4 clone //depot/path/project

这个:

  1. 在名为的子目录中创建一个空的 Git 存储库project

  2. 将来自给定 p4 仓库路径的头部修订版的完整内容导入到 Git 分支中的单个提交中refs/remotes/p4/master

  3. master从这个远程创建一个本地分支并将其检出。

要在 Git 中重现整个 p4 历史记录,请@all在软件仓库路径中使用修饰符:

$ git p4 clone //depot/path/project@all

Sync

随着 p4 存储库中的开发继续,可以使用以下方法将这些更改包含在 Git 存储库中:

$ git p4 sync

该命令在 p4 中查找新的更改,并将它们作为 Git 提交导入。

P4 存储库也可以使用以下方式添加到现有的 Git 存储库git p4 sync

$ mkdir repo-git
$ cd repo-git
$ git init
$ git p4 sync //path/in/your/perforce/depot

这会将指定的软件仓库导入到refs/remotes/p4/master现有的 Git 仓库中。该--branch选项可用于指定用于 p4 内容的不同分支。

如果一个 Git 仓库包含分支refs/remotes/origin/p4,那么它们将在第一次被提取和咨询git p4 sync。由于从 p4 直接导入比从 Git 远程获取更改要慢得多,所以这在多开发人员环境中很有用。

如果有多个分支,git p4 sync则会自动使用“ 分支检测”算法尝试将新更改划分到正确的分支中。这可以通过--branch指定只更新一个分支的选项来覆盖。

Rebase

一个常见的工作模式是从 p4 仓库获取最新的更改,并将它们与本地未提交的更改合并。通常,p4 存储库是所有代码的最终位置,因此重定位工作流程是有意义的。这个命令git p4 sync之后会git rebase在更新的 p4 更改之前移动本地提交。

$ git p4 rebase

Submit

将来自 Git 存储库的更改提交回 p4 存储库需要单独的 p4 客户端工作区。这应该使用P4CLIENT环境变量或 Git 配置变量来指定git-p4.client。p4 客户端必须存在,但如果客户端根目录尚不存在,它将被创建并填充。

要提交当前 Git 分支但不在分支中的所有更改p4/master,请使用:

$ git p4 submit

要指定除当前分支以外的分支,请使用:

$ git p4 submit topicbranch

上游引用通常是refs/remotes/p4/master,但可以使用--origin=命令行选项覆盖。

p4 的更改将在用户调用时创建git p4 submit。该--preserve-user选项将根据 Git 提交的作者来修改所有权。此选项需要 p4 中的管理员权限,可以使用该权限授予p4 protect

选项

常规选项

除克隆以外的所有命令均接受这些选项

--git-dir <dir>

设置GIT_DIR环境变量。见 git [1] 。

-v   --verbose

提供更多进度信息。

同步选项

这些选项可以在初始clone和后续sync操作中使用。

--branch <ref>

将更改导入 <ref> 而不是 refs / remotes / p4 / master 。如果 <ref> 以 refs /开头,则按原样使用。否则,如果它不以 p4 /开头,则添加该前缀。

默认情况下,不以 refs /开始的 <ref> 被视为远程跟踪分支的名称(在 refs / remotes / 下)。这种行为可以使用 --import-local 选项来修改。

默认的 <ref> 是“master”。

本示例将新的远程 “p4 / proj2” 导入到现有的 Git 存储库中:

    $ git init
    $ git p4 sync --branch=refs/remotes/p4/proj2 //depot/proj2

--detect-branches

使用分支检测算法在 p4 中查找新路径。它在“分支检测”中记录如下。

--changesfile <file>

准确导入列出的 p4 更改编号file,每行一个。通常,git p4检查当前 p4 存储库状态并检测它应导入的更改。

--silent

不要打印任何进度信息。

--detect-labels

查询与仓库路径关联的标签的 p4 ,并将它们作为标签添加到 Git 中。由于只有与新的更改列表相关的导入标签才有用。已过时。

--import-labels

将标签从 p4 导入到 Git 中。

--import-local

默认情况下,p4 分支存储在refs/remotes/p4/其中,它们将被 git-branch [1] 和其他命令视为远程跟踪分支。这个选项代替了 p4 分支refs/heads/p4/。请注意,未来的同步操作也必须指定--import-local,以便他们可以在 refs / heads 中找到 p4 分支。

--max-changes <n>

导入大多数n变化,而不是包含在给定修订说明符中的整个变化范围。一个典型的用法将被@all用作修订说明符,然后用于--max-changes 1000仅导入最后的1000个修订版本而不是整个修订历史记录。

--changes-block-size <n>

将修订说明符(例如,@all转换为特定更改编号列表)时使用的内部块大小。不是使用单个调用来p4 changes查找转换的完整更改列表,而是调用一系列调用p4 changes -m,其中每个调用都请求一个给定大小的更改块。默认块大小为500,通常应该是合适的。

--keep-path

缺省情况下,文件名从 p4 软件仓库路径到 Git 的映射涉及删除整个软件仓库路径。使用此选项,完整的 p4 仓库路径将保留在 Git 中。例如,//depot/main/foo/bar.c从中导入的路径//depot/main/变为foo/bar.c。与此同时--keep-path,Git 路径是depot/main/foo/bar.c

--use-client-spec

使用客户端规格在 p4 中查找感兴趣的文件列表。请参阅下面的“客户端规格”部分。

-/ <path>

克隆或同步时排除选定的软件仓库路径。

克隆选项

这些选项可以在初始阶段clone与上述sync选项一起使用。

--destination <directory>

在哪里创建 Git 存储库。如果未提供,则使用 p4 depot 路径中的最后一个组件创建新目录。

--bare

执行克隆空项。参见 git-clone [1] 。

提交选项

这些选项可以用来修改git p4 submit行为。

--origin <commit>

确认提交到 p4 的上游位置。默认情况下,这是可从中获得的最新 p4 提交HEAD

-M

检测重命名。参见 git-diff [1] 。重命名将使用显式move操作在 p4 中表示。没有对应的选项来检测副本,但移动和副本都有变量。

--preserve-user

在提交给 p4 之前,重新创建 p4 更改。该选项需要 p4 管理员权限。

--export-labels

从 Git 导出标签作为 p4 标签。在 Git 中找到的标签应用于 perforce 工作目录。

-n   --dry-run

显示将提交给 p4 的提交; 不要在 Git 或 p4 中更改状态。

--prepare-p4-only

将提交应用于 p4 工作区,在 p4 中打开,添加和删除文件,就像正常的提交操作一样。不要发布最终的“ p4 提交”,而是要打印一条关于如何手动提交或回复的消息。该选项总是在第一个(最早的)提交之后停止。Git 标签不会导出到 p4 。

--shelve

而不是提交创建一系列搁置的更改表。创建每个搁置后,相关文件将被还原/删除。如果您有多个提交,则会创建多个搁板。

--update-shelve CHANGELIST

使用此提交更新现有的搁置更改列表。意味着 --shelve。

--conflict=(ask|skip|quit)

将提交应用于 p4 时可能会发生冲突。发生这种情况时,默认行为(“询问”)是提示是否跳过此提交并继续或退出。此选项可用于绕过提示,导致提交冲突自动跳过,或退出尝试提交而不提示。

--branch <branch>

提交后,同步该命名分支,而不是默认的 p4 / master 。有关更多信息,请参阅上面的“同步选项”一节。

改变选项

这些选项可以用来修改git p4 rebase行为。

--import-labels

导入 p4 标签。

仓库路径语法

p4 的贮库路径参数git p4 syncgit p4 clone可以是一个或多个空格分隔 P4 贮库的路径,与在端部的可选 P4 修订说明符:

"//depot/my/project"

#head在树下的更改中导入一个具有所有文件的提交。

"//depot/my/project@all"

为该软件仓库路径的历史记录中的每个更改导入一个提交。

"//depot/my/project@1,6"

只导入更改1到6。

"//depot/proj1@all //depot/proj2@all"

将来自两个指定软件仓库路径的所有更改导入单个存储库。只包含这些目录下的文件。每个 “proj1” 和 “proj2” 在 Git 中都没有一个子目录。--destination指定多个软件仓库路径时必须使用该选项。修订说明符必须在每个软件仓库路径上指定相同。如果软件仓库路径中有相同名称的文件,则具有该文件最近更新版本的路径就是出现在 Git 中的路径。

请参阅p4 help revisions p4 修订说明符的完整语法。

客户端规格

p4 客户端规范是使用该p4 client命令维护的,并在其他字段中包含一个视图,指定仓库如何映射到客户端存储库。在clonesync给定的命令时,可以咨询客户规范--use-client-spec选项,或当 useClientSpec 变量为真。之后git p4 clone,useClientSpec 变量将在存储库配置文件中自动设置。这允许未来的git p4 submit命令正常工作; 提交命令仅查看变量并且没有命令行选项。

有关 p4 视图的完整语法记录在中p4 help viewsgit p4只知道视图语法的一个子集。它理解多行映射,覆盖+,排除-和空白处的双引号。可能的通配符中git p4只有句柄,并且只有在路径的末尾。git p4如果遇到未处理的通配符将会投诉。

存在重叠映射的实现中的错误。如果多个软件仓库路径通过叠加层映射到存储库中的相同位置,则git p4可以选择错误的路径。如果没有专门的客户端规范,这很难解决git p4

客户的名字可以以git p4多种方式给出。git-p4.client如果该变量存在,则该变量优先。否则,将使用确定客户端的普通 p4 机制:环境变量 P4CLIENT ,由 P4CONFIG 引用的文件或本地主机名。

分支检测

P4 与 Git 没有相同的分支概念。相反,p4将其内容组织为目录树,根据约定,不同的逻辑分支位于树中的不同位置。该p4 branch命令用于维护树中不同区域之间的映射,并指示相关内容。git p4可以使用这些映射来确定分支关系。

如果您有一个存储库,其中所有感兴趣的分支都作为单个软件仓库路径的子目录存在,则可以--detect-branches在克隆或同步时使用git p4自动在 p4 中查找子目录,并在 Git 中将其作为分支生成。

例如,如果 P4 存储库结构是:

//depot/main/...//depot/branch1/...

并且“p4 分支 - o 分支1”显示一个 View 行,如下所示:

//depot/main/... //depot/branch1/...

然后这个git p4 clone命令:

git p4 clone --detect-branches //depot@all

refs/remotes/p4/为// depot / main 生成一个单独的分支master,并调用一个/ depot / branch1 depot/branch1

但是,没有必要在 p4 中创建分支以便像分支一样使用它们。由于很难自动推断分支关系,git-p4.branchList因此可以使用 Git 配置设置来明确标识分支关系。它是一个 “source :destination” 对的列表,就像一个简单的 p4 分支规范,其中 “source” 和 “destination” 是 p4 存储库中的路径元素。上面的例子依赖于 p4 分支的存在。没有 p4 分支,相同的结果将会发生:

git init depot
cd depot
git config git-p4.branchList main:branch1
git p4 clone --detect-branches //depot@all .

性能

快速导入机制git p4为每次调用创建一个包文件git p4 sync。通常,Git 垃圾压缩( git-gc [1] )会自动将这些压缩到更少的包文件,但显式调用git repack -adf可能会提高性能。

配置变量

以下配置设置可用于修改git p4行为。他们都在该git-p4部分。

一般变量

git-p4.user

用户指定为所有p4命令的选项,并带有-u <user>。该环境变量P4USER可以用来代替。

git-p4.password

作为所有 p4 命令的选项指定的密码-P <password>。该环境变量P4PASS可以用来代替。

git-p4.port

端口被指定为所有 p4 命令的选项-p <port>。该环境变量P4PORT可以用来代替。

git-p4.host

主机被指定为所有 p4 命令的选项,其中包含-h <host>。该环境变量P4HOST可以用来代替。

git-p4.client

客户端指定为所有 p4 命令的选项-c <client>,包括客户端规范。

git-p4.retries

指定在p4 sync网络超时的情况下重试 p4 命令(特别是)的次数。默认值为3.将该值设置为0以禁用重试,或者如果您的 p4版本不支持重试(2012年之前)。

克隆和同步变量

git-p4.syncFromOrigin

因为从其他 Git 存储库导入提交比从 p4 导入提交要快得多,因此存在一种机制来首先在 Git 远程中查找 p4 更改。如果存在分支refs/remote/origin/p4,那么当从 p4 同步时,这些分支将被提取和使用。可以将此变量设置false为禁用此行为。

git-p4.branchUser

分支检测的一个阶段涉及查看 p4 分支以找到要导入的新分支。默认情况下,检查所有分支。此选项将搜索限制为仅由变量中指定的单个用户拥有的搜索。

git-p4.branchList

分支检测启用时要导入的分支列表。每个条目应该是一对由冒号(:)分隔的分支名称。这个例子声明 branchA 和 branchB 都是从 main 创建的:

git config       git-p4.branchList main:branchA
git config --add git-p4.branchList main:branchB

git-p4.ignoredP4Labels

要忽略的 p4 标签列表。这是在发现不可引用的标签时自动构建的。

git-p4.importLabels

根据 --import-labels 将 p4 标签导入到 git 中。

git-p4.labelImportRegexp

只有与此正则表达式匹配的 p4 标签才会被导入。默认值是[a-zA-Z0-9_\-.]+$

git-p4.useClientSpec

指定应该使用 p4 客户端规范来识别感兴趣的 p4 仓库路径。这相当于指定选项--use-client-spec。请参阅上面的“客户端规格”部分。这个变量是一个布尔值,而不是 p4 客户端的名字。

git-p4.pathEncoding

Perforce 保留原始操作系统给定的路径编码。Git 预计编码为 UTF-8 的路径。使用此配置来告诉 git-p4 Perforce 用于路径的编码。此编码用于将路径转码为 UTF-8 。例如,Windows 上的 Perforce 通常使用 “cp1252” 来编码路径名称。

git-p4.largeFileSystem

指定用于大型(二进制)文件的系统。请注意,大文件系统不支持该git p4 submit命令。只有 Git LFS 现在被实现(请参阅https://git-lfs.github.com/了解更多信息)。下载并安装 Git LFS 命令行扩展以使用此选项并像这样配置它:

git config       git-p4.largeFileSystem GitLFS

git-p4.largeFileExtensions

所有与列表中文件扩展名匹配的文件都将由大文件系统处理。不要以扩展名为前缀.

git-p4.largeFileThreshold

所有未压缩大小超过阈值的文件都将由大文件系统处理。默认情况下,阈值以字节为单位定义。添加后缀 k ,m 或 g 以更改单位。

git-p4.largeFileCompressedThreshold

压缩大小超过阈值的所有文件都将由大文件系统处理。此选项可能会减慢您的克隆/同步过程。默认情况下,阈值以字节为单位定义。添加后缀 k ,m 或 g 以更改单位。

git-p4.largeFilePush

定义大文件是否自动推送到服务器的布尔变量。

git-p4.keepEmptyCommits

如果此布尔选项设置为 true ,则仅包含排除文件的更改列表将作为空提交导入。

git-p4.mapUser

将 P4 用户映射到 Git 中的名称和电子邮件地址。使用以下格式的字符串来创建映射:

git config --add git-p4.mapUser "p4user = First Last <mail@address.com>"

映射将覆盖来自 P4 的任何用户信息。可以定义多个 P4 用户的映射。

提交变量

git-p4.detectRenames

检测重命名。参见 git-diff [1] 。这可能是真实的,错误的,或者如预期的那样git diff -M

git-p4.detectCopies

检测副本。参见 git-diff [1] 。这可能是真实的,错误的,或者如预期的那样git diff -C

git-p4.detectCopiesHarder

更难检测副本。参见 git-diff [1] 。一个布尔值。

git-p4.preserveUser

在提交时,无论谁调用,都要重新编写更改以反映 Git 作者git p4 submit

git-p4.allowMissingP4Users

如果preserveUser属实,git p4通常会在 p4 用户映射中找不到作者的情况下死亡。无论如何,此设置都会提交更改。

git-p4.skipSubmitEdit

提交过程在提交每个 p4 更改之前调用编辑器。但是,如果此设置为 true ,则跳过编辑步骤。

git-p4.skipSubmitEditCheck

编辑 p4 更改消息后,git p4通过查看文件修改时间确保描述确实发生了变化。该选项禁用该测试。

git-p4.allowSubmit

默认情况下,任何分支都可以用作git p4 submit操作的源。这个配置变量(如果设置的话)只允许指定的分支用作提交源。分支名称必须是短名称(不包括 “refs / heads /” ),并且应该用逗号(“,”)分隔,而不能有空格。

git-p4.skipUserNameCheck

如果git p4 submit在 p4 用户映射中不存在正在运行的用户,则git p4退出。无论如何,此选项都可用于强制提交。

git-p4.attemptRCSCleanup

如果启用,git p4 submit将尝试清理 RCS 关键字($ Header $等)。否则这些会导致合并冲突并阻止提交进行。目前这个选项应该被认为是实验性的。

git-p4.exportLabels

根据 --export-labels 将 Git 标签导出到 p4 标签。

git-p4.labelExportRegexp

只有与此正则表达式匹配的 p4 标签才会被导出。默认值是[a-zA-Z0-9_\-.]+$

git-p4.conflict

根据 --conflict 发现与 p4 发生冲突时的指定提交行为。默认行为是ask

实施细节

  • 使用 Git 快速导入来导入 p4 中的更改集。

  • 克隆或同步不需要 p4 客户端; 文件内容使用收集p4 print

  • 提交需要一个与 Git 存储库不在同一位置的 p4 客户端。修补程序一次一个地应用于此 p4 客户端并从那里提交。

  • 导入的每个提交git p4在日志消息末尾都有一行指示 p4 仓库位置和更改编号。此行被以后的git p4 sync操作用于了解哪些 p4 更改是新的。

上一篇: 下一篇: