# 將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從屬性
* 在專案的最上層 `build.gradle` 檔案中新增 ONE store 付款（計費）程式庫的相依項目。
```gradle
dependencies {
implementation "com.onestorecorp.sdk:sdk-iap:21.04.00"
}
```
* 以下是在應用軟件的`build.gradle`文件中添加ONE store支付library從屬項目。
```gradle
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地址。
```gradle
allprojects {
repositories {
...
maven { url 'https://repo.onestore.net/repository/onestore-sdk-public' }
}
}
```
* 以下是在應用軟件的*build.gradle*文件中添加ONE store支付library從屬項目。
```gradle
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
```xml
```
* 添加maven從屬性 : 參考從v19升级至v21
### 添加Json file從屬性
v19以上開始，SDK的操作需要json文件。請參考[從v19升级至v21 > 變更json file > 添加maven從屬性](#id-jiang-onestoreinapp-zhi-fu-sheng-ji-zhi-v21-tian-jia-jsonfile-cong-shu-xing)在Project裡添加從屬性。
### 修改變更事項
請參考[ONE store In-App支付SDK升级指南](https://onestore-dev.gitbook.io/dev/cht/tools/billing/v21/sdk)修改變更事項。