烽火exmobile--ios原生插件开发

Posted 2020-08-19

一：开发

工具xcode、mbuilder

1：在http://www.exmobi.cn/open/resource.html网站下载生成插件包，XKPlugin_Test2_ComponentFactory是使用时的插件工厂，可以改成自己的名称想使用的名称：XKPlugin_CPI_ComponentFactory.h；其他文件XKPlugin_Component不要改动。

2：XKPlugin_CPI_ComponentFactory.m文件中，修改红色代码，CPI_CalendarComponent是自己写的插件类。

	-    (XKPlugin_Component*) createComponent:(NSString*) type {     NSLog(@"XKPlugin_Component    createComponent %@", type);     //根据插件type名构建插件     if    ([@"CPI_CalendarComponent" isEqualToString:type]){            return [[CPI_CalendarComponent alloc] init];                }     return nil; }

 

3：新建插件类，AppPlugin下，新建New Group，名称是CPI_CalendarComponent，在此文件夹下新建文件，

New File...-->Cocoa Touch Class-->Class(class就是插件类名称，和步骤2中的红色代码中的type类型一致CPI_CalendarCpmponent)-->SubClass(NSObject)-->Language(Objective-C)；

#import <UIKit/UIKit.h>    #import "XKPlugin_Component.h"    @interface CPI_CalendarComponent :  XKPlugin_Component    @property (strong, nonatomic) NSString* idetifier ;

4：CPI_CalendarCpmponent.h文件中导入基础插件类（XKPlugin_Component）,其中idetifier 是需要返回的回调值

 

5：CPI_CalendarCpmponent.m中，

（1）getView是返回视图，如果有视图，则返回视图模式，如果不返回视图，则只可以直接返回一个nil；

（2）call方法是js和插件之间调用的桥梁，第一个参数必须是方法名称，用来判断js调用的什么方法，最多有起个参数，前台自己传参，只要不大于7个就可以，后台自己判断参数个数。call方法格式不要修改，不要在call方法中使用UIAlert方法，容易造成闪退。

<nativecomponentid="native"style="width:200;height:300"type="ABC_SliderComponent"  factoryname=" XKPlugin_Test2_ComponentFactory"onchange="changetodo"minvalue =”1”maxvalue=”10”></nativecomponent>

（3）set方法是获取前台nativecomponent的xml标签中的参数

 

（4）setValue是插件的回调，在方法体里执行了需要操作的功能之后，回调一个值返回

	SEL sel = @selector(setValue:);     if([delegate respondsToSelector: sel]) {            [delegate performSelector: sel withObject: @"success"];     }

 

5：get方法是可以在mbuilder上可以调用的返回值。

	var nav = document.getElementById("nav"); var test = nav.get("test");

 

前段页面调用MBuilder

1：body里放xml标签文件，其实“type”代表的是你写的插件类，id是自己定义的，在js中使用

var nav= document.getElementById("nav");来获取这个插件，factoryname是写的工厂类，wid是自己定义的方法，js中使用toGetWid(v)方法来获取这个回调回来的值，就是xcode插件中，setValue中和回调函数一起返回过来的参数。

<nativecomponent     type="CPI_CalendarComponent" id="nav"     factoryname="XKPlugin_CPI_ComponentFactory"    wid="toGetWid">    </nativecomponent>

 

 

 

 

 

二：打包

1：新建一个文件夹，名称为自己定义的工厂类：XKPlugin_CPI_ComponentFactory

2:将xcode中的代码通过编译，点击AppPlugin项目-->Product-->Archive。

3:可以在项目的Products目录下看见一个libplugin.a文件，右键点击-->Show in Finder,将.a文件复制到文件夹中。

4：将自己写的工厂类XKPlugin_CPI_ComponentFactory.h文件复制到文件夹中

5：在文件夹中新建一个framework文件夹，里面新建一个framework.txt文档，将插件项目中所需要的freamwork相对路径放到.txt文件中，将插件工程中所需要的.a文件或者其他第三方framework库复制到framework文件夹中

6：新建image文件夹，将插件工程中所需要的图片放到文件夹中

7：新建other文件夹，将项目中一些其他文件放置到这个文件夹中，比如plist、xml文件（如果说插件中需要设计到权限的问题，需要在plist文件中添加权限）；

8：新建xib文件夹，将插件工程中需要的xib文件放到文件夹中（返回视图的插件需要，不然不需要）；

9：新建natives文件夹，在文件夹下新建文件夹，名称为插件类的名称CPI_CalendarComponent，新建config.xml文件，作为插件的版本信息，可以有有多个插件，config文件格式如下，其中version是版本号，每次要更新的时候需要提高版本号，不然会打包失败。type是你的插件类，factoryname是工厂类，其他信息可以随便填了。

<?xml version="1.0"    encoding="UTF-8"?> <config>    <version>1.1.9</version>       <type>CPI_CalendarComponent</type>       <factoryname>XKPlugin_CPI_ComponentFactory</factoryname>       <description>日程写入</description>       <date></date>       <vendor url="" email=""></vendor> </config>

 

10：所有文件完成之后，压缩XKPlugin_CPI_ComponentFactory，格式必须是.zip格式的。

11：插件打包好之后登陆到烽火的控制台，在插件管理中，添加插件，打包成功之后，在mbuilder打包的时候 可以修改ios的打包配置文件，将自己的插件添加进去就可以使用了。

 

三：遇到的问题

Q：打包的时候，烽火平台的教程上，直接选择了文件夹中的七项，然后压缩，上传之后显示打包失败；

A：文件夹中的七个选项，外面还需要加一层工厂类的文件夹，然后再压缩，压缩格式必须是ZIP格式的。

Q：在IOS平台压缩打包，上传失败

A：IOS平台打包的时候，文件夹中会出现多余的文件，导致打包失败，将所有的文件拷到windows平台压缩。

Q：第一次上传成功，第二次失败

A：一个可能是修改的插件有问题，还有一个可能是因为config.xml文件中version的版本号没有提高导致的。

Q：本次所做的日历插件中，ios10以下的版本可以正常使用，ios10以上的没有反应

A：IOS10的版本提高了安全性，在开发的时候，需要加上权限，在AppPlugin的文件夹下，新建一个info.plist文件，或者直接从别处拷过来，在Information Property List 下添加一个App TransportSecurity Settings 选项，在此项下面加上插件所需要的权限。然后选中AppPlugin工程，在Build Settings选项下面找到 packaging-->info.plist File 选项，将info.plist文件的路径加上去，并且将这个plist文件加入到打包文件夹中的other文件夹下。

Q：打包成功之后安装app，但是打开之后会有闪退现象

A：第一，在MBuilder中打包的项目的时候，基座版本不要选的太高

   第二，在插件的call方法中，不要使用UIAlert方法弹出信息，将所需的信息通过回调，返回到js中，        通过js去回调。

Q：使用get方法获取参数值，在js中使用nav.get("v"),信息没有返回

A：返回的参数没有获取到，参数需要操作成功之后通过自身的回调函数回来，js使用时并没有获取到这个参数值，callbackFunction是从set方法中根据前端<nativecomponent>中自定义的名称获取的，helper_callJsScript调用了js中的方法名称。

 

-(void) set:(NSString*) name value:(NSString*)value{          if ([@"wid" isEqualToString: name]){              callbackFunction = [NSString stringWithString:value];          }    }   -(void*)setValue:(NSString*)v{         wid = v;         if (callbackFunction.length > 0){             NSString* string = [NSString stringWithFormat:@"%@ (\"%@\")",callbackFunction,v];             [self helper_callJsScript:string];         }        return nil;    }

 

本文出自 “落幕青” 博客，请务必保留此出处http://lmq4930.blog.51cto.com/3208925/1872745