安装 Shotgun Desktop 并创建您的第一个 Toolkit 项目

请注意，此文档已过时。现在，您应该按照 Shotgun 集成用户手册中的说明，从 Shotgun 内下载 Shotgun Desktop。想要对 Shotgun Pipeline Toolkit 有一个全面的了解？本文档提供了简单的分步说明，介绍如何安装 Shotgun Desktop 并设置您的第一个 Toolkit 项目。

弃用注释

本文档已过期。您应该按照用户手册中的说明从 Shotgun 中下载 Shotgun Desktop。

有关如何配置 Desktop 和设置项目的信息已移动到管理员手册。

简介

本文档介绍了如何安装和配置 Toolkit 和 Shotgun Desktop。如果您是首次试用 Toolkit，我们建议您从此处开始。只需按照分布说明执行操作即可。我们将引导您在测试环境中以默认设置完成对 Shotgun Desktop 和 Toolkit 的设置。

设置完第一个项目之后，您可以试用它，对其进行修补，更深入地查看其工作方式和了解其如何使用工作流。学习如何使用 Toolkit 创建文件夹和磁盘以及如何对其进行设置以使用您的工作室文件命名约定。

为了运行 Shotgun Desktop 和 Pipeline Toolkit，需要启动并运行一个 Shotgun 站点。如果没有，请转到此处，创建免费的 Shotgun 试用帐户。

下载 Shotgun Desktop

所有一切都始于 Shotgun Desktop。Shotgun Desktop 是一款软件应用程序，它将 Shotgun 体验延伸到本地计算机，让您可以轻松访问 Shotgun 数据、启动应用程序，并直接从您的计算机上运行工作流集成工具。Shotgun Desktop 还负责 Toolkit 项目的安装和维护。

Shotgun Desktop 具有面向 Windows、Mac 和 Linux 的独立安装程序。请单击下面的链接下载适合您的环境的 Shotgun Desktop：

上面的链接指向最新版本。

如果已在计算机上下载并安装 Shotgun Desktop，只需双击即可启动安装程序。请注意，您可能需要具有管理员权限才能在计算机上安装应用程序。

高级安装主题

配置 Shotgun Desktop

有关如何配置 Shotgun Desktop，请参见管理员手册中的相应文档。

基于命令行的激活

在将 Shotgun Desktop 作为 Toolkit 快速入门推荐方式引入之前，我们有一个基于命令行的激活工作流。此工作流的技术性稍强一些，但在某些情况下可以发挥重要作用，例如您在运行 Shotgun Desktop 的 UI 环境遇到问题之时。在这种情况下，我们建议您参考基于命令行的激活文档：

> 基于命令行的激活。

现有 Shotgun Desktop 试点计划用户

如果您参与了我们的 Shotgun Desktop 试点计划，并已安装试用版 Shotgun Desktop，则需要先卸载该版本，然后再安装正式版。

除此之外，您还需要转到 Shotgun，找到并删除模板项目的主要工作流配置。如果需要任何帮助，请联系我们：support@shotgunsoftware.com。

如果您无法在启动 Shotgun Desktop 之前删除模板项目的主要工作流配置，您将遇到以下错误：

Cannot set up this project! Non-auto-path style pipeline configuration entries already exist in Shotgun.

详细的系统要求

当前支持以下操作系统平台：

Windows XP/Vista/7/8/10
macOS 10.6 以上版本
Linux 64 位 CentOS 5/6 和 Fedora 15 以上版本（单独的安装程序）

对于 CentOS 5/6 安装程序，需要在目标计算机上安装以下库：

libcrypto.so.6（64 位）
libgnome-keyring.so.0（64 位）
libssl.so.6（64 位）
libreadline.so.5（64 位）
libgdbm.so.2（64 位）
在某些版本中，还需要 compat-readline5（64 位）。

对于 Fedora 安装程序，需要在目标计算机上安装以下库：

