迁移指南:OS 2.1 到 OS 3.0

你可以通过本指南了解主题应用扩展 Online Store 2.1 (OS 2.1) 版本和 Online Store 2.1 (OS 3.0) 版本的差异,以及迁移的步骤。


目录升级

OS 2.1 及 OS 3.0 主题应用扩展目录主要差异如下:

OS 2.1 目录OS 3.0 目录
assetspublic
localesi18n
snippetscomponents

OS 2.1 及 OS 3.0 主题应用扩展目录详情参考:


语法升级

原语法新语法
HandlebarsSline

迁移步骤

如果你的现有项目需要升级支持 OS 3.0 主题,可以跟随以下步骤进行升级:

  1. .shopline-cli.yml文件中新增 compatibility: true
---
compatibility: true # 新增
project_type: extension
organization_id: 0
EXTENSION_TYPE: THEME_APP_EXTENSION
  1. 在项目根目录新增 compatibility目录,并且将主题应用扩展 OS 2.1 的目录放在此目录内。
└── theme-app-extension
├── blocks
│ └── ...
├── components
│ └── ...
├── i18n
│ └── ...
├── public
│ └── ...
├── compatibility # 新增
│ ├── assets
│ ├── blocks
│ ├── locales
│ ├── snippets
│ └── ...
└── .shopline-cli.yml
  1. 废弃 schema 内的 locales 字段,统一迁移到 i18n 目录。
<div>{{ "title" | t() }}</div>
{{#schema}}
{
...
locales: { # 废弃
"en": {
"title": "Title"
},
"zh-hans-cn": {
"title": "标题"
}
}
}
{{/schema}}

英文内容迁移到 i18n/en.json

{
"title": "Title"
}

中文内容迁移到 i18n/zh-hans-cn.json

{
"title": "标题"
}
  1. 安装 新版本 SHOPLINE CLI 并使用。
npm install @shoplineos/cli -g
这篇文章对你有帮助吗?