マルチストア決済の設定

now.gg決済モジュールは、nowStudioを利用したマルチストア公開機能を活用する際に、マルチストア決済のサポートを提供します。

このドキュメントでは、マルチストア決済を有効にするための手順を説明します。

前提条件

マルチストア決済を有効にするには、以下の要件を満たす必要があります:

  • 決済統合 – 決済モジュールを統合したことを確認してください。
  • nowStudio設定
    • アプリを公開するストアを選択してください。 詳細はこちら.
      • マルチストア公開に必要な情報を提供してください。 このドキュメントをご参照ください。

1. 対応ストア

現在対応しているストアは以下の通りです:

  • now.gg提供
    • BlueStacksストア
    • Cloudストア
  • その他のストア
    • Amazon Appstore
    • OnePlus OneStore
    • Xiaomi GetApps
    • Huawei AppGallery (近日公開予定)
    • Samsung: Galaxy Store


2. ストア別セットアップ

決済モジュールを統合した後、最終的なAPKを提供する前に、以下のストア別の変更を最終ビルドに含めてください。

ストアの選択に応じて、以下の手順を参照してください。

2.1 Amazon Appstore

Amazon Appstore用のアプリビルドを作成するには、以下の手順を実行してください。

2.1.1 PEMファイル

Amazonでは、Amazon Appstoreとアプリ間の安全な通信チャネルを確立するために、アプリ固有の公開鍵を含むPEMファイルが必要です。

  • PEMファイルを取得するには、dev-support@now.ggまでご連絡ください。
  • 以下の手順に従ってPEMファイルを含めてください。
  • ネイティブAndroid:
    • Android Studioプロジェクトのapp/src/main/assetsディレクトリにPEMファイルを貼り付けます。
      注意:アプリに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 依存関係の追加

モジュール/アプリレベルの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 Xiaomi GetApps

Xiaomi GetApps用のアプリビルドを作成するには、以下の手順を実行してください。

2.3.1 依存関係の追加

モジュール/アプリレベルのbuild.gradleに以下の依存関係を追加してください:

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

2.3.2 署名済み空APK

Xiaomiでは、検証のために署名済みの空APKが必要です。

1. now.gg管理アプリの署名

now.ggの管理アプリの署名を選択した場合、このステップは不要です。now.ggがAPKに署名します。

2. 独自の証明書で署名

独自の証明書でAPKに署名する場合は、以下の手順に従ってください:

  • 空APKをダウンロードします。
  • 最終的な署名証明書を使用してAPKに署名します。
  • 署名済み空APKをdev-support@now.ggまで送付してください(件名:「Xiaomi – Signed Empty APK」)。

重要情報

  • 署名済み空APKは、初回提出時のみ必要です。

2.4 Huawei AppGallery (近日公開予定)

Huawei AppGallery用のアプリビルドを作成するには、以下の手順を実行してください。

2.4.1 ネイティブAndroid

1. 依存関係の追加

モジュール/アプリレベルの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>

注意: HUAWEI_APP_IDdev-support@now.gg までお問い合わせください。


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

カスタムランチャーマニフェストを有効にする。

実施方法:

  • Project Settings > 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>
    

注意: HUAWEI_APP_IDdev-support@now.gg までお問い合わせください。



2.5 Samsung Galaxy Store

Samsung Galaxy Store用のアプリビルドを作成するには、以下の手順を実行してください。

2.5.1 AndroidManifest.xmlの更新

アプリのAndroidManifest.xmlに以下のエントリを追加してください:

<uses-permission android:name="com.samsung.android.iap.permission.BILLING"/>
 <uses-permission android:name="android.permission.INTERNET"/>


3. 最終APKの提出

最終APKを準備した後、nowStudioにビルドをアップロードしてください。

方法:

  • プロダクションリリースを作成
  • 運用チームがアプリの提出内容を確認し、修正または要件について連絡します。
  • 検証後、チームがアプリビルドを各種ストアにアップロードします。
  • アプリが承認されると、メールで通知され、nowStudioのリリースタブでストア固有のリンクを参照できます。
×
テキストがクリップボードにコピーされました。
copyLinkText
ご不明な点がございましたら、お気軽にお問い合わせください。 dev-support@now.gg