将One store In-App支付升级至V21

从v19升级至v21

变更支付library

ONE store In-App Purchase(IAP) SDK从v21版本开始提供通过maven的发布。

如想要通过maven使用IAP library，请根据以下内容进行更改。

• 删除v19 AAR文件

  • 删除Project的libs文件夹中的iap_sdk-v19.XX.XX.aar文件。

• 添加maven从属性

  ONE Store IAP SDK 存储库将于 2026 年 4 月 1 日 起迁移至 Maven Central。

  详细信息请参考 Notice on Migration of ONE store IAP SDK Repository

  • 在项目的顶层 build.gradle 文件中添加 ONE store 计费库依赖项。

    allprojects {
        repositories {
            ...
            mavenCentral() 
        }
    }

  • 以下是在应用软件的build.gradle文件中添加ONE store支付library从属项目。

    
    dependencies {
    def onestore_iap_version = "21.04.00"
    implementation "com.onestorecorp.sdk:sdk-iap:$onestore_iap_version"
    }
    

变更Json file

ONE store从IAP SDK v19开始， 通过global-appstores.json提供SDK使用时必备 param。

从v21开始为了更方便地应用相应值，通过maven发布相应值。

为了变更相关内容，请按照以下内容进行。

• 删除global-appstores.json

  • 删除Project的assets文件夹中的global-appstores.json文件

• 添加maven从属性

  • 在project最上面build.gradle文件中注册ONE store的maven地址。

    
    allprojects {
    repositories {
    ...
        maven { url 'https://repo.onestore.net/repository/onestore-sdk-public' }
    }
    }
    

  • 以下是在应用软件的build.gradle文件中添加ONE store支付library从属项目。

    
    dependencies {
    def onestore_configuration_version = "1.0.0"
    implementation "com.onestorecorp.sdk:sdk-configuration-kr:$onestore_configuration_version"
    }
    

修改Deprecated项目

v21 SDK中的以下项目已被Deprecated。

使用上没有问题，但是为了以后的顺利使用需要变更。

• Interface

  name	description
  PurchasesListener	从v21开始，不使用PurchasesListener ，请使用 QueryPurchasesListener。

• Method

  class	method name	description
  PurchaseClient	manageRecurringProductAsync	从v21开始支持Subscription(订阅)商品，而不支持Auto(包月型)商品，通过定期支付菜单支持相应功能。 定期支付菜单不支持包月型商品，因此必须使用相应API提供使用解除的预约/取消。 订阅商品则需要体现为通过定期支付菜单向用户说明。
  	launchLoginFlowAsync	认证相关的flow被分离为单独的 class。 详情请参考InApp Auth运行指南

从v17升级至v21

变更支付library

从v17变更为v21时，library从jar变更为aar。

使用v17 library的开发公司，通过指南将v19升级至v21变更为maven后，需要对从jar形态转换为aar发布的部分进行追加操作(删除meta-data)。

• 删除v17 jar library

  • 删除Project的libs文件夹中的jar文件

• 删除AndroidManifest的以下meta-data

  
  <meta-data android:name="iap:api_version" android:value="5"/>
  

• 添加maven从属性 : 参考从v19升级至v21

添加Json file从属性

v19以上开始，SDK的操作需要json文件。请参考从v19升级至v21 > 变更json file > 添加maven从属性在Project里添加从属性。

修改变更事项

请参考ONE store In-App支付SDK升级指南修改变更事项。