用途:指导开发者使用 Shopify CLI 与现代框架构建自定义 Shopify 应用,涵盖从环境搭建到部署的完整流程。
主要能力:
- Shopify CLI 安装与初始化:npm install -g @shopify/cli @shopify/app,shopify app init 创建应用,可选 Remix、Node.js+React、PHP、Ruby 模板。
- 开发与部署:shopify app dev 启动带隧道的开发服务器,shopify app deploy 部署并生成应用版本与扩展。
- 应用架构:基于 Remix 的路由、loader/action 与 GraphQL Admin API 调用,使用 @shopify/shopify-app-remix 的 authenticate.admin 完成认证。
- 应用扩展:通过 shopify app generate extension 生成 Admin Action 扩展与 Theme App Extension(Liquid 区块)。
- Webhook:在 shopify.server.js 中注册 APP_UNINSTALLED、PRODUCTS_CREATE、PRODUCTS_UPDATE、ORDERS_CREATE 等主题,并在路由中处理。
- App Proxy:在 Partner Dashboard 配置子路径与代理 URL,处理带签名校验的代理请求。
- Polaris UI:使用 Page、Layout、Card、DataTable、TextField 等组件构建一致的管理界面。
- 部署:提供 Cloudflare Workers 的 wrangler.toml 配置与 wrangler deploy、wrangler secret put 命令。
使用方式:按资料中的命令与配置示例操作,配置 shopify.app.toml 的 scopes、redirect_urls、webhooks,并通过 .env 管理 API 密钥等环境变量。
适用场景:创建公开或自定义 Shopify 应用、实现 OAuth、构建管理界面与主题扩展、集成第三方 API、实现应用计费与订阅、无头店面(Hydrogen/Remix)。
限制:资料未提供具体收费、价格、平台支持范围或效果保证;部分示例(如 verifyProxySignature)为占位实现,需自行完善;实际 API 版本与可用性以官方文档为准。