您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發基礎

自動續訂 IAP 淺談:設置與測試全流程解析

編輯:iOS 開發基礎

本文由 CocoaChina 譯者 Leon(社區 ID)翻譯

作者:Jaz Garewal

原文:How to Set Up and Test an Auto-Renewable Subscription for an iOS App

轉載請保留原文內容和所有鏈接。


自動續訂的訂閱是 iOS 內購形式的一種,它能讓 App 在一段時間內持續提供內容或功能。我在之前的文章中聊過自動續訂這類 IAP 的準則,也談過 Apple 未來可能的改進。現在,讓我們來看看如何在 App 中實際設置並測試自動續訂的訂閱。

在 iTunes Connect 後台設置自動續訂的訂閱

事實上,實現自動續訂的訂閱流程與其他 IAP 並沒有太大不同。網上有許多關於其他類型 IAP 的教程,比如這一篇,主要講非續訂類 IAP(你可以直接跳到中段的「將訂閱添加到產品列表」)。設置自動續訂與非自動續訂的不同之處在於:自動續訂的每個訂閱週期都在同一個 IAP 實體中設置,而非自動續訂則需要為每個週期單獨創建一個產品(比如 3 個月、6 個月等),每個週期對應一個 product ID。

在 App 中實現自動續訂的內購項目

我們發現,使用 IAP helper 類來實現自動續訂式內購是最佳選擇,這與實現其他類型內購在策略上並無不同。不過,自動續訂式內購對收據(receipt)管理有額外要求,我們可以再創建特定的 helper 類來分別處理這部分邏輯。這樣一來,helper 類就能處理各種各樣的內購項目,而不局限於自動續訂式訂閱。在本教程中,為簡潔起見,我們把所有方法都放在同一個 IAP helper 類中;而在實際操作中,建議把收據管理的代碼放在單獨的類裡。考慮到收據交換過程會涉及私鑰,也可能需要把這部分邏輯放到 server 處理,稍後我們會具體講解。

對於 IAPHelper 類,我們需要 import StoreKit 框架,並聲明其遵循 SKProductsRequestDelegate 與 SKPaymentTransactionObserver 協議:

import UIKit import StoreKit class IAPHelper: NSObject, SKProductsRequestDelegate, SKPaymentTransactionObserver

然後聲明初始屬性(後面我們再添加其他屬性):

var productID:NSSet = NSSet(object: "string") var productsRequest:SKProductsRequest = SKProductsRequest() var products = String : SKProduct

在 App 中,IAPHelper 需要成為一個單例。在 Swift 1.2 中有個簡潔的做法,比 Objective-C 的 dispatch_once 更簡單:

static let sharedInstance = IAPHelper()

很簡單吧,Objective-C 的單例實現相當繁瑣,而用 Swift 寫,單例簡潔到超乎想象。

現在屬性都準備好了,來看看方法的實現。

首先,我們需要從 App Store 請求產品的標識,然後啟動產品請求。因此需要如下的 public 方法:

func requestProductsWithProductIdentifiers(productIdentifiers: NSSet) { let productIdentifiers:NSSet = NSSet(objects: "com.ourApp.monthly", "com.ourApp.annually") productsRequest = SKProductsRequest(productIdentifiers: productIdentifiers as Set) productsRequest.delegate = self; productsRequest.start() }

設置了 SKProductsRequest 的 delegate 後,還需要一個方法從 response 中提取信息,實現以下的 delegate 方法:

func productsRequest(request: SKProductsRequest!, didReceiveResponse response: SKProductsResponse!) {     if let productsFromResponse = response.products as? [SKProduct] {              for product in productsFromResponse {         products[product.productIdentifier] = product         }     }  }

現在準備工作已經做好了,需要透過 IAPHelper 的 sharedInstance 調用 requestProducts 方法。

首先,我們需要添加一個新屬性——一個閉包,透過它傳遞購買狀態,再根據狀態進行特別處理。閉包有一個 Bool 參數(true 表示成功,false 表示失敗),還有一個可選的 String 類型參數,用於在購買失敗時傳遞錯誤信息。

var purchaseCompleted: ((Bool, String ) -> Void)

購買產品的第一步,是透過一個方法獲取購買請求,比如點擊按鈕來啟動訂閱購買。

func beginPurchaseFor(productIDString: String, purchaseSucceeded:(Bool, String?) -> Void) {     if SKPaymentQueue.canMakePayments() {              if let product: SKProduct = products[productIDString] {                      purchaseCompleted = purchaseSucceeded             var payment = SKPayment(product: product)             SKPaymentQueue.defaultQueue().addTransactionObserver(self)             SKPaymentQueue.defaultQueue().addPayment(payment);         } else {             purchaseSucceeded(false, "Product \(productIDString) not found")         }      } else {         purchaseSucceeded(false, "User cannot make payments")     }  }

