转载

经验分享：Xcode 创建.a和framework静态库

投稿文章，作者：Haley_Wong

最近因为项目中的聊天SDK，需要封装成静态库，所以实践了一下创建静态库的步骤，做下记录。

库介绍

库从本质上来说是一种可执行代码的二进制格式，可以被载入内存中执行。库分静态库和动态库两种。

iOS中的静态库有 .a 和 .framework两种形式；动态库有.dylib 和 .framework 形式，后来.dylib动态库又被苹果替换成.tbd的形式。

静态库与动态库的区别

静态库和动态库是相对编译期和运行期的：静态库在程序编译时会被链接到目标代码中，程序运行时将不再需要改静态库；而动态库在程序编译时并不会被链接到目标代码中，只是在程序运行时才被载入，因为在程序运行期间还需要动态库的存在。

总结：同一个静态库在不同程序中使用时，每一个程序中都得导入一次，打包时也被打包进去，形成一个程序。而动态库在不同程序中，打包时并没有被打包进去，只在程序运行使用时，才链接载入（如系统的框架如UIKit、Foundation等），所以程序体积会小很多，但是苹果不让使用自己的动态库，否则审核就无法通过。

创建.a静态库

第一步，新建工程。一般使用工程名就使用库的名称，比如我这里用FMDB来创建静态库，我的工程名就取名为FMDB，创建的.a静态库就是libFMDB.a。

经验分享：Xcode 创建.a和framework静态库

第二步，删除系统默认创建的【FMDB.h】和【FMDB.m】文件，导入需要打包的源文件。

经验分享：Xcode 创建.a和framework静态库

第三步(方式一)，修改项目配置

经验分享：Xcode 创建.a和framework静态库

点击上图中的【3】，弹出的列表中选择【New Headers Phase】,打开【Headers (0 items)】，点击左下角的【+】，选择所有的.h文件。

经验分享：Xcode 创建.a和framework静态库

第三步（方式二），修改项目配置

经验分享：Xcode 创建.a和framework静态库

第四步，修改导出product配置

经验分享：Xcode 创建.a和framework静态库

第五步，修改编译指令集

经验分享：Xcode 创建.a和framework静态库

模拟器：iPhone4s~5 : i386 iPhone5s~6plus : x86_64

真机：iPhone3gs~4s : armv7 iPhone5~5c : armv7s iPhone5s~6plus : arm64

如果第五步这里，设置为YES，那么编译出来的.a静态库就只包含当前设备的指令集。

举个例子：如果我们选择iPhone 5模拟器【Command+B】编译，则编译出来的.a静态库只能用iPhone4s~5模拟器跑程序，用iPhone5s~6plus，则会报找不到x86_64的libFMDB库。

设置为NO，则会把所有指令集的都打包合并。

第六步，编译（快捷键【Command+B】

编译时，需要用模拟器和真机各编译一次，这样Products目录下的libFMDB.a静态库才会变为黑色，右键show in Finder，可以进入Products目录下。

经验分享：Xcode 创建.a和framework静态库

为什么需要用模拟器和真机各编译一次呢？

可以看到Products目录下有【Release-iphoneos】和【Release-iphonesimulator】两个文件件。前者里面是真机使用的.a静态库，后者是模拟器使用的.a静态库。

注意：如果步骤四中，不将Build Configuration改为Release,则打包出来的静态库会存于【Debug-iphoneos】和【Debug-iphonesimulator】两个文件夹下。

我们一般都使用Release模式，因为程序最终发布之后是Release版的，所以静态库也是在Release模式下使用。

如果想要通用需要将模拟器使用的静态库与真机使用的静态库合并成一个静态库，可以使用终端命令来实现。命令格式：

lipo -create 第一个.a文件的绝对路径第二个.a文件的绝对路径 -output 最终的.a文件路径。

本文中使用的命令如下：

lipo -create /Users/harvey/Library/Developer/Xcode/DerivedData/FMDB-ctegiztcjikewoeprxxtmryzetfa/Build/Products/Release-iphoneos/libFMDB.a /Users/harvey/Library/Developer/Xcode/DerivedData/FMDB-ctegiztcjikewoeprxxtmryzetfa/Build/Products/Release-iphonesimulator/libFMDB.a -output /Users/harvey/Desktop/libFMDB.a

补充：经过多次实践，第三步的操作省略，依然可以导出可正常使用的包。

如果静态库中有category类，则在使用静态库的项目配置中【Other Linker Flags】需要添加参数【-ObjC]或者【-all_load】。

创建framework静态库

第一步，新建项目

经验分享：Xcode 创建.a和framework静态库

第二步，删除系统默认创建的【FMDB.h】和【FMDB.m】文件，导入需要打包的源文件。

经验分享：Xcode 创建.a和framework静态库

第三步，修改项目配置

首先，设置需要暴漏的头文件

经验分享：Xcode 创建.a和framework静态库

这里需要注意的是暴露出来的头文件中import的其他类也得添加到public中暴露出来。

如果不想将import的类暴露出来，那么在头文件中用@class 然后在对应的.m文件中再import。

然后设置编译模式，在Xcode菜单【Product】--->【Scheme】--->【Edit Scheme...】中

经验分享：Xcode 创建.a和framework静态库

设置编译出的静态库包含的指令集

经验分享：Xcode 创建.a和framework静态库

最后修改生成的Mach-O格式

经验分享：Xcode 创建.a和framework静态库

第四步，编译生成静态库

编译时，需要用模拟器和真机各编译一次，这样Products目录下的libFMDB.a静态库才会变为黑色，右键show in Finder，可以进入Products目录下。

经验分享：Xcode 创建.a和framework静态库

第五步，合并模拟器版framework和真机版framework

合并的命令同上面相似，不同之处是：framework静态库合并的不是framework,而是framework下的一个二进制文件，即上一步图中标记的文件。

lipo -create 第一个framework下二进制文件的绝对路径第二个framework下二进制文件的绝对路径 -output 最终的二进制文件路径。

本文中使用的命令如下：

lipo -create /Users/harvey/Library/Developer/Xcode/DerivedData/FMDB-clvayfrjgytqrbdkyqrtcjkxfeuz/Build/Products/Release-iphonesimulator/FMDB.framework/FMDB /Users/harvey/Library/Developer/Xcode/DerivedData/FMDB-clvayfrjgytqrbdkyqrtcjkxfeuz/Build/Products/Release-iphoneos/Release-iphoneos.framework/FMDB -output /Users/harvey/Desktop/FMDB

最后将任何一个framework中的二进制文件替换成合并后的二进制文件即可。

把framework添加到要使用的项目中即可使用。

注意：如果创建的framework中使用了category类，则在使用framework的项目配置中【Other Linker Flags】需要添加参数【-ObjC]或者【-all_load】。

如果使用framework的使用出现【Umbrella header for module 'XXXX' does not include header 'XXXXX.h'】,是因为错把xxxxx.h拖到了public中。

如果出现【dyld: Library not loaded:XXXXXX】，是因为打包的framework版本太高。比如打包framework时，选择的是iOS 9.0，而实际的工程环境是iOS 8开始的。

如果创建的framework类中使用了.dylib或者.tbd，首先需要在实际项目中导入.dylib或者.tbd动态库，然后需要设置【Allow Non-modular Includes ....】为YES，否则会报错"Include of non-modular header inside framework module"。

经验分享：Xcode 创建.a和framework静态库