Three20如何加入Three20到专案中


2020-06-09


在前一篇文章中我们大致简介了 Three20 背景、在哪些程式中有被使用,并且大概提到了这个框架所提供的功能。而在这一篇文章中,我们将带领各位读者学习如何安装 Three20 到专案中,以便进行后续的使用。

Three20 的变革

Three20 以往受到诟病的一点便是其庞大的程式库档案,有时候开发者或许只是想要使用其中的一个类别、方法,就必须将整个框架加入到专案当中,造成不便。

而在五月初的时候,Three20 便针对这一点进行架构上的改变,从此之后 Three20 成为多个模组所组成的框架,开发者便可以只加入自己所需要的模组,而不需要如从前一般将整个 Three20 函式库加入。

下载 Three20

安装的第一步当然便是要下载 Three20 的档案,我们可以从 github 的页面 上点右上角的 Download Source 下载压缩档。

Three20如何加入Three20到专案中

而在下载完毕后点击进行解压缩,这个路径在最后设定的时候会用到,请各位读者注意。

加入 Three20.xcodeproj

接下来我们打开我们的 Xcode 专案,将下载下来的档案资料夹下面的:

/three20/src/Three20/Three20.xcodeproj

Three20如何加入Three20到专案中
以滑鼠拖曳到专案中的 Framework 群组下,而跳出来的画面选项,请如下图选择:
加入 QuartzCore

由于 Three20 使用了一些额外的绘图函式,故我们也需要将 QuartzCore 这套 framework 加入到专案中。

Three20如何加入Three20到专案中
首先我们一样在 Framework 群组上按右键,选择加入框架:
Three20如何加入Three20到专案中
并且选择 QuartzCore.framework:
编译设定
Three20如何加入Three20到专案中
接下来我们必须对 Three20 的编译进行设定,分别在两处。第一个部份,我们先选择 Framework 群组下刚刚加入的 Three20.xcodeproj,然后在右手边的视窗下喙看到 libthree20.a,并在右手边的框框中打勾确认:
Three20如何加入Three20到专案中
接下来在我们的 Targets 群组下选择所编译的程式,按右键选 Get Info 修改设定。在 General 的分页下,我们将 Three20 加入为 Direct Dependencies:
连结设定、标头档搜寻

接下来我们在左边的画面中,选择最上方的 Project 并按右键打开 Info 画面。在 Build 页面下会有一处需要修改、以让我们能顺利的将专案与 Three20 进行 linking、header searching。

Three20如何加入Three20到专案中
第一个是 Other Linker Flags 这个选项,我们必须分别加入-ObjC 和-all_load 两个选项,如下图:

第二个则是 Header Search Paths,我们必须加入下载档案中的这个目录:

YOUR-PATH/three20/Build/Products/three20

注意,这部份各位读者要自行将解压缩的路径代换,否则会出现找不到 headers 的错误。

大功告成

当以上的工作的设定结束后,便可以在程式码当中加入:

#include "Three20/Three20.h"

正式开始体验 Three20 的各种功能!

结论

这一次的文章中我们简介了安装 Three20 的方法,希望各位读者能够顺利的在自己的专案中顺利安装。

在下一次的文章中,笔者将介绍 Three20 的各个模组,让大家能够对整个框架的架构有初步的认识,敬请期待!



上一篇:
下一篇: