背景
开发一个shopify应用,该应用能在商家安装成功应用后自动在商家商店页面中插入一个jsSDK。搜索了很多文章,找到的大多是跟shopify商店相关的,与开发应用相关的文章相对较少,通过研究shopify API做出了一个简单的demo,下面简单记录一下开发过程,共大家参考。
一、注册Shopify账号
要开发应用并用于测试,需要先进行shopify平台账号注册,平台有14天的免费试用权限, shopify分商家平台www.shopify.com/ 和 开发者平台 partners.shopify.com/ ,进入平台按照要求填写即可完成注册。
二、开发 Shopify App 应用
(一)创建应用
第一步:阅读开发文档指南
开始coding之前,需要先阅读一下Shopify的开发文档,按教程一步步操作即可完成应用创建,开发文档链接:shopify.dev/apps/gettin…
第二步:安装工具
shopify手动开发应用,需要先安装Ruby、Git、Node、Ngrok下载路劲可以直接从shopify开发指南文档点击相对应的链接进行下载安装即可,我这里也贴一下下载地址:
!!!这里需要注意,下载应用版本要根据shopify文档要求选择要下载的版本
- node下载地址:Node.js (nodejs.org)
- git下载地址:Git - Downloads (git-scm.com),git需要安装到环境变量里,确保任意路径可以访问
- Ruby下载地址:rubyinstaller.org/downloads/
- ngrok下载地址:ngrok.com/download
安装完成打开cmd检查一下git、node、ruby是否安装成功,执行完以下三个命令名出线如下图结果,则表示安装成功:
- node -v
- git version
- ruby --version
ngrok下载安装包解压后,双击ngrok.exe文件即可
第三步:安装脚手架shopify-cli
安装好第二步的四个工具之后,接下来全局安装脚手架shopify-cli,参考开发指南打开cmd终端执行命令行
gem install shopify-cli // 安装脚手架shopify-cli
shopify version // 检测是否安装成功,执行后出现版本号则代表安装成功
第四步:登录授权shopify
在终端执行登录命令,完成shopify商店登录授权
shopify login --store test333.shopify.com
test333.shopify.com是shopify商店地址域名
出现logged into ... 则是登录成功
第五步:创建应用并发布
完成以上步骤后,就可以开始创建应用的脚手架了,开发文档链接:shopify.dev/apps/gettin…
1、创建应用脚手架之前需要先在shopify partners开发者后台(链接:partners.shopify.com/)添加测试商店,操作界…
2、在终端执行shopify app create node
创建应用脚手架,根据提示再终端输入应用名称、选择创建应用的类型以及开发应用商店(开发应用商店在开发者后台创建)
3、在启动服务之前需要先到ngrok平台创建一个ngrok账号 (ngrok平台链接:ngrok.com/ ),创建好账号后登录进去管理后台,参考下图界面操作即可复制Authtoken
4、取到ngrok的Authtoken之后,打开终端执行shopify app tunnel auth <Authtoken>
命令进行身份验证,Authtoken是上一步复制的验证token
5、以上步骤完成后,现在可以启动服务器,在终端中切换路径到应用项目的文件夹下,执行启动服务命令shopify app serve
6、服务启动后,可以进行应用安装测试了 (1)打开shopify partners后台,在应用页面会发现你所创建的应用
(2)然后点击应用名称,进入应用详情页面
(3)点击选择商店按钮,进入应用测试商店列表
(4)点击‘install app’,安装成功,进入测试商店后台应用页面,即可发现安装应用区域出现了所安装的应用
同时在shopify partners后台也会发现应用安装数量有所增加
到此,shopify应用创建安装就算成功了,然后可以根据需要进行应用功能开发
(二)Shopify App上线部署至服务器
应用部署请点击链接查看 ---> Shopify应用上线部署 - 掘金 (juejin.cn)
三、开发shopify应用扩展
我的demo需求是开发一个shopify的jsSdk应用程序嵌入块,商店安装按应用,即将该jsSdk插入到在线商店的网页中
- 在开发shopify应用扩展之前,需要先完成shopify相关账号的注册登录(可参考本文的第一点介绍进入shopify相关平台完成注册,若已经有帐号了,直接登录就ok了),然后创建一个用于承载应用扩展的shopify应用(该应用若没有其他其他功能开发,可直接在shopify partners平台创建即可,如下图,跟着指引操作),再将应用绑定一个测试商店(绑定操作参考上文)
- 在完成以上的准备工作后,就可以开始应用程序嵌入块的开发了,首先还得参考第二点第四步,完成shopify的授权登录操作
第一步:创建主题脚手架
- 打开终端窗口并
cd
进入项目的根目录,创建主题应用扩展并选择您要注册扩展的应用(注意:个应用只能开发一个主题应用),开发操作指南请这里贴一下(shopify.dev/apps/online… ), 也可以跟着我的流程操作
// 执行命令
shopify extension creat // 创建主题应用块的脚手架,按照指引选择将主题应用块注册到指定的app应用
第二步:注册应用
首先导航到您的新主题扩展程序目录下,执行shopify extension register
将其注册到您上一步选择的应用程序,根据提示选择Yes完成注册:
第三步:发布到shopify partners平台进行测试
执行shopify extension push
命令将扩展推送到shopify partners平台
第四步:测试应用
- 查看扩展应用,在shopify partners平台,参考第二大点操作指导进入应该用详情页面,然后鼠标滚到最底下,然后找到“Browse extensions”按钮,点击进入扩展应用列表
- 在拓展应用列表点击应用名称进入扩展应用版本页面
- 若扩展应用处于不可用状态,点击“Enable”按钮即可将变为可用状态,然后选择需要发布使用的版本进行发布,这样扩展应用就可以在商店前台编辑页面可见了
- 在测试商店前端进行安装扩展应用即可使用
如何在商店前台编辑页面安装扩展应用等更新.....