iOS 静态库制作（Xcode9.0，Framework制作，Bundle制作

Dear 丶 2022-05-21 23:55 627阅读 0赞

###    基本知识： ###

#### 1. 库类别 ####

*  静态库（.a 和.framework）
 *  动态库（.liby和.framework）

#### 2.静态库和动态库的区别 ####

2.1静态库

*  平时我们用的第三方SDK基本上都是静态库。
 *  静态库在项目编译时完整地拷贝至可执行文件中，被多次使用就有多份冗余拷贝。
 *  静态库很大的一个优点是减少耦合性，因为静态库中是不可以包含其他静态库的，使用的时候要另外导入它的依赖库，最大限度的保证了每一个静态库都是独立的，不会重复引用。
 *  静态库有.a 和 .framework两种形式。

2.2动态库

*  iOS平时使用的系统库基本是动态库，比如使用频率最高的UIKit.framework和Fundation.framework。
 *  动态库在程序运行时由系统动态加载到内存，供程序调用，系统只加载一次，多个程序共用，节省内存。
 *  动态库在制作的时候可以直接包含静态库，也能自动link所需要的依赖库。
 *  动态库有.dylib/.tbd 、.framework两种形式。
 *  苹果禁止iOS开发中使用动态库

#### 3.版本 ####

*  真机-Debug版本
 *  真机-Release版本
 *  模拟器-Debug版本
 *  模拟器-Release版本

3.1 Debug

*  含完整的符号信息，以方便调试
 *  不会对代码进行优化

3.2 Release

*  不会包含完整的符号信息
 *  的执行代码是进行过优化的
 *  的大小会比Debug版本的略小
 *  在执行速度方面，Release版本会更快些（但不意味着会有显著的提升）

### 基本操作：.a静态库制作 ###

>   
>   
>

#### 1. 新建静态库工程 ####

Create a New Xcode project -> Framework&Library -> Cocoa Touch Static Library   
![这里写图片描述][SouthEast]

文件结构如下：

![20180611112329546][]

#### 2. 配置工程环境 ####

2.1配置最低支持版本

![20180611112644678][]

2.2设置适配所有模拟器架构重要

project -> buildSeting -> Build Active Architecture Only 设为NO

![20180611112806893][]

#### 3. 新建公开的文件 ####

3.1新建一个名为“testTool 文件” 公开一个方法“testLog”

![20180611112851574][]

![20180611112921302][]

3.2添加公开文件

3.2.1 点击“+” 新增”Header Phase”

![20180611113312849][]

3.2.2 添加文件到 project

3.2.3 拖拽.h到 public

最终结果如下：

![2018061111370355][]

#### 4. 生成.a文件 ####

此处注意需要生成4个

4.1修改环境

![20180611113756632][]

这里可以选择 Debug 和 Release 环境

![这里写图片描述][SouthEast 1]

4.2选择模拟器+Debug 环境+“cmd+R”生成.a

![20180611113827878][]

此处注意需要生成4个   
如此类推打出四种.a

*  真机-Debug版本
 *  真机-Release版本
 *  模拟器-Debug版本
 *  模拟器-Release版本

最终生成结果   
![这里写图片描述][SouthEast 2]

4.3合并 debug 两个包和 release 两个包

注意：这里的合并指的是 1.debug 下真机+模拟器合并 2.release 下真机+模拟器合并

4.3.1将4个.a文件拷贝到单独文件夹

![这里写图片描述][SouthEast 3]

4.3.2 合并

打开终端   
命令规则

*  1
 *  2
 *  3
 *  4

![这里写图片描述][SouthEast 4]

标注出是自己起名

同理 release 也是如此 最后生成两个文件

![这里写图片描述][SouthEast 5]

#### 5.使用方法 ####

5.1新建一个新工程   
\*\*5.2引入文件   
5.2.1引入libStaticWork-Debug.a和libStaticWork-Release.a

5.2.2引入 include 文件   
在之前的静态库文件找到任意的生成文件 引入 include 文件

![这里写图片描述][SouthEast 6]

最后引入结果如下

5.3调用以及结果

![这里写图片描述][SouthEast 7]

### 基本操作：.framework静态库制作 ###

#### 1.新建 framework 工程 ####

![这里写图片描述][SouthEast 8]

#### 2.新建文件类 ####

![这里写图片描述][SouthEast 9]

#### 3.修改工程文件配置 ####

build setting ->搜索 mach -> 修改 mach -O Type ->static Library

![这里写图片描述][SouthEast 10]

![这里写图片描述][SouthEast 11]

#### 4.引入其他第三方库（如果有的话） ####

⚠️注意：导入第三方静态库的时候不要选择添加到target中

![这里写图片描述][SouthEast 12]

#### 5.暴露头文件 ####

拖拽文件到这里

![这里写图片描述][SouthEast 13]

#### 6.生成 .framework ####

6.1修改环境

![这里写图片描述][SouthEast 14]

这里可以选择 Debug 和 Release 环境

![这里写图片描述][SouthEast 1]

6.2选择模拟器+Debug 环境+“cmd+R”生成.a

![这里写图片描述][SouthEast 15]

此处注意需要生成4个   
如此类推打出四种.a

*  真机-Debug版本
 *  真机-Release版本
 *  模拟器-Debug版本
 *  模拟器-Release版本

最终生成结果

![这里写图片描述][SouthEast 16]

#### 7.合并 debug 两个包和 release 两个包 ####

注意：这里的合并指的是 1.debug 下真机+模拟器合并 2.release 下真机+模拟器合并

7.1将4个.a文件拷贝到单独文件夹

![这里写图片描述][SouthEast 3]

7.2 合并

打开终端   
命令规则

*  1
 *  2
 *  3
 *  4

![这里写图片描述][SouthEast 17]

标注出是自己起名

同理 release 也是如此 最后生成两个文件

![这里写图片描述][SouthEast 18]

\*\*7.3替换文件   
7.3.1寻找之前生成的 任意framework   
\*\*7.3.2替换二进制文件

替换前

![这里写图片描述][SouthEast 19]

替换后

![这里写图片描述][SouthEast 20]

8.使用方法   
8.1新建工程   
8.2应用 framework   
8.3结果如下

![这里写图片描述][SouthEast 21]

9.注意的地方

9.1警告   
如果我们什么都不配置的话 应用 framework 里面的文件 会产生如下的警告   
missing submodule ‘StaticFramework.framewokrTool”

![这里写图片描述][SouthEast 22]

解决方案：   
在 framework 的头文件也就是创建 framework 时同名的.h里面引入我们的头文件

![这里写图片描述][SouthEast 23]

就可以了

9.2资源文件 .bundle

静态库中有使用到图片、音视频等资源文件，可以将这些文件打包成.bundle文件供静态库使用。

最简单的方法是，新建一个文件夹，将图片、音视频等资源拖到文件夹中，将文件夹后缀名改为.bundle.   
静态库想要使用里面的资源的话需要先获取到该.bundle文件。

*  1

静态库中使用.bundle文件里面的图片的方法是：

*  1
 *  2

⚠️注意：.bundle文件无法封装到framework里，需要将.framework，.bundle同时导入项目中才能正常使用

9.3使用category

在制作framework的时候，如果使用了category，则使用该framework的项目运行时会crash，此时需要在该工程中 other linker flags添加一个参数 -ObjC

![这里写图片描述][SouthEast 24]

参数说明

