【转】ios app 应用内购买配置完全指南
转自:http://blog.sina.com.cn/s/blog_4b55f6860100sbfb.html
第一印象觉得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是否包括通配符,请登录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 (这是通用格式
– 注意没有使用通配符)。
- Display name(显示名): 选取一个不同的App ID的名称。你不能编辑或删除旧的App
- 按 “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中生成程序的发行版
- 如果你不知怎么做,请在 iPhone Developer Portal 中点击左方的 Distribution标签,并选择
- 在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(预订): 循环反复
- Non-consumable(非消耗品): 仅需付费一次
- Price Tier(价格等级): 产品价格。参见不同等级的价格列表。
- Cleared for Sale(等待销售):
一定要选取此项,否则的话,测试时会发生非法产品ID的错误。 - Language to Add(增加的语言): 选一项。下列两项将出现:
- Displayed Name(显示名称): 用户看到的产品名称。比如我选择 “Upgrade to
Pro”。 - Description(描述): 对产品进行描述。此处输入的文本将与Displayed Name 及
Price 一起在你代码中提取 SKProduct时出现。
- Displayed Name(显示名称): 用户看到的产品名称。比如我选择 “Upgrade to
- Screenshot(截屏):
展示你产品的截屏。尽管屏幕上会显示“提交截屏会触发产品审核过程”之类的文字(个人拙见,这是非常糟糕的设计),你还是可以安全地提交截屏而不会使产品进入审核过程。存储后,选择“Submit
with app binary”
(随程序二进制码一起提交)选项。是产品与程序二进制绑定在一起,所以在你最后正式提交100%完成的程序二进制码时,产品也会随之提交。
- Reference Name(参考名称): 产品的通用名称。比如,我使用的是 “Pro
- 点击 “Save”
7. 编写代码
下面我们开始编写代码对刚加入到iTunes Connect中的产品信息进行提取。我访问产品数据,我们需要使用 StoreKit
framework。
注意: StoreKit 无法在模拟器上工作。你必须在真机上进行测试。
- 1.添加 StoreKit framework 到你的项目中。
- 2.添加SKProduct引用到你的 .h 文件中:
1
2 3 4 5 6 7 8 9 10 11 |
// InAppPurchaseManager.h #import #define kInAppPurchaseManagerProductsFetchedNotification @interface InAppPurchaseManager : NSObject <SKProductsRequestDelegate> { SKProduct *proUpgradeProduct; SKProductsRequest *productsRequest; } |
注意: InAppPurchaseManager
是一个单例类,它处理程序中所有IAP任务。它是本文中的示例程序。
- 3.产品请求,并在相应.m文件中实现代理协议:
1
2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 |
// InAppPurchaseManager.m - (void)requestProUpgradeProductData { NSSet *productIdentifiers = [NSSet setWithObject:@"com.runmonster.runmonsterfree.upgradetopro" ]; productsRequest = [[SKProductsRequest productsRequest.delegate = self; [productsRequest // } #pragma mark - #pragma mark SKProductsRequestDelegate methods - (void)productsRequest:(SKProductsRequest *)request { NSArray *products = response.products; proUpgradeProduct = [products if (proUpgradeProduct) { NSLog(@"Product NSLog(@"Product NSLog(@"Product NSLog(@"Product } for (NSString *invalidProductId in response.invalidProductIdentifiers) { NSLog(@"Invalid } // [productsRequest [[NSNotificationCenter defaultCenter] postNotificationName:kInAppPurchaseManagerProductsFetchedNotification } |
上面代码有几点需要注意:
- 指定产品id时,你必须使用完整产品id。例如,上例中使用
“com.runmonster.runmonsterfree.upgradetopro”。仅使用 “upgradetopro”
将不会正常工作。 - 如果在productsRequest:didReceiveResponse:中response.products 为
nil,而你的产品id出现于 response.invalidProductIdentifers
数组中时,那么请做好心理准备开始一场徒劳的搜索战吧。 StoreKit
API没有提供任何帮助,也没有任何指示关于为什么你的id是无效的。很可爱,不是吗? - SKProduct类提供了有关程序标题和描述的本地化版本,但是价格则没有本地化版本。下面是针对此疏忽提供的代码:
1
2 3 4 5 6 7 8 9 10 |
// SKProduct+LocalizedPrice.h #import #import @interface SKProduct (LocalizedPrice) @property (nonatomic, @end |
1
2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 |
// SKProduct+LocalizedPrice.m #import "SKProduct+LocalizedPrice.h" @implementation SKProduct (LocalizedPrice) - (NSString *)localizedPrice { NSNumberFormatter *numberFormatter = [[NSNumberFormatter alloc] init]; [numberFormatter [numberFormatter [numberFormatter NSString *formattedString = [numberFormatter [numberFormatter 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 协议:
1
2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 |
// InAppPurchaseManager.h // add a couple notifications sent out when the transaction #define kInAppPurchaseManagerTransactionFailedNotification #define kInAppPurchaseManagerTransactionSucceededNotification … @interface InAppPurchaseManager : NSObject <SKProductsRequestDelegate, { … } // public methods - (void)loadStore; - (BOOL)canMakePurchases; - (void)purchaseProUpgrade; @end |
上面我们定义了两个新的notification,它们将作为购买事务的结果被发送。在上例中我们仍然使用与获取产品描述同一个InAppPurchaseManager类。
1
2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 |
// InAppPurchaseManager.m #define kInAppPurchaseProUpgradeProductId … #pragma - #pragma Public methods // // call this method once on startup // - (void)loadStore { // [[SKPaymentQueue // [self } // // call this before making a purchase // - (BOOL)canMakePurchases { return [SKPaymentQueue } // // kick off the upgrade transaction // - (void)purchaseProUpgrade { SKPayment *payment = [SKPayment [[SKPaymentQueue } #pragma - #pragma Purchase helpers // // saves a record of the transaction by storing the receipt to // - (void)recordTransaction:(SKPaymentTransaction *)transaction { if ([transaction.payment.productIdentifier { // [[NSUserDefaults standardUserDefaults] setValue:transaction.transactionReceipt [[NSUserDefaults standardUserDefaults] synchronize]; } } // // enable pro features // - (void)provideContent:(NSString *)productId { if ([productId { // [[NSUserDefaults standardUserDefaults] setBool:YES forKey:@"isProUpgradePurchased" ]; [[NSUserDefaults standardUserDefaults] synchronize]; } } // // removes the transaction from the queue and posts a notification // - (void)finishTransaction:(SKPaymentTransaction *)transaction { // [[SKPaymentQueue NSDictionary *userInfo = [NSDictionary dictionaryWithObjectsAndKeys:transaction, @"transaction" , nil]; if (wasSuccessful) { // [[NSNotificationCenter defaultCenter] postNotificationName:kInAppPurchaseManagerTransactionSucceededNotification } else { // [[NSNotificationCenter defaultCenter] postNotificationName:kInAppPurchaseManagerTransactionFailedNotification } } // // called when the transaction was successful // - (void)completeTransaction:(SKPaymentTransaction *)transaction { [self [self [self } // // called when a transaction has been restored and and successfully // - (void)restoreTransaction:(SKPaymentTransaction *)transaction { [self [self [self } // // called when a transaction has failed // - (void)failedTransaction:(SKPaymentTransaction *)transaction { if (transaction.error.code != SKErrorPaymentCancelled) { // [self } else { // [[SKPaymentQueue } } #pragma mark - #pragma mark SKPaymentTransactionObserver methods // // called when the transaction status is updated // - (void)paymentQueue:(SKPaymentQueue *)queue { for (SKPaymentTransaction *transaction in transactions) { switch (transaction.transactionState) { case SKPaymentTransactionStatePurchased: [self break; case SKPaymentTransactionStateFailed: [self break; case SKPaymentTransactionStateRestored: [self 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功能比想象的要复杂许多。我可是经过无数痛苦的经历才完成我的程序。希望能够帮助其他开发者减轻他们的痛苦。
【转】ios app 应用内购买配置完全指南的更多相关文章
- iOS App程序内多语言国际化实现 By HL
iOS 多语言设置有很多方式可以实现,之前在做手机思埠1.0时,就对app进行了多语言设置,当时看到很多方法,比如用plist等方式保存键值对的,不过还是用Localisator来国际化最方便 1.添 ...
- unity3d 嵌入iOS的 In App Purchase 应用程序内购买
Unity做东西是快,但是有些功能是需要额外开发的,比如 IAP (In App Purchase,应用程序内购买) 还好unity提供了灵活的扩展功能,允许嵌入原生代码来做一些unity未实现的功能 ...
- iOS开发 使用RMStore简化内购代码 + 内购买订单验证
现在很多的app里面都添加了应用内购买,网上关于苹果证书的生成和设置的教程比较多,这里就不多赘述了,推荐几个个人觉得说的比较详细的网址: http://www.jianshu.com/p/86ac7d ...
- iOS APP内购
看到网上文章一大把,看了这个觉得挺不错的,谢谢 iOS大全 公众平台; 原文:http://mp.weixin.qq.com/s?__biz=MzAxMzE2Mjc2Ng==&mid=2652 ...
- iOS 开发 初级:应用内购买 In-App Purchase
http://blog.csdn.net/songrotek/article/details/8680415 现在有很多应用都使用了In-App Purchase,虽然对于很多用户来说,可能并不喜欢甚 ...
- IOS APP 国际化 程序内切换语言实现 不重新启动系统(支持项目中stroyboard 、xib 混用。完美解决方案)
上篇 IOS APP 国际化(实现不跟随系统语言,不用重启应用,代码切换stroyboard ,xib ,图片,其他资源 介绍了纯代码刷新 实现程序内切换语言. 但效率底下,也存在一些问题.暂放弃. ...
- ios app的真机调试与发布配置
1.打开应用程序—>[钥匙串访问]—>[证书助理]—>[从证书办法机构请求证书] 2.在[用户电子邮件地址]填入apple账户用的邮箱,选择[存储到磁盘],点击[继续],会在 ...
- IOS APP配置.plist汇总(转自coolweather )
IOS APP配置.plist汇总(转自coolweather ) 此文转自http://www.cocoachina.com/bbs/read.php?tid=89684&page=1 作者 ...
- iOS- 给App添加内购& 验证购买iOS7新特性
1.内购——应用内购买 我所说的内购——也可以说是应用内购买 大家都知道通过苹果应用程序商店有三种主要赚钱的方式: 1.直接收费(与国内大部分用户的消费习惯相悖,如果要收费,直接收高的,别收6块钱) ...
随机推荐
- 01-05-01-1【Nhibernate (版本3.3.1.4000) 出入江湖】延迟加载及其class和集合(set、bag等)的Lazy属性配置组合对Get和Load方法的影响
这篇文章 http://ayende.com/blog/3988/nhibernate-the-difference-between-get-load-and-querying-by-id One o ...
- EasyTouch 3.1中文翻译
Unity3D的Easy Touch 的手册最近寻找中文版本,google无果,自己动手.目前暂时只有c# ,javascript原理是一样的. 一.Quick Start 1-Import Easy ...
- 如何恢复SQL Server 中的Master库
如何恢复SQL Server 2005中的Master库 2011-05-10 16:34 Vegas Lee 博客园 我要评论(0) 字号:T | T master库对于SQLServer来说, ...
- Python 资源
转:http://www.360doc.com/content/16/0308/14/31385575_540482688.shtml 本页面是俺收集的各种 Python 资源,不定期更新. 下面列出 ...
- javascript分享到的源码
<!DOCTYPE html> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <m ...
- PHP字符串中的变量解析(+教你如何在PHP字符串中加入变量)
定义字符串的时候,用单引号或者双引号都是可以的.我个人习惯是用双引号.在输出字符串的时候,若字符串中含有字符串变量,使用单引号和双引号则是有区别的.如下面程序: 1 2 3 4 5 6 7 8 < ...
- hdu 4676 Sum Of Gcd
离线+分块!! 思路:序列a[1],a[2],a[3]……a[n] num[i]表示区间[L,R]中是i的倍数的个数:euler[i]表示i的欧拉函数值. 则区间的GCD之和sum=∑(C(num[i ...
- VC程序查错之内存访问异常
作者:langouster 先来看下面这张图,相信很多程序员都见过类似. ---------------------------test1.exe - 应用程序错误------------------ ...
- IDEA15 File工具栏中没有 Import Project
使用IDEA准备导入项目时发现没有Import Project选项... 解决办法: Settings > Appearance & Bechavior > Menus and T ...
- 72. Edit Distance
题目: Given two words word1 and word2, find the minimum number of steps required to convert word1 to w ...