iOS应用内置付费:In-App Purchases完全攻略(1)

  参考:iOS应用内置付费In-App Purchase 个人使用总结

  新:In-App Purchases入门    demo下载:

  第一印象觉得In-App Purchase(简称IAP)非常简单。Apple提供的大量文档应该让开发者很快熟悉地熟悉。那麽,为什麽在你的应用中集成IAP特性就如此令人生厌呢?

  这是因为在开发过程中不可避免会出现一些错误。而但这些错误发生的时候,你就抓瞎了。虽然Apple提供了有关IAP的大量文档,但他们并未提及集成IAP 的详细步骤。而且对StoreKit集成过程中出现的问题也没有一个核对清单。另外对于为什麽诸如产品ID非法之类的问题也没有提供NSError之类的 对象来告诉你原因。

  在试用了各种可能的解决方桉后,你只能身心疲惫,彷徨无助。

  为了提高你的效率和减少你的痛苦,我觉定利用此文来介绍一下实现IAP的详细步骤。本文很详细,有点长。甚至可能太长了,但不像Apple的文档,它提供了为实现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是否包括通配符,请登录,在 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(版本)部分是以后不可修改的

  登录到

  点击右边链接进入 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中添加产品了。

  确保登录到

  进入 iTunes Connect 主页

  点击“Manage Your Applications”

  点击刚建好的程序 点击view details

  点击 “Manage 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”

  最后一定不要忘了回到view details  编辑In-App Purchases

  选择刚刚添加的iap版本

  别走开,下页内容更精彩

  7. 编写代码

  下面我们开始编写代码对刚加入到iTunes Connect中的产品信息进行提取。我访问产品数据,我们需要使用 StoreKit framework。

  注意: StoreKit 无法在模拟器上工作。你必须在真机上进行测试。

  1)添加 StoreKit framework 到你的项目中。

  2)添加SKProduct引用到你的 .h 文件中:

  // InAppPurchaseManager.h
  #import 
  #define kInAppPurchaseManagerProductsFetchedNotification @"kInAppPurchaseManagerProductsFetchedNotification"
  @interface InAppPurchaseManager : NSObject  
  { 
      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 
  #import 
  @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  
  { 
      … 
  } 
  // 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收取费用。

  按以下步骤创建测试用户:

  登录到

  进入 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功能比想象的要复杂许多。我可是经过无数痛苦的经历才完成我的程序。希望能够帮助其他开发者减轻他们的痛苦

本文转载自:http://www.educity.cn/develop/1381729.html

你可能感兴趣的:(iOS,学习)