创建framework项目

  1. 创建framework项目,此处命名为:testCppframework,这里语言选择使用Objective-C;

  2. 将Build Settings->Linking->Mach-O Type改成static;

  3. 选中 Target ,选择 Build Phases - Headers ,可以看出有三个选项,分别是 Public 、Private 、Project ,把需要公开给别人的 .h 文件拖到 Public 中,把不想公开的,即为隐藏的 .h 文件拖到 Project 中。

  4. 在Build Settings->Linking->Other Linker Flag 中添加-ObjC:

     注意:
     1. -ObjC:加了这个参数后,链接器就会把静态库中所有的 Objective-C 类和分类都加载到最后的可执行文件中。
     2. -all_load:会让链接器把所有找到的目标文件都加载到可执行文件中,但是千万不要随便使用这个参数!假如你使用了不止一个静态库文件,然后又使用了这个参数,那么你很有可能会遇到 ld: duplicate symbol 错误,因为不同的库文件里面可能会有相同的目标文件,所以建议在遇到 -ObjC 失效的情况下使用 -force_load 参数。
     3. -force_load:所做的事情跟 -all_load 其实是一样的,但是 -force_load 需要指定要进行全部加载的库文件的路径,这样的话,你就只是完全加载了一个库文件,不影响其余库文件的按需加载。
    
  5. 将Build Settings->Build Active Architecture Only下的release设置为NO,否则生成的静态库就只支持当前选择设备的架构。

添加静态链接库

  1. 在framework项目中新建一个Group,这里以新建cpp为例;

  2. 添加静态链接库.a文件和头文件

    如果静态链接库来自第三方,则直接将头文件和.a文件放入到这个cpp文件夹即可;如果是自己开发的,为了方便后续开发,可以将头文件所在的文件夹和.a文件以链接的方式添加到cpp文件夹中。

  3. 配置.a文件和头文件

    • 在Build Settings->Header Search Paths中添加${PROJECT_DIR}/cpp/include
    • 在Build Settings->Library Search Paths中添加${PROJECT_DIR}/cpp/
    • 在Build Phases-> Link Binary With Libraries中添加对.a文件的引用;

编译framework项目

在Product->Show Build Folder in Finder下可以找到编译后的.framework文件;

这里使用脚本将多个架构的.framework进行合并,参考代码:

rm -r ./build
mkdir build
cp -r {项目编译文件夹}/Build/Products/Debug-iphoneos/testCppframework.framework ./build/testCppframework.framework
lipo -create {项目编译文件夹}/Build/Products/Debug-iphonesimulator/testCppframework.framework/testCppframework {项目编译文件夹}/Build/Products/Debug-iphoneos/testCppframework.framework/testCppframework -output ./build/testCppframework.framework/testCppframework

上述脚本会将x86_64和arm64编译的testCppframework.framework文件合并后放到build文件夹下。

在其他项目中引用此framework项目

  1. 假设这里有一个现成的项目:testcppObjectiveC,为了方便管理,我在项目里新建一个Group,命名为framework;
  2. 在上面编译生成的testCppframework.framework文件拖到这个framework Group中;
  3. 使用Show in Finder 打开framework文件夹,将testCppframework.framework文件复制到framework文件夹下,或创建一个testCppframework.framework的链接到此文件夹下(推荐此方式);
  4. 在Build Setings->Search Paths->Framework Search Paths中添加 $(PROJECT_DIR)/framework ,否则编译时将提示找不到头文件;

调用framework中的代码

添加#import "testCppframework/testCppframework.h"后即可正常使用testCppframework.framework中的代码

注意

  • 如果包含不支持bitcode的库,则所有的项目都应将Build Setings->Build Options->Enable Bitcode设为NO;

参考文献

iOS 打包.framework(包括第三方、图片、xib、plist文件)详细步骤及需要注意的地方