迁移指南: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 目录 |
|---|---|
| assets | public |
| locales | i18n |
| snippets | components |
OS 2.1 及 OS 3.0 主题应用扩展目录详情参考:
语法升级
| 原语法 | 新语法 |
|---|---|
| Handlebars | Sline |
迁移步骤
如果你的现有项目需要升级支持 OS 3.0 主题,可以跟随以下步骤进行升级:
- 在
.shopline-cli.yml文件中新增compatibility: true。
---
compatibility: true # 新增
project_type: extension
organization_id: 0
EXTENSION_TYPE: THEME_APP_EXTENSION
- 在项目根目录新增
compatibility目录,并且将主题应用扩展 OS 2.1 的目录放在此目录内。
└─ ─ theme-app-extension
├── blocks
│ └── ...
├── components
│ └── ...
├── i18n
│ └── ...
├── public
│ └── ...
├── compatibility # 新增
│ ├── assets
│ ├── blocks
│ ├── locales
│ ├── snippets
│ └── ...
└── .shopline-cli.yml
- 废弃 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": "标题"
}
- 安装 新版本 SHOPLINE CLI 并使用。
npm install @shoplineos/cli -g
这篇文章对你有帮助吗?