Payments >

设置多商店支付

当您使用nowStudio的多商店发布功能时，now.gg支付模块（now.gg Payments Module）为多商店支付（multi-store Payments）提供支持。

本文档阐述了启用多商店支付所需的步骤。

前提条件

要启用多商店支付，需满足以下前提条件：

支付集成 – 确保您已经集成了我们的支付模块。
- 原生Android。
- Unity。
nowStudio设置
- 选择您希望发布应用的商店。了解更多。
  - 提供多商店发布所需的信息和资源，参考此文档。

1. 支持的商店

下列是目前支持的商店：

由 now.gg 提供支持
- 云商店
- BlueStacks 商店
替代方案
- Samsung Galaxy Store
- Xiaomi GetApps
- OnePlus OneStore
- Amazon Appstore
- Huawei AppGallery（即将推出）

2. 商店特定设置

在集成支付模块后，请确保在最终构建中包含以下商店特定的更改，然后再提供最终的 APK。

根据您选择的商店，请参考以下步骤：

2.1 Amazon 应用商店

以下步骤是为 Amazon 应用商店创建应用构建所必需的。

2.1.1 PEM 文件

Amazon 需要一个 PEM 文件，其中包含唯一的应用专用公钥，以建立 Amazon 应用商店与您的应用之间的安全通信通道。

要获取 PEM 文件，请联系我们 dev-support@now.gg。
按照以下说明包含 PEM 文件：
原生 Android：
- 将 PEM 文件粘贴到 Android Studio 项目的 app/src/main/assets 目录中。
  注意： 如果您的应用没有 assets 目录，则必须创建一个并将 PEM 文件放入其中。
Unity：
- 在项目的 Assets 文件夹中创建一个名为 StreamingAssets 的新文件夹。
  - 将 PEM 文件粘贴到 Assets/StreamingAssets 目录中。

2.1.2 更新 AndroidManifest.xml

在您的应用的 AndroidManifest.xml 中添加以下条目：

<queries>
     <package android:name="com.amazon.sdktestclient" />
     <package android:name="com.amazon.venezia" />
 </queries>

2.2 OnePlus OneStore

以下步骤是为 OnePlus OneStore 创建应用构建所必需的。

2.2.1 添加依赖项

在模块/app 级别的 build.gradle 中添加以下依赖项：

implementation "com.onestorecorp.sdk:sdk-iap:21.01.00"

2.2.2 更新根 build.gradle / settings.gradle

根据以下内容更新根 build.gradle 或 settings.gradle：

pluginManagement {
    repositories {
        google {
            content {
                includeGroupByRegex("com\\.android.*")
                includeGroupByRegex("com\\.google.*")
                includeGroupByRegex("androidx.*")
            }
        }
      maven { url "https://jitpack.io" }
      maven { url = uri("https://repo.onestore.net/repository/onestore-sdk-public") }
        mavenCentral()
        gradlePluginPortal()
    }
 }
 dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
      maven { url "https://jitpack.io" }
      maven { url = uri("https://repo.onestore.net/repository/onestore-sdk-public") }
    }
 }

2.2.3 更新 AndroidManifest.xml

在您的应用的 AndroidManifest.xml 中添加以下条目：

<queries>
    <intent>
        <action android:name="com.onestore.ipc.iap.IapService.ACTION" />
    </intent>
    <intent>
        <action android:name="android.intent.action.VIEW" />
    <data android:scheme="onestore" />
    </intent>
 </queries>

2.2.4 添加 ProGuard 规则

如果启用了 ProGuard/R8，请在 ProGuard 配置中添加以下规则：

# 核心 ProGuard 规则
 -keep class com.gaa.sdk.base.** { *; }
 -keep class com.gaa.sdk.auth.** { *; }

 # 购买相关 ProGuard 规则
 -keep class com.gaa.sdk.iap.** { *; }
 -keep class com.onestore.extern.licensing.** { *; }

重要信息

仅当 启用了 ProGuard/R8 时才应添加这些规则。

2.3 小米 GetApps

以下步骤是为小米 GetApps 创建应用构建所必需的。

2.3.1 添加依赖项

在模块/app 级别的 build.gradle 中添加以下依赖项：

implementation 'com.xiaomi.billingclient:billing:1.1.3'

2.3.2 已签名构建（空APK）

Xiaomi要求提供一个已签名的空APK以进行验证。以下步骤说明了该过程。

重要信息

已签名的空APK仅在首次提交时需要。
如果您的应用已发布在Google Play，建议使用相同的keystore进行签名。
Unity用户：Unity通过 Edit > Project Settings > Player > Publishing Settings 集成keystore签名。请在构建前确保已设置正确的keystore和别名。

1. 下载空APK

点击这里下载空APK。

2. 生成Keystore（如果尚未拥有）

以下示例命令展示了此过程：

keytool -genkey -v -keystore your-release-key.keystore -alias your-key-alias -keyalg RSA -keysize 2048 -validity 10000

重要信息

如果您的应用已发布在Google Play，建议使用相同的keystore进行签名。

3. 为APK签名

以下示例命令展示了此过程：

jarsigner -verbose -sigalg SHA256withRSA -digestalg SHA-256 -keystore your-release-key.keystore your-app.apk your-key-alias

参数	说明
`-digestalg SHA-256`	确保使用强加密哈希算法进行签名完整性验证。
`-keystore your-release-key.keystore`	使用之前生成的keystore进行签名。
`your-app.apk`	请替换为实际的APK文件名。
`your-key-alias`	应与生成keystore时使用的别名一致。

4. 共享已签名APK

请将已签名的空APK发送至dev-support@now.gg，邮件标题为‘Xiaomi – Signed Empty APK’。

2.4 华为 AppGallery (即将推出)

以下步骤是为华为 AppGallery 创建应用构建所必需的。

2.4.1 原生 Android

1. 添加依赖项

在模块/app 级别的 build.gradle 中添加以下依赖项：

implementation 'com.huawei.agconnect:agconnect-core:1.5.2.300'
 implementation 'com.huawei.agconnect:agcp:1.9.1.303'
 implementation 'com.huawei.hms:iap:6.13.0.300'

2. 更新根 build.gradle / settings.gradle

根据以下内容更新根 build.gradle 或 settings.gradle：

pluginManagement {
    repositories {
        google {
            content {
                includeGroupByRegex("com\\.android.*")
                includeGroupByRegex("com\\.google.*")
                includeGroupByRegex("androidx.*")
            }
        }
        maven {url 'https://developer.huawei.com/repo/'}
        mavenCentral()
        gradlePluginPortal()
    }
 }
 dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        maven {url 'https://developer.huawei.com/repo/'}
    }
 }

3. 更新 AndroidManifest.xml

在您的应用的 AndroidManifest.xml 中添加以下条目：

<Application>
 <meta-data
     android:name="com.huawei.hms.client.appid"
     android:value="<HUAWEI_APP_ID>">
 </meta-data
 </Application>

注意： 您可以通过联系我们 dev-support@now.gg 获取 HUAWEI_APP_ID。

4. 添加 ProGuard 规则

如果启用了 ProGuard/R8，请在 ProGuard 配置中添加以下规则：

-ignorewarnings
 -keepattributes *Annotation*
 -keepattributes Exceptions
 -keepattributes InnerClasses
 -keepattributes Signature
 -keepattributes SourceFile,LineNumberTable
 -keep class com.huawei.hianalytics.**{*;}
 -keep class com.huawei.updatesdk.**{*;}
 -keep class com.huawei.hms.**{*;}

重要信息

仅当 启用了 ProGuard/R8 时才应添加这些规则。

2.4.2 Unity

启用自定义启动器清单。

操作方法：

前往 项目设置 > Player > Build
启用自定义启动器清单 Assets/Plugins/Android/LauncherManifest.xml，如下所示：

更新 LauncherManifest.xml在您的应用的 LauncherManifest.xml 中添加以下条目：

<Application>
 <meta-data
     android:name="com.huawei.hms.client.appid"
     android:value="<HUAWEI_APP_ID>">
 </meta-data
 </Application>

注意： 您可以通过联系我们 dev-support@now.gg 获取 HUAWEI_APP_ID。

2.5 Samsung Galaxy 商店

以下步骤用于为 Samsung Galaxy 商店创建应用构建版本。

2.5.1 添加库文件

从你下载的 nowSDK 软件包中，按照以下步骤将 Samsung 商店特定的库文件添加到你项目的 libs 目录中：

注意：now.gg SDK 包含支付模块、演示应用和示例代码。

1. 解压压缩的 nowSDK 模块并进入 \Modules\Payments 目录，在其中找到 samsung_iap-release.aar 文件：

 samsung_iap-release.aar

2. 添加此提供的 .aar 文件到你项目的 libs 目录中：

3. 提交最终APK

准备好最终APK后，请将其上传到 nowStudio。

操作步骤：

创建一个产品发布。
我们的运营团队将会对您的应用提交进行审核，如若有需要任何修改或添加补充时，团队将会与您联系。
验证通过后，我们团队就会将您的应用构建上传到各个应用商店。
在您的应用审核通过后，您将收到电子邮件通知。您可以在nowStudio的发布（Release）标签下查看各商店特定的链接。

Start Integrating

Testing Integration

概述
开始集成
原生Android支付模块
Unity支付模块
- 快速集成
- 标准集成
设置多商店支付
- 1. 支持的商店
- 2. 商店特定设置
  - 2.1 Amazon 应用商店
  - 2.2 OnePlus OneStore
  - 2.3 小米 GetApps
  - 2.4 华为 AppGallery (即将推出)
  - 2.5 Samsung Galaxy 商店
- 3. 提交最终APK
测试集成
演示工程
注意事项
参考资料

文档版本 1.0

设置多商店支付

前提条件

1. 支持的商店

2. 商店特定设置

2.1 Amazon 应用商店

2.1.1 PEM 文件

2.1.2 更新 AndroidManifest.xml

2.2 OnePlus OneStore

2.2.1 添加依赖项

2.2.2 更新根 build.gradle / settings.gradle

2.2.3 更新 AndroidManifest.xml

2.2.4 添加 ProGuard 规则

重要信息

2.3 小米 GetApps

2.3.1 添加依赖项

2.3.2 已签名构建（空APK）

重要信息

1. 下载空APK

2. 生成Keystore（如果尚未拥有）

重要信息

3. 为APK签名

4. 共享已签名APK

2.4 华为 AppGallery (即将推出)

2.4.1 原生 Android

1. 添加依赖项

2. 更新根 build.gradle / settings.gradle

3. 更新 AndroidManifest.xml

4. 添加 ProGuard 规则

重要信息

2.4.2 Unity

2.5 Samsung Galaxy 商店

2.5.1 添加库文件

3. 提交最终APK

Table of Contents

Table of Contents