天天看点

framework制作

创建一个静态库工程

打开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添加进来。

framework制作

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

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

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

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

framework制作

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

framework制作

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

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

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

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

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

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

framework制作

或者,你可能会发现,更简单的方法是,编辑文件,改变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也有几点不同之处:

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

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

Framework结构

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

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

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

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

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16

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,可以确定一下这里展示了正确的目录结构:

这算是在完成你的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制作

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

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

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

1 2 3 4 5 6 7 8 9 10 11

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"

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

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19

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 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30

# 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

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

1 2 3 4 5 6 7 8 9 10 11 12 13

# 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。

这一步将构建并在你的桌面上存放一个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指令,你可以看到这些片段的一个分组。

继续阅读