App Tester用户指南

您可以在将应用发布到亚马逊应用商店前，使用App Tester工具测试亚马逊应用内购买(IAP)功能。在下载、安装并设置App Tester工具后，您可以开始测试应用内功能。

注意： 您需要通过notifyFulfillment()调用将以前的所有购买标记为已履行或不可用，用户才能进行进一步的应用内购买。此逻辑有助于您正确实现IAP SDK的这一部分。它仅适用于App Tester，不适用于生产行为。

如果您尚未为应用设置App Tester，请参阅安装并配置App Tester。

使用App Tester
选择IAP API
管理用户
配置API响应设置
启用或禁用通知
管理交易
查看JSON文件中的IAP商品
模拟您用户的体验
日志记录
使用App Tester测试DRM

使用App Tester

注意： App Tester适用于调试版本的应用。不能对发行版本使用App Tester。

Amazon App Tester是一款模拟亚马逊应用商店授权的工具（以前仅由IAP使用）。请在此处下载App Tester。

要使用Amazon App Tester测试应用的许可证验证，请执行以下操作：

通过ADB将计算机连接至Fire TV或Fire平板电脑。有关详细信息，请参阅以下任一内容：
- 通过ADB连接到Fire TV
- 通过ADB连接到Fire平板电脑
使用以下命令将应用设置为沙盒模式：
```
adb shell setprop debug.amazon.sandboxmode debug
```
沙盒模式会对通常发送到亚马逊应用商店客户端的调用加以限制，转而将其路由至Amazon App Tester。此模式仅可用于本地测试。
卸载现有版本的Amazon App Tester，然后下载并在Fire设备上打开。
打开Amazon App Tester，然后转至Appstore SDK API > DRM API Response Settings（DRM API响应设置）> GetLicense API。您会看到几个可以设置的许可证选项：

App Tester中DRM API响应设置
运行包含DRM的Fire TV或平板电脑应用。Amazon App Tester会根据您在Amazon App Tester中的选择，模拟有关用户许可证状态的响应。

要退出沙盒模式，请运行以下命令：
```
adb shell setprop debug.amazon.sandboxmode none
```

选择IAP API

首次启动App Tester应用时，登录页面会提示您选择IAP API：

点击In-App Purchasing API（应用内购买API）以开始。

App Tester会显示IAP API的导航选项列表：

用户账户设置：为应用配置用户测试账户。
API响应设置：为您的测试案例配置条件和响应。
通知设置：启用或禁用添加到下拉通知栏的通知。
管理交易：管理应用中有效的IAP交易。
JSON文件中的IAP商品：以人类可读的格式从JSON文件中查看您添加到App Tester中的数据。

管理用户

您可以让用户登录和退出、更改用户以及更改与用户关联的市场。这些选项有助于利用不同市场中的用户来测试各种情景。

要访问用户管理页面，请在App Tester登录页面中选择IAP API，然后点击User Account Settings（用户账户设置）。

登录和退出

要使当前用户在登录和退出状态之间切换，请在Status（状态）下点击Logged in（已登录）或Logged Out（已退出）选项。

更改当前用户

App Tester提供了三个不同的测试用户账户。测试用户名分别为Amazon User 1、Amazon User 2和Amazon User 3。

要更改用户，请查看Amazon User Id（亚马逊用户ID），然后选择要用于测试的用户ID。

为当前用户更改用户市场

使用App Tester可以在不同的国际市场中测试您的应用。要更改与当前用户关联的市场，请查看User Marketplace（用户市场）并选择新市场。可用市场如下：

US：美国
GB：英国
DE：德国
ES：西班牙
FR：法国
IT：意大利
JP：日本

配置API响应设置

使用API Response Settings（API响应设置）选项卡来为您IAP API的测试调用设置其条件和响应：

在指定响应时，以下部分中的“Default”只是表示使用现有的默认设置。“Default”本身不是可用的设置。如果您明确选择了一个值（如SUCCESSFUL或FAILED），则App Tester将返回所选值。例如，如果JSON文件包含所请求的SKU，getProductData将返回SUCCESSFUL。如果在User Account Settings中将用户设置为Logged Out，则GetUserData将返回FAILED。

下表显示了IAP API的可用响应。

API名称	可用响应
GetProductData	Default、SUCCESSFUL、FAILED
GetPurchaseUpdates	Default、SUCCESSFUL、FAILED
GetUserData	Default、SUCCESSFUL、FAILED
Purchase	Default、SUCCESSFUL、FAILED、ALREADY_PURCHASED、INVALID_SKU

启用或禁用通知

使用Notifications Settings（通知设置）选项卡可轻松启用或禁用添加到系统通知栏的通知。

