IAPFree 安装使用手册

【前言】

本手册适用于IAPFree 4.0.1版本,并且随着IAPFree版本升级会不断更新。

预读本手册请着重阅读高亮部分的文字。


【简介】

IAPFree是一款运行于iOS越狱平台的工具软件。其主要功能是实现IAP内容的免费内购。

IAPFree是永久免费的闭源软件,使用者可以在未经过我许可的前提下自由复制、传播。但是不可以修改IAPFree任何机器目标代码、程序代码、资源等。禁止将IAPFree用于任何商业行为或以商业利益为目的的活动,否则由此带来的一切问题由使用者自行承担。

本人从未也永远不会以任何方式、任何理由利用IAPFree向用户收费或募集捐助,也从未授权任何人代表作者本人进行上述活动。任何向用户索取捐助的行为,均为不法分子的骗术,请广大用户仔细甄别,谨防上当!

制作这个软件的目的不是鼓励大家破坏游戏产业的生态环境,大家在免费内购了IAP项目后,如果觉得该项目物有所值,希望大家还是花些真金白银支持下开发商。毕竟没有收入支持的开发商是无法源源不断的提供好玩的游戏的。

 

【环境需求】

iOS 5.0.0~6.1.2 完美越狱的设备

要求设备CPU必须是arm7或arm7s兼容的,armv6已不在IAPFree的支持范围内

具体到设备为:

iPod Touch:Touch3及以后的设备(不包括伪3代)

iPhone:iPhone3Gs及以后的设备

iPad:所有iPad

 

【安装IAPFree】

1)安装IAPFree需要通过iOS越狱后自带的Cydia实现。点击主界面Cydia图标,打开Cydia。

点击查看原图

 

2)点击Cydia界面下方的“管理”卡片,选择“软件源”。

点击查看原图

 

3)在“软件源”列表的界面,点击上方导航栏右上角的“编辑”按钮,这时左上角会出现“添加”按钮,点击“添加”按钮。在弹出的输入框内输入我的官方源地址。官方源地址可以用下列地址任意一个。

http://cydia.crazydoraemon.com

http://repo.crazydoraemon.com

http://cydia.iapfree.org

http://repo.iapfree.org

也可从官方认可的分流源下载:

http://apt.bhgbox.org

注意:非官方认可源里的IAPFree很可能会被篡改,强烈不推荐从非官方源下载安装IAPFree。

点击查看原图

 

4)添加完源之后,Cydia会进行一系列刷新动作。刷新结束后,可以在“软件源”列表内看到“疯狂机器猫”的软件源

点击查看原图

 

5)打开“疯狂机器猫”软件源,正常情况下,可以看到3个项目(如果您看到的内容与一下截图不相符,请参考本手册的【常见问题解答】内的相关内容解决)。这三个项目的具体细节如下:

IAPFree:这是IAPFree的主程序,安装后会要求重启Springboard并生成IAPFree的图标。这个包依赖“疯猫公共库”,安装这个包时Cydia会自动安装依赖包。

IAPFree Toggle:这是专门为喜欢使用SBSettings管理iPhone的同学们开发的一个Toggle,可以快速开关IAPFree的全局功能开关。属于选装项目,不安装它也不会影响IAPFree的任何正常内购工作。这个包依赖“IAPFree”,安装这个包时Cydia会自动安装依赖包。

疯猫公共库:因为以后准备继续开发其他的工具,所以将一些常用的基础工具类封装成一个公共库,这样可以复用代码,降低主程序容量。这个包是我开发的所有工具都会依赖的包。安装源内任何包Cydia都会将这个包作为必要依赖安装。

点击查看原图

 

6)点击IAPFree项目,进入详情界面。注意查看IAPFree软件版本是否是最新版本(截图使用的是4.0.0版,实际情况以最新发布版本为准)。

特别注意软件包的标识是否是“com.crazydoraemon.iapfree”,源信息是否是“疯狂机器猫”(也可以是官方认证的Bhgbox源)。如果标识不是“com.crazydoraemon.iapfree”或者源信息不是“疯狂机器猫”,那么您可能选中的是非官方认证的源,并且您想要安装的IAPFree可能被他人恶意篡改了。被篡改过的IAPFree有可能存在启动闪退,工作不稳定,发布升级后Cydia内找不到升级包,或者升级时无法正确安装等各种问题!所以强烈不建议安装非官方认证源提供的IAPFree,强烈不建议安装标识被修改过的IAPFree。此类方式安装的IAPFree,我无法提供任何使用问题的疑难解答。

