发布 提供将文件发布至 Shotgun 的用户界面和功能。 最新版本：v2.5.5 (prod) 我们的版本号遵循语义化版本标准。 应用插件名称：tk-multi-publish2

文档

发布器的完整文档位于此处。

相关应用和文档

加载器 使用 Shotgun 加载器可以快速简要了解和浏览已发布到 Shotgun 的文件。通过一个可搜索的树视图导航系统可以轻松快速地到达您要查找的任务、镜头或资产，之后，加载器显示相应项目的所有发布的缩略图式概况。通过可配置的挂钩，您便可以轻松地在您的当前场景中引用或导入发布。

Shotgun 面板 通过 Shotgun 面板可以快速访问某个嵌入式面板中的 Shotgun 信息。可以使用它轻松访问有关用户当前正在处理的任务的信息，并且您可以即时访问活动流、注释、任务、版本和发布。可播放您团队中的其他成员发送以进行审核的版本。可在您的应用程序中直接回复注释。如果您的工作流跟踪依存关系信息，您也可以直接从 Shotgun 面板浏览此信息。

管理员手册 这是 Shotgun 集成的管理员手册。

用户手册 这是 Shotgun 集成的用户手册。

安装和更新

将此应用添加到 Shotgun Pipeline Toolkit

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

> tank Project XYZ install_app asset tk-maya tk-multi-publish2

更新至最新版本

如果您已在某个项目中安装了此应用，要获取最新版本，可运行 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-multi-publish2。

特殊要求

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

配置

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

display_name

类型：str

默认值： Publish

说明：指定在菜单和主发布对话框中使用的名称。

pre_publish

类型：hook

默认值： {self}/pre_publish.py

说明：此挂钩定义在显示发布对话框之前要执行的逻辑。在允许用户继续发布之前，可能存在需要检查的情况。

validate_on_publish

类型：bool

默认值： True

说明：如果为 True（默认值），单击“发布”(Publish)按钮将先执行验证逻辑，然后再发布。如果为 False，将跳过验证。如果为 False，并且没有手动触发验证，在继续执行发布逻辑之前，将弹出一个确认对话框。注意：这是高级选项。如果将此项设置为“False”，很可能会打破附带的 Toolkit 集成，这些集成假设在发布之前始终会执行验证。

task_required

类型：bool

说明：如果为 True，则验证是否为每个项目选择了任务，并禁用/启用“验证”(Validate)和“发布”(Publish)按钮，最后更改任务标签的颜色。

publish_plugins

类型：list

默认值： [{'hook': '{self}/publish_file.py', 'name': 'Publish to Shotgun', 'settings': {}}, {'hook': '{self}/upload_version.py', 'name': 'Upload for review', 'settings': {}}]

说明：发布插件列表。

post_phase

类型：hook

默认值： {self}/post_phase.py

说明：此挂钩定义在每个发布执行阶段（包括验证、发布和完成）之后要执行的逻辑。这样，可以在发布会话期间对发布树进行非常具体的管理和自定义。例如，可以通过此挂钩在验证之后将发布树序列化至磁盘。

path_info

类型：hook

默认值： {self}/path_info.py

说明：此挂钩包含在发布期间用于通过文件路径推断信息的方法。它包括版本和帧编号标识、发布显示名称、图像序列路径等。

modal

类型：bool

说明：如果为 True，将在模态窗口模式下打开应用对话框，如果为 False（默认值），将在非模态窗口模式下打开对话框。

help_url

类型：str

说明：在发布器中单击帮助按钮时打开的 URL。此 URL 指向的页面通常应列出工作室的发布工作流。如果没有提供 URL，则帮助按钮不会显示。

display_action_name

类型：str

默认值： Publish

说明：简短版本的 display_name 设置，用作按钮名称。

collector

类型：hook

默认值： {self}/collector.py

说明：从场景和拖放的文件中提取项目时的逻辑。

collector_settings

类型：dict

说明：收集器特定的配置设置。

enable_manual_load

类型：bool

默认值： True

说明：如果为 True（默认值，正常操作），用户可以与主对话框进行交互以放置文件或文件夹。此外，用户还可以使用浏览按钮来选择文件或文件夹。如果为 False，此功能基本上会禁止用户将任何内容添加到项目中。