*  ObjC：加了这个参数后，链接器就会把静态库中所有的Objective-C类和分类都加载到最后的可执行文件中
 *  all\_load：会让链接器把所有找到的目标文件都加载到可执行文件中，但是千万不要随便使用这个参数！假如你使用了不止一个静态库文件，然后又使用了这个参数，那么你很有可能会遇到ld: duplicate symbol错误，因为不同的库文件里面可能会有相同的目标文件，所以建议在遇到-ObjC失效的情况下使用-force\_load参数。
 *  force\_load：所做的事情跟-all\_load其实是一样的，但是-force\_load需要指定要进行全部加载的库文件的路径，这样的话，你就只是完全加载了一个库文件，不影响其余库文件的按需加载
    
      
    
    
    1.什么是库？
    
    库是程序代码的集合，是共享程序代码的一种方式
    
    2.根据源代码的公开情况，库可以分为2种类型
    
    a.开源库
    
    公开源代码，能看到具体实现 ,比如SDWebImage、AFNetworking
    
    b.闭源库
    
    不公开源代码，是经过编译后的二进制文件，看不到具体实现。主要分为：静态库、动态库
    
    3.静态库和动态库的存在形式
    
    静态库：以`.a` 和 `.framework`为文件后缀名。  
    动态库：以`.tbd`(之前叫`.dylib`) 和 `.framework` 为文件后缀名。
    
    .a是纯二进制文件，.a文件不能单独使用，至少要有.h文件配合，而.framework除了二进制文件外，还包含一些资源文件（头文件，plist等），由于自身包含了头文件，所以.framework可以单独使用。
    
    .a和.framework两种静态库，通常都是把需要用的到图片或者xib文件存放在一个bundle文件中，而该bundle文件的名字和.a或.framework的名字相同。
    
    ios 8 以后苹果放开了动态库。
    
    4.静态库和动态库在使用上的区别
    
    静态库：链接时会被完整的复制到可执行文件中，被多次使用就有多份拷贝。  
    动态库：链接时不复制，程序运行时由系统动态加载到内存，系统只加载一次，多个程序共用（如系统的`UIKit.framework`等），节省内存。
    
    5.创建静态库可能出于以下几个理由:
    
    1.你想将工具类代码或者第三方插件快捷的分享给其他人而无需拷贝大量文件。
    
    2.你想让一些通用代码处于自己的掌控之下，以便于修复和升级。
    
    3.你想将库共享给其他人，但不想让他们看到你的源代码。
    
    4.比如很老的框架使用的是MRC环境下面的框架，那么我们只需要将其打包成静态库就可以了，这样就不用担心是不是ARC环境了。
    
    6、iOS设备架构
    
    模拟器：  
    iPhone4s-iPnone5：i386  
    iPhone5s-iPhone7 Plus：x86\_64
    
    真机:  
    iPhone3gs-iPhone4s：     armv7  
    iPhone5-iPhone5c：        armv7s  
    iPhone5s-iPhone7 Plus： arm64
    
    支持armv7的静态库可以在armv7s上正常运行。
    
    Xcode创建静态库详解(Cocoa Touch Static Library)（本人使用的是Version 6.3）
    
    # 一、创建静态库文件(.a 文件） #
    
    打开Xcode, 选择File ----> New ---> Project。 
    
    选择iOS ----> Framework & Library ---> Cocoa Touch Static Library。
    
    点击Next。按照流程一步一步的创建工程。
    
    ![721613-20151006125143737-435795429.jpg][]
    
    ![721613-20151006125205284-938904198.jpg][]
    
     
    
    ![721613-20151006125222628-60733902.jpg][]
    
     
    
     注意静态库文件的版本(4种)
    
    1.真机-Debug版本
    
    2.真机-Release版本
    
    3.模拟器-Debug版本
    
    4.模拟器-Release版本
    
    就是在build configuration 里面进行调整一下debug和release,然后分别在真机和模拟器上面进行编译。
    
    ![721613-20151006125259534-174215269.jpg][]
    
    结果如下图：
    
     ![721613-20151006125308112-926849718.jpg][]
    
    调试版本(Debug版本) VS 发布版本(Release版本)
    
    \--------------------------------------------------------------------------------
    
    \- 调试版本会包含完整的符号信息，以方便调试
    
    \- 调试版本不会对代码进行优化
    
     
    
    \- 发布版本不会包含完整的符号信息
    
    \- 发布版本的执行代码是进行过优化的
    
    \- 发布版本的大小会比调试版本的略小
    
    \- 在执行速度方面，调试版本会更快些，但不意味着会有显著的提升
    
     所以我们建议在产品即将上线的时候要进行如下图的调整：
    
    ![721613-20151006125320612-1746272243.jpg][]
    
    ![721613-20151006125331440-1707404363.jpg][]
    
    # 二、应用静态库文件(.a 文件） #
    
    1.想让静态库文件給别人使用，需要将头文件暴露給别人。按着下面的步骤将头文件添加进来。
    
    ![721613-20151006143222753-1004399607.png][]
    
    ![721613-20151006143244268-1132120790.png][]
    
    再点击libstatic.a右击show In Finder 就可以查看如下图：
    
    ![721613-20151006143257315-1673445238.png][]
    
    2.然后将静态库拖进项目中。就能利用头文件了
    
    ![721613-20151006143310237-307457149.png][] ![721613-20151006144533487-1571360522.png][]
    
    3.因为无论是模拟器还是真机都有不同的架构。所以经常会出现如下找不到某个架构的错误
    
    ![721613-20151006144647799-1209506933.jpg][]
    
    为了解决各个机型的模拟器都能用可以有2种方法：
    
    1.合并各个静态库(在终端中执行如下操作）
    
    ![721613-20151006151056565-1076183178.png][]
    
    $ cd /Users/XQ/Library/Developer/Xcode/DerivedData/static-bdsgvzfqigaspiaeivnhmmygrhgj/Build/Products/Release-iphonesimulator5s 
    
    $ lipo -info libstatic.a 
    
    Architectures in the fat file: libstatic.a are: i386 x86\_64 
    
    $ cd /Users/XQ/Library/Developer/Xcode/DerivedData/static-bdsgvzfqigaspiaeivnhmmygrhgj/Build/Products/Release-iphonesimulator6 
    
    $ lipo -info libstatic.a 
    
    Architectures in the fat file: libstatic.a are: i386 x86\_64
    
     1》.我们可以cd到.a文件所在文件夹的当前目录
    
     2》.再执行 lipo -info 静态库.a文件
    
    这样就可以查询该静态库支持的架构是什么。
    
    回到.a文件所在文件夹所在的文件夹目录：cd ..
    
    $ cd ..
    
    $ pwd
    
    /Users/XQ/Library/Developer/Xcode/DerivedData/static-bdsgvzfqigaspiaeivnhmmygrhgj/Build/Products
    
     
    
    ![721613-20151006151858253-1042070745.png][]
    
    合并2个静态库
    
    $ cd ..
    
    $ pwd
    
    /Users/XQ/Library/Developer/Xcode/DerivedData/static-bdsgvzfqigaspiaeivnhmmygrhgj/Build/Products
    
    $ lipo -create Release-iphonesimulator5s/libstatic.a  Release-iphonesimulator6/libstatic.a \-output lib.a
    
    fatal error: /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/lipo: Release-iphonesimulator5s/libstatic.a and Release-iphonesimulator6/libstatic.a have the same architectures (i386) and can't be in the same fat output file
    
    由于2个静态库都含有相同的架构，所以出现错误,因为我们合并的是Release-iphonesimulator6和Release-iphonesimulator5s之间的版本，都是模拟器的。其实我们在制作静态库的时候，无论是在模拟器还是真机的时候，设置[Build Active Architecture Only][Build_Active_Architecture_Only]为no的话，一次打包，如果是模拟器就会适用所有机型的模拟器，如果是真机就会适用所有机型的真机。实际上我们通常合并的是模拟器和真机的静态库。模拟器和真机版本合并完后，我们姑且称之为“合并版本”吧，那么分别会有debug合并版本和release合并版本，通常我们会在上线前将debug合并版本换成relaese合并版本（当然release合并版本会支持模拟器和真机）。目前还没找到release合并版本和debug合并版本合并的方法（估计有，但是不会是这么简单的合并）。
    
    合并模拟器和真机的静态库,步骤如下：
    
    合并前：
    
    ![721613-20151006155121721-438176110.png][]
    
    $ cd /Users/XQ/Library/Developer/Xcode/DerivedData/static-bdsgvzfqigaspiaeivnhmmygrhgj/Build/Products/Debug-iphonesimulator 
    
    $ lipo -info libstatic.a 
    
    input file libstatic.a is not a fat file
    
    Non-fat file: libstatic.a is architecture: x86\_64
    
    $ cd /Users/XQ/Library/Developer/Xcode/DerivedData/static-bdsgvzfqigaspiaeivnhmmygrhgj/Build/Products/Debug-iphoneos
    
    $ lipo -info libstatic.a 
    
    Architectures in the fat file: libstatic.a are: armv7 arm64 
    
    $ cd ..
    
    $ pwd
    
    /Users/XQ/Library/Developer/Xcode/DerivedData/static-bdsgvzfqigaspiaeivnhmmygrhgj/Build/Products
    
    $ lipo -create Debug-iphonesimulator/libstatic.a Debug-iphoneos/libstatic.a \-output lib.a
    
     合并后：
    
    ![721613-20151006155145237-907932313.png][]
    
    合并后的lib.a同时支持：armv7 x86\_64 arm64 架构。（可以看出在制作模拟器的静态库的时候并没有设置[Build Active Architecture Only][Build_Active_Architecture_Only]为no）
    
    $ cd /Users/XQ/Library/Developer/Xcode/DerivedData/static-bdsgvzfqigaspiaeivnhmmygrhgj/Build/Products 
    
    $ pwd
    
    /Users/XQ/Library/Developer/Xcode/DerivedData/static-bdsgvzfqigaspiaeivnhmmygrhgj/Build/Products
    
    $ lipo -info lib.a 
    
    Architectures in the fat file: lib.a are: armv7 x86\_64 arm64 
    
     2.可以通过配置
    
    ![721613-20151006155929987-2083717529.png][]
    
     
    
    小结一下：
    
     1.编译静态库:项目->Build Phases->Copy File->添加头文件
    
     2.模拟器编译时,挑选高版本(向下兼容,低版本不能在高版本运行)
    
     3.静态库分真机版本和模拟器版本(必须在对应的版本运行)
    
     4.合并真机版本和模拟器版本（常用）
    
     lipo -create 真机.a 模拟器.a -output 结果.a
    
     合并版本更大,开始时使用方便(所以可以开发时使用合并版本,发布时,使用真机版本)
    
     5.release版本和debug版本:
    
     debug版本:调试版本,没有任何优化,也就是说各种错误信息,都将抛出和检测,相对来说性能低一点,但是方便调试
    
     release版本:发布版本,进行了优化,执行效率更高
    
     提醒:实际开发当中,项目完成后,在debug版本上没有问题了,一定要去release版本上调试一下,否则也许可能发生一些bug。
    
    # 三、调试静态库文件(.a 文件） #
    
    因为静态库也是需要不断的开发，调试，最终才能完美，所以我们应该是不断的开发，不断的调试，那么像上面的那种方式直接建立一个静态库项目就很麻烦，所以我们应该是在某一个项目中添加一个静态库文件，那么就可以做到不断开发，不断调试。
    
     1.添加静态库target:项目->General->左下角+->添加静态库(StaticLib)
    
     2.在StaticLib文件夹内就可以就行开发静态库
    
     3.项目引入静态库:项目->General->Linked Frameworks and Libraries->添加静态库
    
     4.导出静态库:选择左上角房子->同之前导出方式（也就是分别在模拟器和真机上面进行编译）。
    
    ![721613-20151006160900237-711025088.jpg][]
    
    ![721613-20151006162007190-431277632.png][]
    
    ![721613-20151006162353909-1485224537.png][]
    
     
    
    (注意：如果是动态库的话，上面的Embedded Binaries 也要导入相应的库 )
    
    总体思路是我们在项目中新添加静态库target，然后在项目中导入静态库文件，这个时候scheme选中原本项目（注意是项目），进行编译看是否通过。所以我们可以通过这样的方法进行调试静态库，如果真的调试到没有错误的时候，可以将scheme处选择成小房子（静态库），然后编译就可以生成相应的静态库。这样我们就可以边开发边经行静态库的调试。
    
    2017.1.24增加脚本打包方法如下：
    
    建立一个Aggregate target  (使用Xcode Version 8.2.1 (8C1002))
    
    从上面可以看出来，因为.a库是会生成模拟器和真机两个不同的包的，下面尝试利用脚本来合成。
    
    1、我们先按照上面的步骤流程建立一个.a静态库(单独的静态库)yooweiSDKTest
    
    2、建立一个Aggregate target，在Aggregate里面执行脚本。
    
    ![721613-20170124180149097-801881146.png][]
    
    3、新建一个运行脚本
    
    ![721613-20170124181248159-1577036069.png][]
    
    4、接下来我们就可以在Run Script里写我们的脚本了
    
    ![721613-20170124181430784-1634526467.png][]
    
    把下面的脚本复制到Run Script里面：
    
        if [ "${ACTION}" = "build" ] then #要build的target名 target_Name=${PROJECT_NAME} echo "target_Name=${target_Name}" #build之后的文件夹路径 build_DIR=${SRCROOT}/build echo "build_DIR=${build_DIR}" #真机build生成的头文件的文件夹路径 DEVICE_DIR_INCLUDE=${build_DIR}/Release-iphoneos/include/${PROJECT_NAME} echo "DEVICE_DIR_INCLUDE=${DEVICE_DIR_INCLUDE}" #真机build生成的.a文件路径 DEVICE_DIR_A=${build_DIR}/Release-iphoneos/lib${PROJECT_NAME}.a echo "DEVICE_DIR_A=${DEVICE_DIR_A}" #模拟器build生成的.a文件路径 SIMULATOR_DIR_A=${build_DIR}/Release-iphonesimulator/lib${PROJECT_NAME}.a echo "SIMULATOR_DIR_A=${SIMULATOR_DIR_A}" #目标文件夹路径 INSTALL_DIR=${SRCROOT}/Products/${PROJECT_NAME} echo "INSTALL_DIR=${INSTALL_DIR}" #目标头文件文件夹路径 INSTALL_DIR_Headers=${SRCROOT}/Products/${PROJECT_NAME}/Headers echo "INSTALL_DIR_Headers=${INSTALL_DIR_Headers}" #目标.a路径 INSTALL_DIR_A=${SRCROOT}/Products/${PROJECT_NAME}/lib${PROJECT_NAME}.a echo "INSTALL_DIR_A=${INSTALL_DIR_A}" #判断build文件夹是否存在，存在则删除 if [ -d "${build_DIR}" ] then rm -rf "${build_DIR}" fi #判断目标文件夹是否存在，存在则删除该文件夹 if [ -d "${INSTALL_DIR}" ] then rm -rf "${INSTALL_DIR}" fi #创建目标文件夹 mkdir -p "${INSTALL_DIR}" #build之前clean一下 xcodebuild -target ${target_Name} clean #模拟器build xcodebuild -target ${target_Name} -configuration Release -sdk iphonesimulator #真机build xcodebuild -target ${target_Name} -configuration Release -sdk iphoneos #复制头文件到目标文件夹 cp -R "${DEVICE_DIR_INCLUDE}" "${INSTALL_DIR_Headers}" #合成模拟器和真机.a包 lipo -create "${DEVICE_DIR_A}" "${SIMULATOR_DIR_A}" -output "${INSTALL_DIR_A}" #打开目标文件夹 open "${INSTALL_DIR}" fi
    
    5、运行程序
    
    注意scheme选择yooweiShell,之后正常的run就行了。编译成功以后，如下：
    
    ![721613-20170124182031269-41971650.png][]
    
    我们这个脚本，将合成后的.a库和头文件都按照我们想要的方式放好了。其他工程要用这个SDK的话，既可以直接拉MySDK文件夹过去就可以了。如果你想要其他的放法，比如不要Headers文件夹，那就，改一下脚本就可以了。
    
    6、验证
    
    在终端使用命令 “lipo -info .a文件路径”查看
    
    $ lipo -info /Users/galahad/Downloads/yooweiSDKTest/Products/yooweiSDKTest/libyooweiSDKTest.a
    
    Architectures in the fat file: /Users/galahad/Downloads/yooweiSDKTest/Products/yooweiSDKTest/libyooweiSDKTest.a are: armv7 i386 x86\_64 arm64
    
    说明成功了
    
    7、脚本解释
    
    本代码中用到的核心命令：xcodebuild  ，主要用来编译Xcode的工程。可以在终端中输入`xcodebuild -h`来查看命令的详情
    
    介绍一下本脚本中用到的几个参数：
    
     *   *  `clean`  
            clean一下工程
         *  `-configuration Release`  
            使用`Release`方式编译，还可以使用`Debug`
         *  `-sdk iphoneos`  
            真机编译，还可以使用`-sdk iphonesimulator`模拟器编译
    
     *   *  `cp "源文件路径" "目标文件路径"`  
            复制"源文件路径"的文件到 "目标文件路径"
         *  `lipo -create "模拟器.a文件路径" "真机.a文件路径" -output "目标.a文件路径"`  
            将模拟器和真机的.a包合成。
    
    用到的一些shell脚本基础命令：
    
    `（1）echo "想要查看的日志或重要东西" `，echo相当于OC中的NSLog。运行脚本后，可以在这里找到log
    
    ![721613-20170124183237691-1617536050.png][]
    
    （2）`变量名=变量值  `
    
    ``赋值命令。比如将"CrazyStone"赋值给MyName变量
    
    `MyName=CrazyStone`
    
     (3)`${变量名}  `
    
    ``取出变量名的内容。比如：取出变量MyName中的内容
    
    `${MyName}`
    
     (4)判断语句
    
        if [ 条件语句 ]then ... fi
    
    `条件语句`为真就执行`then`后面的语句，不成立就结束判断语句  
    本脚本中用到的判断语句：  
    `[ -d "文件夹路径" ]` ：判断是否为文件夹
    
     
    
    ## 脚本结构解释 ##
    
    看完上面，我想你再看一下代码应该就能理解脚本，然后可以做一些简单的改动了。下面再介绍一下脚本的结构。
    
        if [ "${ACTION}" = "build" ] then #我们的大部分脚本代码 fi
    
    执行脚本的时候做个判断，在Xcode里面build这个工程的时候就执行then后面的脚本
    
        #要build的target名 target_Name=${PROJECT_NAME} echo "target_Name=${target_Name}"
    
    变量`target_Name`是我们要编译的target的名字，在这里指的是工程的名字`${PROJECT_NAME}`，也就是yoowei`SDKTest`。  
    顺便说一下，`ACTION`和`PROJECT_NAME`都是Xcode里面定义的，这是在Xcode里面写脚本的一个好处。
    
        #build之后的文件夹路径 build_DIR=${SRCROOT}/build echo "build_DIR=${build_DIR}" #真机build生成的头文件的文件夹路径 DEVICE_DIR_INCLUDE=${build_DIR}/Release-iphoneos/include/${PROJECT_NAME} echo "DEVICE_DIR_INCLUDE=${DEVICE_DIR_INCLUDE}" #真机build生成的.a文件路径 DEVICE_DIR_A=${build_DIR}/Release-iphoneos/lib${ PROJECT_NAME}.a echo "DEVICE_DIR_A=${DEVICE_DIR_A}" #模拟器build生成的.a文件路径 SIMULATOR_DIR_A=${build_DIR}/Release-iphonesimulator/lib${ PROJECT_NAME}.a echo "SIMULATOR_DIR_A=${SIMULATOR_DIR_A}"
    
    这里是定义的build之后各个文件的路径。我们执行了`xcodebuild`命令之后，会在工程目录生成一个build文件夹，里面有build之后生成的文件。打开Finder看看就知道各个文件的路径了。
    
    ![721613-20170124184542581-970932039.png][]  
    
    
    build目录的位置
    
        #目标文件夹路径 INSTALL_DIR=${SRCROOT}/Products/${PROJECT_NAME} echo "INSTALL_DIR=${INSTALL_DIR}" #目标头文件文件夹路径 INSTALL_DIR_Headers=${SRCROOT}/Products/${PROJECT_NAME}/Headers echo "INSTALL_DIR_Headers=${INSTALL_DIR_Headers}" #目标.a路径 INSTALL_DIR_A=${SRCROOT}/Products/${PROJECT_NAME}/lib${PROJECT_NAME}.a echo "INSTALL_DIR_A=${INSTALL_DIR_A}"
    
    这里就是定义目标变量的路径了。你想把文件放在哪里？在这里定义咯。`${SRCROOT}`表示工程的根目录。用了这么久的Xcode，这个有用过吧(全局头文件配置过吧？)？
    
        #判断build文件夹是否存在，存在则删除 if [ -d "${build_DIR}" ] then rm -rf "${build_DIR}" fi #判断目标文件夹是否存在，存在则删除该文件夹 if [ -d "${INSTALL_DIR}" ] then rm -rf "${INSTALL_DIR}" fi #创建目标文件夹 mkdir -p "${INSTALL_DIR}"
    
    这里就是文件的操作了。如果有这两个文件夹，就删除掉。为什么？为了保证我们工程的纯净啊。
    
        #build之前clean一下 xcodebuild -target ${target_Name} clean #模拟器build xcodebuild -target ${target_Name} -configuration Release -sdk iphonesimulator #真机build xcodebuild -target ${target_Name} -configuration Release -sdk iphoneos
    
    这里就跟平常操作一样了。先clean一下工程，然后模拟器编译一次，真机编译一次。
    
        #复制头文件到目标文件夹 cp -R "${DEVICE_DIR_INCLUDE}" "${INSTALL_DIR_Headers}" #合成模拟器和真机.a包 lipo -create "${DEVICE_DIR_A}" "${SIMULATOR_DIR_A}" -output "${INSTALL_DIR_A}"
    
    关键代码。拷贝头文件到我们的目标位置去。合成.a包。大功告成。
    
        #打开目标文件夹 open "${INSTALL_DIR}"
    
    最后，打开文件夹。检查一下文件是否真正生成了。
 *

如果你想将你开发的控件与别人分享，一种方法是直接提供源代码文件。然而，这种方法并不是很优雅。它会暴露所有的实现细节，而这些实现你可能并不想开源出来。此外，开发者也可能并不想看到你的所有代码，因为他们可能仅仅希望将你的这份漂亮代码的一部分植入自己的应用中。

另一种方法是将你的代码编译成静态库（library），让其他开发者添加到自己的项目中。然而，这需要你一并公布所有的公开的头文件，实在是非常不方便。

你需要一种简单的方法来编译你的代码，这种方法应该使得你的代码易分享，并且在多个工程中易复用。你需要的是一种方法来打包你的静态库，将所有的头文件放到一个单元中，这样你就可以立刻将其加入到你的项目中并使用。

非常幸运，这正是本篇教程所要解决的问题。你将会学到制作并使用Framework，帮助你解决这个头疼的问题。OS X完美地支持这一点，因为Xcode就提供了一个项目模板，包含着默认构建目标（target）和可以容纳类似于图片、声音、字体等资源的文件。你可以为iOS创建Framework，不过这是一个比较复杂的手工活，如果你跟着教程走，你将学到怎么样跨过路障，顺利地完成Framework的创建。

当你跟着这篇教程走完后，你将能够：

*  使用Xcode构建一个基本的静态库工程。
 *  依赖于该静态库工程构建一款应用。
 *  掌握如何将静态库工程转换为完整的、合格的Framework。
 *  最终，你将看到如何将一个图像文件同Framework一起打包到resource bundle下。

## 开始 ##

这篇教程的主要目的是解释怎么样在你的iOS工程中创建并使用一个Framework。所以，不像其他网站上的教程，这篇教程将只使用一小部分Objective-C代码，并且这一小部分主要是为了说明我们将会遇到的一些概念。

从[这里][Link 1]下载可用的资源文件RWKnobControl。如果你在Creating a Static Library Project 这篇文章中完成了创建第一个项目的过程，这里你将会看到怎么样使用去它们。

在创建本工程时，你将要创建的所有的代码和项目文件都可以在[Github][]上找到。对于本篇教程中每个创建阶段都有不同的commit。

## 什么是Framework？ ##

Framework是资源的集合，将静态库和其头文件包含到一个结构中，让Xcode可以方便地把它纳入到你的项目中。

在OS X上，可能会创建一个[动态连接][Link 2]（Dynamically Linked）的framework。通过动态连接，framework可以更新，不需要应用重新连接。在运行时，库中代码的一份拷贝被分享出来，整个工程都可以使用它，因此，这样减少了内存消耗，提高了系统的性能。正如你看到的，这是一个功能强大的特性。

在iOS上，你不能用这种方式添加为系统添加自定义的framework，因此仅有的动态链接的framework只能是Apple提供的那些。（编者注：在iOS 8中已加入此特性，开发者可以使用第三方的动态框架）

然而，这并不意味着framework对于iOS而言是无关紧要的，[静态连接][Link 3]的framework依然可以打包代码，使其在不同的应用中复用。

由于framework本质上是静态库的“一站式采购点”，因此在本篇教程中你所做的第一件事就是创建并使用静态库。当跟着教程走到如何创建framework时，你就能明白你所做的一切了，整体思路也不会那么烟雾缭绕了。

## 创建一个静态库工程 ##

打开Xcode，点击File\\New\\Project，选择iOS\\Framework and Library\\Cocoa Touch Static Library新建一个静态库工程.

![ios\_framework\_creating\_static\_lib-700x482.png][ios_framework_creating_static_lib-700x482.png]

将工程命名为RWUIControls，然后将工程保存到一个空目录下。

![ios\_framework\_options\_for\_static\_lib-700x476.png][ios_framework_options_for_static_lib-700x476.png]

一个静态库工程由头文件和实现文件组成，这些文件将被编译为库本身。

为了方便其他开发者使用你的库和framework，你将进行一些操作，让他们仅需要导入一个头文件便可以访问所有你想公开的类。

当创建静态库工程时，Xcode会自动添加RWUIControls.h和RWUIControls.m。你不需要实现文件，因此右键单击RWUIControls.m选择delete，将它删除到废纸篓中。

打开RWUIControls.h，将所有内容替换为：

<table style="border-spacing:0px;width:1256.625px;"> 
 <tbody> 
  <tr> 
   <td style="margin:0px;"> 
    <div style="padding:0px;margin:0px;">
      1 
    </div></td> 
   <td style="margin:0px;"> 
    <div style="padding:24px 24px 0px;margin:0px auto;width:1216px;"> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">#import&nbsp;&lt;&nbsp;UIKit/UIKit.h&gt;</code> 
     </div> 
    </div></td> 
  </tr> 
 </tbody> 
</table>

导入UIKit的头文件，这是创建一个库所需要的。当你在创建不同的组成类时，你将会将它们添加到这个文件中，确保它们能够被库的使用者获取到。

你所构建的项目依赖于UIKit，然而Xcode的静态库工程不会自动连接到UIKit。要解决这个问题，就要将UIKit作为依赖库添加到工程中。在工程导航栏中选择工程名，然后在中央面板中选择RWUIControls目标。

点击BuildPhases，展开Link Binary with Libraries这一部分，点击+添加一个新的framework，找到UIKit.framework，点击add添加进来。

![ios\_framework\_add\_uikit\_dependency.gif][ios_framework_add_uikit_dependency.gif]

如果不结合头文件，静态库是没有用的，静态库编译一组文件，在这些文件中类和方法都以二进制数据的形式存在。在你创建的库中，有些类将能够被公开访问到，有些类只能由库内部访问并使用。

接下来，你需要在build栏中添加新的phase，来包含所有头文件，并将它们放到编译器可以获取到的某个地方。然后，你将会拷贝这些到你的framework中。

依然是在Xcode的Build Phases界面，选择Editor\\Add Build Phase\\Add Copy Headers Build Phase。

Note：如果你发现按上面找到的菜单项是灰色的（不可点击的），点击下方Build Phases界面的白色区域来获取Xcode的应用焦点，然后重新试一下。

![ios\_framework\_add\_copy\_headers\_build\_phase.gif][ios_framework_add_copy_headers_build_phase.gif]

把RWUIControls.h从项目导航栏中拖到中央面板的Copy Headers下的Public部分。这一步确保任何使用你的库的用户均可以获取该头文件。

![ios\_framework\_add\_header\_to\_public.gif][ios_framework_add_header_to_public.gif]

Note：显然，所有包含在你的公共头文件中的头文件必须是对外公开的，这一点非常重要。否则，开发者在使用你的库时会得到编译错误。如果Xcode在读取公共头文件时不能读到你忘记设为public的头文件，这实在是太令人沮丧了。

## 创建一个UI控件 ##

既然你已经设置好你的工程了，是时候为你的库添加一些功能了。由于本篇教程的关键在于教你怎么样创建一个framework，而不是怎么样构建一个UI控件，这里你将使用上一篇教程中创建好的控件。在你之前下载好的压缩包文件中找到RWKnobControl目录，从Finder中拖到Xcode下RWUIControls目录下。

![ios\_framework\_drop\_rwuiknobcontrol\_from\_finder-700x466.png][ios_framework_drop_rwuiknobcontrol_from_finder-700x466.png]

选择Copy items into destination group’s folder，点击下方的选择框，确保RWUIControls静态库目标被选中。

![ios\_framework\_import\_settings\_for\_rwknobcontrol-700x475.png][ios_framework_import_settings_for_rwknobcontrol-700x475.png]

这一步默认把实现文件添加到编译列表，把头文件添加到Project组。这意味着它们目前是私有的。

![ios\_framework\_default\_header\_membership-700x327.png][ios_framework_default_header_membership-700x327.png]

Note：在你弄清楚之前，这三个组的名称可能会让你迷惑，Public是你期望的，Private下的头文件依然是可以暴露出来的，因此名字可能有些误导。讽刺的是，在Project下的头文件对你的工程来说才是“私有”的，因此，你将会更多地希望你的头文件或者在Public下，或者在Project下。

现在，你需要将控件的头文件RWKnobControl.h分享出来，有几种方式可以实现这一点，首先是在Copy Headers面板中将这个头文件从Project栏拖到Public栏。

![ios\_framework\_drag\_header\_to\_public.gif][ios_framework_drag_header_to_public.gif]

或者，你可能会发现，更简单的方法是，编辑文件，改变Target Membership面板下的membership。这个选项更方便一些，可以让你不断添加文件，扩充你的库。

![ios\_framework\_header\_membership-407x320.png][ios_framework_header_membership-407x320.png]

Note：如果你不断往库中添加新的类，记得及时更新这些类的关系（membership），使尽可能少的类成为public，并确保其他非public的头文件都在Project下。

对你的控件的头文件需要做的另一件事是将其添加到库的主头文件RWControls.h中。在这个主头文件的帮助下，开发者使用你的库仅仅需要导入一个头文件，如下面的代码一样，而不是自己去选择自己需要的一块导入。

<table style="border-spacing:0px;width:1256.625px;"> 
 <tbody> 
  <tr> 
   <td style="margin:0px;"> 
    <div style="padding:0px;margin:0px;">
      1 
    </div></td> 
   <td style="margin:0px;"> 
    <div style="padding:24px 24px 0px;margin:0px auto;width:1216px;"> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">#import&nbsp;&lt;&nbsp;RWUIControls/RWUIControls.h&gt;</code> 
     </div> 
    </div></td> 
  </tr> 
 </tbody> 
</table>

因此，在RWUIControls.h中添加下面的代码：

## 配置Build Settings ##

现在距离构建这个项目、创建静态库已经非常接近了。不过，这里要先进行一些配置，让我们的库对于用户来说更友好。

首先，你需要提供一个目录名，表示你将把拷贝的公共头文件存放到哪里。这样确保当你使用静态库的时候可以定位到相关头文件的位置。

在项目导航栏中点击项目名，然后选择RWUIControls静态库目标，选择Build Setting栏，然后搜索public header，双击Public Headers Folder Path，在弹出视图中键入如图所示内容：

![ios\_framework\_public\_headers\_path-700x174.png][ios_framework_public_headers_path-700x174.png]

一会你就会看到这个目录了。

现在你需要改变一些其他的设置，尤其是那些在二进制库中遗留下的设置，编译器提供给你一个选项，来消除无效代码：永远不会被执行的代码。当然你也可以移除掉一些debug用符号，例如某些函数名称或者其他跟debug相关的细节。

因为你正在创建framework供他人使用，最好禁掉这些功能（无效代码和debug用符号），让用户自己选择对自己的项目有利的部分使用。和之前一样，使用搜索框，改变下述设置：

*  Dead Code Stripping设置为NO
 *  Strip Debug Symbol During Copy 全部设置为NO
 *  Strip Style设置为Non-Global Symbols

编译然后运行，到目前为止没什么可看的，不过确保项目可以成功构建，没有错误和警报是非常好的。

选择目标为iOS Device，按下command + B进行编译，一旦成功，工程导航栏中Product目录下libRWUIControls.a文件将从红色变为黑色，表明现在该文件已经存在了。右键单击libRWUIControls.a，选择Show in Finder。

![ios\_framework\_successful\_first\_build-700x454.png][ios_framework_successful_first_build-700x454.png]

再此目录下，你将看到静态库，libRWUIControls.a，以及其他你为头文件指定的目录。注意到，正如你所期望的，那些定为public的头文件可以在此看到。

## 创建一个依赖开发（Dependent Development）工程 ##

在无法看到真实效果的情况下为iOS开发一个UI控件库是极其困难的，而这是我们现在面临的问题。

没有人期望你闭着眼睛开发出一个UI控件，因此在这一部分你将创建一个新的Xcode工程，该工程依赖于你刚刚创建好的库。这意味着允许你使用示例app创建一个framework。当然，这部分代码将和库本身完全分离，结构会非常清晰。

选择File\\Close Project关闭之前的静态库工程，使用File\\New\\Project创建一个新的工程，选择iOS\\Application\\Single View Application，将新工程命名为UIControlDevApp，将类前缀命名为RW，选择该工程只支持iPhone，最后将项目保存到和之前的RWUIControls相同的目录下。

添加RWUIControls依赖库，将RWUIControls.xcodeproj从Finder中拖到Xcode中UIControlDevApp组下。

![ios\_framework\_import\_library\_into\_dev\_app-700x357.png][ios_framework_import_library_into_dev_app-700x357.png]

现在你可以在你的工程中导航到库工程了，这样做非常好，因为这样意味着你可以在库中编辑代码，并且运行示例工程来测试你做的改变。

Note：你无法将同一工程在两个Xcode窗口中同时打开，如果你发现你无法在你的工程中导航到库工程的话，检查一下是否库工程在其他Xcode窗口中打开了。

这里你可以拷贝代码，而不是和上一个教程似的重新创建代码。首先，选择Main.storyboard, RWViewController.h 和 RWViewController.m，然后右键单击，选择Delete，将它们删除到废纸篓中。然后，将你之前下载的压缩文件中DevApp文件夹拷贝到Xcode的UIControlDevApp组下。

![ios\_framework\_adding\_files\_to\_dev\_app.gif][ios_framework_adding_files_to_dev_app.gif]

现在，你将添加静态库作为实例项目的依赖库：

*  在项目导航栏中选择UIControlDevApp。
 *  导航到UIControlDevApp目标下Build Phases面板下。
 *  打开Target Dependencies面板，点击+按钮调出选择器。
 *  找到RWUIControls静态库，选择并点击Add。这一步表明当构建dev应用时，Xcode会检查是否静态库需要重新构建。

为了连接到静态库本身，展开Link Binary With Libraries面板，再次点击+按钮，从Workspace组中选择libRWUIControls.a然后点击Add。

这一步确保Xcode可以连接到静态库，就像连接到系统framework（例如UIKit）一样。

![ios\_framework\_add\_dependencies\_to\_dev\_app.gif][ios_framework_add_dependencies_to_dev_app.gif]

编译并运行，如果你按照之前的教程创建了一个旋钮控件，在你眼前展示的将是与之相同的应用。

![ios\_framework\_dev\_app\_buildrun1-333x500.png][ios_framework_dev_app_buildrun1-333x500.png]

像这样使用嵌套工程的好处是你可以对库本身做出修改，而不用离开示例工程，即使你同时改变两个地方的代码也一样。每次你编译工程，你都要检查是否将头文件的public/project关系设置正确。如果实例工程中缺失了任何需要的头文件，它都不能被编译。

## 创建一个Framework ##

到现在，你可能迫不及待地点着脚趾头，想着什么时候framework可以出来。可以理解，因为到现在为止你已经做了许多工作，然而却没有看到过framework的身影。

现在该有所改变了，你之所以到现在都没有创建一个framework，是因为framework本身就是静态库加上一组头文件——实际上正是你已经创建好的东西。

当然，framework也有几点不同之处：

1.  目录结构。Framework有一个能被Xcode识别的特殊的目录结构，你将会创建一个build task，由它来为你创建这种结构。
2.  片段（Slice）。目前为止，当你构建库时，仅仅考虑到当前需要的结构（architecture）。例如，i386、arm7等，为了让一个framework更有用，对于每一个运行framework的结构，该framework都需要构建这种结构。一会你就会创建一个新的工程，构建所有需要的结构，并将它们包含到framework中。

这一部分非常神奇，不过我们会慢慢地来。实际上它并不像看起来那样复杂。

## Framework结构 ##

正如之前提到的，一个framework有一个特殊的目录结构，看起来像是这样的：

![ios\_framework\_directory\_structure-449x320.png][ios_framework_directory_structure-449x320.png]

现在你需要在静态库构建过程中添加脚本来创建这种结构，在项目导航栏中选择RWUIControls，然后选择RWUIControls静态库目标，选择Build Phases栏，然后选择Editor/Add Build Phase/Add Run Script Build Phase来添加一个新的脚本。

![ios\_framework\_framework\_add\_run\_script\_build\_phase-700x271.png][ios_framework_framework_add_run_script_build_phase-700x271.png]

这一步在build phases部分添加了一个新的面板，这允许你在构建时运行一个Bash脚本。你希望让脚本在build的过程中何时执行，就把这个面板拖动到列表中相对应的那一位置。对于该framework工程来说，脚本最后执行，因此你可以让它保留在默认的位置即可。

![ios\_framework\_new\_run\_script\_build\_phase-700x299.png][ios_framework_new_run_script_build_phase-700x299.png]

双击面板标题栏Run Script，重命名为Build Framework。

![ios\_framework\_rename\_script-700x131.png][ios_framework_rename_script-700x131.png]

在脚本文本框中粘贴下面的Bash脚本代码

这个脚本首先创建了RWUIControls.framework/Versions/A/Headers目录，然后创建了一个framework所需要的三个连接符号（[symbolic links][]）。

*  Versions/Current => A
 *  Headers => Versions/Current/Headers
 *  RWUIControls => Versions/Current/RWUIControls

最后，将公共头文件从你之前定义的公共头文件路径拷贝到Versions/A/Headers目录下，-a参数确保修饰次数作为拷贝的一部分不会改变，防止不必要的重新编译。

现在，选择RWUIControls静态库scheme，然后选择iOS Device构建目标，然后使用cmd+B构建。

![ios\_framework\_build\_target\_static\_lib.png][ios_framework_build_target_static_lib.png]

在RWUIControls工程里Products目录下右键单击libRWUIControls.a静态库，然后再一次选择Show in Finder。

![ios\_framework\_static\_lib\_view\_in\_finder-480x295.png][ios_framework_static_lib_view_in_finder-480x295.png]

在这次构建目录中你可以看到RWUIControls.framework，可以确定一下这里展示了正确的目录结构：

![ios\_framework\_created\_framework\_directory\_structure-480x251.png][ios_framework_created_framework_directory_structure-480x251.png]

这算是在完成你的framework的过程中迈出了一大步。不过你会注意到这里并没有一个静态lib文件。这就是我们下一步将要解决的问题。

## 多架构（Multi-Architecture）编译 ##

iOS app需要在许多不同的CPU架构下运行：

*  arm7: 在最老的支持iOS7的设备上使用
 *  arm7s: 在iPhone5和5C上使用
 *  arm64: 运行于iPhone5S的64位 ARM 处理器 上
 *  i386: 32位模拟器上使用
 *  x86\_64: 64为模拟器上使用

每个CPU架构都需要不同的二进制数据，当你编译一个应用时，无论你目前正在使用那种架构，Xcode都会正确地依照对应的架构编译。例如，如果你想跑在虚拟机上，Xcode只会编译i386版本（或者是64位机的x86\_64版本）。

这意味着编译会尽可能快地进行，当你归档一款app或者构建app的发布版本（release mode）时，Xcode会构建上述三个用于真机的ARM架构。因此这样app就可以跑在所有设备上了。不过，其他的编译架构又如何呢？

当你创建你的framework时，你自然会想让所有开发者都能在所有可能的架构上运行它，不是吗？你当然想，因为这样可以从同行那儿得到尊敬与赞美。

因此你需要让Xcode在所有架构下都进行编译。这一过程实际上是创建了二进制FAT（File Allocation Table，文件配置表），它包含了所有架构的片段（slice）。

Note：这里实际上强调了创建依赖静态库的示例项目的另一个原因：库仅仅在示例项目运行所需要的架构下编译，只有当有变化的时候才重新编译，为什么这一点会让人激动？因为开发周期会尽可能地缩短。

这里将使用在RWUIControls工程中的一个新的目标来构建framework，在项目导航栏中选择RWUIControls，然后点击已经存在的目标下面的Add Target按钮。

![ios\_framework\_add\_target\_button-471x320.png][ios_framework_add_target_button-471x320.png]

找到iOS/Other/Aggregate，点击Next，将目标命名为Framework。

Note：为什么使用集合（Aggregate）目标来创建一个framework呢？为什么这么不直接？因为OS X对库的支持更好一些，事实上，Xcode直接为每一个OS X工程提供一个Cocoa Framework编译目标。基于此，你将使用集合编译目标，作为Bash脚本的连接串来创建神奇的framework目录结构。你是不是开始觉得这里的方法有些愚蠢了？

为了确保每当这个新的framework目标被创建时，静态链接库都会被编译，你需要往静态库目标中添加依赖（Dependency）。在库工程中选择Framework目标，在Build Phases中添加一个依赖。展开Target Dependencies面板，点击 + 按钮选择RWUIControls静态库。

![ios\_framework\_add\_dependency\_to\_framework\_target.gif][ios_framework_add_dependency_to_framework_target.gif]

这个目标的主要编译部分是多平台编译，你将使用一个脚本来做到这一点。和你之前做的一样，在Framework目标下，选择Build Phases栏，点击Editor/Add Build Phase/Add Run Script Build Phase，创建一个新的Run Script Build Phase。

![ios\_framework\_framework\_add\_run\_script\_build\_phase-700x271.png][ios_framework_framework_add_run_script_build_phase-700x271.png 1]

双击Run Script，重命名脚本的名字。这次命名为MultiPlatform Build。

在脚本文本框中粘贴下面的Bash脚本代码：

*  set –e确保脚本的任何地方执行失败，则整个脚本都执行失败。这样可以避免让你创建一个部分有效的framework。
 *  接着，用RW\_MULTIPLATFORM\_BUILD\_IN\_PROGRESS变量决定是否循环调用脚本，如果有该变量，则退出。
 *  然后设定一些变量。该framework的名字与项目的名字一样。也就是RWUIControls，另外，静态lib的名字是libRWUIControls.a。

接下来，用脚本设置一些函数，这些函数一会项目就会用到，把下面的代码加到脚本的底部。

*  build\_static\_library把SDK作为参数，例如iPhone7.0，然后创建静态lib，大多数参数直接传到当前的构建工作中来，不同的是设置ONLY\_ACTIVE\_ARCH来确保为当前SDK构建所有的结构。
 *  make\_fat\_library使用lipo将两个静态库合并为一个，其参数为两个静态库和结果的输出位置。从这里了解更多关于lipo的知识。

为了使用这两个方法，接下来脚本将定义更多你要用到的变量，你需要知道其他SDK是什么，例如，iphoneos7.0应该对应iphonesimulator7.0，反过来也一样。你也需要找到该SDK对应的编译目录。

把下面的代码添加到脚本的底部。

上面四句声明都非常相似，都是使用字符串比较和正则表达式来确定RW\_OTHER\_PLATFORM和RW\_OTHER\_BUILT\_PRODUCTS\_DIR。

详细解释一下上面四句声明：

1.  SDK\_NAME将指代iphoneos7.0和iphonesimulator6.1，这个正则表达式取出字符串开头不包含数字的那些字符，因此，其结果是iphoneos 或 iphonesimulator。
2.  这个正则表达式取出SDK\_NAME中表示版本用的数字，7.0或6.1等。
3.  这里用简单的字符串比较来将iphonesimulator 转换为iphoneos，反过来也一样。
4.  从构建好的工程的目录路径的末尾找出平台名称，将其替换为其他平台。这样可以确保为其他平台构建的目录可以被找到。这是将两个静态库合并的关键部分。

现在你可以启动脚本为其他平台编译，然后得到合并两静态库的结果。

在脚本最后添加下面的代码：

*  首先，调用你之前定义好的函数为其他平台编译
 *  如果你现在正在为模拟器编译，那么Xcode会默认只在该系统对应的结构下编译，例如i386 或 x86\_64。为了在这两个结构下都进行编译，这里调用了build\_static\_library，基于iphonesimulator SDK重新编译，确保这两个结构都进行了编译。
 *  最后调用make\_fat\_library将在当前编译目录下的静态lib同在其他目录下地lib合并，依次实现支持多结构的FAT静态库。这个被放到了framework中。

脚本的最后是简单的拷贝命令，将下面代码添加到脚本最后：

*  第一条命令确保framework在所有平台的编译目录中都存在。
 *  第二条将完成的framework拷贝到用户的桌面上，这一步是可选的，但我发现这样做可以很方便的存取framework。

选择Framework集合方案（aggregate scheme），按下cmd+B编译该framework。

![ios\_framework\_select\_framework\_aggregate\_scheme-480x135.png][ios_framework_select_framework_aggregate_scheme-480x135.png]

这一步将构建并在你的桌面上存放一个RWUIControls.framework。

![ios\_framework\_built\_framework\_on\_desktop-700x319.png][ios_framework_built_framework_on_desktop-700x319.png]

为了检查一下我们的多平台编译真的成功了，启动终端，导航到桌面上的framework，像下面一样：

第一条指令导航到framework中，第二行使用lipo指令从RWUIControls静态库中得到需要的信息，这将列出存在于该库中的所有片段。

![ios\_framework\_architectures\_in\_fat\_library-700x257.png][ios_framework_architectures_in_fat_library-700x257.png]

这里你可以看到，一共有五种片段：i386, x86\_64, arm7, arm7s 和 arm64，正如你在编译时设定的那样。如果你之前使用lipo –info指令，你可以看到这些片段的一个分组。

## 如何使用Framework？ ##

OK，你已经有了framework，你也有了库。它们可以提供一种优雅的方法来解决你迄今为止还没有遇到过的问题，但是做这些的意义是什么呢？

使用framework的其中一个主要的优点是简化使用，现在你将创建一个简单的iOS应用，并使用你刚刚创建好的RWUIControls.framework。

使用Xcode创建一个新工程，选择File/New/Project，然后选择iOS/Application/Single View Application，将新工程命名为ImageViewer，设置为仅仅用于iPhone，将其保存到与之前两个工程同样的目录下。这个应用将展示一张图片，允许用户使用RWKnobControl旋转图片。

在你之前下载的压缩文件中找到ImageViewer目录，这里面只有一个图片文件，把这个图片文件sampleImage.jpg从Finder中拖到Xcode的ImageViewer组中。

![ios\_framework\_drag\_sample\_image\_into\_xcode-480x299.png][ios_framework_drag_sample_image_into_xcode-480x299.png]

选中Copy items into destination group’s folder，点击Finish完成导入操作。

导入一个framework的步骤几乎相同，将RWUIControls.framework从桌面拖到Xcode中的Frameworks组下。同样，确保选中了Copy items into destination group’s folder。

![ios\_framework\_import\_framework.gif][ios_framework_import_framework.gif]

打开RWViewController.m，将里面的代码替换为下面的代码：

<table style="border-spacing:0px;width:1259.40625px;"> 
 <tbody> 
  <tr> 
   <td style="margin:0px;"> 
    <div style="padding:0px;margin:0px;">
      1 
    </div> 
    <div style="padding:0px;margin:0px;">
      2 
    </div> 
    <div style="padding:0px;margin:0px;">
      3 
    </div> 
    <div style="padding:0px;margin:0px;">
      4 
    </div> 
    <div style="padding:0px;margin:0px;">
      5 
    </div> 
    <div style="padding:0px;margin:0px;">
      6 
    </div> 
    <div style="padding:0px;margin:0px;">
      7 
    </div> 
    <div style="padding:0px;margin:0px;">
      8 
    </div> 
    <div style="padding:0px;margin:0px;">
      9 
    </div> 
    <div style="padding:0px;margin:0px;">
      10 
    </div> 
    <div style="padding:0px;margin:0px;">
      11 
    </div> 
    <div style="padding:0px;margin:0px;">
      12 
    </div> 
    <div style="padding:0px;margin:0px;">
      13 
    </div> 
    <div style="padding:0px;margin:0px;">
      14 
    </div> 
    <div style="padding:0px;margin:0px;">
      15 
    </div> 
    <div style="padding:0px;margin:0px;">
      16 
    </div> 
    <div style="padding:0px;margin:0px;">
      17 
    </div> 
    <div style="padding:0px;margin:0px;">
      18 
    </div> 
    <div style="padding:0px;margin:0px;">
      19 
    </div> 
    <div style="padding:0px;margin:0px;">
      20 
    </div> 
    <div style="padding:0px;margin:0px;">
      21 
    </div> 
    <div style="padding:0px;margin:0px;">
      22 
    </div> 
    <div style="padding:0px;margin:0px;">
      23 
    </div> 
    <div style="padding:0px;margin:0px;">
      24 
    </div> 
    <div style="padding:0px;margin:0px;">
      25 
    </div> 
    <div style="padding:0px;margin:0px;">
      26 
    </div> 
    <div style="padding:0px;margin:0px;">
      27 
    </div> 
    <div style="padding:0px;margin:0px;">
      28 
    </div> 
    <div style="padding:0px;margin:0px;">
      29 
    </div> 
    <div style="padding:0px;margin:0px;">
      30 
    </div> 
    <div style="padding:0px;margin:0px;">
      31 
    </div> 
    <div style="padding:0px;margin:0px;">
      32 
    </div> 
    <div style="padding:0px;margin:0px;">
      33 
    </div> 
    <div style="padding:0px;margin:0px;">
      34 
    </div> 
    <div style="padding:0px;margin:0px;">
      35 
    </div> 
    <div style="padding:0px;margin:0px;">
      36 
    </div> 
    <div style="padding:0px;margin:0px;">
      37 
    </div> 
    <div style="padding:0px;margin:0px;">
      38 
    </div> 
    <div style="padding:0px;margin:0px;">
      39 
    </div> 
    <div style="padding:0px;margin:0px;">
      40 
    </div> 
    <div style="padding:0px;margin:0px;">
      41 
    </div> 
    <div style="padding:0px;margin:0px;">
      42 
    </div> 
    <div style="padding:0px;margin:0px;">
      43 
    </div> 
    <div style="padding:0px;margin:0px;">
      44 
    </div> 
    <div style="padding:0px;margin:0px;">
      45 
    </div> 
    <div style="padding:0px;margin:0px;">
      46 
    </div> 
    <div style="padding:0px;margin:0px;">
      47 
    </div> 
    <div style="padding:0px;margin:0px;">
      48 
    </div> 
    <div style="padding:0px;margin:0px;">
      49 
    </div> 
    <div style="padding:0px;margin:0px;">
      50 
    </div></td> 
   <td style="margin:0px;"> 
    <div style="padding:24px 24px 0px;margin:0px auto;width:1216px;"> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">#import&nbsp;"RWViewController.h"</code> 
     </div> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">#import&nbsp;&lt;&nbsp;RWUIControls/RWUIControls.h&gt;</code> 
     </div> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">&nbsp;</code>&nbsp; 
     </div> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">@interface&nbsp;RWViewController&nbsp;()</code> 
     </div> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">@property&nbsp;(nonatomic,&nbsp;strong)&nbsp;UIImageView&nbsp;*imageView;</code> 
     </div> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">@property&nbsp;(nonatomic,&nbsp;strong)&nbsp;RWKnobControl&nbsp;*rotationKnob;</code> 
     </div> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">@end</code> 
     </div> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">&nbsp;</code>&nbsp; 
     </div> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">@implementation&nbsp;RWViewController</code> 
     </div> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">&nbsp;</code>&nbsp; 
     </div> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">-&nbsp;(void)viewDidLoad</code> 
     </div> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">{ </code> 
     </div> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-size:14px;line-height:22px;">[</code> 
      <code style="font-size:14px;line-height:22px;">super</code>&nbsp; 
      <code style="font-size:14px;line-height:22px;">viewDidLoad];</code> 
     </div> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-size:14px;line-height:22px;">//&nbsp;Create&nbsp;UIImageView</code> 
     </div> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-size:14px;line-height:22px;">CGRect&nbsp;frame&nbsp;=&nbsp;self.view.bounds;</code> 
     </div> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-size:14px;line-height:22px;">frame.size.height&nbsp;*=&nbsp;2/3.0;</code> 
     </div> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-size:14px;line-height:22px;">self.imageView&nbsp;=&nbsp;[[UIImageView&nbsp;alloc]&nbsp;initWithFrame:CGRectInset(frame,&nbsp;0,&nbsp;20)];</code> 
     </div> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-size:14px;line-height:22px;">self.imageView.image&nbsp;=&nbsp;[UIImage&nbsp;imageNamed:@</code> 
      <code style="font-size:14px;line-height:22px;">"sampleImage.jpg"</code> 
      <code style="font-size:14px;line-height:22px;">];</code> 
     </div> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-size:14px;line-height:22px;">self.imageView.contentMode&nbsp;=&nbsp;UIViewContentModeScaleAspectFit;</code> 
     </div> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-size:14px;line-height:22px;">[self.view&nbsp;addSubview:self.imageView];</code> 
     </div> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">&nbsp;</code>&nbsp; 
     </div> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-size:14px;line-height:22px;">//&nbsp;Create&nbsp;RWKnobControl</code> 
     </div> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-size:14px;line-height:22px;">frame.origin.y&nbsp;+=&nbsp;frame.size.height;</code> 
     </div> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-size:14px;line-height:22px;">frame.size.height&nbsp;/=&nbsp;2;</code> 
     </div> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-size:14px;line-height:22px;">frame.size.width&nbsp;&nbsp;=&nbsp;frame.size.height;</code> 
     </div> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-size:14px;line-height:22px;">self.rotationKnob&nbsp;=&nbsp;[[RWKnobControl&nbsp;alloc]&nbsp;initWithFrame:CGRectInset(frame,&nbsp;10,&nbsp;10)];</code> 
     </div> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-size:14px;line-height:22px;">CGPoint&nbsp;center&nbsp;=&nbsp;self.rotationKnob.center;</code> 
     </div> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-size:14px;line-height:22px;">center.x&nbsp;=&nbsp;CGRectGetMidX(self.view.bounds);</code> 
     </div> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-size:14px;line-height:22px;">self.rotationKnob.center&nbsp;=&nbsp;center;</code> 
     </div> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-size:14px;line-height:22px;">[self.view&nbsp;addSubview:self.rotationKnob];</code> 
     </div> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">&nbsp;</code>&nbsp; 
     </div> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-size:14px;line-height:22px;">//&nbsp;Set&nbsp;up&nbsp;config&nbsp;on&nbsp;RWKnobControl</code> 
     </div> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-size:14px;line-height:22px;">self.rotationKnob.minimumValue&nbsp;=&nbsp;-M_PI_4;</code> 
     </div> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-size:14px;line-height:22px;">self.rotationKnob.maximumValue&nbsp;=&nbsp;M_PI_4;</code> 
     </div> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-size:14px;line-height:22px;">[self.rotationKnob&nbsp;addTarget:self</code> 
     </div> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-size:14px;line-height:22px;">action:@selector(rotationAngleChanged:)</code> 
     </div> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-size:14px;line-height:22px;">forControlEvents:UIControlEventValueChanged];</code> 
     </div> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">}</code> 
     </div> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">&nbsp;</code>&nbsp; 
     </div> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">-&nbsp;(void)rotationAngleChanged:(id)sender</code> 
     </div> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">{ </code> 
     </div> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-size:14px;line-height:22px;">self.imageView.transform&nbsp;=&nbsp;CGAffineTransformMakeRotation(self.rotationKnob.value);</code> 
     </div> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">}</code> 
     </div> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">&nbsp;</code>&nbsp; 
     </div> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">-&nbsp;(NSUInteger)supportedInterfaceOrientations</code> 
     </div> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">{ </code> 
     </div> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-size:14px;line-height:22px;">return</code>&nbsp; 
      <code style="font-size:14px;line-height:22px;">UIInterfaceOrientationMaskPortrait;</code> 
     </div> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">}</code> 
     </div> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">&nbsp;</code>&nbsp; 
     </div> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">@end</code> 
     </div> 
    </div></td> 
  </tr> 
 </tbody> 
