用途:为使用 Shopify CLI 与现代框架构建自定义 Shopify 应用提供指导,涵盖开发环境搭建、应用架构、认证、扩展与部署。
主要能力:
- CLI 与配置:安装命令 npm install -g @shopify/cli @shopify/app 或 brew tap shopify/shopify 与 brew install shopify-cli;用 shopify version 验证;用 shopify app init 创建应用并选择 Remix、Node.js+React、PHP 或 Ruby 模板;通过 shopify.app.toml 配置应用名称、client_id、application_url、embedded、access_scopes、auth 重定向与 webhooks。
- 开发与部署:shopify app dev 启动带隧道的开发服务器并安装到开发商店;shopify app deploy 生成应用版本并部署扩展;环境变量含 SHOPIFY_API_KEY、SHOPIFY_API_SECRET、SCOPES、HOST 等。
- 架构与界面:以 Remix 为例展示 loader/action 中 authenticate.admin 与 admin.graphql 调用产品查询与更新;使用 @shopify/polaris 组件(Page、Layout、Card、DataTable、TextField、Select、Checkbox、Badge 等)构建管理界面。
- 扩展与集成:shopify app generate extension 生成 Admin Action 与 Theme App Extension;Theme app extension 使用 Liquid schema 与 block settings;通过 App Proxy 将店铺路径映射到应用路由并校验签名;处理 Webhook(如 APP_UNINSTALLED、PRODUCTS_CREATE、PRODUCTS_UPDATE、ORDERS_CREATE、CUSTOMERS_CREATE)并在 shopify.server.js 注册。
- 部署:可部署到 Cloudflare Workers,配置 wrangler.toml,运行 npm run build 与 wrangler deploy,并用 wrangler secret put 管理密钥。
适用场景:创建公开或自定义应用、实现 OAuth、构建管理界面、开发主题或管理扩展、集成第三方 API、实现应用计费与订阅、搭建无头店面。
限制:资料未提供具体收费、价格、平台支持范围与性能指标;部分示例函数(如签名校验实现)未给出完整代码,需按实际环境补充。