MonoTouch绑定CocoaTouch类库

绑定概述

在 Windows/Linux 平台上， .Net/Mono 可以通过平台调用 (P/Invoke) 技术调用本地类库， 通过互操作 (Interop) 技术调用 COM 组件， 在 iOS 平台上， MonoTouch 也有类似的技术， 可以调用 iOS 的 CocoaTouch 类库， 这种技术在 MonoTouch 叫做绑定 (Binding) ， 整个 monotouch.dll 就是用绑定技术完成的。

互联网上有很多热心网友提供的 CacoaTouch 类库， 如果想使用这些类库， 完全用 C# 重写是不可取的， 所以就要用到 MonoTouch 的绑定技术。

绑定技术听起来高深， 其实仔细研究起来， 其实并不难。 接下来， 以 KKGridView 为例， 说明怎样绑定 CocoaTouch 类库项目。

准备 MonoTouch 绑定项目

新建一个名称为 KKGridView 的空白解决方案， 作为工作区， 再新建一个绑定项目， 名称为 Binding ， 项目建好之后， 设置绑定项目的默认命名空间为 MonoTouch.KKGrid ， 并设置项目的输出为 KKGridView ， 相关截图如下：

绑定项目默认结构如下， 包含两个文件： ApiDeginition.cs 和 StructsAndEnums.cs ， 其中 ApiDefinition 用于绑定 CacoaTouch 类库定义的 interface 、 delegate 与 protocol 及其成员， 而 StructsAndEnums 用于绑定 ApiDefinition 所需的结构、 枚举以及其它。 这两个文件的编译方式是不同的， 所以对应的 C# 类型必须对号入座才行。

获取 KKGridView 源代码并编译

KKGridView 在 GitHub 上的主页是 https://github.com/kolinkrewinkel/KKGridView.git ， 使用 git 可以轻松获取其源代码。 打开一个命令行窗口， 切换到绑定项目目录， 输入下面的命令：

?

1	git clone https://github.com/kolinkrewinkel/KKGridView.git

等命令行运行完毕， 源代码就获取好了， 接下来要编译 KKGridView ， 接着输入下面的命令：

?

1 2 3 4

cd KKGridView xcodebuild -project KKGridView.xcodeproj -target KKGridView -sdk iphonesimulator -configuration Release clean build xcodebuild -project KKGridView.xcodeproj -target KKGridView -sdk iphoneos -configuration Release clean build lipo -create -output libKKGridView.a build/Release-iphonesimulator/libKKGridView.a build/Release-iphoneos/libKKGridView.a

现在打开 MonoDevelop 将最终生成的 libKKGridView.a 添加到绑定项目 ， 现在可以开始进行绑定了。

绑定 Objective-C 类型至 C#

绑定的语法定义为：

?

1 2 3 4

[BaseType(typeof(TypeBase))] interface MyType [: Prodocol1, Protocol2] {    IntPtr Constructor(string foo); }

MyType 与 ObjC 的类型对应， TypeBase 与 ObjC 的基类对应， Protocol1 、 Prodocol2 与 ObjC 类型实现的协议对应。

interface

ObjC 的 interface 定义如下：

?

1 2	@interface KKGridView : UIScrollView @end

对应的绑定语法如下：

?

1 2 3

[BaseType(typeof(UIScrollView))] interface KKGridView { }

protocol

ObjC 的 protocol 定义语法如下：

?

1 2	@protocol KKGridViewDataSource <NSObject> @end

或者

?

1 2	@protocol KKGridViewDelegate <NSObject , UIScrollViewDelegate> @end

ObjC 的 protocol 与 C# 的 interface 有些类似， 但是 protocol 中定义的方法有两种， optional 和 required ， 又有点儿像抽象类， MonoTouch 将其绑定为类， 并添加 ModelAttribute 标记， 对应的绑定语法分别为：

?

1 2 3 4 5 6 7

[Model, BaseType(typeof(NSObject))] interface KKGridViewDataSource { }   [Model, BaseType(typeof(UIScrollViewDelegate))] interface KKGridViewDelegate { }

instance method

实例方法绑定为对应的 C# 实例方法：

?

1	- (NSString *)gridView:(KKGridView *)gridView titleForHeaderInSection:(NSUInteger)section;

?

1 2	[Export("gridView:titleForHeaderInSection:")] string GridViewTitleFoHeaderInSection(KKGridView gridView, uint section);

