iOS-APICloud混合模块开发

        技术的革新日新月异,技术发展日新月异.当然,前端开发和原生开发各有所长,我接下来的系列文章,将和各位一起耍耍原生混合模块开发!同样,也看看原生和前端相爱相杀的故事~好了,直接进入正题    

 一.是什么? 通俗一点,就是iOS原生开发App某一个功能或者模块,然后接入前端的项目中

 二.开发环境: 

         1.Xcode6.0或更高版本

         2.Mac os x 10.9以上

三.开发步骤

1.前往http://docs.apicloud.com/APICloud/download下载最新版本的模块开发SDK，找到里面的ModulesDevProject_iOS.zip，这里面包含ModuleDemo、ModulesDevProject和说明文件，进行模块开发之前一定要先阅读read me.txt，了解各个目录里面的内容和功能

2.下载模块中SDK后,删除原有demo中的文件(投机办法,直接将项目中原有模块删除,后面步骤中就可以直接创建自己的模块)

修改原有的demo中文件的内容,将原有的 (模块名称/类名/方法)    删除,修改为自己要用的名称

3.使用APICloud 项目demo中自己修改过的混合模块开发项目(ModulesDevProject  文件夹中的工程工具)

5.打开开发工具工程,修改模块名称

>查找到文件夹

>修改这两个文件夹名称为你自己模块想要命名的名称,且这两个文件夹名称一样

6.创建自己的模块(静态库工程),命名与步骤2中的模块命名一样

先关闭创建的静态库工程,然后打开UZApp工程,将静态库工程中.xcodeproj  文件拖入到UZModules 下面

最后我们需要将静态库工程的Build Active Architecture Only设置为No，如图：

7.创建模块类

在ModuleDemo静态库工程中引入必要的UZModule.h头文件，UZAppDelegate.h和UZAppUtils.h等头文件根据需要引入，这些头文件可以在下载的SDK包里面找到。

在ModuleDemo静态库工程中新建一个UZModuleDemo类，继承于UZModule类，其中UZModule类为模块的基类。模块开发过程中文件命名时提倡加前缀，以避免和其它模块冲突。

模块生命周期：

当在前端JS中首次调用模块的方法时，引擎会调用模块类的 - (id)initWithUZWebView:(UZWebView *)webView 方法进行初始化；

当模块所在的页面被销毁时，模块类也会被销毁，引擎会主动调用其 - (void)dispose 方法。

8.回传数据给JS

我们在这里将用户点击的按钮的index回调给JS端，注意sendResultEventWithCallbackId:dataDict:errDict:doDelete:方法的最后一个参数，如果需要多次进行回调，那么就必须传NO。

- (void)alertView:(UIAlertView *)alertView didDismissWithButtonIndex:(NSInteger)buttonIndex {

if(_cbId >0) {

NSDictionary*ret = @{@"index":@(buttonIndex)};

[selfsendResultEventWithCallbackId:_cbId dataDict:ret errDict:nildoDelete:YES];

}

}

9. JS调用模块方法

前端JS必须使用JSON格式数据作为JS与Native之间交换数据的传参，APICloud引擎会对JS传入的参数进行解析并封装，前端JS使用模块之前需要require模块对象。

找到UZApp工程中widget目录下的index.html，添加调用moduleDemo模块的showAlert方法的代码：

functionshowAlert(){

vardemo = api.require('moduleDemo');

demo.showAlert({

msg:'Hello App!'

},function(ret, err){

varmsg ="点击了第"+ ret.index +"个按钮";

api.toast({

msg: msg

});

});

}