framework制作

最新推荐文章于 2024-03-08 23:07:25 发布

zjmdydgh

最新推荐文章于 2024-03-08 23:07:25 发布

阅读量343

点赞数 1

分类专栏： a 文章标签： framework

a 专栏收录该内容

1 篇文章 0 订阅

订阅专栏

创建一个静态库工程

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

将工程命名为RWUIControls(你的框架名, 下同)，然后将工程保存到一个空目录下。

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

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

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

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

1	`#import < UIKit/UIKit.h>`

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

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

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

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

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

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

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

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

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

把项目中要用到的API接口文件，从Finder中拖到Xcode下RWUIControls目录下。

ios_framework_drop_rwuiknobcontrol_from_finder-700x466.png

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

ios_framework_import_settings_for_rwknobcontrol-700x475.png

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

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

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

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

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

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

1	`#import < RWUIControls/RWUIControls.h>`

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

1 2	`// Knob Control` `#import`

配置Build Settings

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

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

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

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

现在你需要改变一些其他的设置，尤其是那些在二进制库中遗留下的设置，编译器提供给你一个选项，来消除无效代码：永远不会被执行的代码。当然你也可以移除掉一些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。

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

创建一个Framework

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

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

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

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

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

Framework结构

选择Build Phases栏，然后选择Editor/Add Build Phase/Add Run Script Build Phase来添加一个新的脚本。

ios_framework_framework_add_run_script_build_phase-700x271.png

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

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

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

 
     set -e 
    

 
     export FRAMEWORK_LOCN= 
     "${BUILT_PRODUCTS_DIR}/${PRODUCT_NAME}.framework"

 
     # Create the path to the real Headers die 
    

 
     mkdir -p  
     "${FRAMEWORK_LOCN}/Versions/A/Headers"

 
     # Create the required symlinks 
    

 
     /bin/ln -sfh A  
     "${FRAMEWORK_LOCN}/Versions/Current"

 
     /bin/ln -sfh Versions/Current/Headers  
     "${FRAMEWORK_LOCN}/Headers"

 
     /bin/ln -sfh  
     "Versions/Current/${PRODUCT_NAME}"  
     \ 
    

 
     "${FRAMEWORK_LOCN}/${PRODUCT_NAME}"

 
     # Copy the public headers into the framework 
    

 
     /bin/cp -a  
     "${TARGET_BUILD_DIR}/${PUBLIC_HEADERS_FOLDER_PATH}/"  
     \ 
    

 
     "${FRAMEWORK_LOCN}/Versions/A/Headers"

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

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

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

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按钮(或editor下面Add Target)。

找到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静态库。

这个目标的主要编译部分是多平台编译，你将使用一个脚本来做到这一点。和你之前做的一样，在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

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

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

 
     set -e 
    

 
     # If we're already inside this script then die 
    

 
     if  
     [ -n  
     "$RW_MULTIPLATFORM_BUILD_IN_PROGRESS"  
     ]; then 
    

 
     exit 0

fi

 
     export RW_MULTIPLATFORM_BUILD_IN_PROGRESS=1 
    

 
     RW_FRAMEWORK_NAME=${PROJECT_NAME} 
    

 
     RW_INPUT_STATIC_LIB= 
     "lib${PROJECT_NAME}.a"

 
     RW_FRAMEWORK_LOCATION= 
     "${BUILT_PRODUCTS_DIR}/${RW_FRAMEWORK_NAME}.framework"

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

 
     function  
     build_static_library {

 
     # Will rebuild the static library as specified

 
     #     build_static_library sdk

 
     xcrun xcodebuild -project  
     "${PROJECT_FILE_PATH}"  
     \

 
     -target  
     "${TARGET_NAME}"  
     \

 
     -configuration  
     "${CONFIGURATION}"  
     \

 
     -sdk  
     "${1}"  
     \

 
     ONLY_ACTIVE_ARCH=NO \

 
     BUILD_DIR= 
     "${BUILD_DIR}"  
     \

 
     OBJROOT= 
     "${OBJROOT}"  
     \

 
     BUILD_ROOT= 
     "${BUILD_ROOT}"  
     \

 
     SYMROOT= 
     "${SYMROOT}"  
     $ACTION

}

 
     function  
     make_fat_library {

 
     # Will smash 2 static libs together

 
     #     make_fat_library in1 in2 out

 
          
     xcrun lipo -create  
     "${1}"  
     "${2}"  
     -output  
     "${3}" 
    

}

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

 
     # 1 - Extract the platform (iphoneos/iphonesimulator) from the SDK name 
    

 
     if  
     [[  
     "$SDK_NAME"  
     =~ ([A-Za-z]+) ]]; then 
    

 
     RW_SDK_PLATFORM=${BASH_REMATCH[1]}

 
     else 
    

 
     echo  
     "Could not find platform name from SDK_NAME: $SDK_NAME"

 
     exit 1

