Report: State of in-app subscriptions in the US 2023 Get a report

安卓应用内购买,第4部分:Billing Library Error Codes以及如何避免搞砸测试

Vlad Guriev

Updated: March 20, 2023

Content

62fdf1acd9ba1f688246e39e jp android tutorial 1 configuration 3 5

今天我们将讨论我们可以从getResponseCode()法的Billing Library中获得的错误代码

您可以在本文中找到我们如何将错误传递给回调函数的示例。我们已经在之前的文章中讨论过一个错误——当用户没有进行任何购买就关闭购买对话框时,就是 USER_CANCELED。我们来了解一下其他的吧。

ERROR和DEVELOPER_ERROR

让我们从名为 ERROR(responseCode 6)和DEVELOPER_ERROR( responseCode 5)的错误开始吧。对于第一种情况,Google在文档中写了“API操作过程中的致命错误”,对于第二种情况——“提供给API的无效参数”。例如,当我为querySkuDetailsAsync()请求传递一个空字符串给setType()中的构建器时,我能够得到一个DEVELOPER_ERROR。

但事情没那么简单。我更近了一步,在launchBillingFlow()法中,我使用了修改后的SkuDetails(从实际产品的SkuDetails中提取json,更改其中的productID并将其传递给新的SkuDetails构造器)。事实上,这是一个无效参数,我希望得到一个DEVELOPER_ERROR,但是……我得到了一个ERROR

当然,这是一个人工例子。Google拒绝支付的情况更接近现实。如果您从一个测试卡测试购买时,在购买对话框选择“测试卡,总是拒绝”,我们将在文章的最后告诉您,ERROR也将返回,但具有正确的文本。

第三篇文章中,我们描述了订阅(subscription)变化,我们将其中一种比例模式的年订阅价格提高了近3倍,但没有说明如果我们没有这么做会出现什么错误。我们正在进行修改。

因为这里指定了错误的比例模式,所以在逻辑上我们应该得到相同的DEVELOPER_ERROR。相反,我们得到了 SERVICE_UNAVAILABLE(responseCode 2)。如果我们输入任何不适当的数字作为比例模式(这是int,不是enum,没人会阻止我们),或者如果我们明确指出错误的purchaseToken,我们也会得到这个。我们看了SERVICE_UNAVAILABLE的文档,然后……等等,什么?!我们看到了“网络连接中断。”

与此同时,我们也看到了一个奇怪的对话框:

615371cbae3a194fdd67617c 5n7uqaw9bx5dejwxgqh9sluv3r38yqwegbzbnzj5db9bullr12o2uraffoyko2jn4pjwhsy04xwdwrwxt37pkvgt3q1zgtblivzbagg 91v1ogagpaptqj av1kdmoqhe96kwy4x3ds0 5

ERROR的情况下,另一个有趣的现象是,当通过“OK”键关闭对话框(即,通过被解释为“导航返回”的方法)时,ERROR来到onPurchasesUpdated(),而在SERVICE_UNAVAILABLE的情况下,类似的情况出现的是USER_CANCELED(但如果您在对话框中点“OK”,我们将收到SERVICE_UNAVAILABLE,正如预期的那样)。

在失去互联网连接的情况下,确实会出现SERVICE_UNAVAILABLE

Subscribe to Adapty newsletter

Get fresh paywall ideas, subscription insights, and mobile app news every month!

错误代码

这里还有一些带有小注释的错误代码,可以说是比较罕见的错误。

  • BILLING_UNAVAILABLE(responseCode 3)。Google解释说“Billing API版本不支持请求的类型”。当我退出Google账户,以及使用没有Google Play Services的华为设备时,我能够重现这个错误。它也可能在Google Play没有更新的旧手机上进行复制。
  • SERVICE_DISCONNECTED(responseCode -1)。应用程序有时会与Google Play服务断开连接。如果安卓市场意外更新,这种情况就会发生。因此,我建议您谨慎行事,在每次调用Billing Library方法之前进行连接,就像前几篇文章中介绍的那样。此外,如果响应中仍然出现此错误,Google和我们都建议您添加一些重试策略。
  • SERVICE_TIMEOUT(responseCode -3)。这个名字不言而喻——我们已经等待Google Play的响应太久了。
  • FEATURE NOT SUPPORTED。BillingClient类中有5个 FeatureType常量。它们在这个设备上的可用性可以使用 BillingClient.isFeatureSupported(BillingClient.FeatureType.A_NECESSARY_FEATURE)方法来检查。在我的手机(小米Mi A2 Lite)上,FEATURE_NOT_SUPPORTED只返回了SUBSCRIPTIONS_ON_VR。同时,对于IN_APP_ITEMS_ON_VR以及所有其他特性,OK已返回。
  • ITEM_NOT_OWNED(responseCode 8)。它会在我们试图消费一件我们没有的东西时发生。可能会,甚至多次成功消费后也会。
  • ITEM_ALREADY_OWNED(responseCode 7)。而这里,恰恰相反,错误发生在试图购买我们已经拥有的产品时。在这种情况下,您只需要更新用户界面并让购买按钮不可点击即可。

ITEM_UNAVAILABLE

在应用内购买实现路径开始的最后一个可能也是最常见的错误就是ITEM_UNAVAILABLE(responseCode 4)。它说该产品无法购买,但没有解释原因。原因可能非常不同:从在错误的账户或设备上测试到购买不活跃的产品。

以下是您在测试时需要做的避免这种错误的清单:

1.   将一个带有Billing Library的应用程序发送到您的测试轨道。这是一个强制性条件;同时,您也可以使用相同的applicationId在调试构建上进行测试,但有一点很重要,至少把Billing Library的应用程序上传到Play Console一次。

2.   将测试人员的Google账号添加到测试轨道中,这对于内部测试或封闭的阿尔法/贝塔测试尤为重要。在测试人员如何加入您的测试部分也会有一个链接,测试人员应该在那里接受邀请。

3.   您只能购买已激活的产品。创建一个产品后,在Play Console有一个“激活”按钮。我们在第一篇文章中更详细地描述了创建产品的过程。

4.   请确保设备上的测试是从测试人员的Google账户进行的(这意味着它必须注册为测试轨道的测试人员,必须拥有所有必要的技术访问权限)。这一点似乎很明显,但世事难料,如果收到这样的错误,您也需要检查这一点。

5.   用于购买测试构建的applicationId必须完全匹配来自Play Console的applicationId。对于那些在调试版本中已经添加后缀的来说,这一点尤其重要。

6.   将测试人员的电子邮件地址添加到账户左侧菜单的Setup → License Testing部分(而不是应用程序),这样他们就可以从测试卡上免费购买产品,而不是从真实的卡上购买产品。在这种情况下,订阅的另一个优点是有一个测试持续时间。它与这个错误无关,但也是有用的知识。

结论

错误会使工作变得非常复杂,所以了解它们是如何发生的一直很重要。考虑到需要经过多少步骤才能访问产品,最简单的方法就是捕获ITEM_UNAVAILABLE。因此,我希望我的清单可以帮到您。

Adapty软件开发工具包(SDK)将促进错误处理,并提供许多其他优势:基本订阅分析、群组分析(cohort analysis)、付费墙(paywall)的简单测试、与分析服务的整合、服务器错误验证。现在就试试吧!