Skip to content

在Cordova及插件的基础上封装一些常用的功能,不断更新中

License

Notifications You must be signed in to change notification settings

wujunyang/JiaCordova

Repository files navigation

JiaCordova介绍

JiaCordova是为了让项目对于Cordova引入更加方便快捷的一个封装式插件,插件中已经集成的关于Cordova跟其一些常用的第三库,对于Cordova的配置模板也进行整理,且封装从服务端下载ZIP包进行解压到沙盒文件夹中,利用Cordova进行请求的功能;最大程度上简化关于Cordova的运用跟学习成本;

Cordova理论知识点

Cordova提供了一组设备相关的API,通过这组API,移动应用能够以JavaScript访问原生的设备功能,如摄像头、麦克风等。Cordova还提供了一组统一的JavaScript类库,以及为这些类库所用的设备相关的原生后台代码。Cordova支持如下移动操作系统:iOS, Android,ubuntu phone os, Blackberry, Windows Phone, Palm WebOS, Bada 和 Symbian。

JiaCordova默认已经引入Cordova插件如下:

    pod 'CordovaPlugin-console'
    pod 'cordova-plugin-camera'
    pod 'cordova-plugin-contacts'
    pod 'cordova-plugin-device'
    pod 'cordova-plugin-device-orientation'
    pod 'cordova-plugin-device-motion'
    pod 'cordova-plugin-globalization'
    pod 'cordova-plugin-geolocation'
    pod 'cordova-plugin-file'
    pod 'cordova-plugin-media-capture'
    pod 'cordova-plugin-network-information'
    pod 'cordova-plugin-splashscreen'
    pod 'cordova-plugin-inappbrowser'
    pod 'cordova-plugin-file-transfer'
    pod 'cordova-plugin-statusbar'
    pod 'cordova-plugin-vibration'

JiaCordova运用

一:引用方式

pod 'JiaCordova'

只要简单运用Pod指令并可以引入,目前iOS最低版本支持为8.0

二:资源文件引入

目前在插件中有两种方式进行引入资源文件(html页面、JS脚本、CCS文件等),都是以ZIP包进行存放;

1:第一种是存放在工程中的某个目录中,然后APP第一次运行时就会实现对它进行解压;实现的代码如下:

    JiaCordovaFileManage *fileManager=[[JiaCordovaFileManage alloc]init];
    [fileManager loadLocalFileName:@"html.zip" unZipFolderName:@"www" successBlock:^{
        NSLog(@"成功");
    } failBlock:^(NSString *errorInfo) {
        NSLog(@"失败");
    }];

其中html.zip就是对应的资源压缩包,而unZipFoldName就是解压后在沙盒目录下的文件夹名称,如果unZipFoldName则会默认以资源包的名称作为其解压后的名称;

2:第二种则是通过网络请求到的资源包,插件会进行下载并对它进行解压;实现的代码如下:

    JiaCordovaFileManage *fileManager=[[JiaCordovaFileManage alloc]init];
    
    [fileManager loadFileWithUrl:@"http://test.qshmall.net:9090/html.zip" unZipFolderName:@"html" deleteZip:YES successBlock:^{
        
    } failBlock:^(NSString *errorInfo) {
        
    }];

其中相应的参数类似第一种,而deleteZip是为了标识当解压成功后是否要对ZIP包进行删除;

三:项目页面使用

在插件中已经封装的一个控制器JiaCordovaViewController页面,对于一些常规的操作跟设置进行处理;只要简单让项目要做为Cordova的页面继承于它就可以;如下的代码实现:

   #import "JiaCordovaHeader.h"

   @interface TestCordovaViewController : JiaCordovaViewController

   @end

然后就可以实现请求的方式,这边同样也是区分的沙盒中的页面还是远端的网页;

1:请求网页的方式,

   TestCordovaViewController *vc=[[TestCordovaViewController alloc]initConfigWithNetwork:YES folderName:@"" homePage:@"http://www.cnblogs.com/" parameter:nil];
   [self.navigationController pushViewController:vc animated:YES];

