DevOps解决方案 ＞ DevOps集成工具介绍 ＞ 代码关联介绍 ＞ Perforce ＞ TAPD Perforce SDK使用文档

用户使用说明

如何使用(linux)

1. 在p4d server上创建任意目录,并且修改其owner为perforce，例:/opt/tapd-p4-hook/

   1. chown -R perforce:perforce /opt/tapd-p4-hook```

2. 在tapd页面下载p4-hook-linux，将该文件放到第一步的目录下，并且给他分配执行权限，例: /opt/tapd-p4-hook/p4-hook-linux

   2. 3. 在tapd页面下载TAPD-config.json,将文件放到上一步文件同级目录,并且给他分配读权限，例: /opt/tapd-p4-hook/tapd-config.json

   chmod a+r /opt/tapd-p4-hook/tapd-config.json```

3. 执行命令初始化p4环境,(P4PORT根据实际的PORT来，默认是本机的1666端口)

   su -c "p4 set P4PORT=ssl:localhost:1666" perforce

4. 如果p4 server采用了unicode模式，必须要设置P4CHARSET（可选）

   su -c "p4 set P4CHARSET=utf8" perforce

5. 在p4 triggers中最后配置Triggers使hook生效

   su -c "p4 triggers" perforce

   Triggers解释：${Name} ${Type} ${Path} ${Command}

   • ${Name}可以自定义

   • ${Type}必须选change-commit

   • ${Path}填你需要监听的p4 path

   • ${Command}必须填之前的p4-hook-linux命令加上%change%参数（由于中间有空格，一定要带双引号）

   例:
   1. Triggers:
   2. tapd-p4-hook-linux change-commit //depot/... "/opt/tapd-p4-hook/p4-hook-linux %change%"

如何使用(windows)

1. 在p4d server上创建任意目录, 例:"C:\Users\zhangsan\workspace\tapd-p4-hook\"

2. 在tapd页面下载p4-hook-win.exe,将该文件放到第一步的目录下,例: "C:\Users\zhangsan\workspace\tapd-p4-hook\p4-hook-win.exe"

3. 在tapd页面下载TAPD-config.json,将文件放到上一步文件同级目录, 例: "C:\Users\zhangsan\workspace\tapd-p4-hook\tapd-config.json"

4. 在控制面板/编辑系统环境变量中设置系统变量(S) P4PORT,(P4PORT根据实际的PORT来，默认是本机的1666端口)(系统环境变量需要重启或者注销才能生效)

变量	值
P4PORT	localhost:1666

1. 如果p4 server采用了unicode模式，必须要在控制面板/编辑系统环境变量中设置系统变量(S)

   P4CHARSET(系统环境变量需要重启或者注销才能生效)（可选）

变量	值
P4CHARSET	utf8

1. 在p4 triggers中最后配置Triggers使hook生效

   2. Triggers解释：`${Name}` `${Type}` `${Path}` `${Command}`
   3. - `${Name}`可以自定义
   4. - `${Type}`必须选change-commit
   5. - `${Path}`填你需要监听的p4 path
   6. - `${Command}`必须填之前的p4-hook-win.exe命令加上%change%参数（由于中间有空格，一定要带双引号）
   8. 例:

   Triggers:

   tapd-p4-hook-win change-commit //depot/... "C:\Users\zhangsan\workspace\tapd-p4-hook\p4-hook-win.exe %change%"

   ```