</table>

这就是一个简单的视图控制器，它做了以下几件事：

*  使用\#import导入框架的头文件
 *  设置了一组私有属性来持有UIImageView和RWKnobControl。
 *  创建一个UIImageView，将其放到合适的位置。
 *  为Knob control设置一些属性，包括添加值改变的事件监听器。相应方法为rotationAngleChanged:方法。
 *  rotationAngleChanged:方法简单更新了UIImageView的transform属性，让图片随着knob control的移动而旋转。

具体怎么样使用RWKnobControl，可以看一下上一篇教程，那里解释了怎么样去创建它。

编译并运行，你就能看到一款简单的应用，当你改变knob control的值时图片就会旋转。

![ios\_framework\_image\_viewer\_rotating.gif][ios_framework_image_viewer_rotating.gif]

## 打包（Bundle）资源 ##

你有没有注意到RWUIControls的framework只包含了代码和头文件，其他的文件却没有被包含。例如，你没有使用其他任何资源，比如图片。这是iOS的一个限制，framework只能包含头文件和静态库。

现在准备好，这篇教程要开始进阶了。这一部分你将学到怎么样通过使用bundle整合资源，让其可以随着framework一起发布，进而突破这一限制。

你将创建一个新的UI控件——丝带控件，作为RWUIControls库的一部分。这个控件将在一个UIView的右上方展示一个丝带图片。