fi

 
     # 2 - Extract the version from the SDK 
    

 
     if  
     [[  
     "$SDK_NAME"  
     =~ ([0-9]+.*$) ]]; then 
    

 
     RW_SDK_VERSION=${BASH_REMATCH[1]}

 
     else 
    

 
     echo  
     "Could not find sdk version from SDK_NAME: $SDK_NAME"

 
     exit 1

fi

 
     # 3 - Determine the other platform 
    

 
     if  
     [  
     "$RW_SDK_PLATFORM"  
     ==  
     "iphoneos"  
     ]; then 
    

 
     RW_OTHER_PLATFORM=iphonesimulator

 
     else 
    

 
     RW_OTHER_PLATFORM=iphoneos

fi

 
     # 4 - Find the build directory 
    

 
     if  
     [[  
     "$BUILT_PRODUCTS_DIR"  
     =~ (.*)$RW_SDK_PLATFORM$ ]]; then 
    

 
     RW_OTHER_BUILT_PRODUCTS_DIR= 
     "${BASH_REMATCH[1]}${RW_OTHER_PLATFORM}"

 
     else 
    

 
     echo  
     "Could not find other platform build directory."

 
     exit 1

fi

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

 
     # Build the other platform. 
    

 
     build_static_library  
     "${RW_OTHER_PLATFORM}${RW_SDK_VERSION}"

 
     # If we're currently building for iphonesimulator, then need to rebuild 
    

 
     #   to ensure that we get both i386 and x86_64 
    

 
     if  
     [  
     "$RW_SDK_PLATFORM"  
     ==  
     "iphonesimulator"  
     ]; then 
    

 
     build_static_library  
     "${SDK_NAME}"

fi

 
     # Join the 2 static libs into 1 and push into the .framework 
    

 
     make_fat_library  
     "${BUILT_PRODUCTS_DIR}/${RW_INPUT_STATIC_LIB}"  
     \ 
    

 
     "${RW_OTHER_BUILT_PRODUCTS_DIR}/${RW_INPUT_STATIC_LIB}"  
     \

 
     "${RW_FRAMEWORK_LOCATION}/Versions/A/${RW_FRAMEWORK_NAME}"

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

1

2

3

4

5

6

 
     # Ensure that the framework is present in both platform's build directories 
    

 
     cp -a  
     "${RW_FRAMEWORK_LOCATION}/Versions/A/${RW_FRAMEWORK_NAME}"  
     \ 
    

 
     "${RW_OTHER_BUILT_PRODUCTS_DIR}/${RW_FRAMEWORK_NAME}.framework/Versions/A/${RW_FRAMEWORK_NAME}"

 
     # Copy the framework to the user's desktop 
    

 
     ditto  
     "${RW_FRAMEWORK_LOCATION}"  
     "${HOME}/Desktop/${RW_FRAMEWORK_NAME}.framework" 
    

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

ios_framework_select_framework_aggregate_scheme-480x135.png

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

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

1 2	`$ cd ~/Desktop/RWUIControls.framework` `$ RWUIControls.framework xcrun lipo -info RWUIControls`

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

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

zjmdydgh

关注

1
点赞
踩
0

收藏

觉得还不错? 一键收藏
0
评论
framework制作

创建一个静态库工程打开Xcode，点击File\New\Project，选择iOS\Framework and Library\Cocoa Touch Static Library新建一个静态库工程.将工程命名为RWUIControls(你的框架名, 下同)，然后将工程保存到一个空目录下。一个静态库工程由头文件和实现文件组成，这些文件将被编译为库本身。
复制链接

扫一扫