新功能
产品变体意图
React SDK 新增了用于选择变体、将变体添加到购物车以及引导买家前往快速结账页面的类型化产品变体意图钩子：
- useSelectVariant 包裹 select:shopify/ProductVariant。
- useAddToCart 包裹 add_to_cart:shopify/ProductVariant。
- useBuyNow 包裹 buy_now:shopify/ProductVariant。
当 Mini 应用拥有产品 ID 但需要买家选择变体或数量时，这些钩子可以在 Mini WebView 上方打开原生的 Shop 变体选择器面板。结果能够区分成功操作、用户取消、主机错误、导航至产品详情页（PDP）以及推荐产品的交接处理。
用法：
const {addToCart} = useAddToCart() const result = await addToCart({productId}) if (result.code === 'ok') { switch (result.data.outcome) { case 'added_to_cart': break case 'navigated_to_product': break case 'redirected_to_product': break } }提交时的构建验证
命令行界面现在在 submit 中运行 Minis 构建验证，验证系统也拆分为具有人类可读进度和 JSON 输出支持的逐检查编排。当前检查涵盖依赖项验证、ESLint 禁用、ESLint、TypeScript、构建输出和清单验证。
作用域钩子设置警告
CLI 现在会在 Mini 应用在使用作用域 SDK 钩子之前未完成必要设置时发出警告。这能让合作伙伴在代码使用依赖于声明的作用域或账户设置的功能时，更早获得反馈。
文档更新
意图解析文档
为 useResolveIntent 添加或修复了文档，包括展示向 Shop 返回类型化意图结果的示例。
verify-build 和 submit 文档
Shop Minis 命令文档现在包含 verify-build、构建验证用法以及 submit 与构建验证的关系。
产品评论文档
为 useProductReviews 添加了文档，涵盖按产品 ID 分页获取评论。
允许依赖项文档
允许的依赖项文档已与命令行界面源代码协调一致，并更新了新允许的包，包括 tw-animate-css。
弃用
usePopularProducts
usePopularProducts 已弃用，现在会发出开发警告。没有一对一的替代品。请使用 useRecommendedProducts 进行个性化发现，或使用 useProductSearch 进行搜索驱动发现。
包版本
| 包 | 版本 |
|---|---|
| @shopify/shop-minis-platform | 0.26.0 |
| @shopify/shop-minis-react | 0.28.0 |
| @shopify/shop-minis-cli | 0.3.21 |
其他更改
- 允许的依赖项集已扩展，增加了较新的合作伙伴可用包，包括 tw-animate-css。
- 构建验证现在包括清单验证和更清晰的逐项检查输出。
- Shop Minis CLI 和文档在允许的依赖项和构建验证行为方面保持同步。
摘要
2026年5月至6月带来了三项全新更新：
- 更丰富的商业操作 通过类型化的产品变体意图和本地变体选择实现。
- 更严格的提交质量关卡 在提交期间进行构建验证。 submit。
- 更清晰的迁移指南 通过 usePopularProducts 弃用消息和更新文档。
如有问题或反馈，请联系 Shop Minis 团队。