Polaris 2.0 的候选版本现已可用于嵌入式应用主页界面。它包含了 Shopify 管理后台的全新视觉样式，使您的应用能够采用新的外观。
全新的 Shopify 管理后台设计于 2026 年 9 月 15 日起逐步向商家推出。您可以立即采用该候选版本，并在旧版和新版 Shopify 管理后台设计中测试您的应用。
采用 Polaris 2.0 后的变化
当您的应用在 Shopify 管理后台内部使用 polaris-2.0-rc.js 时，其 Polaris Web Components 将匹配该商店当前的视觉设计：
- 在采用新版 Shopify 管理后台设计的商店中，组件会使用新的颜色、排版、间距和图标。
- 在采用旧版 Shopify 管理后台设计的商店中，组件保持与 polaris-1.js 相同的视觉风格。
如果您在 Shopify 管理后台外部渲染这些组件，它们默认采用新的视觉样式。这使您能够在访问具有新版 Shopify 管理后台设计的商店之前，提前测试新外观。
采用 Polaris 2.0 是显式操作。使用 polaris-1.js 或传统 polaris.js URL 的应用不会自动迁移到 Polaris 2.0。
这对 Built for Shopify 意味着什么
如果您的应用属于 Built for Shopify 计划，您有直到 2027 年 5 月 1 日 来更新您的嵌入式应用主页界面，以匹配 Shopify 管理后台的视觉风格。
使用 Polaris 2.0 候选版本可让您在 Shopify 管理后台逐步推广期间做好准备。组件会匹配每个商店可用的视觉设计，因此同一款应用可以支持使用任意一种 Shopify 管理后台设计的商家。
如何测试候选版本
从 Shopify CDN 加载候选版本：
<script src="https://cdn.shopify.com/shopifycloud/polaris-2.0-rc.js"></script>然后在以下环境中测试您的应用：
- 采用新版 Shopify 管理界面的商店。如果您无法访问此类商店，可以使用“Shopify 管理界面的新设计”功能预览来创建新商店。 功能预览
- 采用旧版 Shopify 管理界面的商店。
- 在 Shopify 管理界面之外，组件默认采用新的视觉样式。
如果您的应用在视口底部附近包含固定或粘性内容，请使用环境 API 的 --shopify-safe-area-inset-bottom CSS 变量 ，以防止浮动 Sidekick 栏遮挡您的界面。
从 Polaris React 迁移
如果您的嵌入式应用主页界面使用 Polaris React，请遵循 迁移到 Polaris Web Components 的迁移指南。
从 Page、Section 和 Button 组件开始。这些组件在使您的应用与新版 Shopify 管理界面保持一致时，具有最大的视觉效果。
如果您的应用已使用 Polaris Web Components，请将 CDN URL 更新为候选版本并测试现有界面。如果您的应用未使用 Polaris Web Components，请先进行迁移，以便采用 Polaris 2.0。
扩展自动更新
管理界面扩展和应用主页 UI 扩展会自动匹配每位商家可用的 Shopify 管理界面设计。它们的功能不会改变，您无需更新扩展代码即可获取新样式。
相关文档
- 从 Polaris React 迁移到 Polaris Web Components
- App Home 文档
- Environment API
- Polaris CDN 语义化版本控制
- Shopify admin 概述