## 创建一个Bundle ##

资源都会被添加到bundle中，这将是RWUIControls工程上的另一个目标。

打开UIControlDevApp工程，选择RWUIControls子工程，点击Add Target按钮，导航到OS X/Framework and Library/Bundle。将新的Bundle命名为RWUIControlsResources，然后从framework选择框中选择Core Foundation。

![ios\_framework\_import\_framework.gif][ios_framework_import_framework.gif 1]

这里需要配置几个编译设置，因为你正在创建一个在iOS上使用的bundle，这与默认的OS X不同。选择RWUIControlsResources目标，然后点击Build Settings栏，搜索base sdk，选择Base SDK这一行，按下delete键，这一步将OS X切换为iOS。

![ios\_framework\_bundle\_set\_base\_sdk-700x161.png][ios_framework_bundle_set_base_sdk-700x161.png]

同时你需要将工程名称改为RWUIControls。搜索product name，双击进入编辑模式，将$\{TARGET\_NAME\}替换为RWUIControls。

![ios\_framework\_bundle\_set\_product\_name-700x206.png][ios_framework_bundle_set_product_name-700x206.png]

默认情况下，有两种resolutions的图片可以产生一些有趣的现象。例如，当你导入一个retina @2x版本的图片时，普通版的和Retina版的将会合并成一个多resolution的TIFF（标签图像文件格式，Tagged Image File Format）。这不是一件好事。搜索hidpi将COMBINE\_HIDPI\_IMAGES设置为NO。

