变更内容
shopify.extension.version 返回正在运行的扩展的版本。它与 Dev Dashboard 的“版本”页面上显示的名称以及在运行 shopify app deploy 时选择的名称相同。
该值是一个不透明的名称，而非版本号，因此应通过相等性比较而非排序来使用它。当扩展从本地开发服务器运行时，该值为 undefined。
受影响范围
此字段适用于目标 API 版本为 2026-10 的 POS UI 扩展。目标为早期 API 版本的扩展不受影响。
为何重要
POS 可以缓存扩展包并离线运行它们。该字段有助于开发者识别商户设备正在运行哪个已发布的构建版本。
操作建议
现有扩展无需任何操作。要使用该字段，请将目标 API 版本设置为 2026-10。在从本地开发服务器进行测试时，需考虑 undefined 的情况。
相关文档
- POS UI Extensions API，版本 2026-10