從方法簽名可以看到,第二個參數作為回調方法使用,它與我們的 purchaseCompleted 屬性一樣。

方法中,我們先驗證該設備是否可以進行 IAP 購買,如果可以,進一步驗證是否有一個 productID 與傳入的匹配。若驗證都通過,就設置 purchaseSucceeded 參數到 purchaseCompleted 屬性,這樣就能將狀態透過 purchaseCompleted 屬性回傳。接下來,我們創建一個 SKPayment 對象,並將 self(我們的 IAPHelper 實例)設置為交易觀察者(transaction observer),然後把 payment 添加到 default 的支付隊列(payment queue)中。

上述過程中,如果有一項檢查失敗(如設備不允許內購,或 product ID 不匹配),我們都可以透過 purchaseSucceeded 回調傳遞 false 狀態,並附上錯誤詳情(如「產品(代碼 xxx)不存在」或「使用者不允許進行內購買」)。透過這些,再判斷下一步的處理。

假定產品購買成功,得透過一個方法來監聽購買的響應事件。這裡需要實現 SKPaymentTransactionObserver 協議的 paymentQueue 方法。但這裡我把詳細說明分成兩部分,先看看成功購買的處理:

func paymentQueue(queue: SKPaymentQueue!, updatedTransactions transactions: [AnyObject]!) {     for transaction: AnyObject in transactions {              if let trans:SKPaymentTransaction = transaction as? SKPaymentTransaction {                      switch trans.transactionState {                 case .Purchased:                 SKPaymentQueue.defaultQueue().finishTransaction(trans)                 if let receiptURL = NSBundle.mainBundle().appStoreReceiptURL where                 NSFileManager.defaultManager().fileExistsAtPath(receiptURL.path!) {                     if let purchaseSuccessCallback = purchaseCompleted {                         purchaseSuccessCallback(true, nil)                     }                                     self.isPurchasing = false               self.receiptValidation()                 } else {                              if !isRefreshingReceipt {                                      self.isPurchasing = false                     isRefreshingReceipt = true                     let request = SKReceiptRefreshRequest(receiptProperties: nil)                     request.delegate = self                     request.start()                                      if let _ = purchaseCompleted {                                      purchaseCompleted**(true, nil)                 }             }         }             break

假定購買過程順利,我們高興地得到了「已購買」狀態,不用再去糾結標準 IAP 實現的細節。上面的代碼中可以看到,我們需要那個收據信息。交易成功後,App 可以透過 appStoreReceiptURL 得到使用者的本地收據位址;如果可以得到收據,我們就能繼續進行下一步 receiptValidation,這是設置、管理使用者訂閱的前提。在這個時間點,我們透過 purchaseSuccessCallBack 屬性回調的信息有:bool 類型的 true 值,表明購買已成功;nil 的 error message。這些好消息將被發送給 IAPHelper 的使用者,供其後期處理。

如果萬一購買成功,卻還是得不到收據信息,我們可以透過新建 SKReceiptRefreshRequest 的方式在後面「踢一腳」。

這裡先跳過 paymentQueue,看一下 SKReceiptRefreshRequest 的 requestDidFinish delegate 方法。

 if let appStoreReceiptURL = NSBundle.mainBundle().appStoreReceiptURL where     NSFileManager.defaultManager().fileExistsAtPath(appStoreReceiptURL.path!) {              if  NSFileManager.defaultManager().fileExistsAtPath(appStoreReceiptURL.path!) {             self.receiptValidation()                          if let purchaseSuccessCallback = purchaseCompleted {                   purchaseSuccessCallback(true, nil)                       }         }     } else {         if let purchaseSuccessCallback = purchaseCompleted {             purchaseSuccessCallback(false, "Cannot find receipt")         }     } }

當在 requestDidFinish 方法中獲得響應時,我們可以檢查 appStoreReceiptURL 位址上是否有相關文件存在。若存在,就通知那些正在等待回調的對象,告知它們購買已經成功,同時可以繼續進行收據的有效性驗證。

如果這時還是找不到收據,接著仍然得返回錯誤處理方法,傳遞 false 的 Bool 值,還有「無法找到收據」的錯誤信息——我們的 IAPHelper 在哭訴。有點像虛擬的收銀機被卡住了,無法打印。這樣,相關的對象就能處理這些 IAPHelper 收集的錯誤。

哦,這個話題太沉重了,來看點高興的。

接下來,看看如果我們的 paymentQueue 相關 delegate 方法收到「Failed」狀態,該如何處理。什麼?不是說高興的事麼?我感覺世界都變得陰暗起來了。

不管怎樣,讓我們繼續完成 func paymentQueue(queue: SKPaymentQueue!, updatedTransactions transactions: [AnyObject]!) 方法吧:

       case .Failed:                 self.isPurchasing = false                     if let _ = purchaseCompleted {                              var errorMessage: String?                                     if let _ = transaction.error {                                          errorMessage = transaction.error.localizedDescription                                     }                               purchaseCompleted(false, errorMessage)                           }                      SKPaymentQueue.defaultQueue().finishTransaction(trans)         SKPaymentQueue.defaultQueue().removeTransactionObserver(self)         break                 default:        break                    }        }     } }

