在Unite 2017上，我们讨论过我们的改进自定义店面开发工具包，它源于新的GraphQL Storefronts API，允许开发人员更有效地将电子商务体验构建到网站，移动游戏和移动应用程序中。
鉴于美国的情况，大致如此30%的电子商务销售发生在移动设备上A。最近，android宣布其月活跃用户已达20亿，在原生Android手机应用中添加应用内购物体验对应用开发者来说意义重大——以及Shopify的Android购买SDK使其简单且易于实现。
为了帮助指导您如何使用我们的Android Buy SDK将Shopify的全套电子商务功能添加到您现有的Android应用程序中，Josh Brown - Shopify应用程序团队的开发人员倡导者-最近领导了一个网络研讨会，带您了解该SDK，以及如何在移动应用程序开发中使用此库。
什么是Android Buy SDK?
Android Buy SDK是一个移动开发者可以使用的库在任何安卓移动应用中建立商务．有了这个库，你可以:
- 设置客户端以安全地访问Shopify的Storefront API。
- 获取产品和集合，并将它们呈现到应用程序中。
- 允许客户通过你的应用程序注册。
- 创建结帐和处理付款。
你所能构建的基础
知道许多开发人员喜欢亲自动手编写代码，我们从Android Buy SDK构建了一个示例应用程序，这将允许您快速剖析它是如何工作的，以及如何在未来的项目中实现它。你可以通过Android Buy SDK访问样例应用Github库．
基于这个示例应用程序，下面是应用程序的索引屏幕的示例，以及集合页面、产品页面和包含web结帐和web结帐选项的结帐页面Android支付．
现在，您已经概述了使用Android Buy SDK可以构建的内容，下面是将电子商务体验构建到移动应用程序中的九个步骤。
你可能还喜欢:自定义店面-建立商业的任何地方．
步骤1。创建一个销售渠道来获取API密钥
访问API密钥将允许您将Shopify商店连接到您的Android应用程序，并且可以在几秒钟内直接在Shopify管理中完成。要连接您的商店，您将使用销售渠道函数。如下图所示，你需要:
- 点击+旁边销售渠道在右边的菜单中。
- 向下滚动并选择手机应用程序。
- 将加载一个新屏幕;复制并粘贴顶部提供的API密钥。
此外，如果你想将Android Pay集成为支付选项，请向下滚动刚刚创建的移动应用页面，然后单击启用在Android支付页底部的部分。这将为该函数提供一个特定的公钥。
步骤2。添加构建依赖项
现在您有了API密钥，您需要为构建依赖项添加一些代码行。如果你使用的是常见的Android应用构建工具，比如Gradle，您需要添加以下代码行来使用Shopify的Android Buy SDK，而不使用Android Pay。
编译“com.shopify.mobilebuysdk: buy3:3.x.x”
或者添加下面的代码行，如果你想使用SDK与启用Android支付。
编译com.shopify.mobilebuysdk: buy3-pay-support: 1.0.0的
步骤3。设置GraphQL客户机
如前所述，这个SDK源于Storefronts API，它是用查询语言GraphQL构建的。通过设置GraphQL客户端，您将能够通过Shopify发出查询请求，并通过Shopify修改数据突变．
通过添加下面的代码，并插入您的商店域名(如。joshubrown.myshopify.com)和API密钥，您将能够快速设置GraphQL客户端。
graphClient = graphClient .builder(this) .shopDomain(BuildConfig.SHOP_DOMAIN) .accessToken(BuildConfig.API_KEY) .build();步骤4。定义查询
通过定义查询，您将能够帮助构建将应用程序连接到Shopify商店数据的GraphQL请求，包括产品和产品详细信息，如价格、描述和库存编号。
这个特殊的请求允许我们获取数据，但不能修改数据。在下面的例子中，我们请求Shopify商店的隐私政策，以便它可以包含在移动应用程序中。
专业技巧:您可以使用Lambda表达式．这可以通过SDK通过retro Lambda获得。本教程中的其余代码示例将使用Lambda。
第5步。对API进行调用
一旦定义了查询，就可以使用Lambda表达式调用Shopify API。首先，您将使用queryGraph．然后，将请求排队到API，使用call.enqueue．您将需要两个回调:一个用于onResponse一个是onFailure．的失败回调用于通知由于服务器中断而导致的错误。
步骤6。检索产品和收集数据
在Shopify中，产品被组织成集合，其中有一个或多个产品变体，包括价格和可用数量。为了显示你想通过应用销售的产品，你必须检索这些信息。同样，在Shopify管理中，您可以制作专属于您的移动应用程序的产品。
下面的代码是请求产品数据和集合数据。我们要求Shopify为我们提供最多10个系列，每个系列的标题，以及每个系列中最多10个该系列的产品。
步骤7。添加搜索
如果您的商店有广泛的产品选择，那么添加搜索功能可能会很有用。下面的代码提供了与客户查询标题匹配的产品搜索。在这种情况下，产品的标题中有“石灰”。
上面的例子是一个特定字段搜索的例子(只搜索标题)，但这个SDK还允许:
- 模糊匹配搜索:即使搜索词没有完全匹配，也会找到匹配。查找所提交文本部分的对应关系。
- 消极比赛:屏蔽基于某个词的搜索结果。例如，如果一个应用程序用户在搜索中提交“Free”，你可以阻止包含这个词的产品出现。
- 组合搜索如果shopify商店里有很多商品，你可以让用户同时提交两个搜索查询。一种情况是，如果他们想搜索产品类别(例如:“饮料”)和产品类型(例如:“茶”)
步骤8。整合客户注册
此SDK还支持突变请求，这将允许您在Shopify商店中创建和修改数据。
在GraphQL中，查询请求具有与得到REST中的请求。类似地，突变对应于拉或帖子请求。
允许客户在应用程序中注册是一个很好的用例。在下面的代码的第一部分中，您可以收集客户信息，包括姓名、电子邮件地址和密码。你也可以选择加入市场推广，这对未来的通讯和客户关系管理很有用。ob欧宝娱乐app下载地址
此外，由于变化允许你修改Shopify的数据，客户注册将在在线商店和其他地方被识别欧宝体育官网入口首页Shopify POS系统也是如此。
代码的后半部分创建了一个用户错误字段，以帮助捕获任何验证错误。在这个例子中，如果一个用户试图用数据库中已经存在的电子邮件地址注册，你可以推送一个响应，比如，“电子邮件地址已经存在于应用程序中。也许你已经在我们这里有一个帐户?”
你可能还喜欢:学习使用Shopify的POS应用程序SDK构建面对面销售应用程序．
第9步。设置结帐
正如本教程开始时提到的，这个SDK为您提供了在应用程序中提供两种类型结帐的选项。第一个选项是添加Shopify web结帐，另一个是使用Android Pay购物车。
网络付款
一个简单的选择是在Shopify中创建结帐，并将客户重定向到Shopify网络商店中的结帐处。你要用变异来实现这一点。一旦结帐完成，客户将通过您可以设置的特殊UTM参数重定向回您的应用程序。
设置网络结帐最重要的部分是输入行项目。行项目输入将要求输入一个变体ID，并要求客户输入他们想要购买的产品数量。请注意，这些不同于REST api中的变体id。对于产品任务，我们将使用产品变体id。
您还需要再次设置两个回调:一个用于响应，一个用于失败。
- 错误1:网络问题。由于服务器意外停机，无法完成签出。
- 错误2:用户错误．由于用户输入不正确，例如不正确的登录信息，因此无法完成签出。
Android支付
再说一遍，如果你想用Android支付在签出时，你需要在Gradle中添加以下构建依赖项。
编译com.shopify.mobilebuysdk: buy3-pay-support: 1.0.0的
需要注意的一点是，Android Pay并不是在每个国家都可以使用。如果你的应用面向全球商户，你应该仔细检查这种支付方式在客户所在的国家是否可行。
设置Android Pay Cart:
恭喜!现在，您已经将Shopify商店连接到您的Android应用程序!
既然你已经在应用程序中启用了购物功能，你的客户就有了在线购物的新选择。或者，你的客户很高兴你为他们提供了一种新的在线销售方式。
你对Android Buy SDK有什么看法?请在下面的评论中告诉我们!
