跳到主要内容

概述

Shoplazza CLI 是一个命令行界面工具,可帮助您构建 Shoplazza theme 和应用。它可以快速生成 Shoplazza theme 和应用,也可用于自动化处理许多常见的开发任务。

本文介绍如何使用 Shoplazza CLI 进行 theme 开发。

如果您刚开始搭建开发环境,可以先了解 CLI 在 theme 开发中的作用,再进入安装和命令参考。本文中的“开发 theme”强调本地开发与店铺预览之间的连接关系,后续命令说明会围绕初始化、预览、上传、共享和发布等常见任务展开。

功能

Shoplazza CLI 可通过以下功能加快您的 theme 开发流程:

  • 使用开发 theme 安全地预览、测试和共享 theme 更改
  • 预览 theme 时,对 CSS 和 section 更改进行热重载,或在文件更改时自动刷新页面
  • 使用 Nova 2023 作为起点初始化新的 theme
  • 通过命令行推送和发布 theme

开发 theme

开发 theme 是一种临时、隐藏的 theme,会连接到您用于开发的 Shoplazza 店铺。当您将 theme 作为开发 theme 连接到店铺时,可以使用该店铺的数据进行本地测试。

您可以使用 Shoplazza theme serve 命令创建开发 theme。

运行 shoplazza logout 后,您的开发 theme 会被删除。如果您希望在退出登录后仍可访问 theme 预览链接,则应将开发 theme push 到店铺中一个未发布的 theme。

您可以使用开发 theme 完成以下任务:

  • 实时查看本地开发 theme 的更改
  • 使用 Shoplazza admin theme editor 自定义 theme 并与其交互
  • 与其他开发者共享受密码保护的 theme 预览

安装

如需了解如何在 Windows、macOS 或 Linux 上安装 Shoplazza CLI,请参阅安装 Shoplazza CLI

开始使用

有关使用 Shoplazza CLI 创建或处理 Shoplazza theme 的详细信息,请参阅以下教程:

命令参考

请参阅 Shoplazza CLI theme 命令参考,了解可用于构建 theme 的命令。

身份验证和访问店铺

作为 theme 开发者,您可能需要使用 Shoplazza 店铺来测试 theme,或与相关人员共享 theme。您也可能需要处理多个店铺,或使用不同的凭证来验证特定店铺的访问权限。您可以了解使用 Shoplazza CLI 处理店铺时可用的身份验证方式,以及如何在账号和店铺之间切换。

身份验证

使用 Shoplazza CLI 处理 Shoplazza 店铺中的 theme 时,您只能使用 Log in with a Shoplazza account 身份验证方式。

使用 Shoplazza 账号登录

您可以使用以下类型的 Shoplazza 账号访问要处理的店铺:

  • 具有 Themes 权限的员工账号
  • 店铺所有者账号

如需使用 Shoplazza 账号进行身份验证,请运行一个需要访问店铺的命令。系统会提示您登录。

切换账号

如果需要切换账号,请使用以下命令退出当前账号:

shoplazza logout

下次输入需要身份验证的命令时,系统会提示您登录,您可以输入一组新的凭证。

连接到店铺

首先,运行一个需要访问店铺的命令以使用 Shoplazza 账号进行身份验证,然后输入需要与 Shoplazza 店铺交互的命令。

shoplazza login --store my-store
shoplazza theme serve

您指定的店铺会用于后续命令,直到指定新的店铺为止。

如果要更改正在交互的店铺,必须先退出当前已登录的账号,然后登录到要交互的新 Shoplazza 店铺。

目录结构

只有当您使用的目录符合默认 Shoplazza theme 目录结构时,才能运行某些 theme 命令,例如 shoplazza theme serve。如果使用构建工具生成 theme 文件,您可能需要从生成文件所在的目录运行命令。

默认 Shoplazza theme 目录结构如下:

└── project
├── assets
├── config
├── layout
├── locales
├── sections
├── snippets
└── templates
└── customers

升级 Shoplazza CLI

如需将 Shoplazza CLI 升级到最新版本,请使用 upgrade 命令:

npm update -g shoplazza-cli

如需检查 CLI 版本,请使用 version 命令:

shoplazza version