下图显示了Notification Settings选项卡：

以下为可用的通知设置：

Purchase Updates Notifications（购买更新通知）：默认情况下，若应用加载购买对话但从未调用过getPurchaseUpdates()，亚马逊会发送通知。应用调用getPurchaseUpdates()一次后，亚马逊会停止发送此通知。使用Purchase Updates Notifications可设置亚马逊是否发送此通知。
Notify Fulfillment Notifications（发送履行通知）：默认情况下，如果用户进行了购买，但商品没有在30秒内履行，亚马逊会发送通知。使用Notify Fulfillment Notifications可启用或禁用此通知。
Reset Purchase Updates（重置购买更新）：重置指示getPurchaseUpdates()是否已调用的状态。

管理交易

使用Manage Transactions（管理交易）选项卡可查看、取消或删除当前用户的购买交易。在测试权利和订阅时，取消或删除交易是非常有用的工具。此选项卡显示当前用户的所有交易。

Manage Transactions选项卡包含每个交易的以下信息：

RECEIPT（收据）：所购买产品的类型。IAP的有效值为CONSUMABLE、ENTITLEMENT和SUBSCRIPTION。
RECEIPT ID（收据ID）：交易的唯一标识符。
SOLD BY（销售方）：销售商品的应用。
PURCHASED ON（购买日期）：购买商品的日期。
STATUS：交易状态。有效值为PURCHASED或CANCELED。这些App Tester值分别对应IAP API值FULFILLED和UNAVAILABLE。

当应用调用PurchasingService.notifyFulfillment(receiptId, FulfillmentResult.FULFILLED)时，“管理交易”部分会显示收据，其状态为： FULFILLED（已履行）。

在Manage Transactions选项卡中，您可以执行以下任务：

刷新当前用户的交易列表。
删除当前用户的所有交易。
取消单个交易。
删除单个交易。

查看JSON文件中的IAP商品

要提供简单方法来查看您在安装并配置App Tester中配置的JSON文件中的IAP商品，请点击IAP Items in JSON File（JSON文件中的IAP商品）选项卡。如果您正确添加了有效的JSON文件，则App Tester将解析此文件的内容并将其显示在此选项卡下。

如果您尚未正确添加有效的JSON文件，则此选项卡将发送一条错误消息，或指明JSON文件不存在。

模拟您用户的体验

除了为API请求提供响应，App Tester还可以像已发布的上线应用一样，显示购买流程对话框。此功能的好处是，对话框可以帮助您评估应用购买过程的用户体验。

App Tester会为每个购买请求显示两个插屏对话框。第一个对话框是显示购买价格和其他信息的详情屏幕，如以下IAP示例所示：

第二个对话框是用户必须通过点击右上角的“X”按钮来手动关闭的“感谢”屏幕，如以下IAP示例所示：

日志记录

AppTester使用Logcat工具来捕获有关应用交易以及其他API交互的详细信息。使用Logcat查看在测试应用时生成的日志：

将包含应用和AppTester的Android设备连接到运行Android调试桥（ADB）的计算机。
搜索标签“AmazonAppTester”以查看AppTester日志条目。

如果使用Eclipse DDMS开发环境，可以通过在Logcat选项卡中的筛选条件文本区域中输入tag:AmazonAppTester来筛选App Tester生成的日志条目。

使用App Tester测试DRM

需要安装Amazon App Tester（参见上文）才能在设备上测试DRM。要测试应用中的DRM功能，就必须使用Amazon App Tester。

Amazon App Tester中提供了名为“DRM API Response Settings（DRM API响应设置）”的选项卡，使您能够模拟不同许可证状态的响应。

要使用Amazon App Tester测试应用的许可证验证，请在应用的AndroidManifest.xml文件中添加以下drm.ResponseReceiver。如果您的应用以Android 12或更高版本为目标，则必须在MainActivity和ResponseReceiver中显式地将android:exported设置为true，如下面的示例所示：

 <application>
 ...
    <activity android:label="@string/app_name" android:name="com.amazon.sample.drm.MainActivity" 
                android:exported="true">
        <intent-filter>
            <action android:name="android.intent.action.MAIN" />
            <category android:name="android.intent.category.LAUNCHER" />
        </intent-filter>
    </activity>

    <receiver android:name = "com.amazon.device.drm.ResponseReceiver" android:exported="true" 
                android:permission = "com.amazon.drm.Permission.NOTIFY" >
        <intent-filter>
            <action android:name = "com.amazon.drm.NOTIFY" />
        </intent-filter>
    </receiver>
 ...
 </application>

DRM示例应用中也提供了更多详情。

Last updated: 2022年9月20日