IAP入门

如果您从未使用过Amazon Appstore SDK，或从未实现过IAP API，本页会帮助您设置IDE并熟悉推荐的IAP开发、测试和提交工作流程。

本主题将引导您将IAP示例应用导入IDE，而不是启动一个新的项目，这样您就可以更快地开始。要了解有关如何实现IAP API的详细信息，请参阅实现IAP。

提示： 有关如何将Appstore SDK库添加到新项目中的说明，请参阅集成Appstore SDK

下载Appstore SDK
在Android Studio中设置示例应用
设置App Tester
提交应用和应用程序内商品

下载Appstore SDK

可以从这里下载Appstore SDK：

下载项包括IAP JAR文件、API文档和示例应用。

在Android Studio中设置示例应用

如果使用Android Studio作为IDE，您可以导入示例项目，将它们导出为APK并在Android设备上运行它们。

设置您的Android Studio开发环境以使用IAP示例应用：

将Appstore_SDK_<version>.zip文件的内容解压到您的本地计算机上。
启动Android Studio。
将IAP示例应用导入您的工作区：
1. 在“Welcome to Android Studio”（欢迎使用Android Studio）屏幕的More Actions（更多操作）菜单（右上角的三个堆叠的点），选择Import Project (Eclipse ADT, Gradle, etc.)（导入项目（Eclipse ADT、Gradle等））以打开项目导入窗口。
2. 在“Select Eclipse or Gradle Project to Import（选择要导入的Eclipse或Gradle项目）”窗口中，导航到解压缩Amazon-Android-SDKs.zip文件内容的位置，然后导航到并选择/Appstore_SDK_<version>/examples。
3. 选择三个IAP示例项目之一的目录，然后单击OK（确定）转到“Import Project from ADT（从ADT导入项目）”屏幕。
4. 在“Import Project from ADT”屏幕上，选择目标目录，然后单击Next（下一步）。
5. 在后面的屏幕上，保持所有默认设置的选中状态，然后单击Finish（完成）来导入IAP示例应用项目。
6. 对每个示例应用重复上述步骤。
如果您使用的是最新版本的Appstore SDK，则可以跳过此步骤。如果您使用的是旧的IAP v2.0 SDK，请将JAR文件添加到您的项目中：
1. 在Android Studio的左上角（项目的选项卡下方），从下拉菜单中选择Project（项目）（其他选项是Android或Packages（程序包））以显示项目的目录树。
2. 在项目的app目录下，创建新目录并将其命名为“libs”。
3. 将Appstore SDK JAR文件复制到新的libs目录中。
  
  如果使用Mac，请右键单击libs文件，然后从上下文菜单中选择Reveal in Finder（在访达中显示）。然后，可以将Appstore SDK JAR文件从Appstore_SDK_<version>复制到新的libs目录。目录刷新后，可在Android Studio中此目录内看到该文件。
4. 右键单击Appstore SDK JAR文件，然后选择Add as Library…（添加为库...）。
  
  IAP库将添加到项目的gradle依赖项列表中。您现在应该能够成功构建示例应用项目了。
  
  注意：如果您更喜欢使用Gradle来添加库，请打开build.gradle文件并将以下代码添加到此文件的依赖项部分中，然后单击build.gradle文件顶部的Sync Now（立即同步）链接来同步所做更改：
```
dependencies {
...
compile fileTree(dir: 'libs', include: ['*.jar'])
}
```
5. 对每个示例应用项目重复这些步骤。
为其中一个示例应用生成APK：
1. 将您的Android移动设备连接到开发计算机。
2. 在Android Studio中，单击Debug（调试），然后选择正在运行的设备，以将应用安装到该设备。

注意： 对于亚马逊Android SDK，目前不能在Android Studio中将Javadoc添加到您的项目中，因为Android Studio要求Javadoc可用作它们自己的JAR文件，目前无法将它作为此SDK的一部分提供。

您现在应该能够在移动设备上运行此示例应用了。

请注意，在将实际应用提交到亚马逊应用商店时，亚马逊签名将应用于您的应用，无论您提交的是已签名还是未签名的APK。

设置App Tester

注意： 在开始任何实际测试之前，请了解您的IAP测试选项和推荐的测试过程。请参阅测试应用内购买(IAP)。

亚马逊提供了App Tester工具来对IAP执行单元测试。您可以使用IAP示例应用来测试此工具。

安装App Tester并在在App Tester上运行示例应用：

按照安装并配置App Tester中的说明操作。
从示例应用中，使用adb push命令，将amazon.sdktester.json文件复制到您设备上的/mnt/sdcard/amazon.sdktester.json路径中：
```
$ adb push <_Your_JSON_File_Folder_>/amazon.sdktester.json /mnt/sdcard/`  
```
按照App Tester用户指南中的说明进行操作，了解有关使用App Tester测试应用的更多信息。如果您在设置要使用App Tester进行检查的测试案例这方面需要帮助，请参阅为IAP定义并执行测试案例。

提交应用和应用程序内商品

测试完应用后，即可向亚马逊提交应用和应用程序内商品。

请参阅创建并提交IAP商品。

Last updated: 2023年12月4日