결제 >

멀티 스토어 결제 설정

now.gg 결제 모듈은 nowStudio를 사용하여 멀티 스토어 퍼블리싱 기능을 활용할 때 멀티 스토어 결제를 지원할 수 있습니다.

이 문서는 멀티 스토어 결제를 활성화하는 데 필요한 단계를 설명합니다.

사전 조건

멀티 스토어 결제를 활성화하려면 다음 요구 사항을 충족해야 합니다:

결제 통합 – 결제 모듈을 통합했는지 확인하세요.
- 네이티브 안드로이드
- Unity
nowStudio 설정
- 앱을 퍼블리싱할 스토어를 선택하세요. 자세히 보기.
  - 멀티 스토어 퍼블리싱에 필요한 정보를 제공하세요. 이 문서를 참조하세요.

1. 지원 스토어

현재 지원되는 스토어는 다음과 같습니다:

now.gg 제공
- 클라우드 스토어
- BlueStacks 스토어
대안 스토어
- 삼성 갤럭시 스토어
- 샤오미 GetApps
- OnePlus OneStore
- 아마존 앱스토어
- 화웨이 AppGallery (곧 제공 예정)

2. 스토어별 설정

결제 모듈을 통합한 후, 최종 APK를 제공하기 전에 다음 스토어별 변경 사항을 최종 빌드에 포함했는지 확인하세요.

스토어 선택에 따라 다음 단계를 참조하세요:

2.1 아마존 앱스토어

아마존 앱스토어용 앱 빌드를 생성하려면 다음 단계를 수행해야 합니다.

2.1.1 PEM 파일

아마존은 PEM 파일을 요구하며, 이는 아마존 앱스토어와 앱 간의 안전한 통신 채널을 설정하는 고유한 앱 전용 공개 키를 포함합니다.

PEM 파일을 받으려면 dev-support@now.us로 문의하세요.
다음 지침에 따라 PEM 파일을 포함하세요:
네이티브 안드로이드:
- 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 원플러스 원스토어

원플러스 원스토어용 앱 빌드를 생성하려면 다음 단계를 수행해야 합니다.

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 구성에 추가하세요:

# Core 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 종속 항목 추가

다음 종속 항목을 모듈/앱 수준의 build.gradle에 추가하세요:

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

2.3.2 서명된 빌드 (빈 APK)

Xiaomi는 검증을 위해 서명된 빈 APK를 요구합니다. 아래 단계는 해당 과정을 설명합니다.

중요 정보

서명된 빈 APK는 초기 제출 시에만 필요합니다.
앱이 Google Play에 게시되어 있다면, 동일한 키스토어를 사용하는 것이 권장됩니다.
Unity 사용자: Unity에서는 Edit > Project Settings > Player > Publishing Settings 경로를 통해 키스토어 서명을 통합합니다. 빌드 전에 올바른 키스토어 및 별칭이 설정되어 있는지 확인하세요.

1. 빈 APK 다운로드

여기를 클릭하여 빈 APK를 다운로드하세요.

2. 키스토어 생성 (이미 없다면)

다음 샘플 명령어는 이 과정을 보여줍니다:

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

중요 정보

앱이 Google Play에 게시되어 있다면, 동일한 키스토어를 사용하는 것이 권장됩니다.

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`	이전에 생성한 키스토어를 사용합니다.
`your-app.apk`	실제 APK 파일명으로 교체하세요.
`your-key-alias`	키스토어 생성 시 사용한 별칭과 일치해야 합니다.

4. 서명된 APK 공유

서명된 빈 APK를 dev-support@now.us로 ‘Xiaomi – Signed Empty APK’ 제목과 함께 공유하세요.

2.4 화웨이 AppGallery (출시 예정)

화웨이 AppGallery용 앱 빌드를 생성하려면 다음 단계를 수행해야 합니다.

2.4.1 네이티브 안드로이드

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_ID는 dev-support@now.us로 문의하면 받을 수 있습니다.

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_ID는 dev-support@now.us로 문의하면 받을 수 있습니다.

2.5 삼성 갤럭시 스토어

삼성 갤럭시 스토어용 앱 빌드를 생성하려면 다음 단계를 수행해야 합니다.

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의 릴리스 탭에서 스토어별 링크를 참조할 수 있습니다.

결제 모듈 적용

적용 테스트

멀티 스토어 결제 설정

사전 조건

1. 지원 스토어

2. 스토어별 설정

2.1 아마존 앱스토어

2.1.1 PEM 파일

2.1.2 AndroidManifest.xml 업데이트

2.2 원플러스 원스토어

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. 키스토어 생성 (이미 없다면)

중요 정보

3. APK 서명

4. 서명된 APK 공유

2.4 화웨이 AppGallery (출시 예정)

2.4.1 네이티브 안드로이드

1. 종속 항목 추가

2. 루트 build.gradle / settings.gradle 업데이트

3. AndroidManifest.xml 업데이트

4. ProGuard 규칙 추가

중요

2.4.2 Unity

2.5 삼성 갤럭시 스토어

2.5.1 AndroidManifest.xml 업데이트

3. 최종 APK 제출

Table of Contents

Table of Contents