点击查看原图 点击查看原图

 

7)包信息检查无误后,可以点击界面右上角的“安装”按钮进行安装,如果一切顺利(所谓“一切顺利”,比较简单的判断标准是安装过程中界面没有黄字或红字出现),安装后Cydia会要求重启SpringBoard。

点击查看原图

 

8)重启Springboard后,如果手机一切正常,未出现安全模式等警告,则说明安装成功完成,您可以在iPhone主屏幕上找到IAPFree的图标。如果这个过程中存在问题,请参考后面的【常见问题解答】尝试解决。

点击查看原图

 

 

【使用IAPFree进行免费内购】

 1)点击IAPFree图标打开IAPFree主界面(如果点击图标后闪退,请参考【常见问题解答】尝试解决)。IAPFree经过短暂加载后,您可以看到主界面由三个卡片构成:“插件管理”、“应用列表”、“软件信息”,并且会看到一个警告对话框,这个对话框是提示您尚未安装“核心插件”。“核心插件”是IAPFree实现免费内购的基础插件,所有其他插件都必须依赖核心插件才可以正常工作

点击查看原图

 

2)点击“确定”自动进入“更多插件”界面,这个界面需要从我的服务器上在线读取可安装的插件列表,并且为每个插件读取图标。初次加载列表时,图标文件的下载时间较长,请耐心等待。图标文件加载完成后会在本地缓存,以后再需要读取列表时图标的加载速度会明显加快。

点击查看原图

 

3)列表成功载入后,会在“可安装”分类里第一个的位置上找到一个以绿色齿轮为图标的“核心插件”项目。

点击查看原图

 

4)点击“核心插件”,进入“插件详情”界面,点击界面右上角的“安装”按钮,插件将从服务器上下载并安装到IAPFree的插件列表内。安装成功后,点击左上角的“插件管理”按钮,退回“插件管理”主界面,您将在“已安装插件”的分栏内看到“核心插件”。

点击查看原图 点击查看原图

 

4)安装完“核心插件”,IAPFree就已经可以免费内购大多数软件或游戏的IAP项目了

以《Mega Run》为例。保证安装了“核心插件”并且IAPFree的全局开关“启用已安装插件”为开启状态。退出IAPFree,在iPhone主界面双击Home键,检查Mega Run是否在程序后台,如果存在,按住这个图标,将其关闭。这么做是因为如果目标程序已经在后台运行着,你再次打开执行的依然是IAPFree的变动起作用前的程序,新的设置不会追加生效。也就是说,对IAPFree做任何改动(修改设置,增减插件等)都必须彻底重开目标程序才能生效。

点击查看原图 点击查看原图

 

5)运行Mega Run,进入其Store界面,尝试购买价值¥328.00的3,500MP,如果一切顺利,你会发现你拥有的MP增加3500个。

点击查看原图

需要注意的是:IAP项目本身是需要通过网络从苹果服务器获取产品信息的,而且有些游戏在购买流程中也需要用到网络,所以在进行内购时,务必保持网络畅通。如果您发现内购项目中的价格一栏没有正常显示,或者购买过程中提示“产品无效”,“暂时不可用”这类的信息,多半是因为网络不畅通造成的。还有些游戏的产品购买流程中所访问的服务器在伟大的墙后面,这类东西就要大家发挥聪明才智搞个梯子才行了:)


6)“核心插件”并不能内购所有软件和游戏的IAP项目,有些游戏对内购内容做了二次验证防护,这类游戏需要通过在IAPFree里安装专用的插件才可以实现免费内购。

已《Danger Boat》为例,全局开关开启,已安装核心插件的前提下,彻底重新运行Danger Boat,进入金币购买界面,尝试购买金币会提示购买失败。

点击查看原图

关闭Danger Boat回到IAPFree,点击“插件管理”卡片内的“下载更多插件...”,会进入插件列表界面。

点击查看原图

 

插件列表完成载入后,拖动列表找到“Danger Boat”项目。

点击查看原图

点击该项目进入“插件详情”界面,在本例中这个插件的状态为“警告”,并且有个黄色的惊叹号,造成警告的原因在此界面也已经说明。这个警告是由于我安装的《Danger Boat》是1.0版本,而针对这个游戏的专用内购插件是按1.1版本开发的。也就是说,我本地安装的《Danger Boat》版本太老,与插件支持的版本不匹配。

