一:开发

工具xcodembuilder

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