IAP 實現

概況
IAP能正常工作的祕訣:分成兩個步驟:

創建及提取產品描述
購買產品
第一個步驟是你可能遇到問題的部分。一旦你在代碼中成功地獲取了產品描述,編寫購買產品的代碼不過是小菜一碟。

我們先看看步驟1。

創建及提取產品描述
下面是有關創建產品及提取其描述的非常粗略的步驟:

創建唯一的App ID
生成及安裝新的provisioning profile文件
在Xcode中更新 bundle ID 及 code signing profile
如果還沒做的話,請在iTunes Connect中提交有關你程序的 metadata
如果還沒做的話,請在iTunes Connect中提交你程序的二進制碼
爲IAP添加新產品
編寫提取產品描述的代碼
等待幾小時
提取產品描述的代碼非常簡單,但其他步驟則很容易錯。

注意: 爲提取產品描述,你並不需要在iTunes Connect中創建IAP測試用戶。

 

1. 創建唯一的App ID
爲支持IAP,你的App ID不能包括通配符(“*”)。爲確定你的App Id是否包括通配符,請登錄http://developer.apple.com/iphone,在 iPhone Developer Program Portal中選擇左邊菜單中的 “App IDs”檢查你的 App ID。

下面是一個唯一的App ID:

7DW89RZKLY.com.runmonster.runmonsterfree

下面不是一個唯一的 App ID:

7DW89RZKLY.com.runmonster.*

如果你還沒有一個唯一的App ID,按如下步驟創建一個:

在developer portal中的 App IDs 部分,選擇“New App ID”
填寫下列信息:
Display name(顯示名): 選取一個不同的App ID的名稱。你不能編輯或刪除舊的App ID,所以你必須爲你的App ID提供一個新名稱以避免溷淆。
Prefix(前綴): 生成一個新的前綴,或者如果你的程序是通過Keychain Services API分享數據的系列程序中之一的話,則選用已存在的前綴。
Suffix(後綴): com.companyname.appname (這是通用格式 – 注意沒有使用通配符)。
按 “Save”
按 App ID旁的“Configure” 鏈接
選取 “Enable In App Purchase”選擇框
按“Done”
2. 創建一個新的Provisioning Profile文件
在創建了新的App ID後,你需要生成一個指向這個App ID的新provisioning profile。

下面就是令人痛苦的生成和安裝新provisioning profile的詳細步驟:

在 iPhone Developer Portal中, 選擇左邊的Provisioning部分
確保你處於Development 標籤下, 按下右上角的 “New Profile”
填入所需信息並指向你剛創建的唯一的App ID
如果你在Actions條目下看到 “Pending”,那麼請按下“Development”標籤標題進行刷新
點擊 “Download” 下載新的profile文件
將profile文件拖入到Dock中Xcode圖標上進行安裝
如果你想在硬盤上保存provisioning profile,那麼你可以按如下步驟手工安裝profile:
在Xcode中, 選擇 Window > Organizer
選擇左邊 “Provisioning Profiles” 分類
Ctrl-按下profile > Reveal in Finder
將新profile拖入到 profile Finder 窗口
3. 更新Xcode 設置
在Xcode中安裝了 profile 文件後,你需要對使用此provisiong profile的項目進行一些編輯工作:

編輯項目 .plist 文件使其 Bundle ID 與 App ID 匹配。忽略ID開始部分的字母數字序列。例如,在Developer Portal中你的App ID爲“7DW89RZKLY.com.runmonster.runmonsterfree”,那麼在Bundle ID中你只需輸入“com.runmonster.runmonsterfree” 。
編輯項目的 target 信息以使用新的provisioning profile:
選取 Project > Edit Active Target
選取頂部“Build” 標籤
選取需要的 configuration (通常爲 Debug)
在Code Signing Identity中選擇新的provisioning profile
在Code Signing Identity之下的行中(可能名爲 Any iPhone OS Device)選擇新的provisioning profile
4. 添加你的應用程序
如果你的程序已經發表到App Store了,那麼可以略過此步驟。

在你將產品添加到 iTunes Connect之前,你必須添加此產品所需的程序。如果你的程序還沒有100%完成也無需擔心,你可以先提交具有部分數據的程序,最後再提交真實的程序。

