# 將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升级指南](/dev/cht/tools/billing/v21/sdk.md)修改變更事項。
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://onestore-dev.gitbook.io/dev/cht/tools/billing/v21/upgrade.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.