Shopify应用开发指南

开发一个具有无限潜力的 Shopify 应用程序，可以在 Shopify 多元化的生态体系里触及到超过一百万的商家群体。对于开发者来说，从应用开发到审核提交的过程中会遇到许多困惑，希望这篇文章能够给 Shopify 的开发者们答疑解惑，使应用开发和上线流程更加顺畅。 

App应用开发流程

• 注册合作伙伴帐户

• 前往此处注册一个合作伙伴账户（个人或公司均可注册）
• 了解更多：合作伙伴条款 

• 添加开发商店

• 注册帐户后登录单击合作伙伴仪表板上显示的“添加商店”按钮
• 了解更多：详细步骤

• 创建应用并获取凭据 (O-Auth)

• 从合作伙伴仪表板上的应用程序菜单中创建一个应用程序，并获取使用API​​所需的凭据（凭证）。
• 了解更多：详细资料
• Shopify App CLI  （命令行工具，该工具会自动生成用于获取权限和使用Polaris的代码）

• 开发商店中的安装流程

• 生成 一个URL，以获取使用您的凭据调用API的许可并将其安装在开发存储中。
• 了解更多：详细资料
• 更多阅读：如何创建嵌入式 App 

• 使用API​​创建应用流程

根据OAuth 2.0规范从获得的权限中生成访问令牌，然后调用API。

• 了解更多：详细资料

有以下三种类型的API，但是访问令牌获取方法相同。

• REST Admin API　（针对商家的管理功能）
• GraphQL Admin API（为GraphQL中的商家提供管理功能）
• 店面API（通过GraphQL为店面提供功能）

您可以使用以下应用检查GraphQL Admin API的操作

• GraphQL应用

注：推荐使用GraphQL作为API。

打造嵌入式应用程序：使用Polaris创建UI 

• Polaris设置
• App Bridge设定
• 将App Bridge和Polaris与React结合使用
• 如何使用Polaris组装UI（来自下面的教程应用程序）
• 应用程式桥动作
• 应用程序扩展程序扩展点
• 应用于POS应用
• 套件中增加了技能（Shopify标准聊天机器人）

将通知作为触发器进行处理：使用Webhook创建处理

您可以使用webhook来实现基于通知的处理（例如，当订单来临时，调用链接的库存系统的API）。Webhooks可以通过商家的界面进行手动注册，也可以通过API自动注册（通过API注册的Webhooks不会显示在设置上。也可以使用API​​或注册的应用程序进行删除）。

• Webhook事件列表

如果Shopify在指定时间内未收到响应，则将重新发送Webhook。因此，有必要预料到重复传输的可能性，并进行设计以使响应首先返回，然后再异步执行操作。请查看上面的链接以获取详细信息。

向店面添加功能：使用主题编辑店面

如果要向店面（即在线商店的站点侧，购买者使用的界面）添加功能（例如，向购物车中添加唯一商品，为会员创建积分功能等），则需要自定义主题。 .如果要使用API从店面操作数据，请使用上面提到的Storefront API。要基于商店数据动态更改主题，您需要插入一种称为Liquid的模板语言。

• 主题概述
• 主题文件结构
• 主题设定
• 主题详情
• 部分的详细信息（可以在主题编辑器中设置的部分）
• Liquid样例代码
• 向产品页面和购物车添加唯一商品（购物车属性，订单项属性）
• 向客户（会员）信息添加唯一项
• Liquid对象类型和参考范围
• 多语言在线商店
• 多语言主题
• 主题的多币种支持
• Shopify主题工具包 （创建主题模板并自动反映它们的命令行工具）
• Ajax API（用于在主题内控制购物车，产品，搜索等的JavaScript API）
• ScriptTag API（该API可让您在不编辑主题的情况下将外部JavaScript插入店面）
• 多次行证（允许您使用外部帐户注册和登录在线商店的功能。仅适用于Shopify Plus）

要在安装应用程序时自动自定义主题，您需要使用在线商店API，但如果改动较小，则可以通过在帮助中编写插入过程来进行。 

