在开发项目时,有时候需要依赖其他的工程(通常是第三方开源的静态库工程)。网上有很多第三方开源库都是以一个静态库工程提供给开发者的(比如Codova, CocoaPods等)。
其次,我们自己可以建一个这样的静态库工程,专门用来放自己在实际开发中用的比较多的技术,比如一些帮助类,一些好的技术封装等等。这样在开发新项目时,就可以把这个工程引入进来,要用里面的功能时就可以直接使用,不用找这个工程copy下,那个工程copy下,最后找不到了就更头疼。只要我们维护好这个静态库工程,以后开发就会省事不少。
好啦,步入正题。如果我们的工程要引入静态库工程,如何配置简单实用,以下是个人在实际开发中使用的方法:
场景1:把依赖工程作为主工程的一个子工程, 这种十分简单,在此不做介绍。 (苹果官方文档中有对其的介绍)
场景2:建工作区,把相关的工程导入到工作区下。在工作区下面的工程都是并列关系。
example :
工作区 :MyWorkplace
主工程 : MyApp
依赖库工程 :MyLib
利用Xcode新建一个工作区MyWorkplace,会生成一个MyWorkplace.xcworkspace文件,这就是工作区工程文件,打开该文件,在里面新建一个应用程序工程MyApp,新建一个Static Lib工程MyLib。这样工作区里面就有两个工程,接下来就是配置让MyApp能够编译,使用MyLib。
1.设置两个工程依赖关系。进入MyApp工程的"MyApp"target的“Build Phase”设置项页面,展开“Link Binnary With Libraries”选项卡,点击“+”,选择“Workspace”中的“libMyLib.a”。此步有两个作用:一是设置MyApp的库依赖,这样编译MyApp时,编译器会自动编译MyLib工程。二是设置MyApp找寻该静态库的搜索路径,会自动设置“Library Search Paths”,这样链接时,MyApp就知道去哪里链接libMyLib.a文件了。
2.设置头文件搜索路径。进入MyLib工程的"MyLib"target的“Build Phase”设置项页面,添加一个设置项“Copy Files”,然后选择“Destination”为“Products Directory”。Subpath设置成“include”即可,这是指定将那些MyLib中的头文件copy到“include”中去,也可以自定义这个路径,接下来我们需要用到这个路径。进入MyApp工程的"MyApp"target的“Build Settings"页面,找到“User Header Search Paths”,设置为“$(BUILT_PRODUCTS_DIR)”,这是为了让MyApp能够找到MyLib公开的头文件,否则编译是会找不到头文件报错的。
3.如何在static lib中加入资源。通常,在我们的静态库工程中,会包含有资源文件,比如images, xib, plist等等,但这些资源文件在编译过程中是不会加入到.a中的,所以我们需要通过其他的途径把资源提供给使用者。个人推荐使用bundle,一来bundle会被编译,xib文件会成为二进制文件,这样外界就无法查看xib的内容,其次也是一个很好的封装,很方的插入或删除资源,这也是目前大多数SDK提供商采用的普通方式。 方法:在MyLib中添加一个Target,选择“OS X”下的“Framework & Library”,选择“Bundle”。进入MyLibBundle的“Build Setting”设置页面,修改“Base SDK”为 “Latest iOS(iOS latestversion)”。然后就可以往MYLibBundle里面加入你想要的资源了。
在MyLib代码中要引用MyLibBundle中的资源文件时,需要这样使用:
#define MyLibBUNDLE_NAME @ "MyLibBundle.bundle"
#define MyLibBUNDLE_PATH [[[NSBundle mainBundle] resourcePath] stringByAppendingPathComponent: MyLibBUNDLE_NAME]
#define MyLibBUNDLE [NSBundle bundleWithPath: MyLibBUNDLE_PATH]
xib :
self = [super initWithNibName:@"MyLibViewController" bundle:MyLibBUNDLE];
image :
+ (UIImage *)getImageWithName:(NSString *)pImageName {
return [UIImage imageWithContentsOfFile:[[MyLibBUNDLE resourcePath] stringByAppendingPathComponent:pImageName]];
}
4. 主工程引用静态库工程的资源。 我们上面创建好了MyLibBundle,MyApp已经可以访问MyLib的.a和.h了,现在配置MyApp访问MyLibBundle。本人愚笨,因为时间关系,暂时没有找到一个非常好的办法,但是想出一个方法可以解决这个问题。进入MyApp的“Build Phases”,添加选项“Run Scrip”,添加下述脚本:
cp -R ${BUILT_PRODUCTS_DIR}/MyLibBundle.bundle ${BUILT_PRODUCTS_DIR}/${TARGET_NAME}.app
MyLibBundle.bundle就是你在MyLib中新建的bundle的target名字。该脚本作用就是把生成的.bundle拷贝到最终生成的.app中,这样.app中就包含了我们MyLib要用到的资源。
5. 做完上述操作,已完成了多工程联编的99%的配置工作。现在我们编译MyApp工程,已经会先编译MyLib,然后一切运行OK,但是运行程序时爆掉了,原因是我们用到了MyLib的UI,但MyLib找不到这个MyLibBundle。原来我们还未联编MyLibBundle这个target。 简单,进入target“MyLib"的“Build Phases”,展开“Target Dependencies”,添加“MyLibBundle”。这样就添加了MyLib的依赖,在编译MyLib时,编译器就会去编译MyLibBundle。好啦,再重新编译,发现已经可以正常运行啦,但是需要告诉广大同胞的是,我们在修改了MyLib的代码时,最好clean一下工程在重新编译,因为xcode的缓存可能导致你刚刚修改的内容尚未编译到.a中。