注意: 只有 SKU 和 version(版本)部分是以後不可修改的

登錄到 http://developer.apple.com/iphone
點擊右邊鏈接進入 iTunes Connect
注意:你必須先登錄到developer.apple.com,否則會有不測發生(譯者注:具體是什麼不測我也不太清楚,膽大的請自己試一下)
在 iTunes Connect主頁點擊 “Manage Your Applications”
在右上角點擊“Create New Application”
填寫程序所需的一切信息。當要求程序二進制碼時,請選擇稍後上傳選項。
5. 提交程序二進制碼
Apple的文檔中沒有任何地方提及詳情,但它卻是必須的步驟。要成功測IAP功能,你必須提交程序的二進制碼。即使你的程序還沒有100%完成,你仍然需要提交二進制碼。然而,你也可以立即擯棄你的二進制碼,使其不會進入審覈階段。

下面這些步驟非常關鍵,我可是因爲少做了某些步驟而度過了一段非常痛苦的時間:

生成App Store發佈版程序
如果你不知怎麼做,請在 iPhone Developer Portal 中點擊左方的 Distribution標籤,並選擇 “Prepare App” 標籤。然後,根據藍色鏈接的指示:
獲取iPhone發行許可證
創建並下載在App Store發行所需的iPhone Distribution Provisioning Profile
在Xcode中生成程序的發行版
在iTunes Connect中進入程序頁
選擇 “Upload Binary”
上傳.zip壓縮程序
如果你的程序還沒有100%完成以進行審覈,那麼請點擊iTunes Connect中你程序首頁中的 “Reject Binary”鏈接。程序的狀態應該更新爲 “Developer Rejected”.
不用擔心,由於程序的狀態是“Developer Rejected”,Apple是不會對其進行審覈的。你可以在任何時候提交程序的新版本並使其狀態爲“Developer Rejected”,這不會對以後程序正式提交的等待時間有任何影響。

6. 添加產品
完成了以上所有步驟後,我們最終可以向iTunes Connect中添加產品了。

確保登錄到 http://developer.apple.com/iphone
進入 iTunes Connect 主頁
點擊 “Manage Your in App Purchases” 鏈接
點擊 “Create New”
選擇你的程序
填寫下列產品信息:
Reference Name(參考名稱): 產品的通用名稱。比如,我使用的是 “Pro Upgrade”。此名稱是不允許進行編輯的,它不會顯示於App Store中。
Product ID(產品ID): 你產品的唯一id。通常格式是 com.company.appname.product,但它可以說任何形式。它並不要求以程序的App ID作爲前綴。
Type(類型): 有三種選擇
Non-consumable(非消耗品): 僅需付費一次 (例如你希望將出現從免費版升級爲專業版)
Consumable(消耗品): 每次下載都需要付費
Subscription(預訂): 循環反覆
Price Tier(價格等級): 產品價格。參見不同等級的價格列表。
Cleared for Sale(等待銷售): 一定要選取此項,否則的話,測試時會發生非法產品ID的錯誤。
Language to Add(增加的語言): 選一項。下列兩項將出現:
Displayed Name(顯示名稱): 用戶看到的產品名稱。比如我選擇 “Upgrade to Pro”。
Description(描述): 對產品進行描述。此處輸入的文本將與Displayed Name 及 Price 一起在你代碼中提取 SKProduct時出現。
Screenshot(截屏): 展示你產品的截屏。儘管屏幕上會顯示“提交截屏會觸發產品審覈過程”之類的文字(個人拙見,這是非常糟糕的設計),你還是可以安全地提交截屏而不會使產品 進入審覈過程。存儲後,選擇“Submit with app binary” (隨程序二進制碼一起提交)選項。是產品與程序二進制綁定在一起,所以在你最後正式提交100%完成的程序二進制碼時,產品也會隨之提交。
點擊 “Save”
7. 編寫代碼
下面我們開始編寫代碼對剛加入到iTunes Connect中的產品信息進行提取。我訪問產品數據,我們需要使用 StoreKit framework。

注意: StoreKit 無法在模擬器上工作。你必須在真機上進行測試。

1.添加 StoreKit framework 到你的項目中。
2.添加SKProduct引用到你的 .h 文件中:
複製代碼
// InAppPurchaseManager.h
#import <StoreKit/StoreKit.h>
#define kInAppPurchaseManagerProductsFetchedNotification @"kInAppPurchaseManagerProductsFetchedNotification"
@interface InAppPurchaseManager : NSObject <SKProductsRequestDelegate>
{
SKProduct *proUpgradeProduct;
SKProductsRequest *productsRequest;
}

注意: InAppPurchaseManager 是一個單例類,它處理程序中所有IAP任務。它是本文中的示例程序。

3.產品請求,並在相應.m文件中實現代理協議:
複製代碼
// InAppPurchaseManager.m
- (void)requestProUpgradeProductData
{
NSSet *productIdentifiers = [NSSet setWithObject:@"com.runmonster.runmonsterfree.upgradetopro" ];
productsRequest = [[SKProductsRequest alloc] initWithProductIdentifiers:productIdentifiers];
productsRequest.delegate = self;
[productsRequest start];

// we will release the request object in the delegate callback
}
#pragma mark -
#pragma mark SKProductsRequestDelegate methods
- (void)productsRequest:(SKProductsRequest *)request didReceiveResponse:(SKProductsResponse *)response
{
NSArray *products = response.products;
proUpgradeProduct = [products count] == 1 ? [[products firstObject] retain] : nil;
if (proUpgradeProduct)
{
NSLog(@"Product title: %@" , proUpgradeProduct.localizedTitle);
NSLog(@"Product description: %@" , proUpgradeProduct.localizedDescription);
NSLog(@"Product price: %@" , proUpgradeProduct.price);
NSLog(@"Product id: %@" , proUpgradeProduct.productIdentifier);
}

for (NSString *invalidProductId in response.invalidProductIdentifiers)
{
NSLog(@"Invalid product id: %@" , invalidProductId);
}

// finally release the reqest we alloc/init’ed in requestProUpgradeProductData
[productsRequest release];

[[NSNotificationCenter defaultCenter] postNotificationName:kInAppPurchaseManagerProductsFetchedNotification object:self userInfo:nil];
}

上面代碼有幾點需要注意:

指定產品id時,你必須使用完整產品id。例如,上例中使用 “com.runmonster.runmonsterfree.upgradetopro”。僅使用 “upgradetopro” 將不會正常工作。
如果在productsRequest:didReceiveResponse:中response.products 爲 nil,而你的產品id出現於 response.invalidProductIdentifers 數組中時,那麼請做好心理準備開始一場徒勞的搜索戰吧。 StoreKit API沒有提供任何幫助,也沒有任何指示關於爲什麼你的id是無效的。很可愛,不是嗎?
SKProduct類提供了有關程序標題和描述的本地化版本,但是價格則沒有本地化版本。下面是針對此疏忽提供的代碼:
複製代碼
// SKProduct+LocalizedPrice.h
#import <Foundation/Foundation.h>
#import <StoreKit/StoreKit.h>
@interface SKProduct (LocalizedPrice)
@property (nonatomic, readonly) NSString *localizedPrice;
@end

複製代碼
// SKProduct+LocalizedPrice.m
#import "SKProduct+LocalizedPrice.h"
@implementation SKProduct (LocalizedPrice)
- (NSString *)localizedPrice
{
NSNumberFormatter *numberFormatter = [[NSNumberFormatter alloc] init];
[numberFormatter setFormatterBehavior:NSNumberFormatterBehavior10_4];
[numberFormatter setNumberStyle:NSNumberFormatterCurrencyStyle];
[numberFormatter setLocale:self.priceLocale];
NSString *formattedString = [numberFormatter stringFromNumber:self.price];
[numberFormatter release];
return formattedString;
}
@end

加入上述代碼,測試一下。你應該在控制檯窗口中看見產品信息了。然而更大的可能是,你得到了一個無效的產品id。我下一篇文章將介紹怎樣對這個問題進行調試。但是,下面的步驟8有可能是阻礙你前進的障礙。

8. 等待幾小時
遵循了上述所有步驟,但是你的產品仍然是無效的?你是否兩次,三次,四次不懈努力地確認你是否遵循了上面提到的每個步驟?你是否已經對網上IAP信息少得可憐而感到絕望?