由于软件和游戏的每次升级开发商都可能对程序进行改动,这些改动我无法预知。所以制作插件时只能以我当前可获得的最新版本制作和测试。如果您本地安装的应用的版本与插件能支持的版本不匹配,很可能会因为程序的变动造成免费内购无法支持。请注意,是“很可能”,但是并不是绝对。一般情况下,如果插件支持的版本比您安装的版本高,那此插件同样可以支持内购的可能性比较大,反之则可能性比较小,因为开发商很可能这次就是是针对内购防护做的升级。也正因为如此,如果一个当前能支持免费内购的游戏发布了新版本,您在升级前需要有一定的权衡:这次升级也许会让您永远告别免费内购。

点击查看原图

 

一般情况下,插件会有三种状态:正常、警告、异常。分别以绿色对勾(正常),黄色惊叹号(警告),红色禁止标志(异常)表示。造成警告和异常的原因有很多种,具体情况可以通过查看插件详情内的说明获知。

简单的理解插件状态对内购的影响可以理解为:

正常状态:可以无压力免费内购。

警告状态:存在一些不匹配的情况,但是有可能依然可以实现免费内购。

异常状态:存在严重的不匹配情况,这个插件无法正常工作。

点击查看原图 点击查看原图

 

安装完成《Danger Boat》的专用插件后,彻底重开Danger Boat(一定要记住彻底重开),进入金币购买界面,点击任意购买项目,会发现金币数直接增加了。

点击查看原图

 

 

【排除IAPFree与其他软件的冲突】

1)因为iOS平台下的软件和游戏数量浩如烟海,难免由于某些原因造成IAPFree与某些应用存在冲突的情况。以《搜苹果》为例。安装IAPFree后,本来使用正常的搜苹果会出现提示未安装IPA补丁的情况。虽然不影响《搜苹果》的使用,但是每次都提示的确挺烦的。

点击查看原图

 

2)要解决这个冲突,您只需要到IAPFree主界面的“应用列表”卡片内,找到“搜苹果”,并且将其附带的开关关闭。然后彻底重开《搜苹果》,您会发现恼人的提示不会再出现了。

点击查看原图

 

3)有些时候也许您是真的想花些真金白银买一些IAP项目的,这种情况下,您也可以通过关闭列表内应用的开关来禁用IAPFree对这个软件的作用。这样做之后,IAP会完全按正常流程进行。

提示:判断IAPFree是否在对一个软件或游戏发生作用的明确的判断标准是,如果您尝试购买某个项目时,出现了系统提示的对话框,特别是要求您输入Apple ID的密码时,这说明IAPFree没有对这个应用起作用。

提示:反之也可以通过这个标准推断,如果您本意是想通过IAPFree免费内购的,但是出现了上述对话框,那说明IAPFree没有正常配置(如,没开全局开关或者这个应用的开关,没有正确安装核心插件等问题),无法工作,也就没法实现免费内购了。

点击查看原图 点击查看原图

 

 

【在SBSettings中开启IAPFree Toggle】

 IAPFree Toggle是应一些SBSettings拥趸们的要求专门开发的一个小插件,它是IAPFree的一个可选安装包,对SBSettings无爱的同学可以无视此章节。

安装过程与安装IAPFree主程序基本无异,这里不再赘述。

安装完成后,需要到SBSettings设置界面内开启相应的开关,具体操作方式请度娘SBSettings的使用方法(建议只开启Dropdown Window内的开关。因为SBSettings对Notification内的开关状态刷新处理有bug)。

配置好重启Springboard,划出Dropdown Window,即可看到IAPFree的开关。开关的功能与您在IAPFree主界面内看到的“全局开关”完全相同。

点击查看原图

 

【联系我获取支持】

如果您在使用IAPFree遇到自己解决不了的问题,或者有一些改进意见想反馈给我,您可以在IAPFree的“软件信息”界面找到联系我的办法。

点击查看原图

官方主页:http://www.crazydoraemon.comhttp://www.iapfree.org

BHGBOX论坛IAPFree专区:http://bbs.bhgbox.org/forum-554-1.html

腾讯微博:@CrazyDoraemon

新浪微博:@IAPFree

Twitter:@IAPFree

Facebook:@IAPFree

 

特别声明:除了上述列举出的联系方式,其他方式均非我本人或我本人授权过的。请仔细甄别,谨防诈骗。

 

【常见问题解答】

[安装篇]

提问:为什么添加完官方源之后源里一片空白?为什么发布了新版IAPFree4.0.0但是我在Cydia里只能看到3.2.2版本。

