我开了年卡测试或者开了月卡测试之后,沙盒测试当中我没有办法快进时间,比如说应用内10月5号会过期,但是我现在才10月1号,我没有办法模拟10月6号的时候应用内会员过期时候的状态
YOUNGHarmonyOS 6
软件开发
IAP Kit 沙盒测试
不羁的木木楼主你好,
这个不用等真实日期。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
157******26您可以通过以下方式测试会员过期:
等待自动到期:购买订阅后,等待 6 次自动续期完成,系统会自动将订阅状态设为停用(status = 3)
检查订阅状态:通过
getSubscriptions接口获取订阅信息,关注status字段:- 0:初始状态
- 1:正常(活跃)
- 2:用户手动取消
- 3:到期停用(沙盒 6 次续费后触发)
清除购买记录重新测试:如果需要重新测试,可以在 AppGallery Connect 中清除沙盒账号的购买历史记录:
- 登录 AppGallery Connect → 用户与访问 → 沙盒测试 → 测试账号
- 勾选对应测试账号,点击"清除购买历史记录"
- 清除后可重新购买测试
时间计算参考,以您的场景为例:
- 年卡(365天):首次购买后约 1 小时(3650秒)发生第一次续期,6 次续期后约 6 小时到期。
- 月卡(30天):首次购买后约 5 分钟(300秒)发生第一次续期,6 次续期后约 30 分钟到期。
蓝瘦的蜕变
沙盒不能手动改日期快进,官方用“时光机”自动加速:10 秒 = 1 天。
- 10 月 1 日到 10 月 6 日,沙盒约等 50 秒;月卡约 300~310 秒,年卡约 3650 秒。
- 自动续订首期后还会自动续 5 次(共 6 期),所以单纯等一个周期不会进入过期态。
- 测过期建议新建/使用周卡:购买并完成发货后,到订阅管理页取消续订,约等一个周期(70 秒)后校验权益失效;或等 6 期结束且不恢复订阅。
- 测试结束可在 AGC「沙盒测试 > 测试账号」清除购买历史,再重新购买。
- 改设备系统时间不能替代沙盒时光机;官方未提供手动设置沙盒时间的入口。
官方资料:
丿未来丶背景知识:
自动续期订阅商品的购买流程和消耗型/非消耗型商品的购买流程类似,但订阅还有其他细节场景,比如续订成功或失败,续订周期时长。为了帮助开发者快速测试应用的订阅场景,沙盒环境下的订阅续订时间会比正常情况更快,引入“时光机”概念,沙盒环境中的订阅换算时间为10秒/天。比如订阅周期为1周,商品将在首次购买成功70秒后发生续期。
- 沙盒环境下的订阅流程与正式环境的订阅流程一致,仍需要完成绑定付款方式,但该过程不会真实扣费。
- IAP扣费成功后的收据信息PurchaseOrderPayload中,会携带值为"SANDBOX"的environment字段,标识此次购买为沙盒测试的记录。
- 自动续期处理不需要完成真实扣款,IAP会直接返回成功。
- 在沙盒测试环境下,用户发起订阅首期会自动续期五次(累计共六期),后续需用户手动操作以恢复订阅。若同时涉及促销场景,系统将优先完成优惠周期内的自动续期,再继续进行六次续期,此场景下总续期次数为优惠周期数与六次续期之和。
- 沙盒测试拉起收银台时,会在收银台展示沙盒测试提示语,支付结果页也有沙盒环境的提示语
参考:测试自动续期订阅商品
飞b6时光机机制
月卡(按30天举例)
≈ 300 秒
≈ 5 分钟
年卡(365天)
≈ 3650 秒
≈ 60.8 分钟
FIEforever
测试自动续期订阅商品
https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/store-iap-sandbox
自动续期订阅商品的购买流程和消耗型/非消耗型商品的购买流程类似,但订阅还有其他细节场景,比如续订成功或失败,续订周期时长。为了帮助开发者快速测试应用的订阅场景,沙盒环境下的订阅续订时间会比正常情况更快,引入“时光机”概念,沙盒环境中的订阅换算时间为10秒/天。比如订阅周期为1周,商品将在首次购买成功70秒后发生续期。
-
沙盒环境下的订阅流程与正式环境的订阅流程一致,仍需要完成绑定付款方式,但该过程不会真实扣费。
-
IAP扣费成功后的收据信息PurchaseOrderPayload中,会携带值为"SANDBOX"的environment字段,标识此次购买为沙盒测试的记录。
-
自动续期处理不需要完成真实扣款,IAP会直接返回成功。
-
在沙盒测试环境下,订阅首期由用户发起后会自动续期五次(累计共六期),后续需用户手动操作以恢复订阅;若同时涉及促销场景,系统将优先完成优惠周期内的自动续期,再继续进行六次续期,此场景下总续期次数为优惠周期数与六次续期之和。
-
沙盒测试拉起收银台时,会在收银台展示沙盒测试提示,结果页也有沙盒环境的标志,如下图所示。

157******26
橙动创意不用也不能手动把设备日期跳到 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 的“沙盒测试 > 测试账号”清除该账号购买历史,清除后不可撤销。
- 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
- 如您发布的内容为转载内容,请注明内容来源。
我要提问题
HarmonyOS CallerInfoQueryExtensionContext如何读取主应用沙盒下的数据(API12+)
HarmonyOS 基于Hypium单元测试框架,执行测试用例的时候,无法访问到用户文件夹“文件管理”->“我的手机”中自己上传的测试素材(API12+)
HarmonyOS 创建内部测试Profile无法选择组织内部发布证书 (API12+)
HarmonyOS 使用core speech kit的语音识别不准(API12+)
HarmonyOS app签名证书打包问题(API12+)
HarmonyOS IAP Kit 在华为内购服务开通成功前,怎么测试IAP Kit的服务?(API12+)
HarmonyOS 如果组织内部分发证书过快期,要怎么去更新这证书 (API12)
HarmonyOS IAP Kit的沙盒测试接入失败1001860002 (API12+)




































苏公安网备 32011402010933号