那麼,你應該等待。

你的產品要進入iTunes Connect使得Apple準備好沙箱環境需要一些時間。對於我而言,我是經過了無數次產品無效錯誤的絕望。而在24小時後,我沒有修改任何一行代碼, 但產品id變爲有效。我認爲要使產品發佈到Apple的網絡系統需要幾個小時的時間,但如果你有時間的話,你可以像我一樣等上24個小時。

購買產品
至此你應該已經成功地獲取了 SKProduct 描述。比較而言,支持購買產品相對簡單些。僅需下面三個步驟:

編寫代碼支持事務(transaction)
在iTunes Connect中添加程序測試用戶
在設備中登錄你的 iTunes Store 帳號
購買測試
我們從編寫支持事務所需代碼開始。

1. 編寫代碼支持事務
首先注意:你將負責開發產品購買的用戶界面。StoreKit 未提供任何與用戶界面相關的元素。如果你希望你的購買用戶界面與App Store一樣,那麼你要自己完成。

下面所有代碼都是有關事務處理的後臺部分。這是一個單獨的類只有一條簡單的API以供外部類(比如view controller)調用進行購買。如果你找到將其集成到你程序的購買部分的方法,那麼我推薦你使用類似方桉。

首先,需要遵循 SKPaymentTransactionObserver 協議:
複製代碼
// InAppPurchaseManager.h
// add a couple notifications sent out when the transaction completes
#define kInAppPurchaseManagerTransactionFailedNotification @"kInAppPurchaseManagerTransactionFailedNotification"
#define kInAppPurchaseManagerTransactionSucceededNotification @"kInAppPurchaseManagerTransactionSucceededNotification"

@interface InAppPurchaseManager : NSObject <SKProductsRequestDelegate, SKPaymentTransactionObserver>
{

}
// public methods
- (void)loadStore;
- (BOOL)canMakePurchases;
- (void)purchaseProUpgrade;
@end

上面我們定義了兩個新的notification,它們將作爲購買事務的結果被髮送。在上例中我們仍然使用與獲取產品描述同一個InAppPurchaseManager類。
複製代碼
// InAppPurchaseManager.m
#define kInAppPurchaseProUpgradeProductId @"com.runmonster.runmonsterfree.upgradetopro"

