将整个Xcode项目打包成静态库Framework

一、介绍

1、背景

考虑到上架App的安全性和后期代码管理的一些内容，以及现有马甲和超级App的一些业务上，越来越多的涉及到大模块的内容搬移和共享，所以权衡各种方式之后，考虑使用静态库的方式来把独立业务部分用静态库的方式加载和共享。

2、静态库介绍

• 什么是库？

共享代码便是库，实现代码的复用，一般分为静态库和动态库。

• 静态库和动态库的区别？

静态库：链接时完整的拷贝到可执行文件，多次使用多次拷贝，造成冗余，使包变的更大。
动态库：链接时不复制，程序运行时由系统加在到内存中，供系统调用，系统加在一次，多次使用，共用节省内存。

• iOS/Mac 中的静态库？

后缀为： .a和.framework 文件

• iOS/Mac 中的动态库？

后缀为： .dylib和.framework 文件

• iOS/Mac Framework 为什么即是动态又是静态？

系统的架构是动态的，我们自己创建的是静态的。

• .a和.framework的区别是什么？

.a是单纯的二进制文件，.framework是二进制问价+资源文件。
其中.a不能直接使用，需要.h文件配合，而.framework则可以直接使用
.framework = .a + .h + sorrceFile（资源文件）

• 为什么要使用静态库？

共享代码，方便使用。
实现iOS 程序的模块化，固定的业务模块话，减少开发的重复劳动。
和别人分享代码，但又不想让别人知道代码的具体实现。
开发第三方SDK 的需要。
有时候集成其他项目的时候 也可以使用。

3、注意点

• AppDelegate

AppDelegate不能打包进静态库,所以AppDelegate.m文件在编译的文件列表中要撤选,在AppDelegate中做的一些操作要全部封装成接口暴露出去

• 第三方库

项目中的第三方库优先使用CocoaPods管理，可以不用打包进自己的静态库。如果我们打包整个工程的时候没有把用到的第三方框架一起打包，那么提供静态库的时候，要说明依赖哪些第三方的库。

• 资源文件

默认情况下，静态库只会打包代码文件，像图片、xib、storyboard、plist文件等都不会被打包，就需要创建一个bundle文件夹，把所有的图片、plist文件、Images.xcassets、xib、storyboard都打包进去，而且项目中用到图片的时候，只能通过bundle/xxx.png文件名的方式来设置。

二、封装步骤

1、新建工程

• 选择File>New>Project>iOS>Cocoa Touch Framework

1.png

2、导入文件

• 先删除系统自动生成的工程同名的.h文件，创建相同名称继承自NSObject的类，用于对外暴露接口的类,到时候只需把创建的.h暴露出去即可。
• 拉取需要制作静态库的所有文件资源到新工程目录下。

3、导入第三方库

• 使用CocoaPods管理的第三方库，在此工程下，同样配置需要支持的第三方库的Podfile后执行pod install，并用.xcworkspace文件重新打开工程。

2.png

• 非CocoaPods管理的第三方库，连同资源文件一起拉进工程目录下，并部署对应的依赖和系统库，必要时，把第三方的.h文件暴露成Public。

4、创建bundle文件

• 创建一个bundle文件，命名为：Resources，把项目中用到的图片或者其他非代码资源都拖拽进去。

4.png

• 读取的时候需要带上读取路径，示例：

[_searchButton setImage:[UIImage imageNamed:@"Resources.bundle/search.png"] forState:UIControlStateNormal];

5、修改pch文件路径

• 若原来的文件中包含pch文件用来做全局引用，需要再此工程中修改pch文件路径。

13.png

6、工程配置

• 修改支持设备、版本和架构

3.png

7.png

8.png

注意：.Build Setting搜索linking设置Dead Code Stripping为NO是编译选项优化,可以使包瘦身，可以根据具体要求选择是否修改。

备注说明

不同的模拟器和真机所支持的CPU架构是不一样的，如果库文件不支持某种CPU架构，那么就无法在对应的设备上编译。

模拟器环境下支持的CPU架构：
4s — 5：支持i386架构，CPU处理器是32位的
5s — 6Plus：支持x86_64架构，CPU处理器是64位的

真机环境下支持的CPU架构：
3gs — 4s：支持armv7架构，CPU处理器是32位的
5 — 5c：支持armv7s架构，CPU处理器是32位的
5s — 6Plus及以上：支持arm64架构,CPU处理器是64位的

Architectures属性是系统根据你的Xcode版本自动默认配置的，如果你当前的Xcode版本比较旧，默认的真机架构有可能只是：armv7，而我目前的版本是Xcode9.4，Architectures的默认设置只有两种架构：armv7和arm64。

Valid Architectures选项里面却有三种架构，包括arm64,armv7,armv7s，在打包成静态库的时候，Xcode会拿到这两个选项里面的参数进行比较，只保留在两个选项里都同时存在的架构。

7、头文件配置

根据需要开放的.h拖动Project的文件到Public列，需要隐藏的拖动到Private。
注意：因为 Framwork 工程是没有自动导入系统的 UIKit.framwork，我们Framwork里面是用到了UI控件的，所以需要手动导入系统UI库。否则封装完毕，调用该库的时候，里面的UI控件是不可见的。

12.png

8、工程编译

• 编译之前需要进行Edit Scheme，把Debug修改成Release。

10.png

• 选择真机（或者Generic iOS Device）和模拟器都编译一次，编译通过后，选择Products文件夹，对应生成的framework文件Show in Finder，会发现有对应生成的真机和模拟器的framework。

14.png

15.png

9、合并Framework

• 先检查一下对应的framework架构信息是否正确，打开终端使用命令行：

lipo -info 空格 framework地址

• 合并真机和模拟器的framework，使用命令行处理：

sudo lipo -create 空格 (此处请填写真机testNewFramework文件路径) 空格 (此处填写模拟器testNewFramework文件路径) 空格 -output 空格 自定义合成文件存储路径（合成文件的名字testNewFramework）

• 最后查看合并后的framework架构信息是否包含真机和模拟器的所有的架构信息。

17.png

备注说明

架构信息：首先了解一下什么是ARM，ARM是微处理器，而armv6, armv7, armv7s是ARM CPU的不同指令集。
armv6设备：iPhone， iPhone2， iPhone 3G，第一代、第二代iPod Touch
armv7设备：iPhone 3GS，iPhone 4，iPhone 4S，iPad ，iPad 2，iPod Touch 3G，iPod Touch 4
armv7s设备：iPhone 5，iPad4
arm64设备：iPhone 5S，iPad Air，iphone6，iphone6plus，iPhone6s，iPhone6s Plus及以上版本等。

三、使用Framework

1、拖入主程序

• 直接将生成的framework拖入要使用的工程中去，使用文件复制类型加载。
• 引入framework，否则会娶不到framework的图片等资源。

18.png

2、使用功能

• 对应暴露的.h文件，可以直接使用#improt 来引用头文件。
• 对于framework的其他资源文件，可以使用读取bundle资源包的路径来获取，示例：

[_searchButton setImage:[UIImage imageNamed:@"Resources.bundle/search.png"] forState:UIControlStateNormal];

至此，教程完毕。