Cordova webapp实战开发(十)- 开发自己的插件(cordova原理 - 1)

随说 :项目如期进行中,利用空闲的时间,理解了一下cordova的打包原理.

你想要开发自己的插件,首先要理解cordova的调用插件原理。

1. cordova.js/cordova_plugins.js文件

——自动生成####

cordova.js :
在创建Android&iOS工程的时候,
是从cordova的lib目录下Copy到platforms\android&iOS\assets\www\cordova.js的。
同时备份到platforms\android&iOS\platform_www\cordova.js

cordova_plugins.js :
而platforms\android&iOS\assets\www\是根据plugins文件夹的内容生成的。

——手动生成####

可以直接参考, 有详细的安装指令
github : https://github.com/apache/cordova-js

——cordova目录(Android和iOS的目录有所不同)####

;(function() {  
var CORDOVA_JS_BUILD_LABEL = '4.1.1';  
// file: src/scripts/require.js  
//...  

// file: src/cordova.js  
// cordova主要实现功能实现模块
define("cordova", function(require, exports, module) { /*...*/ }  

//================下面这些是通用的方法iOS&Android============
// file: src/common/argscheck.js  
// 用于plugin中校验参数
define("cordova/argscheck", function(require, exports, module) { /*...*/ }  

// file: src/common/base64.js  
// JS->Native交互时对ArrayBuffer进行uint8ToBase64
define("cordova/base64", function(require, exports, module) { /*...*/ }  

// file: src/common/builder.js  
// 对象属性操作, 注意,它用到了utils
define("cordova/builder", function(require, exports, module) { /*...*/ }  

// file: src/common/channel.js  
// 控制事件调用
define("cordova/channel", function(require, exports, module) { /*...*/ }  

// file: src/common/exec/proxy.js 
//  用于Plugin中往已经有的模块上添加方法
define("cordova/exec/proxy", function(require, exports, module) { /*...*/ }  

// file: src/common/init.js  
// 初始化处理
define("cordova/init", function(require, exports, module) { /*...*/ }  

// file: src/common/modulemapper.js  
// 把定义的模块clobber到一个对象,在初始化的时候会赋给window
define("cordova/modulemapper", function(require, exports, module) { /*...*/ }  


// file: src/common/pluginloader.js  
// 加载所有cordova_plugins.js中定义的模块,执行完成后会触发onPluginsReady
define("cordova/pluginloader", function(require, exports, module) { /*...*/ } 
 
// file: src/common/urlutil.js  
// 获取绝对URL,InAppBrowser中会用到
define("cordova/urlutil", function(require, exports, module) { /*...*/ }  

// file: src/common/utils.js  
// 提供了一些工具方法 , 检测是否数组,是否数据等
define("cordova/utils", function(require, exports, module) { /*...*/ }  

//================下面iOS 与 Android 调用不同,这里是以iOS作为例子=====
// file: /Users/ednamorales/dev/apache_plugins/cordova-ios/cordova-js-src/exec.js
// 执行JS->Native交互
define("cordova/exec", function(require, exports, module) 

// file: /Users/ednamorales/dev/apache_plugins/cordova-ios/cordova-js-src/platform.js
// 模块处理
define("cordova/platform", function(require, exports, module)

// 加载cordova模块,赋给window.cordova
// require()第一次被调用,就开始调用factory
window.cordova = require('cordova');  

// 加载Plugin代码等初期化处理  
require('cordova/init');  
})();  

注 :

当index.html引入后,

1-> 定义 require, define; 开始定义 require, define; 实现函数,
2-> define() 注册各模块, 然后开始window.cordova = require('cordova'); 将cordova赋值给window.cordova
3-> 第一次require()被调用,就会开始调用factory,然后因为factory里面包含其他require(), 形成循环嵌套
4-> 至此所有factory,被执行完毕。

(你喜欢可以修改cordova.js。 +上alert,就能调试他们的加载顺序了)

——cordova_plugins.js目录####

cordova从3.0版本开始不再在cordova.js中包含plugin的代码,cls引入后,plugin采用cls生成cordova_plugins.js然后动态加载需要的plugin

// 注册cordova/plugin_list 模块
cordova.define('cordova/plugin_list', function(require, exports, module) {
module.exports = [
    {
        "file": "plugins/cordova-plugin-console/www/console-via-logger.js",
        "id": "cordova-plugin-console.console",
        "pluginId": "cordova-plugin-console",
        "clobbers": [
            "console"
        ]
    }
];

module.exports.metadata = 
// TOP OF METADATA
{
    "cordova-plugin-console": "1.0.3"
}
// BOTTOM OF METADATA
});

这个模块是怎样添加进去的?在cordova.js中,找到源代码

// 异步加载 onDeviceReady 受制于
// 插件加载完毕后,会调用 onPluginsReady.
exports.load = function(callback) {
    var pathPrefix = findCordovaPath();
    if (pathPrefix === null) {
        console.log('Could not find cordova.js script tag. Plugin loading may fail.');
        pathPrefix = '';
    }
  // 当开始加载的时候,将cordova/plugin_list的list拿出来,一个一个凭借
                    
                    

你可能感兴趣的:(Cordova webapp实战开发(十)- 开发自己的插件(cordova原理 - 1))