用途:本技能用于指导在 Shopify Admin 中嵌入应用时与宿主界面交互,基于 Shopify App Bridge 实现操作触发与导航。
主要能力:支持 Toast 提示、Modal 对话框、资源选择器(产品/变体/集合)、Admin 内导航重定向,以及未保存更改时的 Contextual Save Bar。
使用方式:可通过 CDN(App Bridge v4,推荐)加载 https://cdn.shopify.com/shopifycloud/app-bridge.js 并配置 shopify.config(apiKey、host、forceRedirect);也可使用 @shopify/app-bridge-react 的 Provider 用于 React 场景。调试时在 Shopify Admin 的 Chrome 控制台切换到应用 iframe 后输入 shopify 查看可用方法与配置。
限制与注意事项:host 参数为必需项(base64 编码,由 Shopify 提供);需确保应用处理 OAuth 并生成 session token,后端请求须携带 Bearer token;不同项目可能使用 v3 或 v4,需先确认版本;Remix 应用可考虑使用 @shopify/shopify-app-remix 辅助处理。