![ios\_framework\_bundle\_hidpi\_images-700x234.png][ios_framework_bundle_hidpi_images-700x234.png]

现在，你将确保当你编译framework时，bundle也能被编译并将framework作为依赖添加到集体目标中。选中Framework目标，选择Build Phases栏，展开Target Dependencies面板，点击 + 按钮，选择RWUIControlsResources目标将其添加为依赖。

![ios\_framework\_add\_bundle\_as\_framework\_dependency.gif][ios_framework_add_bundle_as_framework_dependency.gif]

现在，在Framework目标的Build Phases中，打开MultiPlatform Build面板，在脚本的最后添加下述代码：

这条指令将拷贝构建好的bundle到用户的桌面上。现在，编译framework scheme，你会发现bundle在桌面上出现。

![ios\_framework\_bundle\_on\_desktop-198x320.png][ios_framework_bundle_on_desktop-198x320.png]

## 导入Bundle ##

为了用这个新的bundle开发，你需要在示例项目中使用它，这意味着你必须既把它作为依赖添加到工程中，同时作为一个对象拷贝到项目中。

在项目导航栏中，选择UIControlDevApp工程，点击UIControlDevApp目标，展开RWUIControls工程的Product组，把RWUIControls.bundle拖到Copy Bundle Resources面板中的 Build Phases栏。

