iOS7开发～Xcode5制作framework

一、Framework 简介（Introduction to Framework Programming Guide）

Mac OS X 扩展了 framework 的功能，让我们能够利用它来共享代码和资源。通过 framework 我们可以共享所有形式的资源，如动态共享库，nib 文件，图像字符资源以及文档等。系统会在需要的时候将 framework 载入内存中，多个应用程序可以同时使用同一个 framework，而内存中的拷贝只有一份。一个 framework 同时也是一个 bundle，我们可以在 finder 里浏览其内容，也可以在代码中通过 NSBundle 访问它。利用 framework 我们可以实现动态或静态库的功能。

翻译：https://developer.apple.com/library/mac/documentation/MacOSX/Conceptual/BPFrameworks/Frameworks.html

二、Framework制作方法

1、首先新建两个项目，分别为FrameworkHome 和 FrameworkDemo，其中FrameworkHome为framework制作项目，FrameworkDemo为framework测试项目。



（1）建立FrameworkHome（选择静态库模版）

a、选择工程模版



b、清理工程无用文件（ Target 、 FrameworkHome、 FrameworkHomeTests）

删除前：



删除后：



c、删除旧目标对应的编译设置



点击Manage Scheme



点击左下角 “ － ” 号



选择Delete并且点击OK



d、增加一个新的Target

点击 Add Target



选择模版



点击Next，并且配置不需要需改，起一个名字，然后点击Finish



结果



e、修改项目配置

点击 “步骤d” 中创建的Target，并选择 Build Settings -> Architectures -> Base SDK 改为Latest iOS（ios 7.0）

并将 Architectures 改为 Standard architectures （armv7, armv7s）



在 Deployment 下，将 “Mac OS X Deployment Target”改为”Compiler Default”，将 “Targeted Device Family”改为需要的，此处改成了”iPhone/iPad”,同时可以根据需要修改 “iOS Deployment Target”，此处改为了 “iOS 5.0”:



在 Linking 中，将 “Dead Code Stripping” 改为 “NO”，将 “Link with Standard Libraries” 改为 “NO”，将 “Mac-O Type” 改为 “Relocatable Object File”：



Packaging 中，将 “Wrapper Extention” 改为“framework”:



修改 Info，将 “Bundle OS Type Code” 改为 “FMWK”（Framework ）



修改预编译头文件，注视其中代码



到此为止，基本的配置就算完成了，可以看到现在的 Products中的文件为 DemoLibrary.framework，不错，这个就是给FrameworkDemo 使用的framwwork，虽然现在FrameworkDemo还没有创建。但在这之前首先编写一些 DemoLibrary.framework 中的内容，然后把接口提供给FrameworkDemo。

f、提供对外接口

首先，创建一个类，建议不要使用IXIB，因为以后打包成 framework以后，我遇到了viewController找不到XIB文件的问题，所以不建议使用XIB。

创建两个ViewController，分别为 OpenViewController 和 PraviteViewController ，其中OpenViewController 是对外公开的接口，内部实现使用到了 PraviteViewController。



别忘记选择Target



g、导出头文件

选中Target（DemoLibrary ) -> Build Phases - > Editor - > Add Build Phase - > Add Copys Headers Build Phase



展开 “Copy Headers”



点击右下角的 “ ＋ ”选择相应的 .h 文件来添加对外的接口



还要把相应Project下的文件拖动到Public下



大功告成，但这个地方有一个细节要注意，当前选择build生成的framework要选择ios Device，不要选择你当前链接的真机，否则会出现在打包的framework在别的机器上使用时出错。



另外，当前的framework适合真机，如果要做模拟器的framework，要修改成模拟器版本





现在可以build FrameworkHome 工程了！



这个地方有个小技巧，当选择模拟器，build之后，发现Products下的文件仍然是红色字体，表示不存在，实际上文件已经有了。那把模拟器换成Devixe，再build一下，会发现DemoLibrary.framework 字体变黑，表示文件有了，用finder找到起位置：