#pragma -
#pragma Public methods
//
// call this method once on startup
//
- (void)loadStore
{
// restarts any purchases if they were interrupted last time the app was open
[[SKPaymentQueue defaultQueue] addTransactionObserver:self];

// get the product description (defined in early sections)
[self requestProUpgradeProductData];
}
//
// call this before making a purchase
//
- (BOOL)canMakePurchases
{
return [SKPaymentQueue canMakePayments];
}
//
// kick off the upgrade transaction
//
- (void)purchaseProUpgrade
{
SKPayment *payment = [SKPayment paymentWithProductIdentifier:kInAppPurchaseProUpgradeProductId];
[[SKPaymentQueue defaultQueue] addPayment:payment];
}
#pragma -
#pragma Purchase helpers
//
// saves a record of the transaction by storing the receipt to disk
//
- (void)recordTransaction:(SKPaymentTransaction *)transaction
{
if ([transaction.payment.productIdentifier isEqualToString:kInAppPurchaseProUpgradeProductId])
{
// save the transaction receipt to disk
[[NSUserDefaults standardUserDefaults] setValue:transaction.transactionReceipt forKey:@"proUpgradeTransactionReceipt" ];
[[NSUserDefaults standardUserDefaults] synchronize];
}
}
//
// enable pro features
//
- (void)provideContent:(NSString *)productId
{
if ([productId isEqualToString:kInAppPurchaseProUpgradeProductId])
{
// enable the pro features
[[NSUserDefaults standardUserDefaults] setBool:YES forKey:@"isProUpgradePurchased" ];
[[NSUserDefaults standardUserDefaults] synchronize];
}
}
//
// removes the transaction from the queue and posts a notification with the transaction result
//
- (void)finishTransaction:(SKPaymentTransaction *)transaction wasSuccessful:(BOOL)wasSuccessful
{
// remove the transaction from the payment queue.
[[SKPaymentQueue defaultQueue] finishTransaction:transaction];

NSDictionary *userInfo = [NSDictionary dictionaryWithObjectsAndKeys:transaction, @"transaction" , nil];
if (wasSuccessful)
{
// send out a notification that we’ve finished the transaction
[[NSNotificationCenter defaultCenter] postNotificationName:kInAppPurchaseManagerTransactionSucceededNotification object:self userInfo:userInfo];
}
else
{
// send out a notification for the failed transaction
[[NSNotificationCenter defaultCenter] postNotificationName:kInAppPurchaseManagerTransactionFailedNotification object:self userInfo:userInfo];
}
}
//
// called when the transaction was successful
//
- (void)completeTransaction:(SKPaymentTransaction *)transaction
{
[self recordTransaction:transaction];
[self provideContent:transaction.payment.productIdentifier];
[self finishTransaction:transaction wasSuccessful:YES];
}
//
// called when a transaction has been restored and and successfully completed
//
- (void)restoreTransaction:(SKPaymentTransaction *)transaction
{
[self recordTransaction:transaction.originalTransaction];
[self provideContent:transaction.originalTransaction.payment.productIdentifier];
[self finishTransaction:transaction wasSuccessful:YES];
}
//
// called when a transaction has failed
//
- (void)failedTransaction:(SKPaymentTransaction *)transaction
{
if (transaction.error.code != SKErrorPaymentCancelled)
{
// error!
[self finishTransaction:transaction wasSuccessful:NO];
}
else
{
// this is fine, the user just cancelled, so don’t notify
[[SKPaymentQueue defaultQueue] finishTransaction:transaction];
}
}
#pragma mark -
#pragma mark SKPaymentTransactionObserver methods
//
// called when the transaction status is updated
//
- (void)paymentQueue:(SKPaymentQueue *)queue updatedTransactions:(NSArray *)transactions
{
for (SKPaymentTransaction *transaction in transactions)
{
switch (transaction.transactionState)
{
case SKPaymentTransactionStatePurchased:
[self completeTransaction:transaction];
break;
case SKPaymentTransactionStateFailed:
[self failedTransaction:transaction];
break;
case SKPaymentTransactionStateRestored:
[self restoreTransaction:transaction];
break;
default:
break;
}
}
}

要測試上面的新代碼,你還需要編寫調用 loadStore, canMakePurchases 以及 purchaseProUpgrade 方法的代碼。

有關上述代碼的詳細解釋,請參考官方 In App Purchase Programming Guide (IAP編程指南)

上述代碼有幾個部分是針對我的程序的。例如,在 provideContent:中,NSUserDefaults 中的@”isProUpgradePurchased” BOOL 字段被設定爲 YES。程序的其他部分將檢查此BOOL值以確定是否需要啓動專業版功能。如果你正好也要實現免費升級專業版的功能,那麼你可以使用同樣的方法。

2. 添加測試用戶
爲測試上述代碼,你需要在 iTunes Connect 中創建測試用戶以對IAP功能進行測試。你可以使用測試帳號購買產品而不被Apple收取費用。

按以下步驟創建測試用戶:

登錄到 http://developer.apple.com/iphone
進入 iTunes Connect
選擇iTunes Connect首頁中的 “Manage Users”
選擇 “In App Purchase Test User”
選擇 “Add New User”
填入用戶信息. 所有信息都不必是合法的。建議使用虛假簡短的email地址及簡短的密碼。
選擇 “Save”
測試時你需要輸入這些email地址和密碼。

3. 在你的設備中退出登錄
在進行程序購買功能測試前,你必須在你的設備中退出iTunes Store。遵循以下步驟:

打開Settings App
點擊 “Store” 行
點擊 “Sign Out”
4. 購買測試
現在,終於可以開始進行IAP功能的測試了。測試很簡單:

運行你設備中的程序
進行購買
當程序提示輸入用戶名和密碼時,輸入參數用戶的信息
如果你使用同一賬戶進行購買時,系統將提示你已經購買了此產品。按“Yes”就可以再次下載此產品。

總結
實現IAP功能比想象的要複雜許多。我可是經過無數痛苦的經歷才完成我的程序。希望能夠幫助其他開發者減輕他們的痛苦。應用程序內購買

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章