文档开发者中心
我的
|

HarmonyOS 6

软件开发

IAP Kit 沙盒测试

我开了年卡测试或者开了月卡测试之后,沙盒测试当中我没有办法快进时间,比如说应用内10月5号会过期,但是我现在才10月1号,我没有办法模拟10月6号的时候应用内会员过期时候的状态

点赞
收藏
回复
8
分享
举报
浏览86 发布于2026-08-20 14:22广东
全部评论
最多点赞
最新发布
最早发布

楼主你好,

这个不用等真实日期。IAP Kit 沙盒对自动续期订阅提供了“时光机”机制,时间会自动加速。

目前官方规则是:

沙盒时间按 10 秒 = 1 天计算。  

例如:

  • 月卡:约 30 × 10 = 300 秒,也就是 5 分钟后进入下一周期
  • 年卡:约 365 × 10 = 3650 秒,也就是约 60.8 分钟后续期

所以你不需要把手机系统日期从 10 月 1 日改成 10 月 6 日,沙盒环境会自动推进订阅时间。

另外,沙盒自动续期最多自动续 5 次,共 6 期,之后需要重新操作恢复订阅。  

如果你的目的其实是测试**“会员已经过期 → App 应该变成非会员”**这个场景,建议重点测试:

购买 → 等待沙盒订阅周期 → 自动续期 → 取消自动续期 → 当前周期结束 → 查询权益 → 判断已过期

其中“取消自动续期”后,当前周期不会立即失效,而是到当前订阅周期结束后才失效。

还有一点要注意:非消耗型商品没有过期时间,这里的“时光机”主要针对自动续期订阅。

你可以阅读以下文档:

IAP Kit 沙盒测试:https://developer.huawei.com/consumer/cn/doc/doccenter-capabilities/store-iap-sandbox

IAP Kit 开发指南:https://developer.huawei.com/consumer/cn/sdk/iap-kit

5楼回复于2026-08-21 08:15 来自辽宁
开发者您好,请参考官方文档:测试数字商品服务、应用内支付沙盒测试常见问题及解决方案、IAP应用内沙盒测试。

您可以通过以下方式测试会员过期:

  1. 等待自动到期:购买订阅后,等待 6 次自动续期完成,系统会自动将订阅状态设为停用(status = 3)

  2. 检查订阅状态:通过 getSubscriptions 接口获取订阅信息,关注 status 字段:

    • 0:初始状态
    • 1:正常(活跃)
    • 2:用户手动取消
    • 3:到期停用(沙盒 6 次续费后触发)
  3. 清除购买记录重新测试:如果需要重新测试,可以在 AppGallery Connect 中清除沙盒账号的购买历史记录:

    • 登录 AppGallery Connect → 用户与访问 → 沙盒测试 → 测试账号
    • 勾选对应测试账号,点击"清除购买历史记录"
    • 清除后可重新购买测试

时间计算参考,以您的场景为例:

  • 年卡(365天):首次购买后约 1 小时(3650秒)发生第一次续期,6 次续期后约 6 小时到期。
  • 月卡(30天):首次购买后约 5 分钟(300秒)发生第一次续期,6 次续期后约 30 分钟到期。
4楼回复于2026-08-21 03:02 来自广东

沙盒不能手动改日期快进,官方用“时光机”自动加速:10 秒 = 1 天。

  • 10 月 1 日到 10 月 6 日,沙盒约等 50 秒;月卡约 300~310 秒,年卡约 3650 秒。
  • 自动续订首期后还会自动续 5 次(共 6 期),所以单纯等一个周期不会进入过期态。
  • 测过期建议新建/使用周卡:购买并完成发货后,到订阅管理页取消续订,约等一个周期(70 秒)后校验权益失效;或等 6 期结束且不恢复订阅。
  • 测试结束可在 AGC「沙盒测试 > 测试账号」清除购买历史,再重新购买。
  • 改设备系统时间不能替代沙盒时光机;官方未提供手动设置沙盒时间的入口。

官方资料:

2楼回复于2026-08-21 02:05 来自广东

背景知识:

