目标
尝试参考 官方文档 Helix Core Command-Line (P4) Guide (2022.1) 学习如何使用命令行执行P4操作。
(P4所有命令见:Helix Core Command-Line (P4) Reference (2022.1))
(本篇测试环境上接《学习从零创建并配置一个P4服务器》,只是又新加了一个名为yaksue的用户,并在仓库中新加了一个测试文件名为 guaguga.txt)
确认:已经连上服务器
输入p4 info
来确认是否已经连上了服务器,如果没有,则会出现以下提示:(这里我预先输入了一个错误的PORT)
要设置一个正确的PORT来连接服务器:
SET P4PORT=[服务器IP地址]:1666
这里我的所使用的的机器就是服务器的机器,所以我可以使用localhost,即:
SET P4PORT=localhost:1666
如果设置成功,再输入p4 info
,就可以看到有连接信息了:
(这里看到 Server address 竟然是steamcommunity的 -。- 应该是之前登不上Steam社区而做了一些设置导致localhost显示steam社区。。。)
确认:登录上了用户
输入p4 user
来查看当前登录的用户。如果没有登录用户,则会出现以下提示:(这里我预先输入了一个错误的用户)
要登录用户,需要先设置用户名:
SET P4USER=[账户名]
比如我这里就是
SET P4USER=yaksue
随后输入p4 login
来登录。会提示要输入密码。输入之后即显示登录:
如果登录用户成功,输入p4 user
就会弹出当前登录的用户的信息:
(可以在这个文本编辑中改变用户的信息)
测试:创建WorkSpace
先切换到想要建立WorkSpace的本地路径,比如我这里是
cd D:\Test\TestP4WorkSpace
然后,设置WorkSpace的名字,比如我这里是:
SET P4CLIENT=TestYaksueWorkSpace
最后就可以使用p4 client
来创建WorkSpace了
p4 client -S //ProjectYKS/main
(-S
表示对应的Stream是哪个,注意最后没有/
符号)
此命令将打开一个文本编辑器,可以在此修改WorkSpace的各种设定
关闭此文本编辑器后,WorkSpace即成功创建
测试:更新
使用p4 sync
来更新WorkSpace。
注意我这里还使用了-c
来指定WorkSpace,这个是一个“全局设置”,详见 官方文档 Global options
测试:创建changelist
命令是p4 change
。
输入后会弹出文本编辑框,在此可以设置changelist的一些信息
修改并保存文本后关闭,可以在cmd中看到创建了新的编号为 3 的changelist:
还可以打开P4V确认changelist已经创建:
测试:checkout文件到指定changelist
使用p4 edit
来checkout文件。注意,我这里使用的命令是
p4 -c TestYaksueWorkSpace edit -c 3 guaguga.txt
。
其中:
- 第一个
-c
正如先前提到,是 “全局设置” ,覆写了WorkSpace名字。 - 第二个
-c
是edit
命令的参数,它指定了changelist的编号,我这里是 3,即刚创建出来的。 - 最后的参数是文件名,我这里不带路径了是因为我已经在WorkSpace的目录下了。
运行后也可以在 P4V 中确认到文件已经被checkout到了指定的changelist中了:
测试:提交特定changelist
修改一下 guaguga.txt 文件,准备提交。
提交的命令是p4 submit
比如这里我使用
p4 -c TestYaksueWorkSpace submit -c 3
这将提交编号是 3 的changelist。
运行后,也可以在P4V中此文件已经被提交:
总结
- 在跑命令之前,先使用
p4 info
来确认连接上了服务器,再使用p4 user
确认登陆上了正确的用户。 - 一些环境变量会起到重要的作用,比如
P4PORT
和P4USER
等,完整的变量见 官方文档:Environment and registry variables - P4的命令结构大多是
p4 [全局设置] [命令] [命令的若干参数] [文件们]
。其中:所有的[全局设置]
见 官方文档:Global options;而所有的[命令] [命令的若干参数]
见 官方文档:Commands - alphabetical list
命令行教程首页:Helix Core Command-Line (P4) Guide
命令行手册首页:Helix Core Command-Line (P4) Reference