[转]封装自己的控件库:iPhone静态库的应用
?
由于iPhone控件的极度匮乏和自定义组件在重用上的限制,在过去的项目中我们积累了大量的“纯代码”组件——因为IB本身的限制,我们无法把这些组件封装为IB组件库(本来我们想通过分发xib文件的方式重用这些组件,但最终发现这根本不可能,苹果的Plug-in编程不支持iPhone)。
最终我们想到了静态库。虽然这仍然还是一种比较原始的复用方式,但起码我们可以隐藏组件的源代码。
下面, 我们使用iPhone静态库把自定义组件CheckButton 进行进一步的封装。(组件的实现参考前一篇博文《自定义控件复选框和单选框的实现》)
一、实现静态库
新建工程,?选择?Library?下的?“?Cocoa Touch Static Library?”?。给工程命名,例如:yhyLibrary。?????????????????
复制CheckButton组件的4个源文件:CheckButton.h、CheckButton.m、RadioGroup.h、RadioGroup.m到Classes目录下,同时把CheckButton的4个资源文件:check.png、uncheck.png、radio.png、unradio.png,复制到工程文件夹。
按下???+b编译,在Products目录下即产生一个 .a文件。
二、?新建资源束
静态库中并不能包含资源文件,虽然我们已经把4个资源文件(.png文件)拷贝到静态库工程中,但实际上这些.png是不会添加到target的,也就是说编译结果中并不包含这些资源,因此如果此时调用静态库,所有的资源(字符串、图片)都是缺失的。
我们可以把资源建立成单独的束(Bundle)。
新建工程“?Mac OS X??-> Framework & Library -> Bundle?”,命名为:yhyLibraryBundle。
然后把上面4个.png文件拷进Resouces中去。编译,生成yhyLibraryBundle.bundle文件。
返回静态库工程,新建一个类:Utils 。
编辑Utils.h:
#define MYBUNDLE_NAME @?"yhyLibraryBundle.bundle"
#define MYBUNDLE_PATH [[[NSBundle mainBundle] resourcePath] stringByAppendingPathComponent: MYBUNDLE_NAME]
#define MYBUNDLE [NSBundle bundleWithPath: MYBUNDLE_PATH]
NSString?* getMyBundlePath(?NSString?* filename);
编辑Utils.m:
#import?"Utils.h"
NSString* getMyBundlePath(?NSString?* filename)
{
?
NSBundle?* libBundle =?MYBUNDLE?;
if?( libBundle && filename ){
NSString?* s=[[libBundle?resourcePath?]?stringByAppendingPathComponent?: filename];
NSLog?(?@"%@"?,s);
return?s;
}
return?nil?;
}
函数getMyBundlePath可以取得束yhyLibraryBundle中具体资源的绝对文件路径,如:
/Users/kmyhy/Library/Application Support/iPhone Simulator/4.2/Applications/8213652F-A47E-456A-A7BB-4CD40892B66D/yhyLibTest.app/yhyLibraryBundle.bundle/Contents/Resources/radio.png
同时,修改CheckButton.m中的代码,导入Utils.h头文件,把其中获取图片的代码由imageNamed修改为imageWithContentsOfFile,如:
[?icon?setImage?:[?UIImage?imageWithContentsOfFile?:?getMyBundlePath?(?checkname?)]];
即通过绝对路径读取图片资源。
除了这种方法,我们还可以有一个简单办法,就是把4个资源文件直接拷贝到你调用静态库的应用工程中(不需要修改静态库代码)。
?
三、静态库调用
1、添加静态库
新建Window-based Application工程,给工程命名,如yhyLibraryTest。
右键点?Frameworks->Add->Existing Files..?,把静态库工程的yhyLibrary.xcodeproj文件?添加到当前工程(不要选择Copy items?)?。
?
选中添加进来的yhyLibrary.xcodeproj文件,勾选“include to target”选项,如下图,打上最后一个小勾:
?
2、添加Direct Dependencies(即引用工程)
类似于Visual Studio中的引用工程,目的是便于在本工程中直接编辑所引用的静态库工程,以便对静态库进行修改。
在“?Targets?”目录下选择“?FirstLibraryTest?”,点击“info”按钮,调出目标的属性窗口,切换到“General”栏,点击“Direct Dependencies?”下方的“?+?”按钮,将工程静态库libyhyLibrary添加到Direct Dependencies中,结果如下图:
?
?
3、添加头文件搜索路径
打开工程的info窗口,在Build栏中找到Header Search Paths,添加字符串“../yhyLibrary”。
4、 引用资源束
在target的Copy Bundle Resources上右键,选择“Add->Existing File…”,把前面生成的yhyLibraryBundle.bundle束添加到工程。
5、调用静态库中的类
编辑?application:(?UIApplication?*)application didFinishLaunchingWithOptions:?方法中的代码:
//?单选按钮组
RadioGroup?*?rg?=[[?RadioGroup?alloc?]?init?];
//?第?1?个单选按钮
CheckButton?* cb=[[?CheckButton?alloc?]?initWithFrame?:?CGRectMake?(?20?,?60?,?260?,?32?)];
//?把单选按钮加入按钮组
[?rg?add?:cb];
cb.?label?.?text?=?@"★"?;
cb.?value?=[[?NSNumber?alloc?]?initWithInt?:?1?];
//?把按钮设置为单选按钮样式
cb.?style?=?CheckButtonStyleRadio?;
//?加入视图
[?self?.?window?addSubview?:cb];
[cb?release?];?//add?后,会自动持有,可以释放
//?第?2?个单选按钮
cb=[[?CheckButton?alloc?]?initWithFrame?:?CGRectMake?(?20?,?100?,?260?,?32?)];
[?rg?add?:cb];
cb.?label?.?text?=?@"★★"?;
cb.?value?=[[?NSNumber?alloc?]?initWithInt?:?2?];
cb.?style?=?CheckButtonStyleRadio?;
[?self?.?window?addSubview?:cb];
[cb?release?];
//?第?3?个单选按钮
cb=[[?CheckButton?alloc?]?initWithFrame?:?CGRectMake?(?20?,?140?,?260?,?32?)];
[?rg?add?:cb];
?
cb.?label?.?text?=?@"★★★"?;
cb.?value?=[[?NSNumber?alloc?]?initWithInt?:?3?];
cb.?style?=?CheckButtonStyleRadio?;
[?self?.?window?addSubview?:cb];
[cb?release?];
运行结果如下:
?
6、分发静态库
将生成的.a文件和.bundle文件打包分发给其他人。