更新记录

1.3（2025-06-11）

1、修改请求商品详情接口，增加通过id查询（支持id和handle两种方式） 2、修改创建购物车接口，支持创建购物车时使用折扣码 3、新增给购物车设置折扣码接口

1.2（2025-06-09）

增加初始化方法，支持从插件外部传入shopDomain和apiKey，无需再去修改插件内部参数。

1.1（2025-05-28）

增加Android平台支持（minsdkversion >= 24)

平台兼容性

uni-app x

hy-shopify

功能简介

hy-shopify是一个基于UTS开发的Shopify电商平台集成模块，支持在App中使用StoreFront API，完成商品信息获取、购物车使用已经下单同步到web端等功能。 支持iOS、Android双端。

DONE:

1. 商品管理：获取商品列表、商品详情
2. 购物车功能：商品添加、删除、数量修改
3. 订单管理：创建订单
4. 支付集成：集成Shopify checkout套件,支持Shopify Payments等多种支付方式

TODO:

1. 订单管理：获取订单列表、订单详情、取消订单
2. 地址管理：获取地址列表、添加地址

快速开始

1. 通过HBuilderX导入hy-shopify插件
2. 打开uni_modules/hy-shopify目录，修改安卓和iOS文件夹里创建client时设置的shopDomain和apiKey

   self.client = Graph.Client(
     shopDomain: "ororo-eason.myshopify.com",
     apiKey: "57d52bac001d07d3e8101ec49650565c"
   )

3. 在需要使用的页面中引入hy-shopify

   import * as hyShopify from '@/uni_modules/hy-shopify'

4. 根据业务需求使用hyShopify中的方法，具体方法见下面的API介绍

API介绍

1. 获取商品列表

   hyShopify.getProductList(query : string, after : string, first : number, callback : (result : HYProductListInfo) => void) : void;

2. 获取商品详情

   hyShopify.getProductDetail(handle : string, callback : (result : UTSJSONObject) => void) : void;

3. 创建购物车

   hyShopify.createCart(callback : (result : UTSJSONObject) => void) : void;

4. 添加商品到购物车

   hyShopify.addToCart(cartId : string, variantId : string, quantity : number, callback : (result : UTSJSONObject) => void) : void;

5. 更新购物车商品数量

   hyShopify.updateCartLine(cartId : string, lineId : string, quantity : number, callback : (result : UTSJSONObject) => void) : void;

6. 删除购物车商品

   hyShopify.removeCartLine(cartId : string, lineId : string, callback : (result : UTSJSONObject) => void) : void;

7. 获取购物车

   hyShopify.getCartDetail(cartId : string, callback : (result : UTSJSONObject) => void) : void;

8. checkoutWithUrl

   hyShopify.checkoutWithUrl(checkoutUrl : string, payCallBack : HYPayResultCallBack) : void;

9. checkoutWithCartId

   hyShopify.checkoutWithCartId(cartId : string, payCallback : HYPayResultCallBack) : void;

开发文档

UTS 语法 UTS API插件 UTS uni-app兼容模式组件 UTS 标准模式组件 Hello UTS