在Target Dependencies面板中，点击+按钮，添加新的依赖，然后选择RWUIControlsResources。

![ios\_framework\_add\_bundle\_for\_dev\_project.gif][ios_framework_add_bundle_for_dev_project.gif]

## 创建一个丝带视图（Ribbon View） ##

上面的就是所有必需的配置工作了，从你之前下载的压缩文件中将RWRibbon文件夹拖入到RWUIControls工程下RWUIControls组中。

![ios\_framework\_drag\_rwribbon-480x309.png][ios_framework_drag_rwribbon-480x309.png]

选中Copy the items into the destination group’s folder，在对应的选择框中打勾，确保它被添加到RWUIControls静态lib目标中。

![ios\_framework\_rwribbon\_membership-700x472.png][ios_framework_rwribbon_membership-700x472.png]

代码中一个很重要的部分是你怎样引用一张图片。如果你看一下RWRibbonView.m文件中的addRibbonView方法，你将会看到相关的这一行代码：

<table style="border-spacing:0px;width:1256.625px;"> 
 <tbody> 
  <tr> 
   <td style="margin:0px;"> 
    <div style="padding:0px;margin:0px;">
      1 
    </div></td> 
   <td style="margin:0px;"> 
    <div style="padding:24px 24px 0px;margin:0px auto;width:1216px;"> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">UIImage&nbsp;*image&nbsp;=&nbsp;[UIImage&nbsp;imageNamed:@</code> 
      <code style="font-size:14px;line-height:22px;">"RWUIControls.bundle/RWRibbon"</code> 
      <code style="font-size:14px;line-height:22px;">];</code> 
     </div> 
    </div></td> 
  </tr> 
 </tbody> 