這麼說方法失敗了?這不是 Apple 的 API 嗎?它運轉正常、順風順水,但還是失敗了。一定是打開方式不對……接下來退回去,看著鏡子,想想該對 Apple 大神做個什麼表情。手腕上的 Apple Watch 已經不見了,你知道是怎麼回事。

生氣歸生氣,還是得看看錯誤處理。收到錯誤後,先透過 localizedDescription 拿到本地化的錯誤信息,將 false 和這個錯誤信息都回調回去(滿滿的都是淚)。接下來告訴 SKPaymentQueue.defaultQueue(),支付戰役已經結束,我們輸了。

以上內容將貫穿整個自動續訂 IAP 的實現過程。下面我们來看看為何我們需要收據信息,並學習如何進行處理。

自動續訂 IAP 的訂閱管理

在深入研究代碼之前,讓我們先理解自動續訂 IAP 中訂閱管理的工作原理,看看它對 App 的意義何在。

Apple 並沒有在 iOS 系統中提供任何關於訂閱詳情的 API 或 REST 接口,也沒有提供查看訂閱更新或取消的回調方法。它只提供了一個 API:當你傳遞使用者本地的收據和一個「shared secret」(共享密鑰,在 iTunes Connect 後台創建)時,返回一個包含使用者購買歷史的 JSON 數據,裡面就包含了訂閱的詳細信息。

我們需要透過某種方式持續檢測訂閱,透過週期性地獲取這個 JSON 數據,解析並查看其中的過期時間是否改變,以此判斷訂閱是否更新或取消。如果過期時間已改變,則訂閱被更新;如果過期時間未改變且當前已超過過期時間,則可視為訂閱未被更新。這種情況下,可以假定訂閱已被取消(稍後可透過解析返回數據獲得取消日期——cancellation date 做進一步判定),也可以認為是從 Apple 返回的支付信息出現錯誤。無論哪種情況,都可以認為當前訂閱無效,對於這個使用者來說,App 中的訂閱內容不可用。

以上邏輯可以在本地處理,也可以自建服務器,或使用公開的後端服務(如 Parse)。

說得夠多了,上代碼!

錯了,現在還不到寫代碼的時候。首先需要在 iTunes Connect 後台創建 shared secret。先跳轉到 App 的 IAP 設置部分,在 IAP 列表下面你會看到「View or generate a shared secret」,點擊即可:

好了,現在可以看看收據處理的代碼了。第一個方法:

    if let receiptPath = NSBundle.mainBundle().appStoreReceiptURL?.path where     NSFileManager.defaultManager().fileExistsAtPath(receiptPath), let receiptData  = NSData(contentsOfURL:      NSBundle.mainBundle().appStoreReceiptURL!), let receiptDictionary = ["receipt- data" :      receiptData.base64EncodedStringWithOptions(nil), "password" : "your shared  secret"], let requestData =      NSJSONSerialization.dataWithJSONObject(receiptDictionary, options: nil,  error: error) as NSData! {         let storeURL = NSURL(string:  "https://sandbox.itunes.apple.com/verifyReceipt")!         var storeRequest = NSMutableURLRequest(URL: storeURL)         storeRequest.HTTPMethod = "POST"         storeRequest.HTTPBody = requestData                  let session = NSURLSession(configuration:  NSURLSessionConfiguration.defaultSessionConfiguration())         session.dataTaskWithRequest(storeRequest, completionHandler: { (data:  NSData!, response: NSURLResponse!,           connection: NSError!) → Void in                     if let jsonResponse: NSDictionary =  NSJSONSerialization.JSONObjectWithData(data, options:            NSJSONReadingOptions.MutableContainers, error: &error) as?  NSDictionary, let expirationDate: NSDate =              self.expirationDateFromResponse(jsonResponse) {                                      self.updateIAPExpirationDate(expirationDate)                                 }        })     } }

