Perforce - Shotgun 同步

Perforce Shotgun 同步

此应用包含用于将 Perforce 更改同步到 Shotgun 的同步命令。


开发者:Shotgun Software
最新版本:v0.1.5 (Alpha)
我们的版本号遵循语义化版本标准。
系统名称:tk-shell-perforcesync

概述

本文档介绍仅当控制 Toolkit 配置时可用的功能。有关详细信息,请参见 Shotgun 集成用户手册。此应用是 Perforce 与 Shotgun 之间的链接。应用将在 Shotgun 中为新提交的、包含 Toolkit 可识别的文件的 Perforce 更改创建修订实体,并且每个文件修订将注册一个发布文件实体。该应用可以作为后台进程/进程运行以确保 Shotgun 与 Perforce 保持同步。

文档

目前,我们正在编写此应用的文档。在此期间,如果您想高度概括地了解我们如何将 Perforce 集成到 Shotgun Pipeline Toolkit 之中,请参见此页面:

将 Perforce 与 Shotgun 同步。

要在 Perforce 与 Shotgun 之间同步特定的更改,需要使用此应用注册的 sync_perforce 命令。此命令应在项目上下文中运行,例如:

./tank Project <project id> sync_perforce -s <start change> -e <end change> -u <perforce user> -p <perforce password>

此命令仅会注册尚未向 Shotgun 注册的更改和已发布的文件。

同步进程

要在新更改提交至 Perforce 的同时不断同步这些更改,您可以使用 sync_perforce_daemon 命令,该命令应作为后台进程运行在服务器上(具体做法因操作系统而异 - 更多详细信息即将推出!)。

按如下所示运行同步进程命令:

./tank Project <project id> sync_perforce_daemon -u <perforce user> -p <perforce password>

大量先前存在的更改

如果您使用的 Perforce 服务器包含大量更改,而您确信 Toolkit 一定能够忽略这些更改,也可以向进程命令传递一个启动参数 - 但是只需在首次启动进程时发送一次即可。

./tank Project <project id> sync_perforce_daemon -s 123456 -u <perforce user> -p <perforce password>

相关应用和文档

Perforce 集成

本文档介绍仅当控制 Toolkit 配置时可用的功能。有关详细信息,请参见《Shotgun 集成管理员手册》(https://support.shotgunsoftware.com/hc/zh-cn/articles/115000067493#Configuring%20the%20software%20in%20Shotgun%20Desktop)。本文档介绍了 Toolkit 的 Perforce 集成 - 内容、受众和执行方式的深层概述。

安装和更新

将此应用添加到 Shotgun Pipeline Toolkit

如果您想将此应用添加到 Project XYZ 中名为 asset 的环境中,请执行以下命令:

> tank Project XYZ install_app asset tk-shell tk-shell-perforcesync

更新至最新版本

如果您已在某个项目中安装了此应用,要获取最新版本,可运行 update 命令。您可以导航到该特定项目随附的 tank 命令,并在该项目中运行它:

> cd /my_tank_configs/project_xyz
> ./tank updates

或者,也可以运行您的工作室的 tank 命令并指定项目名称,指示该命令要对哪个项目运行更新检查:

> tank Project XYZ updates

协作和代码演进

如果您可以获取 Shotgun Pipeline Toolkit,意味着也可以获取我们在 GitHub 中存储和管理的所有应用、插件和框架的源代码。欢迎根据实际需要演进和完善这些内容,以它们为基础做进一步的独立开发,修改它们(以及向我们提交 Pull 请求!),或者只是随手玩一玩,简单了解它们的构建方式和 Toolkit 的工作原理。您可以通过以下网址访问此代码库:https://github.com/shotgunsoftware/tk-shell-perforcesync

特殊要求

  • 需要安装 Shotgun Pipeline Toolkit 核心 API 版本 v0.14.43 或更高版本才能使用此功能。
  • 需要安装插件版本 v0.3.6 或更高版本才能使用此功能。

配置

下面是使用的所有配置设置的摘要。您需要在要启用此应用或插件的环境文件中定义这些设置。

poll_interval

类型:int

默认值:5

说明:进程轮询新更改的间隔时间(以秒为单位)。

关注

0 评论

登录写评论。