# 更新您的 theme
> Shoplazza Theme Store 的主题更新流程：提交更新 ZIP、版本号规则、发布说明，以及两次更新之间的最短间隔。
在 Theme Store 上首次发布 theme 后，您开始进入迭代流程：考虑商家反馈，通过定期质量保证测试持续改进构建，并积极整合 Shoplazza 要求的更新。
作为 Shoplazza Theme Partner，您需要持续为 theme 提供更新，以留在 Shoplazza Theme Store 上。
以下部分介绍 theme 更新流程和更新类型。
## Theme 更新流程
您可以通过 Partner 控制台将更新以 ZIP 文件形式提交审核。每次更新应根据更新内容确定[版本号](#%E7%89%88%E6%9C%AC%E6%8E%A7%E5%88%B6)和[发行说明](#%E5%8F%91%E8%A1%8C%E8%AF%B4%E6%98%8E)。
商家将在**在线商店** > **Themes** 页面看到通知，告知他们可以更新 theme。商家可以将更新应用到 theme 的未发布副本，以便在发布之前进行审核。
为避免给商家造成更新疲劳，更新之间应至少间隔 4 周。
**备注**
每个 theme 只有一个 Theme Store 列表，即最新版本。这意味着所有评价都将显示在同一列表中，无论评价提交时对应哪个 theme 版本。这也意味着您不能为不同 theme 版本收取不同价格。
更新成功审核和发布后，您将收到自动通知邮件。
## 新版本的注意事项
创建新版本时，请考虑以下内容及其对商家的影响：
* 如果您修改了现有 setting 使得商家的当前值不再有效，商家的值将重置为新版本中指定的默认值。为了减少对现有商家的影响，应尽可能保持相同的默认 settings。
* 如果您更改了 setting 的 ID，当前 theme 中的 setting 将被视为已删除，新 setting 将以默认值添加。这会带来较差的商家体验，应尽量避免。
* 如果您更改了 setting 的类型，商家当前的 setting 值可能会失效并重置为默认值。
## 版本控制
Theme 版本帮助商家轻松识别他们拥有的 theme，以便确定哪些功能可用，或是否有更新版本可以更新。
构建版本字符串时，应使用 X.Y.Z 格式的[语义化版本](https://semver.org/)。
| 组件 | 说明 |
| --- | --- |
| `X` | 表示引入或修改非向后兼容功能的主要版本，例如：
* 修改 setting 的值。
* 删除 setting、section 或 block。
* 添加全局 setting。
例如，从 `1.4.8` 升级到 `2.0.0`。
发布主要版本时，商家将在**在线商店** > **Themes** 页面看到通知，告知他们可以将更新应用到 theme 的未发布副本以进行审核和发布。 |
| `Y` | 表示引入或修改向后兼容功能的次要版本，例如：
* 修改现有 setting 的标签或默认值。
* 添加 section 或 block。
* 在不更改 setting schema 的情况下更改现有 section 或 block 的视觉设计或功能。
例如，从 `1.4.8` 升级到 `1.5.0`。
发布次要版本时，商家将在**在线商店** > **Themes** 页面看到通知，告知他们可以将更新应用到 theme 的未发布副本以进行审核和发布。 |
| `Z` | 表示修复 bug 或安全问题，或进行非视觉性代码改进的维护版本。
例如，从 `1.4.8` 升级到 `1.4.9`。
发布维护版本时，商家将在**在线商店** > **Themes** 页面看到通知，告知他们可以将更新应用到 theme 的未发布副本以进行审核和发布。 |
theme 版本可以通过 [theme metadata](/zh-CN/docs/theme/architecture/config/settings-schema-json) 包含在 theme 中。
## 发行说明
每个 theme 版本都需要有发行说明，突出显示该版本的主要功能。
发行说明的主要受众是商家，因此您使用的语言应反映这一点。发行说明不是变更日志，而是会影响商家或其买家的精选内容列表。因此，应包含所有面向用户的变更，应排除面向开发者的变更。您还应只包含与当前发布相关的信息。
### 在 theme 中包含发行说明
要在 theme 中包含发行说明，请在 theme ZIP 根目录中创建一个名为 `release-notes.md` 的 Markdown 文件。文件内容应包含以下组件：
| 组件 | 说明 |
| --- | --- |
| 描述 | 对此版本最重要变更的简要描述。 |
| 变更列表 | 版本中包含的变更列表。变更可以归入以下标题之一：
* **Added（新增）**
* **Changed（变更）**
* **Removed（移除）**
* **Security（安全）**
* **Other fixes and improvements（其他修复和改进）**
变更应以项目符号列在各自的标题下。每个标题应作为 **H3**，因此需要以 `###` 开头。例如，`###` Added。
如果有特定变更需要特别关注，可以在变更前加上 `Important:`。例如：
* `Important: This is an important change.`
渲染发行说明时，这些重要变更将以视觉方式突出显示。 |
**示例：**
```markdown
我们新增了为顾客添加支付选项的功能，移除了 Instagram section，并更改了社交媒体 section 的工作方式。
### Added
- Important: 新增搜索分面筛选
- 在购物车通知中新增销售计划
### Changed
- Important: 将默认社交媒体分享图片更改为来自商店管理后台的图片。您可以添加默认图片，在无法找到页面特色图片时使用。
### Removed
- 由于 API 已被弃用且没有合适的替代方案，移除了 Instagram section。今后您需要改用 App 来显示 Instagram 动态。
### Security
- 修复了安全问题
### Fixes and other improvements
- 合集页面侧边栏现在与工具栏对齐
- 修复了顾客登录页面的"忘记密码"链接
```
## 紧急更新
紧急更新是商家立即需要的 theme 更新，以确保业务不中断。通常，只有解决购买流程问题的更新才被视为紧急。购买流程是顾客进行购买时的完整过程，从商品页面开始，通过快速结账按钮继续，或从购物车通过结账行动号召或快速结账按钮继续到结账。
如果您认为某个重要更新不影响购买流程，可以在提交更新之前咨询 Theme Partner 经理。