2:请求沙盒的方式

   TestCordovaViewController *vc=[[TestCordovaViewController alloc]initConfigWithNetwork:NO folderName:@"www" homePage:@"index.html" parameter:nil];
   [self.navigationController pushViewController:vc animated:YES];

其中parameter是存放参数,可以让JS进行调用,JS就可以动态获取到本身自个想要的参数,上面这两种方式都有做容错处理,假如不存在页面时都会默认跳到项目中提供的一个错误提示页面;

3:请求沙盒的方式之Scheme跳转

   TestCordovaViewController *vc=[[TestCordovaViewController alloc]initConfigScheme:@"jia-webview://www/index.html?id=1234&name=wujunyang"];
   [self.navigationController pushViewController:vc animated:YES];

针对本地加载的页面增加的scheme方式,只要简单把协议的字符串传入更可以进行跳转到加载指定的html页面,协议头都是以jia-webview为标识,www是对应的沙盒文件夹名称,index.html则要是页面,后面可以跟上对应的参数;代码会自动解析成字典;

四:JS获取OC的参数

1:对于传参除了直接在url地址拼成以外,JiaCordova里面还通过一个JiaCordovaParameterPlugin插件实现交互,js可以把想获取到的参数的key值以数组的形式传给JiaCordovaParameterPlugin,会自动完成先前传参时的过滤然后再把对应的值回传给前端html页面;

        var options=new Array("name");
        alert(options);
        cordova.exec(
                     function(result){
                     var s=result;
                     
                     alert(s);
                     
                     for(var key in result )
                     {
                       var value=  result[key];
                       alert(key+":"+value);
                     }
                     
                     },
                     function(error)
                     {
                       alert("error",error);
                     }
                     ,'JiaCordovaParameterPlugin','requestParameterData',[options]);

上面代码就是想获取OC中参数字典中key为name的值;如果你有多个参数都可以增加到数组中;但前提是客户端OC参数里面要有对应的key;

      NSDictionary *dic=@{@"name":@"wujunyang",@"projectID":@"12345"};
        
      TestCordovaViewController *vc=[[TestCordovaViewController alloc]initConfigWithNetwork:NO folderName:@"wwws" homePage:@"index.html" parameter:dic];

因为OC的字典已经存在name的key,所以它会把这个值过滤出来,并赋值成字典回传给JS;完成对于参数的动调获取;

2:如果OC要根据Cordova的JS返回参数进行业务逻辑处理,JiaCordovaParameterPlugin插件中提供fromHtmlParameterData进行OC接收JS的字典参数,然后可以如下(提示原生OC端要进行登录的操作)进行操作;

        options={LoginStatus:false};
        cordova.exec(
                     function(result){
                     var s=result;
                     alert(s);
                     },
                     function(error)
                     {
                     alert("error",error);
                     }
                     ,'JiaCordovaParameterPlugin','fromHtmlParameterData',[options]);

这边JS只要调用,OC端就会马上进行响应,并根据通过去的字典值进行业务判断并处理;至于字典的参数则是前后端进行商议定下的字段;如上面LoginStatus这边用来定义登录状态;

	-(void)jiaCordovafromHtmlParameterAction:(NSDictionary *)dictionary
	      {
    		if (dictionary.count==0) {
        	return;
    		}
    		//可以前后端约定好相应的参数值 进行业务的处理
    		NSNumber *loginState=dictionary[@"LoginStatus"];
    		NSLog(@"OC收到参数了:%@",dictionary);
    
    		if(![loginState boolValue])
    		{
        	   NSLog(@"跳转到登录");
   		 }
	      }

OC端只要在继承于JiaCordovaViewController的页面写上面的方法进行处理,实例中在TestCordovaViewController里面;

五:效果展现

联系方式

如果你在使用过程中有什么不明白或者问题可以[email protected]联系,当然如果你有时间也可以一起维护

许可

JiaCordova 使用 MIT 许可证,详情可见 LICENSE 文件。

About

在Cordova及插件的基础上封装一些常用的功能,不断更新中

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published