方法中聲明了 optional 類型的 NSError 變量。接下來是溫習 Swift 1.2 中 optional 類型 chaining 能力的好機會。按鏈式結構,先判斷是否存在 appStoreReceiptURL(購買完成時我們已驗證過這個屬性,但在 Swift 中多一層檢查就多一重保障),接著檢查這個 path 下是否有文件存在,如果存在就透過該文件創建 receiptData 對象,然後填上 shared secret,就創建了一個 receiptDictionary JSON 數據。

上述過程完成後,就可以用 requestData 創建 NSMutableRequest。在本例中,我們透過沙箱 URL 來驗證收據,在實際環境中你需要把「sandbox」換成「buy」。

我們將 requestData 數據發送給 Apple,等待它對 completionHandler 的回調。回調收到後,繼續透過 optional chain 方式檢查返回數據:如果第一部分(這裡是 data 轉到 JSON)存在的話,就用 expirationDateFromResponse 方法在裡面找到 expiration date 數據。

進展順利的話,我們就可以在適當時機處理該過期時間——檢查它與我們之前存儲的是否一致(如果一致,表明訂閱已更新);若過期時間等於或早於當前日期,則意味著訂閱未更新,很可能已被取消,可透過 JSON 數據中的 Cancellation Date 進一步檢查。

現在我們來創建 expirationDateFromResponse,從 JSON 返回數據中解析過期時間:

func expirationDateFromResponse(jsonResponse: NSDictionary) → NSDate? {     if let receiptInfo: NSArray = jsonResponse["latest_receipt_info"] as? NSArray {             let lastReceipt = receiptInfo.lastObject as! NSDictionary        var formatter = NSDateFormatter()        formatter.dateFormat = "yyyy-MM-dd HH:mm:ss VV"                let expirationDate: NSDate =  formatter.dateFromString(lastReceipt["expires_date"] as! String) as NSDate!        return expirationDate     } else {        return nil     } }

這個方法中,先看看「latest receipt info」這個 key 是否對應 NSArray 類型的數據。如果有的話,我們從數組中獲取最後一個對象,再從這個對象中查找 key「expires_date」對應的對象,將其轉換成 NSDate 類型。上述過程無誤的話,就可以返回 expirationDate 對象;過程中出錯的話,就直接返回 nil。

接下來,我們來學習如何測試自動續訂訂閱 IAP。

測試自動續訂類 IAP

完成收據驗證代碼只是第一步,問題是如何驗證我們的驗證代碼?答案是:測試。你的代碼依賴於外部模塊(IAP 服務器),而你無法控制,只能透過一些工具來進行測試。

之前提到過,有兩個 URL 可以用來驗證收據,一個針對測試環境,另一個針對實際環境。沙箱模式下購買自動續訂訂閱類 IAP 與測試其他類型 IAP 的過程類似,只需在 iTunes Connect 後台創建沙箱測試帳戶(Users and Roles 功能下),可以創建多個測試帳戶以備測試之需,然後就可以用沙箱帳戶在設備上完成內購。

測試自動續訂類 IAP 時有一個不同之處:該購買是有週期的,訂閱會於 5 次更新後作廢。看到這裡你可能會想:「等等,要是我設置了每月訂閱,要測試過期得等到 5 個月後?」實際上,自動續訂的 IAP 在沙箱環境下週期是會加速的,更新按分鐘或小時計算。如果你要測試一月的訂閱,更新週期是 5 分鐘。因此要測試過期(5 次更新後),等待 25 分鐘即可。

另外需要注意的一點是:在測試環境下,訂閱並不是每次都會自動更新。據我估算,大約有三分之一的概率,月度訂閱會在 5 分鐘後被標記一次,然後直接過期,並不會被自動更新。記得我提醒過你多創建幾個測試帳戶嗎?就是為了方便測試訂閱更新時使用。要是你需要測試過期處理的代碼,就一直用過期的那個帳戶,這樣就能把等待時間減少到原來的五分之一。

也就是說,在測試一周自動續訂訂閱時,每次都等 15 分鐘並不明智。另外,如何測試訂閱取消?壞消息是,你無法測試。當前測試環境的訂閱無法手動取消。因此最好的方式是:創建多個沙箱測試帳號,用一個先測試,再用其他測試;等第一個快過期時,切換過去測試。

結論備註

學到這裡,你不僅知道了如何實現自動續訂類 IAP,還知道了如何進行測試。本教程有一點沒講到:如何將收據驗證碼與 IAP 的 shared secret key 保存到服務器,這是我們後面需要研究的。現在,希望現有知識能幫助你順利實現訂閱功能。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved