SuperAPI AI 工具集

shopify-app-bridge

通用与其它

查看项目

更新于 10-16 06:44

技能介绍

用途:本技能提供 Shopify App Bridge 的使用指南,用于把应用嵌入 Shopify Admin(网页或移动端),并与宿主环境通信以触发界面动作和导航。需注意项目使用的版本:资料聚焦 App Bridge v3(NPM 包)与 App Bridge CDN(v4)模式,最新常见标准为 v4(基于 CDN),但不少 React 应用仍使用 @shopify/app-bridge-react 包装。

核心概念:Host 指 Shopify Admin,Client 指被嵌入的应用,Actions 指发送给宿主以触发 Toast、Modal 或导航的消息。

初始化:CDN 方式推荐使用脚本 https://cdn.shopify.com/shopifycloud/app-bridge.js,随后设置 shopify.config,包含 apiKey、host(取自 URL 查询参数)与 forceRedirect。初始化后可在浏览器控制台访问 shopify 全局变量,需将控制台框架上下文切换到应用 iframe 后输入 shopify 查看可用方法与配置。React 方式可导入 @shopify/app-bridge-react 的 Provider。

常见能力:Toast 用 shopify.toast.show('Product saved') 显示临时消息;Modal 用 await shopify.modal.show 打开对话框并通过 action 事件处理按钮;资源选择器 shopify.resourcePicker 支持选择 product、variant、collection,可设置 multiple、selectionIds 预选、filter 按 query 过滤及隐藏变体或草稿;导航使用 open('shopify:admin/products','_top') 或应用内部路由;上下文保存栏用 shopify.saveBar.show() 并监听 save、discard 事件。

限制与注意事项:必须处理 OAuth 流程并生成会话令牌,依赖 Shopify 认证时后端请求须带 Bearer 会话令牌;host 参数为 base64 编码字符串,是 App Bridge 工作的关键,必须出现在 URL 或配置中;Remix 应用可借助 @shopify/shopify-app-remix 辅助处理请求头与桥接。其他版本、收费或平台细节资料暂未提供。