适用于 Google Pay API for Passses 的 Android API 快速入门

凭借适用于 Google Pay for Passes 的 Android API，用户只需点击一下按钮，便可将重要的对象保存到 Google Pay 中。此快速入门示例为保存会员卡、礼品卡和优惠对象提供了快速设置指南。

请按照 Android SDK 指南及后续步骤，运行示例 Android 应用：

步骤 1：设置 Android 应用

此快速入门是一个开源项目，您可以从 GitHub 中下载。 要下载该项目，请执行以下操作：

  1. 访问 GitHub 资源库
  2. 下载 zip 文件，或者通过运行 git clone https://github.com/google-pay/s2gp-quickstart-android 来克隆代码库。

接下来可以通过 Android Studio 将示例应用作为现有项目打开。 您需要同步该项目才能正确编译。在 Android Studio 中创建后，示例应用即可在 Android 设备或模拟器上运行。

步骤 2：创建类

您可以通过 Google Pay API for Passes Merchant 创建一个类。 在 Merchant Center 的“Classes”页面中，选择“Create Class”来创建该类。带红色边框的输入字段为必填项，其他为可选项。如果字段中含有 URL，务必确保该链接可公开访问。创建重要的对象时将引用已创建的类。

步骤 3：配置 Android 应用

如需配置示例应用，使其正常运行，必须调整某些值。在 app/res/values/ 中发现的 strings.xml 范围内：

  1. 将 ISSUER_ID 值替换为您的 Google Pay API for Passes 发卡机构 ID。
  2. 将 LOYALTY_CLASS_ID、GIFTCARD_CLASS_ID 或 OFFER_CLASS_ID 替换为您已在 Google Pay API for Passes Merchant Center 中创建的相关类的名称。

在 MainActivity.java 中，必须为每个对象类型配置特定值，使其与该对象在 Merchant Center 中引用的类匹配：

  1. 对于 generateGiftCardWalletObject 方法中的 GiftCardWalletObject，setIssuerName 和 setTitle 必须与类中的值匹配。
  2. 对于 generateLoyaltyWalletObject 方法中的 LoyaltyWalletObject，setIssuerName 和 setProgramName 必须与类中的值匹配。
  3. 对于 generateLoyaltyWalletObject 方法中的 OfferWalletObject，setIssuerName 和 setTitle 必须与类中的值匹配。

步骤 4：测试 Android 应用

您可以在模拟器或 Android 实体设备上运行此应用。正确同步 gradle 后，通过 Android Studio 运行该应用，并选择所需的部署目标。部署完成后，示例应用会自动启动。