libcrypto.so.10（64 位）
libgobject-2.0.so.0（64 位）
libssl.so.10（64 位）
libreadline.so.6（64 位）
libgdbm.so.4（64 位）

在 Linux 上，成功安装后可执行文件位于此处：/opt/Shotgun/Shotgun

如果您的工作室已经设置 Toolkit，会怎么样？

如果工作室中已经在运行 Toolkit，Shotgun Desktop 不会更改任何现有的工作流。它将读取现有工作流配置，然后当您在项目概述中单击某个项目时，它会尝试加载该项目的项目环境，并启动 Desktop 插件。如果未找到 Desktop 插件，可以单击某个按钮，然后 Shotgun Desktop 将自动复制现有 Shotgun 动作菜单项并使用这些条目创建 Desktop 插件配置。

Desktop 安装过程如何正常工作？它会影响现有设置吗？

未经您的同意，Shotgun Desktop 不会更改任何现有项目配置或其他设置项。安装完成后，启动 Shotgun Desktop，然后使用正常的 Shotgun 用户名和密码登录，Shotgun Desktop 将创建“站点配置”。这是一种新型的工作流配置，它并不关联任何特定项目，而是表示整个站点及其所有项目。您可以采用与默认模板项目关联的工作流配置条目形式查看此站点配置。另请注意，在默认情况下，此工作流配置为空路径条目。这意味着配置可以在新的自动路径模式下运行，而无需位于磁盘的特定位置。相反，Shotgun Desktop 将管理站点配置的位置，并自动在您的本地计算机上安装。

不需要像正常项目那样来维护此站点配置（使用 tank updates 和 tank core 命令）。这并不切合实际，因为每台已安装 Shotgun Desktop 的本地计算机上都有一个站点配置。相反，每次启动 Shotgun Desktop 时都将自动更新，以确保所有用户都运行相同（最新）版本。

请注意，您完全可以更改此站点配置的行为，使其与正常项目一样。只需在 Shotgun 中向站点工作流配置添加路径条目，然后将本地站点配置移动到此位置，这样此配置的行为将与其他项目一样。为站点配置准确设置路径后，自动更新也将停止。

还可以在环境变量 TK_SITE_CONFIG_ROOT 中指定站点配置根路径。这是在发布之前测试对站点配置所做更改的好方法。但是，请注意，必须使用指定配置的路径更新 install_location.yml，这样才能实际使用该配置。

无法快速入门？

如果您在安装 Toolkit 或 Shotgun Desktop 时遇到问题，不必担心。我们随时提供帮助。Toolkit 系统有点复杂，我们很高兴能够引导您完成高级设置，或者在您不确定要执行什么操作时提供帮助。下面是一些提示：

如果您运行的是本地托管的 Shotgun 或使用代理服务器，请参见上述“高级安装主题”部分，查看相关建议和选项。
如果您希望设置 Perforce 或游戏配置，安装后还需执行一些其他步骤。请联系我们，我们很高兴为您提供帮助！
如果使用 Shotgun Desktop 时出现问题，并希望使用之前的基于命令行的 Toolkit 激活，可以在此处找到详细说明：

> 基于命令行的激活。

如果您有任何疑问或需要帮助，请随时与我们联系：support@shotgunsoftware.com。我们很乐意帮助并引导您完成该过程。

首次运行 Shotgun Desktop

首次启动 Shotgun Desktop 时，系统会要求您登录到您的站点。

注意：首次在某个 Shotgun 站点上登录到 Desktop 时以及每次设置项目时，请确保您的登录身份具有管理员权限，否则将无法执行某些设置步骤。

现在，Shotgun Desktop 将提示您跳转到“App Preferences”并启用 Toolkit（如果尚未执行此操作）。

启用 Toolkit 后，Shotgun Desktop 将自动初始化，短暂延迟后，您将看到所有 Shotgun 项目的概况。现在，进入一个项目之后，通过单击“Set up Project”按钮即可直接进入 Toolkit 项目设置向导。

Desktop 下载和设置