# App 命令参考

> 旧版 Shoplazza CLI app 命令参考：应用开发的主题与命令总表，以及各条 app 命令和无前缀命令的详细说明。

本参考文档列出了 Shoplazza CLI 中用于 app 开发的命令。Theme 命令请参阅 [Theme 命令参考](/zh-CN/docs/theme/developer-tools/shoplazza-cli/theme-commands)。

这些命令使用语法 `shoplazza [topic] [command]`。

## 命令概览

| Topic | 命令 | 说明 |
| --- | --- | --- |
| [none](#login) | [login](#login) | 通过 Shoplazza CLI 对指定店铺进行身份验证并登录。 |
| [logout](#logout) | 退出 Shoplazza 账号。 |
| [switch](#switch) | 无需退出并重新登录即可切换店铺。 |
| [store](#store) | 显示当前连接的店铺。 |
| [version](#version) | 显示当前运行的 Shoplazza CLI 版本。 |
| [help](#help) | 列出可用命令并说明其功能。 |
| [app](#app-命令详情) | [init](#app-init) | 初始化新应用项目。创建新应用项目，或连接现有应用项目。 |
| [generate extension](#generate-extension) | 生成 extension template。为现有应用添加新 extension。 |
| [dev](#dev) | 启动本地开发服务器。本地开发与调试。 |
| [deploy](#deploy) | 将应用部署到生产环境。将应用发布到生产环境。 |
| [app config link](#config-link) | 链接应用配置文件。将现有应用连接到本地项目。 |
| [config use](#config-use) | 切换应用配置文件。在多个应用配置之间切换。 |
| [versions list](#versions-list) | 查看应用版本列表。管理应用版本历史。 |

## App 命令详情

### app Init

创建新应用项目，或连接现有应用项目。

```shell
shoplazza app init
```

#### Init 参数

| 参数 | 说明 |
| --- | --- |
| `--path <path>` | 指定项目创建路径（默认：当前目录） |
| `--client-id <client-id>` | 指定要连接的现有应用的 client ID |
| `--name <name>` | 指定应用名称 |

### generate extension

为现有应用生成新的 extension template，支持多种 extension 类型。

```shell
shoplazza app generate extension
```

#### generate extension 参数

| 参数 | 说明 |
| --- | --- |
| `--path <path>` | 指定项目路径（默认：当前目录） |

### dev

启动本地开发服务器。

```shell
shoplazza app dev
```

#### dev 参数

| 参数 | 说明 |
| --- | --- |
| `--path <path>` | 指定项目路径（默认：当前目录） |

### deploy

将应用部署到生产环境。

```shell
shoplazza app deploy
```

#### deploy 参数

| 参数 | 说明 |
| --- | --- |
| `--path <path>` | 指定项目路径（默认：当前目录） |

### config link

将现有 Shoplazza 应用链接到本地项目，创建配置文件。

```shell
shoplazza app config link
```

#### config link 参数

| 参数 | 说明 |
| --- | --- |
| `--path <path>` | 指定项目路径（默认：当前目录） |
| `--client-id <client-id>` | 指定要链接的应用的 client ID |

### config use

在项目中的多个应用配置文件之间切换，激活指定配置。

```shell
shoplazza app config use
```

#### config use 参数

| 参数 | 说明 |
| --- | --- |
| `--path <path>` | 指定项目路径（默认：当前目录） |

### versions list

查看应用所有已部署版本，支持分页和详细信息展示。

```shell
shoplazza app versions list
```

#### versions list 参数

| 参数 | 说明 |
| --- | --- |
| `--path <path>` | 指定项目路径（默认：当前目录） |
| `--page-size <number>` | 每页显示的版本数量（默认：10） |

## 无前缀命令详情

### login

登录 Shoplazza 账号。

**终端**

```shell
shoplazza login
```

#### login 参数

| 参数 | 说明 |
| --- | --- |
| `--store <store>` | 用于预览 theme 的开发店铺。<br>`--store` 参数接受以下输入：<br>*   店铺前缀，例如 `my-store.myshoplaza.com`<br>*   Shoplazza URL，例如 `https://my-store.myshoplaza.com` |

### logout

退出 Shoplazza 账号。

**终端**

```shell
shoplazza logout
```

### switch

无需退出并重新登录即可切换店铺。

如果不带 `--store` 参数输入此命令，系统会提示您选择与账号关联的店铺。

**终端**

```shell
shoplazza switch
```

#### switch 参数

| 参数 | 说明 |
| --- | --- |
| `--store <store>` | 用于切换 theme 的开发店铺。<br>`--store` 参数接受以下输入：<br>*   店铺前缀，例如 `my-store.myshoplaza.com`<br>*   Shoplazza URL，例如 `https://my-store.myshoplaza.com` |

### store

显示当前连接的店铺。

**终端**

```shell
shoplazza store
```

### version

显示当前运行的 Shoplazza CLI 版本。

**终端**

```shell
shoplazza version
```

### help

列出可用命令并说明其功能。

**终端**

```shell
shoplazza help
```

您还可以使用 `help` 命令或选项获取特定命令的详细信息：

**终端**

```shell
shoplazza help [command]
```

或者，

**终端**

```shell
shoplazza [command] --help
```

或者，

**终端**

```shell
shoplazza [command] -h
```