如果要用应用程序的图形替换Shopify在线商店的特定URL（例如，如果要在结帐时插入应用程序提供的外部屏幕），或者要从主题调用服务器端API，您可以使用称为App代理的功能将Shopify的在线商店的URL映射到您应用的服务器的URL。如果您想在订单完成页面上插入自己的脚本例如执行转化评估JavaScript，显示Liquid数据等，则可以设置其他脚本或调用上面的ScriptTag API。

您也可以将视频和3D模型插入主题。相关详情，请参见下文。

• 关于产品媒体
• 如何插入媒体主题

使用外部网站或移动应用程序构建店面

要将在线商店创建为外部网站或移动应用程序（以所谓的无头商业为代表），并创建仅提供Shopify的商业功能的应用程序，请使用Storefront API和Buy SDK。

• Storefront API的示例实现
• JavaScript购买SDK
• BuyButton.js
• Android购买SDK
• iOS购买SDK
• Unity Buy SDK

适用于App Store

有两种类型的应用程序：只适用于一个商店上安装的私人定制应用程序，以及可以发布到应用程序商店并由任何商店使用的公共应用程序（从搜索目标中排除，并且实际上是私有的）。如果您可以开发满足许多商店需求的通用应用程序，请向应用程序商店提交应用程序，并让其他商家使用它。该应用可以免费发布或收费发行。

• 关于应用程序的类型
• 如何发布Shopify应用
• 申请时需符合的条件
• 关于用于付费应用程序（应用程序内购买）的Billing API
• 关于卸载应用程序时的行为
• 符合GDPR要求的必需Webhook
• 关于应用程序的多语言支持在应用商店中取得成功 （描述了如何推广您的应用以及禁止使用的内容）

审核应用常见错误

完整审核清单请详读此文档。 

• 提交应用名称要符合partner后台的应用名称 
• 安装成功到Shopify后台登陆界面必须自动跳出
• 应用listing的主要语言必须跟应用界面的语言相同
• 请务必创建一个中文应用程序 listing
• Oauth认证必须完整呈现
• App listing, Section G 提供测试应用的虚拟账户以及密码
• App listing, Section G 用视屏链接提供使用应用说明流程
• App listing, Section G & B4 写清楚使用应用说明 (G项提供给Shopify内部，B4项提供给客户)
• 应用的HTTPS没有使用SSL认证
• App listing, Section D 提供应用的紧急联络人联系方式
• 完善GDPR Webhooks应用开发注意事项 

开发应用前，请务必把 app-submissions@shopify.com 该邮件地址列入你的邮箱白名单，确保审核过程若有任何问题能够第一时间和Shopify团队保持联系。 

• 关于测试环境
• 如上所述，如果您通过合作伙伴帐户创建开发商店，则可以无限期获得测试环境。
• Shopify数据扩展
• 有一项名为Metafields的功能，该功能可让您使用API​​更新和引用各种Shopify数据（例如，客户，产品，订单等）中的任何项目。注册的数据也可以从主题中称为Liquid，这对于店面功能开发很有用。
• 从应用商店中的应用中学习技术
• 应用程序安装屏幕，需要获得所需API和功能的许可。相反，您可以通过详细查看此屏幕来检查使用哪种技术。
• 对于店面应用程序，您可以通过在安装应用程序后更改主题或页面并使用浏览器的开发控制台检查店面内部来猜测应用程序在做什么。
• 阅读规格以适合您的需求
• 即使Shopify没有直接满足您需求的规范，也可以通过成功阅读（应用）现有规范来解决。例如，该指定的交货日期和时间的附加方法可以通过改变元件类型和UI被应用到其他车扩展，以及此优惠券代码的URL嵌入可以应用于建会员积分数的成员。
• 在创建用于运费计算和仓库合作的应用程序时
• 发货物流API（CarrierService)和履行服务API注册使用就可以实现自己的运费计算及运费说明功能（运费计算在规划限制）。
• 获取商店统计信息
• 如果使用称为ShopifyQL的API，则可以使用SQL（有计划限制）获取商店统计信息（销售等）。
• 将主题独立发布到主题商店您可以与应用商店分开申请并向主题商店发布自己的主题。见这里了解详细信息。