开始使用主题套件

主题套件是一个跨平台命令行工具，您可以用它来创建 Shopify 主题。要快速使用主题工具包，请按照本指南中的步骤操作。

要求

您可以访问 Shopify 商店。
熟悉命令行的基本操作。

第1步：安装主题工具包

您可以在以下操作系统中使用命令行安装主题工具包：

Linux
MacOS
Windows

注意
如果以前安装过主题工具包，请确保使用的是最新版本。

Linux

使用以下安装脚本自动下载并安装最新版本的主题工具包：

curl -s https://shopify.dev/themekit.py | sudo python3

注意事项
目前不支持 Linux 下的Homebrew。

macOS

使用 Homebrew 运行以下命令安装主题工具包：

brew tap shopify/shopify
brew install themekit

苹果 M1 架构尚未获得本机支持，但如果使用 Rosetta 启动终端，主题工具包就能正常工作。

Windows

运行以下命令，用 Chocolatey 安装主题工具包：

choco install themekit

步骤 2：获取主题密码

安装主题工具包后，您需要获取一个主题密码，以便将主题工具包连接到您的商店并管理模板文件。拥有相应权限的店主或员工可以使用主题访问应用程序为你创建一个主题密码。

步骤：

请店主或有相应权限的工作人员使用主题访问应用程序为你创建主题密码。
进入收件箱，打开包含主题密码的邀请函。
在邀请函中单击 “获取主题密码”。
复制密码。您将在下一步中使用它。

链接在 7 天后或您查看密码后失效。您只能查看一次密码

步骤 3：连接到现有主题

注意
如果不想使用现有主题，可以创建一个新主题。

要连接到现有主题，你需要该主题的 ID。获取主题 ID 的最简单方法是使用主题获取命令，它会返回商店中存在的主题和 ID 列表。

下面是主题获取命令的示例，其中 your-password 是步骤 2 中的主题密码，your-store 是店铺的 Shopify 域名：

theme get --list --password=[your-password] --store="[your-store.myshopify.com]"

提示
不要在商店参数中包含 URL 协议（HTTP 或 HTTPS）。

使用 PowerShell

如果您使用的是 PowerShell，那么在单破折号之后的 URL 周围需要加上引号。如果您在命令中使用的是简写形式，这一点尤为重要。例如，下面显示了一个可以使用的示例和一个不能使用的示例：

正确的

theme get --list -p=[password] -s="my-store.myshopify.com"

错误的

theme get --list -p=[password] -s=my-store.myshopify.com

步骤4：设置配置文件

配置文件（config.yml）会创建与 Shopify 商店主题的本地连接。您可以使用之前收集的信息（主题密码和主题 ID）在主题中创建 config.yml 文件，然后在本地下载主题。

步骤：

1.为您的主题创建一个目录：

mkdir [your-theme-name]

2.导航至新目录

cd [your-theme-name]

3.要下载特定主题，并创建 config.yml 文件将该主题与刚创建的目录中的本地版本连接起来，请运行以下命令：

theme get --password=[your-password] --store="[your-store.myshopify.com]" --themeid=[your-theme-id]

步骤 5：创建新主题

要创建新主题，请运行以下命令：

theme new --password=[your-password] --store="[your-store.myshopify.com]" --name=[theme name]

运行新建主题命令可实现以下功能：

在本地生成基本主题模板
在您的 Shopify 商店中创建一个新主题
将新文件上传到您的 Shopify 商店
用新主题的配置创建或更新 config.yml 文件

第 6 步：向主题推送更新

现在您已经建立了与 Shopify 主题的连接，可以在主题目录下运行以下命令：

theme watch

主题监视命令指示主题工具包监视对本地文件所做的任何更改，并自动将更改推送到所连接的 Shopify 商店中的主题。要关闭观察连接，请键入 ctrl + c。

要求