zl程序教程

您现在的位置是:首页 >  移动开发

当前栏目

cordova插件iOS平台实战开发注意点

ios平台插件开发 实战 注意 Cordova
2023-09-27 14:29:22 时间

cordova插件是其设计理念的精髓部分,创建并使用自定义插件也是一件比较容易的事。但在这个过程中也容易进入一些误区或者有一些错误的理解,下面从笔者实际开发中遇到的问题出发,对其中的一些注意点和重要概念进行适当的阐述。

相关修改的文件:
1. iOS原生开发的插件类;其中需要包括参数为(CDVInvokedUrlCommand *)command的接口(供web侧调用);还可以在其中实现一些生命周期方法,比如pluginInitialize(类公用的方法),但需要对其做相应的配置(在配置文件中,后面会说到)。
2. 映射用的配置文件config.xml. 示例如下:


 feature name="GestureHandler" 

 param name="ios-package" value="CDVGestureHandler" / 

 param name="onload" value="true" / 

 /feature 

可以这样理解每一个feature都对应着一个插件,这里的feature name也就是插件模块的名字;它需要和后面js调用native的exec方法的参数相同,否则就无法找到这个插件了。 而其中的param name固定为”ios-package”,即指定iOS平台;后面的value是对应的iOS原生类的名字(这个也是用来匹配到原生代码的,务必要正确)。后面的 param name=”onload” value=”true” 是可选的,配置此项后,插件的 pluginInitialize 才会在每次初始化的时候被调用.
3.index.html文件。这个是用来测试插件功能的html文件,我们可以在此处写一些测试的js代码来验证我们的插件功能。


input type="button" onclick="test()" value="插件测试" input type="button" onclick="test2()" value="插件测试2"

ps: 新版本的cordova默认是启用CSR的,会禁用html中的inline-js,注释掉(或加上特定标记 unsafe-inline)之后inline-js才能起作用。

4.index.js
你也可以把测试代码写在index.js里。
cordova.exec的调用格式为:

exec( successFunction , failFunction , service , action , [ args ]);

前两个是回调处理函数,第三个是插件模块的名字,第四个是原生方法的方法名。后面的args可以用于向原生传递数据。


config.xml的配置一定要注意,exec的调用参数也要与之匹配。 访问外部的url需要加入到白名单(默认是启用白名单的)。 inline-js 不执行的情况需要在CSR中作配置或者直接注释掉。 当前项目中存在的问题:
在config.xml里面加入了大量的feature,实际这个是不必要的。1个模块可以对应多个接口,这些接口可以只从属于一个插件模块。 有些调用可能存在时间较长的情况,需要将其运行在background thread(通过runInBackground方法,在block中执行)。

官方参考文档