如果是 protocol 的 required 方法， 则在对应的 C# 方法上添加 Abstract 标记， 例如：

?

1	- (NSUInteger)gridView:(KKGridView *)gridView numberOfItemsInSection:(NSUInteger)section;

?

1 2	[Abstract, Export("gridView:numberOfItemsInSection:")] uint GridViewNumberOfItemsInSection(KKGridView gridView, uint section);

class method

ObjC 中的 class method 与 C# 中的静态方法概念一致， 因此绑定为 C# 的静态方法， 例如：

?

1	+ (id)cellForGridView:(KKGridView *)gridView;

?

1 2	[Static, Export("cellForGridView:")] KKGridViewCell CellFroGridView(KKGridView gridView);

property

ObjC 的属性通常由 setPropertyName 、 propertyName 两个方法组成， 绑定为 C# 的属性：

?

1	@property (nonatomic) BOOL allowsMultipleSelection;

?

1 2	[Export("allowsMultipleSelection")] bool AllowsMultipleSelection { get; set; }

如果不是由默认的两个方法组成， 例如：

?

1	@property (nonatomic, getter = isSelected) BOOL selected;

对应的绑定为：

?

1 2	[Export("selected")] bool Selected { [Bind("isSelected")]get; set; }

enum

枚举的绑定是最容易的， 不过要放在 enums.cs 文件中， 例如：

?

1 2 3 4 5 6 7 8 9 10 11

typedef enum {    KKGridViewAnimationFade,    KKGridViewAnimationResize,    KKGridViewAnimationSlideLeft,    KKGridViewAnimationSlideTop,    KKGridViewAnimationSlideRight,    KKGridViewAnimationSlideBottom,    KKGridViewAnimationExplode,    KKGridViewAnimationImplode,    KKGridViewAnimationNone } KKGridViewAnimation;

?

1 2 3 4 5 6 7 8 9 10 11

public enum KKGridViewAnimation {    Fade,    Resize,    SlideLeft,    SlideTop,    SlideRight,    SlideBottom,    Explode,    Implode,    None }

添加 Makefile

?

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 31 32 33 34 35 36 37 38 39 40 41 42

# 定义一些常量 PROJECT_ROOT=KKGridView PROJECT=$(PROJECT_ROOT)/$(PROJECT_ROOT).xcodeproj BUILD_ROOT=$(PROJECT_ROOT)/Build TARGET=$(PROJECT_ROOT) SDK=lib$(TARGET).a BTOUCH=/Developer/MonoTouch/usr/bin/btouch SMCS=/Developer/MonoTouch/usr/bin/smcs XBUILD=/Developer/usr/bin/xcodebuild   # 从github获取源代码 $(PROJECT_ROOT):    git clone https://github.com/kolinkrewinkel/$(PROJECT_ROOT).git    cd $(PROJECT_ROOT) && git pull   # 编译模拟器版本 simulator: $(PROJECT_ROOT)    mkdir -p libs    $(XBUILD) -project $(PROJECT) -target $(TARGET) -sdk iphonesimulator -configuration Release clean build    mv -f $(BUILD_ROOT)/Release-iphoneSimulator/lib$(TARGET).a ./libs/lib$(TARGET)-simulator.a   # 编译设备版本 iphoneos: $(PROJECT_ROOT)    mkdir -p libs    $(XBUILD) -project $(PROJECT) -target $(TARGET) -sdk iphoneos -configuration Release clean build    mv -f $(BUILD_ROOT)/Release-iphoneos/lib$(TARGET).a ./libs/lib$(TARGET)-iphoneos.a   # 讲两个版本合成为一个 sdk:    lipo -create -output $(SDK) libs/lib$(TARGET)-simulator.a libs/lib$(TARGET)-iphoneos.a   # 编译 MonoTouch 组件 asm:    # 使用 btouch 编译出的 dll 文件总是无法运行， 不知是怎么回事， 只能用 MonoDevelop 进行编译， 所以把这里注释掉了。    #$(BTOUCH) -d=MONOTOUCH -out:bin/$(TARGET).dll api.cs -s:enum.cs --link-with=$(SDK),$(SDK)   # 清理 clean:    rm -rf $(PROJECT_ROOT) libs ios *.a *.dll *.stamp   # 全部任务 all: clean simulator iphoneos sdk asm

绑定项目源代码

KKGridView 的全部绑定源代码放在 GitHub ， 地址为 https://github.com/beginor/MonoTouch.KKGridView ， 有兴趣的可以围观。