测试指南
1. 概述
Samsung 应用程序内购买 (IAP) 支持对您的应用程序内项目提供、购买和付款功能进行应用程序 IAP 集成和应用程序内项目开发测试,然后再提交您的应用程序和应用程序内项目(消耗性、非消耗性和订阅项目)以供在 Galaxy Store 中进行验证测试和正常发布。
对应用程序内项目提供(当应用程序获取当前项目价格和详细信息并向应用程序用户显示时)进行 IAP 测试与正常发布相同。对应用程序内项目购买和付款进行 IAP 测试与正常发布相同,不同的是订阅项目测试有所变化,并且部分测试者可以免费获得项目。
2. IAP 测试环境
确定 IAP 测试和对项目进行测试要使用的购买和付款交易的类型。
在您的应用程序代码中,请按如下所示设置 IAP 操作模式。 在卖家门户中:注册您的应用程序和应用程序内项目、设置封闭式 Beta 版测试(如果已使用),并按如下所示设置应用程序状态。
IAP 测试 | 交易 | IAP 操作模式 | 应用程序状态 |
---|---|---|---|
始终成功的侧面加载 | 免费 | OPERATION_MODE_ |
正在注册 |
始终失败的侧面加载 | 免费 | OPERATION_MODE_ |
正在注册 |
生产封闭式 Beta 版 | 免费或收费 (取决于测试者的类型) |
OPERATION_MODE_ |
已部署 Beta 版 |
IAP 操作模式为“OPERATION_MODE_PRODUCTION”且应用程序状态为“正在注册”时,请勿测试。在这些条件下不支持 IAP 功能。
IAP 测试交易类型
IAP 测试支持项目购买的“免费”和“收费”交易。
(1) 免费交易
- 项目付款不向付款网关(PG 卡公司或付款机构)报告。对于成功的交易,将向测试者发送购买电子邮件和金额。
- 在项目购买 UI 弹出窗口中,显示了“Sandbox”图标。
- 详细信息依赖于 IAP 测试环境和测试者的类型:
IAP 操作模式 | 测试者类型 | 详细信息 |
---|---|---|
OPERATION_MODE_ |
所有类型 |
|
OPERATION_MODE_ |
所有类型 |
|
OPERATION_MODE_ |
已许可测试者 |
|
(2) 收费交易
- 对于成功的交易,项目付款将向付款网关(PG 卡公司或付款机构)报告并由网关授权,IAP 将报告购买金额。
- 在项目购买 UI 弹出窗口中,未显示“Sandbox”图标。
- 仅对于 OPERATION_MODE_PRODUCTION Beta 版测试和非许可测试者才会发生: 对于成功的购买,测试者将获得项目并对其收费,IAP 报告购买成功。
3. IAP 测试
为您的应用程序、应用程序内项目和 Samsung IAP 创建测试时,IAP 测试是测试设置以及启动和验证 IAP 功能的指导原则。您可以通过一个或多个 IAP 测试来测试您的应用程序和应用程序内项目。
3.1 准备
对于所有 IAP 测试,测试者、应用程序和应用程序内项目均需准备就绪:
-
确保每个测试者都有可用于付款的有效信用卡。 不会针对任何项目购买向侧面加载测试者和已许可测试者的信用卡计费。 对于所有项目购买,都不会向非许可测试者的信用卡计费。
-
在您的应用程序代码中:
a. 为选定的 IAP 测试设置 IAP 操作模式。
mIapHelper.setOperationMode(HelperDefine.OperationMode.[IAP operating mode for the selected test])
b. 设置在项目购买期间是否显示“付款完成”或“付款失败”消息
IapHelper.startPayment class parameter _showSuccessDialog is true or false
-
生成应用程序 APK。 有关详细信息,请参阅《编程指南》。
-
在 Samsung Galaxy Store 卖家门户中:
a. 注册应用程序和应用程序内项目。
b. 为选定的 IAP 测试设置应用程序状态。
3.2 测试类型
(1) 始终成功的侧面加载测试
- 目的和用途:
- 测试所有项目的提供、购买和付款。
- 测试处于 IAP 测试期限内的订阅项目。
- 通常用于应用程序、应用程序内项目和 IAP 集成开发期间。
-
- IAP 操作模式设置为 OPERATION_MODE_TEST。
-
通过独立方法(例如侧面加载)在测试设备上安装应用程序。
a. 测试者始终获得已购买的项目且不收费。
b. IAP 将所有购买报告为成功并报告购买金额。
(2) 始终失败的侧面加载测试
- 目的和用途:
- 测试所有项目的提供和失败的购买及付款。
- 通常用于应用程序、应用程序内项目和 IAP 集成开发期间。 1.准备要进行测试的应用程序和应用程序内项目。
- IAP 操作模式设置为 OPERATION_MODE_TEST_FAILURE。 2.通过独立方法(例如侧面加载)在测试设备上安装应用程序。 3.测试项目提供和购买: a. 测试者始终未获得项目且不收费。 b. IAP 将所有项目购买和付款报告为失败。
(3) 生产封闭式 Beta 版测试
-
所部署要进行 Beta 版测试的应用程序只能使用 Beta 版测试 URL 进行安装。如果进行侧面加载,则无法访问项目信息。
-
如果更新 Beta 版测试应用程序并部署较新的版本,则测试者必须从其设备中删除早期 Beta 版测试应用程序,然后重新安装该应用程序。
- 目的和用途:
可以按照下列步骤进行 Beta 版测试设置以及由同一人按照下列步骤执行测试。通常,Beta 版测试负责人会将 Beta 版测试设置为由多个 Beta 版测试者运行。
-
如果应用程序先前是通过侧面加载方式加载到测试设备上的,请卸载应用程序。
-
准备要进行测试的应用程序和应用程序内项目。 IAP 操作模式设置为 OPERATION_MODE_PRODUCTION。
-
在卖家门户中: a. 注册应用程序及其项目。 有关详细信息,请参阅《应用程序注册指南》和《应用程序内购买指南》。
b. 设置封闭式 Beta 版测试: 在卖家门户应用程序注册的“二进制文件”选项卡中,注册所有测试者(包括非许可测试者和已许可测试者)和封闭式 Beta 版测试的反馈渠道。
在您的卖家门户配置文件中,注册已许可测试者。
c. 单击“提交 Beta 版测试”,提交应用程序及其项目以供进行 Beta 版发布。 有关更多详细信息,请参阅《应用程序注册指南》。
-
在每个 Beta 版测试者的设备上,从 Beta 版测试 URL 下载 Beta 版应用程序。
-
测试项目提供和购买: 通常,一些测试者为非许可测试者,一些测试者为已许可测试者。
3.3 测试项目提供和购买
可以对每个已测试的应用程序内项目执行以下步骤:
-
测试应用程序内项目提供: a. 在应用程序中,启动对每个项目显示当前价格和详细信息。 b. 验证项目信息是否与卖家门户中注册的价格和详细信息一致。
-
测试应用程序内项目购买: a. 在应用程序中,启动对项目的购买。 b. 对于已许可测试者,请单击“确定”。
c. 对于始终成功的侧面加载和始终失败的侧面加载测试者,请单击“继续”。
d. 在购买弹出窗口中: 免费交易 收费交易
(1) 验证项目详细信息是否与卖家门户中注册的信息一致。
将显示项目折扣、优惠券、免费试用期、低层价格和自动付款到期日期,但在 IAP 测试期间不会显示。
(2) 选择付款方式并验证付款信息是否正确。 (3) 选择“积分和优惠券”并验证所显示的信息是否正确。 (4) 单击**[“项目购买”按钮]。**
e. 验证以下信息:
IAP 测试准备设置是否显示“付款完成”或“付款失败”消息。
测试 | 说明 |
---|---|
始终成功的侧面加载测试 |
|
始终失败的侧面加载测试 |
|
生产封闭式 Beta 版测试 | 对于成功的购买: - 将显示“付款完成”消息(如果已配置)。 - 购买的项目将添加到您的帐户中。 - 将向您发送“项目已购买”电子邮件。 - 如果您是非许可测试者,将向您收费。 - 如果您是许可测试者,将不向您收费。 对于失败的购买: - 将显示“付款失败”消息(如果已配置)。 - 购买的项目将不会添加到您的帐户中。 - 将不向您收费。 |
3.4 测试订阅项目
对于自动定期订阅 (ARS) 项目,您可以测试其提供、购买、免费试用、低层和常规层定价、自动付款、手动订阅取消和再次购买。
每个订阅应用程序内项目可以有 1 个免费试用期(可选)、1 到 100 个低层价格期限(可选)和常规层价格期限(必需,但可以由测试者随时取消,或者应用 IAP 测试期限时在 12 个期限后自动取消)。
- 根据 IAP 测试环境,免费试用期和订阅期限在下列情况之一后结束:
已注册项目期限
- 免费试用期和订阅期限将按订阅项目的卖家门户注册中指定的时间结束,可以是几周、几个月或几年。
- 应用于非许可测试者的生产封闭式 Beta 版测试期间。
IAP 测试期限
- 免费试用期和订阅期限每隔 10 分钟结束一次(分别为 hh:10、hh:20、hh:30、…)。购买或再次购买后的第一个期限在接下来的 10 分钟时间后结束。例如,如果免费试用项目的第一次购买时间为 11:08,则免费试用结束的时间为 11:10。
- 应用于所有测试者的始终成功侧面加载测试期间,以及已许可测试者的生产封闭式 Beta 版测试期间。
测试订阅项目
- 设置测试环境:
- 始终成功的侧面加载测试。 或者
- 生产封闭式 Beta 版测试以及非许可测试者和/或许可测试者。
以下步骤适用于侧面加载测试者和不向购买收费的已许可测试者,免费试用和订阅将按 IAP 测试期限结束。
将向非许可测试者收取购买费用,且期限按注册的时间结束。
- 购买订阅项目。
如果在 IAP 测试中购买免费试用项目和/或采用低层定价的项目,并且同一测试者在另一 IAP 测试中购买相同项目,则免费试用和低层定价将不会生效。
- 在初始购买后测试项目。 根据下面所适用情况对应的示意图,验证是否发生下列操作:
- 在购买电子邮件中向您发送免费或已注册购买的价格,以及其他购买详细信息。
- 第一次自动付款电子邮件在下一个 10 分钟后发送,并按第一次自动付款价格收费(已注册低层或常规层价格)。
- 每隔 10 分钟发送另一封自动付款电子邮件,并按自动付款价格收费(已注册低层或常规层价格)。
- 测试项目再次购买: a. 再次购买订阅项目。 b. 根据下面所有项目类型对应的示意图,验证是否发生下列操作: • 购买后很快向您发送包含常规层价格的购买电子邮件。 • 在购买后的 10 分钟发送第一封自动付款电子邮件。 • 每隔 10 分钟发送的所有自动付款电子邮件中包含常规层价格。
- 测试手动订阅取消: a. 在 Galaxy Store 中,自动取消前随时单击“我的页面”>“接收内容”>“项目”选项卡>“[选择已购买的项目]”>“取消订阅”。 b. 验证是否向您发送了取消电子邮件。
示例订阅项目测试
在这两个示例中,一个测试者设置了侧面加载测试,或者一个注册的已许可测试者设置了生产封闭式 Beta 版测试。免费试用期和订阅期限处于 IAP 测试期限内,并且免费试用和低层定价在再次购买项目后未生效。
购买、免费试用、手动取消和再次购买非分层订阅项目
- 测试订阅应用程序内项目具有 7 天的免费试用期,每月常规订阅价格为 $4.99。时间(hh:mm 本地时间)适用于列出的操作和事件。
购买、免费试用、手动取消、再次购买和自动取消分层订阅
- 测试订阅应用程序内项目具有 7 天的免费试用期,3 个月的低层订阅价格每个月为 $2.99,每月常规订阅价格为 $4.99。
时间(hh:mm 本地时间)适用于列出的事件。
4. IAP 测试后
完成所有 IAP 测试之后,且在提交您的应用程序及其应用程序内项目以供验证测试之前,必须为正常发布做好准备。
您只能在 Beta 版测试期间跟踪 Beta 版测试应用程序的购买历史记录。当应用程序更新为常规(非 Beta 版)安装时,Beta 版测试购买历史记录将不再可用。
准备正常发布
- 对于在 IAP 测试期间购买的订阅项目,请确保其订阅已取消。
- 从测试者移动设备中删除已测试的应用程序。
- 在要提交以供验证测试的应用程序代码中,请确保 IAP 操作模式为 OPERATION_MODE_PRODUCTION。Caution :
如果 IAP 操作模式设置为 OPERATION_MODE_TEST 的应用程序已正常发布,则不会针对应用程序内项目购买向已许可的测试者收费。所有其他用户将会收到错误消息。
a. 删除您的配置文件中注册的所有已许可测试者。
b. 如果 IAP 测试之后更改了应用程序或其项目,请使用应用程序及其项目的生产版本更新应用程序注册,并根据需要更改注册信息。
c. 提交应用程序及其项目以供 Samsung 进行验证测试和在 Galaxy Store 中正常发布。 有关详细信息,请参阅《应用程序注册指南》和《应用程序内购买指南》。