APICloud iOS模块开发

概念 名词解释

• 模块: 将特定功能或UI用原生代码封装成一个js对象.
• 回调: 前端传来的消息,经过模块原生代码处理后,把处理结果从原生向前端发送信息的过程.

准备

• 下载模块开发sdk ,里面的ModulesDevProject_iOS为iOS部分
• 里面的ModelDemo为生成模块的部分: ModelDemo为待待压缩模块文件夹,ModelDemo.zip为ModelDemo文件夹的压缩包,也是最终上传的模块文件. ModelDemoProject为生成ModelDemo.a静态库文件的工程.
• ModulesDevProject为用于开发模块的模板及测试工程.
• 整个流程为: 开发测试工程中开发-->静态库工程中生成静态文件-->按要求组织模块文件夹并压缩上传-->云编译应用(-->自定义loader)

开发测试项目组织说明

Paste_Image.png

开发引擎: UZEngine文件夹

• UZModule为模块基类,自己开发的模块要继承自此类
• 原生与js的对接都使用这个引擎里的接口

开发及调试

• 开发自己的模块原生代码
• 在moudule.json文件中配置
  • name对应值为模块的名称，js中通过该名称来使用模块；
  • class对应值为模块的类名；
  • methods中配置的是实例方法，js中调用的就是这里的方法，多个方法以英文逗号隔开；
  • launchClassMethod为可选项配置，若配置，引擎将在应用启动的时候调用该方法，注意该方法需是类方法，没有参数。

模块打包静态库

• 创建Cocoa Touch Static Library工程,删除默认的h和m文件删除
• Edit Scheme 中配置run-> build Configuration为release
• 配置deployment Target为6.0
• buildSetting中为Architectures添加指令集armv7s; 设置build active Architecture only 为 NO
• 模块源码加入工程
• 引入必要的模块引擎.h头文件(没用到的也可以放进来,反正文件体积不大),注意.a文件不用引入.
  • 对于第三方库,也是只引入.h文件,.a后边放入target目录中
• 选择编译类型为Generic iOS Device, 进行编译.a静态文件,并获取到该文件

打包模块

• 新建模块名命名的文件夹
• 在上一步创建的文件家中创建下图所示的文件和文件夹
  • target文件夹中放置模块的静态库文件以及用到的第三方静态库文件,framework文件,budle资源文件
  • module.json文件中配置模块的相关信息

模块文件夹组织

上传到自定义模块中

• 项目中添加自定义模块,然后云编译生成安装包
• 如果有需要,云编译后可以生成自定义loader来使用. 自定义loader的相关权限和参数以最近一次云编译为准.