构建你的第一个应用
本教程用 Shoplazza CLI 走一遍完整的应用生命周期——从空目录到部署好、带扩展的应用,约 15 分钟。
前置条件
- 已安装 Shoplazza CLI——见安装
- 一个 Shoplazza 合作伙伴账号
PATH中有git(app init和app extension create用它克隆模板)
1. 认证
--domain app 会授予应用扩展开发所需的权限:
shell
shoplazza auth login --store-domain my-store.myshoplaza.com --domain app
验证:
shell
shoplazza auth status
2. 脚手架应用
app init 创建一个新应用,并将其项目脚手架到子目录中:
shell
shoplazza app init --name "my-app"
若你的账号属于多个 partner,加上 --partner <id>。若要关联已有应用,改用 shoplazza app init --client-id <client_id>。若该 partner 下已有名为 my-app 的应用,app init 会停下并给出它的 client_id,而不会重复创建。在终端中也可以不带参数运行 shoplazza app init,按提示作答。
shell
cd my-app
3. 添加扩展
将一个主题扩展脚手架到项目中:
shell
shoplazza app extension create --type theme --name my-theme --theme-type basic
--type 接受 theme、checkout 或 function。函数扩展:--type function --name my-function。
4. 本地开发
构建所有扩展并推送到店铺,同时启动带公网隧道的开发服务器:
shell
shoplazza app dev
应用来自当前激活的应用配置,店铺为你的当前店铺。刷新店铺即可看到扩展的改动。没有文件监听——改完文件后需重新运行 app dev。用 --debug 输出详细构建日志。
要在合作伙伴后台登记隧道 URL,运行 shoplazza app dev --write-urls(会把它们记录到应用配置的 [dashboard] 段),再运行 shoplazza app config push。
5. 部署
构建所有扩展,并把应用的新版本部署到你的当前店铺(在终端中会先请你确认):
shell
shoplazza app deploy
6. 查看已部署版本
shell
shoplazza app versions