其中Debug-iphoneos中的framework就是真机版本的，下边的文件夹就是模拟器版本的。

2、建立FrameworkDemo工程，选择Empty Application模版就可以了，将刚刚生成的 DemoLibrary.framework 拷贝（也可以引用形式）拖拽到FrameworkDemo中并运行FrameworkDemo。这个地方还有个小细节，FrameworkDemo －>Target - > Architectures 的设置要和framework中的设置相同，不然会出现问题。



编译运行：



控制台打印：



补充：一般framework项目中会有一些图片等资源要一同提供给使用者，这时就需要将这些资源打包成bundle文件，和framework一起拷贝到相应的项目中。

1、建立bundle文件

新建文件夹 －> 将图片资源放到文件夹中 － > 改文件夹名字为 XXX.bundle ，再将这个bundle文件一同放到目标工程中。

2、读取文件

framework中的代码就要这样读取文件了，当然还有其他的初始化路径方法，有需要的可以以后补充。

[objc] view plaincopyprint?

NSBundle *bundle = [NSBundle bundleWithURL:[[NSBundle mainBundle] URLForResource:@"Resource" withExtension:@"bundle"]];

UIImage *img = [UIImage imageWithContentsOfFile:[bundle pathForResource:@"testImg" ofType:@"png"]];

[viewCtr.view addSubview:[[UIImageView alloc] initWithImage:img]];

3、一些错误的解决办法
http://stackoverflow.com/questions/14367793/duplicate-symbol-error-in-xcode

duplicate symbol _NXArgcin:    解决办法：Please set the option "Link with Standard Library" to NO in your build setting

也可以参考：http://blog.csdn.net/lizhongfu2013/article/details/12912807

4、建立一个真机和模拟器通用的framework

首先用finder找到framework所在的位置



然后找到framework中的文件，例如这里的 Kalagame-library，并且纪录其路径 os_frame_path



同样方法打开另一个文件夹，纪录其中库的路径，simulator_frame_path



然后打开控制台，输入 lipo -create os_frame_path simulator_frame_path -output newframe

这样就完成了模拟器和真机版本framework的合并，用finder找到这个newframe，然后把newframe改名字（例如这里的Kalagame-library），并放回到framework文件夹中，替换原来的文件

先来看一下framework中的tgfmwk

打开终端。输入pwd 先看一下当前所在的目当路径。使用ls 查看当前目录下的文件夹。

cd /users/[用户名]/Desktop/fmwksqlite/DerivedData/fmwksqlite/build/products/release-iphoneos/tgfmwk.framework

然后使用lipo -info tgfmwk 查看一下库的信息。

看到输出Non-fat file: tgfmwk is architecture: armv7

这里表明只支持真机。



同样的再来看看模拟器的。

cd /users/[用户名]/Desktop/fmwksqlite/DerivedData/fmwksqlite/build/products/release-iphonesimulator/tgfmwk.framework

然后使用lipo -info tgfmwk 查看一下库的信息。

看到输出Non-fat file: tgfmwk is architecture: i386



可见要想真机和模拟器都可以使用该framework需要将这两个版本的tgfmwk文件进行合并。

使用命令lipo -create xxxx/tgfmwk xxxxx/tgfmwk -output tgfmwknew

其中xxxx表示路径，一个是真机的tgfmwk所在路径，一个是模拟器tgfmwk文件所在路径，然后输出tgfmwknew新的文件。输出后，只需要将这个tgfmwknew重命名为tgfmwk然后复盖原来的tgfmwk 文件即可。把复盖后的这个tgfmwk.framework考出来到具体使用的项目就可以实现真机和模拟器通用的framework 了。

看一下tgfmwknew的信息。

显示：Architectures in the fat file: tgfmwknew are : armv7 i386

可见这个合并的文件已具备了armv7（真机）和i386（虚拟机）的能力。



由于OCSqlite这个类使用到了libsqlite3.dylib ，所在在调用framework库时也需要添加这个动态库。

其他：完整的Demo下载