回答:造成添加源失败的原因可能有如下几个:网络不通畅或源服务器暂时异常没能完整读取源的信息;有其他源也收录了IAPFree;Cydia整体刷新过程出现中断或尚未完成等。解决这类问题的建议是删除IAPFree官方源和其他所有包含IAPFree的源,然后关闭Cydia并重启手机。重新开机后启动Cydia,等待Cydia载入工作全部完成,然后再次重新添加IAPFree官方源和其他源,一般就可以解决这类问题。

 

提问:为什么安装IAPFree时提示Depends异常。

回答:apt软件包的组织结构非常严密,软件依赖关系必须严格保证才能安装。这样做可以减少因为周边环境的问题造成软件不稳定的情况。IAPFree的依赖包关系主要是MobileSubstrate和“疯猫公共库”。如果大家遇到Depends问题,多数是因为MobileSubstrate版本过低,请从MobileSubstrate的官方源内进行升级即可。如果是找不到“疯猫公共库”的话,多半是源添加得有问题,没有读取到“疯猫公共库”的信息,这种情况可以参考上面一个问答解决。

 

提问:我可以通过Deb文件包手动安装IAPFree吗?

回答:当然可以,只要您对apt体系有一定的理解,能看懂包之间的依赖关系,手动安装一点问题也没有。安装顺序是必须先装“疯猫公共库”,然后安装IAPFree主程序包,如果您喜欢使用SBSettings,还可以选装IAPFree Toggle。安装好之后记得重启设备。

 

提问:安装IAPFree并重启后,手机无限白苹果、无限安全模式等

回答:这种情况属于存在比较严重问题的案例。造成这种问题的原因主要是您从Cydia安装的其他软件有与IAPFree存在冲突的,您可以尝试排除法一个一个卸载其他插件,从而找到相冲突的插件。在您找到冲突插件之后,您可以把信息反馈给我,我会尽量在下一个版本的IAPFree中找到解决方案排除这种冲突。

 

持续添加中... 

 

[使用篇]

 提问:安装IAPFree之后是可以免费内购任何软件和游戏了吗?

回答:不是。“核心插件”插件可以内购大多数没做针对性防护的应用;有一些做了针对性防护的游戏,需要额外安装专用插件才能实现免费内购,这类专用插件需要逐步开发;还有一些游戏,关键数据和逻辑都在网络服务器侧,这类应用理论上无法实现免费内购,比如各种网游。

 

 提问:安装IAPFree之后是可以免费购买AppStore的收费软件吗?

回答:不能。永远打消这个念头吧。给汽车加上航空煤油能开着去月球吗?。

 

 提问:免费内购了某些游戏的收费内容后,会被苹果发现和封锁账号吗?会被开发商发现和封锁账号吗?

回答:这个很难说。就我目前的经验来说,苹果不会因为使用了免费内购封锁你的Apple ID账号,起码目前为止还从没出现过。游戏开发商方面就比较难说了,这完全看开发商的运营策略。

 

 提问:IAPFree安装过程没什么问题,但是主程序打不开,点击图标直接闪退。

回答:这种启动闪退的现象,经过我收集的案例发现。99%以上因为从非官方认可源安装了的被篡改的版本,至于那些源基于什么目的要篡改IAPFree至今我也无法理解。排除这个原因的话,那就是您的设备的运行环境与IAPFree存在冲突了。可能的问题来自以下几个方面:1)系统关键运行库文件缺失,2)存在与IAPFree冲突的其他Cydia插件,3)系统文件系统的读写权限存在异常改动。您可以从这三个方面尝试排查问题,如果您自己无法排查出问题,可以到Bhgbox论坛上报这个问题,我会协助您一切解决。闪退问题解决专用帖地址:http://bbs.bhgbox.org/thread-30077-1-1.html


 提问:为什么有些游戏的专用插件突然从列表里消失了?

回答:这个问题吧...开发商其实也不容易,在这个行业生存鸭梨山大的!所以有时候,还是稍微保护一下熊猫吧。

 

持续添加中... 

 

【鸣谢】

多语言支持:小面怪(法语),makis(瑞典语),BlackCorsar(俄语),Abeq(印尼语),叶崇军(西班牙语),ro van tilburg(荷兰语),Frank(韩语),有风的交叉路(繁体中文),JohnnyVip(英语)

丸丸,云中月圆,金子,半痴半狂半疯癫,qiqi,The Walking Dead 等所有参加4.0.0内测的同学



return top