【转】学习apicloud和IOS之间的模块化使用

最近公司有使用APICloud发开的需求，需要我这边提供一些模块包得封装。因为没有也是刚接触APICloud，所以也就在看官方文档 。下面讲一讲我再使用过程中得一点点东西。

  首先，下载官方SDK,下载最新版本的模块开发SDK，找到里面的ModulesDevProject_iOS.zip，这里面包含ModuleDemo、ModulesDevProject和说明文件。ModuleDemo是一个官方的模块包封装和静态库生成的工程。ModulesDevProject则是可以让我们自己调试的工程。

模块类实现

2.1. 新建模块类

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

2.2. 模块生命周期

当前端js中调用模块方法时，模块首先会被初始化，引擎会调用其 - (id)initWithUZWebView:(UZWebView *)webView 方法；

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

2.3. 启动方法

如果模块需要在应用启动的时候就执行一些操作，那么首先得在module.json里面配置launchClassMethod，例如配置的方法为launch，然后在模块里面实现该方法，当应用启动时该方法就会被执行。

[objc] view plaincopy在CODE上查看代码片派生到我的代码片
 
  1. + (void)launch{  
  2.  //在module.json里面配置的launchClassMethod，必须为类方法，引擎会在应用启动时调用配置的方法，模块可以在其中做一些初始化操作；下面代码为注册一个实现了UIApplicationDelegate协议方法的对象，该对象中方法就会在需要的时候被调用，通过此方式可以实现第三方应用回调url解析、推送等常用功能  
  3.  //UZApphandler 基础Object基类 可以做一些需要AppDelegate 实现的初始化 如初始化推送的AppKey等等  
  4.    // UZAppHandler *appHandler = [[UZAppHandler alloc] init];  
  5.    // [theApp addAppHandle:appHandler];  
  6.   
  7. }  



2.4. 方法调用

实现 - (void)showAlert:(NSDictionary *)paramDict 方法，用于显示一个对话框，该方法需要在module.json里面配置，然后在前端js里面才可以调用该方法。

如果前端调用该方法时传入了一个function，那么在这里可以通过cbId字段获取该function对应的id，然后在需要的时候把数据通过该function回调给js。

[objc] view plaincopy在CODE上查看代码片派生到我的代码片
 
  1. - (void)showAlert:(NSDictionary *)paramDict {  
  2.     _cbId = [paramDict integerValueForKey:@"cbId" defaultValue:-1];  
  3.     NSString *message = [paramDict stringValueForKey:@"msg" defaultValue:nil];  
  4.     UIAlertView *alert = [[UIAlertView alloc] initWithTitle:nil message:message delegate:self cancelButtonTitle:@"取消" otherButtonTitles:@"确定", nil nil];  
  5.     [alert show];  
  6. }  

2.5. 回调

我们在这里实现UIAlertViewDelegate中的 - (void)alertView:(UIAlertView *)alertView didDismissWithButtonIndex:(NSInteger)buttonIndex 方法，将用户点击的按钮index回调给js端，代码如下：

[objc] view plaincopy在CODE上查看代码片派生到我的代码片
 
  1. - (void)alertView:(UIAlertView *)alertView didDismissWithButtonIndex:(NSInteger)buttonIndex {  
  2.     if (_cbId >= 0) {  
  3.         NSDictionary *ret = @{@"index":@(buttonIndex)};  
  4.         [self sendResultEventWithCallbackId:_cbId dataDict:ret errDict:nil doDelete:YES];  
  5.     }  
  6. }  


当然，也可以定义自己的方法method,同时要修改module.json的配置 注意不要[+]以及引号的英 汉。

[objc] view plaincopy在CODE上查看代码片派生到我的代码片
 
  1. {  
  2.     "name":"moduleDemo",//模块包名一致  
  3.     "class":"UZModuleDemo",//模块类名  
  4.     "methods":["showAlert","method"],//自己定义的方法名  
  5.     "launchClassMethod":"launch"//是否执行launc类方法  
  6. }  

找到widget目录下html目录里面的module-con.html，我们在这里面调用showAlert等方法，如下

[objc] view plaincopy在CODE上查看代码片派生到我的代码片
 
  1. var param = {  
  2.     msg:"Hello App!"  
  3. };  
  4. var demo = api.require('moduleDemo');//模块包名称 （module.json 这里 模块包名称 三者要一致）  
  5. demo.showAlert(param, callBack);//传参数调用方法 和回调  
  6.   
  7. function callBack(ret, err){  
  8.     var msg;  
  9.     if (ret.index == 0){  
  10.         msg = "点击了第一个按钮";  
  11.     } else {  
  12.         msg = "点击了第二个按钮";  
  13.     }  
  14.     api.toast({  
  15.         msg:msg  
  16.     });  
  17. }  


调试好了之后，把添加 修改的文件 加入ModuleDemo的静态库工程（也可以自己创建），去掉没用的，选择iOS device编译,复制静态库文件。 创建文件夹名称和模块包一致，里面在创建target文件夹，把静态库文件粘贴进来，加入用到了第三方的Framework和bundle束也放进来。 target同级目录粘贴module.json文件，返回压缩成zip文件. 获取在apicloud创建的应用的Id 修改widget下config.xml 顶部的id,复制压缩widget文件。在apicloud控制台，转到该应用，选择代码部分，上传widget.zip 跳转模块中自定义模块上传模块包，名称必须和模块包名称一致。保存 编译，如果没有意外，你就能扫二维码 下载安装你的应用到手机了。 这里默认的时apicloud提供的证书，加入要改自己的就看证书栏目，都有教程的。Mark!

【推广】 免费学中医，健康全家人
原文地址：https://www.cnblogs.com/xuan52rock/p/5125019.html