iPhone私有API学习笔记

转自：http://bbs.51cto.com/archiver/tid-846159.html

一．基本知识

iPhone中的API除了公开的 API：Published API外（或者叫文档中记录的API：Documented API），还有两类API：私有API：Private API和未公开的API：UnPublished API(或者叫文档中未记录的API：Undocumented API)。其中私有API是指放在PrivateFrameworks框架中的API，未公开的API是指虽然放在Frameworks框架中，但是却没有在苹果的官方文档中有使用说明、代码介绍等记录的API。后两种API是有区别的，按苹果的说法，未公开的API是还不够成熟，可能还会变动的API，等完全成型了后会变成公开的API，但是目前不对其提供承诺，就是系统版本升级后可能会失效。而私有API是苹果明确不能使用的API。虽然两者有所区别，但是在具体使用方法上是类似的。

二．具体介绍

1.导出生成私有API的头文件声明

使用私有或未公开的API，首先需要导出其对应的头文件，在头文件里有相关函数的声明。

工具：

class-dump 

到此处下载最新的版本：http://stevenygard.com/projects/class-dump/

class-dump可以从编译后的Objective-C的二进制文件中提取对应的数据结构及函数等声明。

使用方法：

先把class-dump编译后，在product里找到那个class-dump文件，拖入到/usr/bin目录下，

这样我们就可以在任意目录下输出API的列表了，也就是.h头文件例如，如果要在桌面上输出UIKit框架里所有的API，

就需要打开终端，cd Desktop，然后class-dump 

 /Applications/Xcode.app/Contents/Developer/Platforms/iPhoneSimulator.platform/

Developer/SDKs/iPhoneSimulator5.1.sdk/System/Library/Frameworks/UIKit.framework/ >UIKit_5.1.h  

这样就会在桌面生成一个UIKit_5.1的h文件，里面有UIKit里的各种API，你可以在项目框架里查看UIKit.h比较一下，

多出来的API声明就是所谓的private API了，这后面的路径是新版本Xcode的路径，以前的老版本的应该在/Developer目录下。


也可以用ericasadun写的DumpFrameworks.pl（文件中有部分注释说明）这个文件把私有框架下的API头文件全部提取出来。

使用方法也是首先把class-dump文件拷贝到/user/local/bin/目录下，然后在任意一个目录下执行./DumpFrameworks.pl,

然后就会在你的家目录下产生一个Headers文件夹，里面罗列了私有框架下的API头文件。

2.使用私有API

导出了私有API的头文件声明后，使用方法就比较简单了，首先在你的工程中包含进头文件，然后导入对应的框架，

之后就可以类似提供了静态库的方式在我们的代码中使用这些私有API函数。


三．附加说明

iPhone编程中一些非常精致好玩的API都包含在私有API或未公开的API中，虽然我们可以以这种方式使用这些非常好的API，

但是这样做是存在一定风险的，首先为公开的API有变更的可能，这样在每个固件版本中，你的代码都有可能中断。同时，

最大的问题是使用了私有API的程序是不能放在App Store上销售的。因此如果我们只是为了好玩体验iPhone中这些精彩的API，

那没关系。如果是为了做出程序放在App Store上销售的，那就不要动私有API的主意了。