</table>

Bundle就像一个文件目录，所以引用bundle中的一张图片是非常简单的。

将图片添加到bundle中，选择这张图片，在右边的面板中，通过选择来表示它应该属于RWUIControlsResources目标。

![ios\_framework\_rwribbon\_image\_membership-700x208.png][ios_framework_rwribbon_image_membership-700x208.png]

还记得我们说过要确保framework可以被访问吗？现在，你需要导出头文件RWRibbon.h，在Target Membership面板中选择该文件，然后从弹出视图中选择Public。

![ios\_framework\_rwribbon\_header\_membership-480x262.png][ios_framework_rwribbon_header_membership-480x262.png]

最后，你需要将头文件引用添加到framework的头文件中。打开RWUIControls.h添加下面这两行：

## 将丝带添加到示例工程中 ##

在UIControlDevApp项目中打开RWViewController.m文件，在@interface后的大括号中添加下面的实例变量声明。

<table style="border-spacing:0px;width:1256.625px;"> 
 <tbody> 
  <tr> 
   <td style="margin:0px;"> 
    <div style="padding:0px;margin:0px;">
      1 
    </div></td> 
   <td style="margin:0px;"> 
    <div style="padding:24px 24px 0px;margin:0px auto;width:1216px;"> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">RWRibbonView&nbsp;&nbsp;*_ribbonView;</code> 
     </div> 
    </div></td> 
  </tr> 
 </tbody> 
</table>

在viewDidLoad:的末尾添加下面的代码来创建一个丝带视图：

编译并运行UIControlDevApp scheme。你将看到新的丝带控件出现在应用的下方。

![ios\_framework\_dev\_app\_with\_ribbon-333x500.png][ios_framework_dev_app_with_ribbon-333x500.png]

## 在ImageViewer中使用Bundle ##

我要向你分享的最后一件事是怎么样在其他应用中使用这个新的bundle，例如，你之前创建的ImageViewer应用。

开始之前，确保你的bundle和framework都是最新版本的，选择Framework scheme然后按下cmd+B编译。

打开ImageViewer工程，找到Frameworks组中的RWUIControls.framework项目，然后将其删除，选择Move to Trash。然后将RWUIControls.framework从你的桌面上拖到Frameworks组中。这是必须的，因为此时的framework已经与你第一次导入时的framework大不相同了。

![ios\_framework\_delete\_framework-700x283.png][ios_framework_delete_framework-700x283.png]

Note：如果Xcode拒绝让你添加framework，这可能是因为你并没有真正将之前版本的framework删除到废纸篓。如果是因为这样的话，从Finder中ImageViewer目录下删除framework然后重新尝试。

导入bundle，简单将其从桌面上拖到ImageViewer组中。选中Copy items into destination group’s folder，选中对应的选择框，确保它被添加到ImageViewer目标中。

![ios\_framework\_import\_bundle-700x474.png][ios_framework_import_bundle-700x474.png]

接下来你要将丝带添加到可以旋转的图片上。因此，在RWViewController.m文件中代码要有一些简单的变动。

打开该文件，将属性imageView的类型从UIImageView变为RWRibbonView：

<table style="border-spacing:0px;width:1256.625px;"> 
 <tbody> 
  <tr> 
   <td style="margin:0px;"> 
    <div style="padding:0px;margin:0px;">
      1 
    </div></td> 
   <td style="margin:0px;"> 
    <div style="padding:24px 24px 0px;margin:0px auto;width:1216px;"> 
     <div style="padding:0px;margin:0px;"> 
      <code style="font-size:14px;line-height:22px;">@property&nbsp;(nonatomic,&nbsp;strong)&nbsp;RWRibbonView&nbsp;*imageView;</code> 
     </div> 
    </div></td> 
  </tr> 
 </tbody> 
</table>

将viewDidLoad方法中第一部分，负责创建并配置UIImageView的代码，替换为下面的代码：

编译并运行该项目，现在该项目中你同时使用了RWUIControls framework下的RWKnobControl和RWRibbonView。

![ios\_framework\_image\_viewer\_with\_ribbon.gif][ios_framework_image_viewer_with_ribbon.gif]

