跳到主要内容

构建结账扩展

本教程端到端构建一个结账扩展——脚手架、开发、推送版本、再激活。checkoutcheckout-extension 的别名。

前置条件

  • 已安装 Shoplazza CLI——见安装
  • 已认证——见认证

1. 脚手架项目

init 创建一个项目目录并带上第一个扩展(本地,无网络):

shell
shoplazza checkout init --name my-project --extension my-ext
cd my-project

之后要加扩展,在项目内运行 shoplazza checkout create --name another-ext

2. 带热更新开发

启动开发服务器(重建 + HMR,端口 8888):

shell
shoplazza checkout dev --extension-name my-ext

--extension-name ext1,ext2 同时开发多个,或用 --all 开发全部。

3. 构建

shell
shoplazza checkout build --name my-ext

4. 推送版本

push 会构建并上传新版本,但不激活:

shell
shoplazza checkout push --name my-ext

也可显式指定版本(必须大于上次推送的版本):

shell
shoplazza checkout push --name my-ext --version 1.1

5. 激活

先找到服务端扩展 id 及其版本:

shell
shoplazza checkout list --all
shoplazza checkout versions --extension-id abc123

再用 deploy 激活该版本:

shell
shoplazza checkout deploy --extension-id abc123 --version 1.1
提示

deployundeploypreviewversions--dry-run,可只打印请求而不发送。

6. 预览

为某个版本生成可分享的预览 URL:

shell
shoplazza checkout preview --extension-id abc123 --version 1.1

下一步