自动续期订阅商品的购买流程和消耗型/非消耗型商品的购买流程类似,但订阅还有其他细节场景,比如续订成功或失败,续订周期时长。为了帮助开发者快速测试应用的订阅场景,沙盒环境下的订阅续订时间会比正常情况更快,引入“时光机”概念,沙盒环境中的订阅换算时间为10秒/天。比如订阅周期为1周,商品将在首次购买成功70秒后发生续期。

  • 沙盒环境下的订阅流程与正式环境的订阅流程一致,仍需要完成绑定付款方式,但该过程不会真实扣费。
  • IAP扣费成功后的收据信息PurchaseOrderPayload中,会携带值为"SANDBOX"的environment字段,标识此次购买为沙盒测试的记录。
  • 自动续期处理不需要完成真实扣款,IAP会直接返回成功。
  • 在沙盒测试环境下,用户发起订阅首期会自动续期五次(累计共六期),后续需用户手动操作以恢复订阅。若同时涉及促销场景,系统将优先完成优惠周期内的自动续期,再继续进行六次续期,此场景下总续期次数为优惠周期数与六次续期之和。
  • 沙盒测试拉起收银台时,会在收银台展示沙盒测试提示语,支付结果页也有沙盒环境的提示语

参考:测试自动续期订阅商品

  

9楼编辑于2026-08-25 03:33 来自广东

时光机机制

月卡(按30天举例)

≈ 300 秒

≈ 5 分钟

年卡(365天)

≈ 3650 秒

≈ 60.8 分钟

7楼回复于2026-08-21 13:15 来自陕西

测试自动续期订阅商品

https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/store-iap-sandbox

自动续期订阅商品的购买流程和消耗型/非消耗型商品的购买流程类似,但订阅还有其他细节场景,比如续订成功或失败,续订周期时长。为了帮助开发者快速测试应用的订阅场景,沙盒环境下的订阅续订时间会比正常情况更快,引入“时光机”概念,沙盒环境中的订阅换算时间为10秒/天。比如订阅周期为1周,商品将在首次购买成功70秒后发生续期。

  • 沙盒环境下的订阅流程与正式环境的订阅流程一致,仍需要完成绑定付款方式,但该过程不会真实扣费。

  • IAP扣费成功后的收据信息PurchaseOrderPayload中,会携带值为"SANDBOX"的environment字段,标识此次购买为沙盒测试的记录。

  • 自动续期处理不需要完成真实扣款,IAP会直接返回成功。

  • 在沙盒测试环境下,订阅首期由用户发起后会自动续期五次(累计共六期),后续需用户手动操作以恢复订阅;若同时涉及促销场景,系统将优先完成优惠周期内的自动续期,再继续进行六次续期,此场景下总续期次数为优惠周期数与六次续期之和。

  • 沙盒测试拉起收银台时,会在收银台展示沙盒测试提示,结果页也有沙盒环境的标志,如下图所示。

    cke_359.png

6楼回复于2026-08-21 09:18 来自广东
开发者您好,华为 IAP 沙盒环境已经内置了时间加速机制,您不需要手动快进时间。订阅换算时间为 10秒/天,这意味着沙盒环境中的时间会自动加速。
3楼回复于2026-08-21 02:55 来自广东

不用也不能手动把设备日期跳到 10 月 6 日;IAP 沙盒本身会加速订阅时间,当前换算是 10 秒 = 1 天。例如 7 天自动续期订阅,首次购买约 70 秒后就会续期;月卡/年卡也按这个比例等待即可验证到期、续期和权益回收。

客户端正常发起购买并把原始 purchaseData 交给服务端;服务端验签其中的 JWS 后,读取订阅状态的 expiresTime 来驱动会员过期,不要用手机系统时间造数据:

收起
自动换行
深色代码主题
复制
import { iap } from '@kit.IAPKit'

const result = await iap.createPurchase(context, {
  productId: 'vip_month_auto',
  productType: 2
})
await uploadPurchaseData(result.purchaseData) // 服务端验签并判断 expiresTime

测试前确认设备登录的是 AGC 配置的测试账号,且安装的是 debug 签名包;验签后的订单 environment 不是 SANDBOX 时不要继续购买,先排查沙盒未生效。想从头再测可在 AGC 的“沙盒测试 > 测试账号”清除该账号购买历史,清除后不可撤销。

 

1楼回复于2026-08-21 01:59 来自四川
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要提问题

了解社区公约,与您携手共创和谐专业的开发者社区。