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

时间:2022-03-14 20:18:03

最近公司有使用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,然后在模块里面实现该方法,当应用启动时该方法就会被执行。

  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. }

2.4. 方法调用

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

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

  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端,代码如下:

  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的配置 注意不要[+]以及引号的英 汉。

  1. {
  2. "name":"moduleDemo",//模块包名一致
  3. "class":"UZModuleDemo",//模块类名
  4. "methods":["showAlert","method"],//自己定义的方法名
  5. "launchClassMethod":"launch"//是否执行launc类方法
  6. }

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

  1. var param = {
  2. msg:"Hello App!"
  3. };
  4. var demo = api.require('moduleDemo');//模块包名称 (module.json 这里 模块包名称 三者要一致)
  5. demo.showAlert(param, callBack);//传参数调用方法 和回调
  6. function callBack(ret, err){
  7. var msg;
  8. if (ret.index == 0){
  9. msg = "点击了第一个按钮";
  10. } else {
  11. msg = "点击了第二个按钮";
  12. }
  13. api.toast({
  14. msg:msg
  15. });
  16. }

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