[SouthEast]: /images/20220522/33af6d880db24428a7d2605474e6394e.png
[20180611112329546]: /images/20220522/5c2a502170334349bb0cae63b97733d4.png
[20180611112644678]: /images/20220522/b84cd8511cc74cb9818707aaff719aec.png
[20180611112806893]: /images/20220522/227d854b61a841ff8bd338a0b8a9e792.png
[20180611112851574]: /images/20220522/44563206497243b3941cbc0fc2adfe8d.png
[20180611112921302]: /images/20220522/7c6d99bf538d4992a40d0b233742ad0a.png
[20180611113312849]: /images/20220522/e846243c9ab840339611a56103e72ca0.png
[2018061111370355]: /images/20220522/7d4766569b4945b59c1854e76d38d1a5.png
[20180611113756632]: /images/20220522/9d861da3fda14f1aa8361a0a39beb989.png
[SouthEast 1]: /images/20220522/0c4d74fc5ee24dd1a6175c211f6556e0.png
[20180611113827878]: /images/20220522/a6a798bbafad4ff3836b43d6898fc0a1.png
[SouthEast 2]: /images/20220522/b36c7cbd40854dc88ea4a9e6edbc280d.png
[SouthEast 3]: /images/20220522/1446e73defb649ab9e5ae49359bce32d.png
[SouthEast 4]: /images/20220522/10ca7ca2a085499c8cd879a183382052.png
[SouthEast 5]: /images/20220522/22af2d36daf645bd94375ab020eeeee8.png
[SouthEast 6]: /images/20220522/182d27e465574627add27bb8e0de7b9f.png
[SouthEast 7]: /images/20220522/5d4e6ebd130947b3815b8bfdb890734f.png
[SouthEast 8]: /images/20220522/bba5a2f177b5445e8e469156ceb9f48c.png
[SouthEast 9]: /images/20220522/22a341ee0db34709aaa438e5fe2d954f.png
[SouthEast 10]: /images/20220522/21e7816b352d43d1ba3da8275674edd3.png
[SouthEast 11]: /images/20220522/15a800d059994db8a5a68af3fda077d3.png
[SouthEast 12]: /images/20220522/00caa2db2e2e40fa82ac71e4c813fd3c.png
[SouthEast 13]: /images/20220522/b92629cf8feb48ac82386342c2e128d6.png
[SouthEast 14]: /images/20220522/b9b48c74f43b47489bcdf9cff53b641c.png
[SouthEast 15]: /images/20220522/7f77b52ad8c54e8a9d3be4e951dd4250.png
[SouthEast 16]: /images/20220522/0315e2eff8c04857b7cb895c7a516125.png
[SouthEast 17]: /images/20220522/6d11ecad8a2449f0ada59dc2ad37695a.png
[SouthEast 18]: /images/20220522/fb3a9ce556544004b4ec8562ae091c73.png
[SouthEast 19]: /images/20220522/bc05ffb63dc943e5bf6b0fdaaf4335a8.png
[SouthEast 20]: /images/20220522/596d32c1d111409f8c114e5dbfbba86f.png
[SouthEast 21]: /images/20220522/f7455b74e4554208835b28cd2f7253af.png
[SouthEast 22]: /images/20220522/36f7636cbe414466b34c7071ebefac28.png
[SouthEast 23]: /images/20220522/7b03829bbeb04a408f7a90e7ab36a0b2.png
[SouthEast 24]: /images/20220522/c6cd30689f2e4faa9ade044f0cfd6a38.png
[721613-20151006125143737-435795429.jpg]: /images/20220522/a133ef3ab4984ad3beddd078c91dc1af.png
[721613-20151006125205284-938904198.jpg]: /images/20220522/33318381594949afb85ef1110d0b65ee.png
[721613-20151006125222628-60733902.jpg]: /images/20220522/282e6011481e4b70b9ff120c5841a76d.png
[721613-20151006125259534-174215269.jpg]: /images/20220522/eaa14cccd8db488c86e4479bad242cf5.png
[721613-20151006125308112-926849718.jpg]: /images/20220522/3dcabc37ccfd4f419a157ef5c608933b.png
[721613-20151006125320612-1746272243.jpg]: /images/20220522/1f3d3dcf3b594cebad1fc0d4bb04b75a.png
[721613-20151006125331440-1707404363.jpg]: /images/20220522/87ece40b07c34e70a7c2506d4c3aec4d.png
[721613-20151006143222753-1004399607.png]: /images/20220522/80694615c82b4025a0417abba0aaeeb0.png
[721613-20151006143244268-1132120790.png]: /images/20220522/d4fcc077951e4651b59b322dc39ba6a2.png
[721613-20151006143257315-1673445238.png]: /images/20220522/4a6830b3593d43b5879076319363a48a.png
[721613-20151006143310237-307457149.png]: https://images2015.cnblogs.com/blog/721613/201510/721613-20151006143310237-307457149.png
[721613-20151006144533487-1571360522.png]: /images/20220522/559e9f29368d49b0b24a87bf1c8050e0.png
[721613-20151006144647799-1209506933.jpg]: /images/20220522/09f2625725964b1bbb55e6ac548c637b.png
[721613-20151006151056565-1076183178.png]: /images/20220522/073def82c4994b3caae57009e85de032.png
[721613-20151006151858253-1042070745.png]: /images/20220522/df2db07866fa40e88317b5c5c886e55f.png
[Build_Active_Architecture_Only]: https://www.baidu.com/link?url=UHrDs0z8msrQO7P5MNqB5bW5fyRBu00-KMRODG-z2-LPrSjL9t78O215CBr_3FuzrVAC7Wc47z8WphfQDyRdka&wd=&eqid=a9af8fc2000ab794000000035769059e
[721613-20151006155121721-438176110.png]: /images/20220522/62e0934b18ee49dcbcbf301ba7f88a21.png
[721613-20151006155145237-907932313.png]: /images/20220522/286f2959a3d64704bdcaf713b05552c0.png
[721613-20151006155929987-2083717529.png]: /images/20220522/774ee5ee687943ecb428df93d5b605d5.png
[721613-20151006160900237-711025088.jpg]: /images/20220522/443add40d91f4df988a3a2c7e090201c.png
[721613-20151006162007190-431277632.png]: /images/20220522/2a2cc05c595047e28b72ca9615953e65.png
[721613-20151006162353909-1485224537.png]: /images/20220522/3ff439d8b94b4b7faddde2ab061692f1.png
[721613-20170124180149097-801881146.png]: /images/20220522/40b73aaa681e444393a38b8ca0063caf.png
[721613-20170124181248159-1577036069.png]: /images/20220522/88b021fe8d864a75820fd476e9c0caa2.png
[721613-20170124181430784-1634526467.png]: /images/20220522/7ce49c5eb4e54b9d8b9e2d8e2a9f3dd9.png
[721613-20170124182031269-41971650.png]: /images/20220522/a3b2b7332a6343c9ad1f360892370e84.png
[721613-20170124183237691-1617536050.png]: /images/20220522/fc05596378bf42c8b6fbd7aa8d5ad283.png
[721613-20170124184542581-970932039.png]: /images/20220522/7b33b6ab05d549f8afe14e253a5f8301.png
[Link 1]: http://cdn2.raywenderlich.com/wp-content/uploads/2014/02/BuildAFramework.zip
[Github]: https://github.com/sammyd/RW-iOSFramework
[Link 2]: https://developer.apple.com/library/mac/documentation/macosx/conceptual/BPFrameworks/Concepts/FrameworkBinding.html
[Link 3]: http://www.raywenderlich.com/?p=41377
[ios_framework_creating_static_lib-700x482.png]: /images/20220522/ee246594bc0f4441bf887a2210a0ebb9.png
[ios_framework_options_for_static_lib-700x476.png]: /images/20220522/b2a8238743eb4bd5952ab097bdb44cbc.png
[ios_framework_add_uikit_dependency.gif]: /images/20220522/c12caabea2134466bcd9b7b43d7621fc.png
[ios_framework_add_copy_headers_build_phase.gif]: /images/20220522/96865a9e41ee486f91fc6a6a919c7381.png
[ios_framework_add_header_to_public.gif]: /images/20220522/e0cabbd51fa441939ec94e751a332de7.png
[ios_framework_drop_rwuiknobcontrol_from_finder-700x466.png]: /images/20220522/7bbd8c06a441415cbcb12ff19c9c8f57.png
[ios_framework_import_settings_for_rwknobcontrol-700x475.png]: /images/20220522/fffa6da849b14a38bb7ae92a1166bced.png
[ios_framework_default_header_membership-700x327.png]: /images/20220522/a09fd35b05d74ed39dd7614bf8a1e2d7.png
[ios_framework_drag_header_to_public.gif]: /images/20220522/355e29bd685d47a48cd4db3af012fb96.png
[ios_framework_header_membership-407x320.png]: /images/20220522/1d8e55a1cbbb49d2ae27bf53eb50e4e5.png
[ios_framework_public_headers_path-700x174.png]: /images/20220522/07eeed019ff647789c067cb6be72fec1.png
[ios_framework_successful_first_build-700x454.png]: /images/20220522/e47fb4f3b44b49978cf6221d3f30f71b.png
[ios_framework_import_library_into_dev_app-700x357.png]: /images/20220522/c227105ea9544d1390658f0f004092b0.png
[ios_framework_adding_files_to_dev_app.gif]: /images/20220522/3b10d917b7ff41bbaab4a138b4883e36.png
[ios_framework_add_dependencies_to_dev_app.gif]: /images/20220522/323d54b56a524b788c2226317396f727.png
[ios_framework_dev_app_buildrun1-333x500.png]: /images/20220522/af7ccf933ab24d9f878575b748658126.png
[ios_framework_directory_structure-449x320.png]: /images/20220522/6e0d9463353645ada78c8634861a76ef.png
[ios_framework_framework_add_run_script_build_phase-700x271.png]: /images/20220522/abffb675a7db43aa81144d2f46036eed.png
[ios_framework_new_run_script_build_phase-700x299.png]: /images/20220522/7b8a5333d7be4dc0b3ec67a5b11a7c96.png
[ios_framework_rename_script-700x131.png]: /images/20220522/f5235b72dfd24e13823796c89cb4d957.png
[symbolic links]: http://en.wikipedia.org/wiki/Symbolic_link
[ios_framework_build_target_static_lib.png]: /images/20220522/bc6e4903842f48bca9291036781e61cf.png
[ios_framework_static_lib_view_in_finder-480x295.png]: /images/20220522/f1e8b24d3cc24d9d9f26b8e0ac67d042.png
[ios_framework_created_framework_directory_structure-480x251.png]: /images/20220522/5a80a909809c4d9d8d7b40477ab10f91.png
[ios_framework_add_target_button-471x320.png]: /images/20220522/e9e4870f89ee49d0af4f3c90e30e7e08.png
[ios_framework_add_dependency_to_framework_target.gif]: /images/20220522/3113237f7986464781f1326821c3a3e8.png
[ios_framework_framework_add_run_script_build_phase-700x271.png 1]: /images/20220522/51c0e6bf4f3a409e86f4b1975ed1d9f6.png
[ios_framework_select_framework_aggregate_scheme-480x135.png]: /images/20220522/07c5afd2a53443e686d0779c4c04580d.png
[ios_framework_built_framework_on_desktop-700x319.png]: /images/20220522/2bb67f04bbc146fc85d25d488f16df46.png
[ios_framework_architectures_in_fat_library-700x257.png]: /images/20220522/2e27658601b5417f87a75733b58d3735.png
[ios_framework_drag_sample_image_into_xcode-480x299.png]: /images/20220522/dd3d38ab7fae40f6b693b905da7d77d4.png
[ios_framework_import_framework.gif]: /images/20220522/04a8c5da61f342ba8061489e60496f73.png
[ios_framework_image_viewer_rotating.gif]: /images/20220522/52e1501a7a014be19b242506f83f7a5f.png
[ios_framework_import_framework.gif 1]: /images/20220522/13396dbf72554a288431b160a27b7140.png
[ios_framework_bundle_set_base_sdk-700x161.png]: /images/20220522/94fe1eef23f74df0a3470cf89b4b5be9.png
[ios_framework_bundle_set_product_name-700x206.png]: /images/20220522/323fa658cf614f468dbcfc41ab4d23f4.png
[ios_framework_bundle_hidpi_images-700x234.png]: /images/20220522/b02d9095ce404ccd895aad80b7e4c0a3.png
[ios_framework_add_bundle_as_framework_dependency.gif]: /images/20220522/391d0dfaa9704366b7796b83a4b17f6c.png
[ios_framework_bundle_on_desktop-198x320.png]: /images/20220522/40f299dc1a8c486293455f6e82b6fa6b.png
[ios_framework_add_bundle_for_dev_project.gif]: /images/20220522/7eb644399b3e4c909611dde09f31bcce.png
[ios_framework_drag_rwribbon-480x309.png]: /images/20220522/9a86286291f44ee0bd9dc0cd661ba9af.png
[ios_framework_rwribbon_membership-700x472.png]: /images/20220522/721436dbd130447fae993d496a4e2143.png
[ios_framework_rwribbon_image_membership-700x208.png]: /images/20220522/ab042c8d15284e1c83d154b3a7858be1.png
[ios_framework_rwribbon_header_membership-480x262.png]: /images/20220522/ba5be5d8c4f7429ca1cdeab7a1b85928.png
[ios_framework_dev_app_with_ribbon-333x500.png]: /images/20220522/36fbce9a82c24f52bbe5d0bab95226b4.png
[ios_framework_delete_framework-700x283.png]: /images/20220522/817006381d1648398c1ee2808f565d90.png
[ios_framework_import_bundle-700x474.png]: /images/20220522/6501835e4da64be586dec69f90a9935b.png
[ios_framework_image_viewer_with_ribbon.gif]: /images/20220522/8482ae289e7d4ef8b6091679aa735ea2.png