从 Shopify CDN 加载的 Polaris Web Components 正在转向语义化版本控制。大多数应用将继续自动接收兼容性的改进,而开发者可以选择何时采用破坏性变更。现有应用无需立即采取行动。
变更内容
Polaris CDN 发布现在遵循熟悉的语义化版本控制规则:
- 主要版本可能包含需要应用更新的破坏性 API 或行为变更。
- 次要版本包含兼容的组件、API、错误修复、无障碍性和性能改进以及视觉优化。
- 安全修复可应用于受影响的稳定版本,包括较旧的主要版本。
@shopify/polaris-types包使用与 CDN 发布相同的主要版本。
发布
自动兼容更新
应用默认应使用稳定发布通道,在更新经过候选版本阶段后,您将收到该通道的更新。如果发生重大变更,此 URL 不会自动更新。采用新的主版本号始终是显式操作。
<script src="https://cdn.shopify.com/shopifycloud/polaris-1.js"></script>固定发布
固定发布不会接收常规功能、修复或视觉更改。
当您需要在以下情况下进行固定时非常有用:
- 控制常规变更何时到达生产环境。
- 重现测试期间使用的发布版本。
- 从影响您应用的更新中恢复。
- 将 Polaris 更新与您的发布流程协调一致。
注意:<code>polaris-1.1.js</code>仅在 Polaris 1.1 变为稳定状态时发布。
测试即将推出的变更
所有即将推出的变更在发布到稳定通道之前,都可以在候选版本构建中进行测试。
此候选版本将在候选窗口期内积累改进,并在同一 URL 处就地更新。它旨在用于开发和测试。
<script src="https://cdn.shopify.com/shopifycloud/polaris-1.1-rc.js"></script>现有的polaris.js URL
现有的polaris.js将与polaris-1.js同时更新,并且在出现主要版本时不会自动更新。
受影响对象
这适用于从 Shopify CDN 加载 Polaris Web Components 的第三方应用和使用@shopify/polaris-types的开发人员。
它不会更改 App Home UI 扩展、Admin UI 扩展或 App Bridge 的版本控制。
相关文档
- App Home 文档
- Polaris 1.1 候选发布版

