UI 扩展的 语言环境文件 组合大小不再受 256 KB 限制。自 2026 年 10 月 30 日起，您可以向扩展中添加更多语言，而无需在部署时触及组合大小限制。此变更适用于所有包含 UI 扩展的应用，且无需采取任何操作。
变更内容
此前，UI 扩展的 locales 文件夹中语言环境文件的总大小不能超过 256 KB。拥有多种语言的扩展可能会达到该限制并导致部署失败，从而迫使您缩减翻译内容或移除某些语言。
该组合限制现已取消。每个单独的语言环境文件的 30 KB 限制仍然适用。语言环境文件保持与 结账 UI 扩展本地化指南 中描述的相同格式、文件命名和回退行为。您无需更改翻译的结构方式。
受影响范围
此变更适用于所有包含带有本地化文件的 UI 扩展的应用，涵盖所有 API 版本。现有的扩展版本将继续按原样正常运行。新的部署不再受本地化文件总大小的限制。
如果您的扩展此前未超出旧限制，则对您没有任何影响。
需要采取的操作
您无需执行任何操作。如果您之前为了保持在 256 KB 限制以内而移除了某些语言或缩短了翻译内容，现在可以将其恢复：
- 将所需的语言环境文件添加到扩展的 locales 文件夹中，例如 de.json 或 pt-BR.json。请确保每个文件大小不超过 30 KB。
- 运行 shopify app deploy 以发布新的应用版本。
- 在开发商店中预览该扩展，将商店或客户区域设置设置为其中一种新语言，并确认已显示翻译后的字符串。
相关文档
- 本地化结账 UI 扩展
- 本地化客户账户 UI 扩展